Merge pull request #729 from Djuffin/content-hint

Add VideoEncoderConfig.contentHint

Author: aboba

index.src.html

@@ -47,9 +47,12 @@
         type: dfn; text: current playback position; url: media.html#current-playback-position
     type: dfn; text: live; url: infrastructure.html#live
 
-spec: webrtc-svc; urlPrefix: https://w3c.github.io/webrtc-svc/
+spec: webrtc-svc; urlPrefix: https://www.w3.org/TR/webrtc-svc/
     type: dfn; text: scalability mode identifier; url:#scalabilitymodes*
 
+spec: mst-content-hint; urlPrefix: https://www.w3.org/TR/mst-content-hint/
+    type: dfn; text: video content hints; url:#video-content-hints
+
 spec: ECMASCRIPT; urlPrefix: https://tc39.es/ecma262/
     type: dfn; text: the current Realm; url: #current-realm
 </pre>
@@ -2104,6 +2107,7 @@
   DOMString scalabilityMode;
   VideoEncoderBitrateMode bitrateMode = "variable";
   LatencyMode latencyMode = "quality";
+  DOMString contentHint;
 };
 </xmp>
 
@@ -2221,6 +2225,20 @@
   <dd>
     Configures latency related behaviors for this codec. See {{LatencyMode}}.
   </dd>
+  <dt><dfn dict-member for=VideoEncoderConfig>contentHint</dfn></dt>
+  <dd>
+    An encoding [=video content hint=] as defined by [[mst-content-hint]].
+
+    The User Agent <em class="rfc2119">MAY</em> use this hint to set
+    expectations about incoming {{VideoFrame}}s and to improve encoding quality.
+
+    The User Agent <em class="rfc2119">MUST NOT</em> refuse the configuration
+    if it doesn't support this content hint.
+    See {{VideoEncoder/isConfigSupported()}}.
+
+    NOTE: Any codec-specific encoding options take precedence over
+      {{contentHint}}.
+  </dd>
 
 </dl>