Add OpusEncoderConfig.[signal/application]

Author: tguilbert-google

opus_codec_registration.src.html

@@ -46,6 +46,12 @@
     "title": "RFC 7845: Ogg Encapsulation for the Opus Audio Codec",
     "publisher": "IETF",
     "date": "April 2016"
+  },
+  "OBJECT-RTC": {
+    "href": "https://w3c.github.io/ortc/",
+    "title": "Object RTC (ORTC) API for WebRTC",
+    "publisher": "W3C",
+    "date": "January 2021"
   }
 }
 </pre>
@@ -115,6 +121,8 @@
 <xmp>
 dictionary OpusEncoderConfig {
   OpusBitstreamFormat format = "opus";
+  OpusSignal signal = "auto";
+  OpusApplication application = "audio";
   [EnforceRange] unsigned long long frameDuration = 20000;
   [EnforceRange] unsigned long complexity;
   [EnforceRange] unsigned long packetlossperc = 0;
@@ -139,6 +147,14 @@
     Configures the format of output {{EncodedAudioChunk}}s. See
     {{OpusBitstreamFormat}}.
   </dd>
+  <dt><dfn dict-member for=OpusEncoderConfig>signal</dfn></dt>
+  <dd>
+    Specificies the type of audio signal being encoded. See {{OpusSignal}}.
+  </dd>
+  <dt><dfn dict-member for=OpusEncoderConfig>application</dfn></dt>
+  <dd>
+    Specificies the encoder's intended application. See {{OpusApplication}}.
+  </dd>
   <dt><dfn dict-member for=OpusEncoderConfig>frameDuration</dfn></dt>
   <dd>
     Configures the frame duration, in microseconds, of output {{EncodedAudioChunk}}s.
@@ -197,6 +213,67 @@
   </dd>
 </dl>
 
+OpusSignal {#opus-signal}
+------------------------------------------
+<pre class='idl'>
+<xmp>
+enum OpusSignal {
+  "auto",
+  "music",
+  "voice",
+};
+</xmp>
+</pre>
+
+The {{OpusSignal}} describes the type of audio signal being encoded. See
+[secion 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]].
+
+<dl>
+  <dt><dfn enum-value for=OpusSignal>auto</dfn></dt>
+  <dd>
+    The audio signal is not known to be of a particular type.
+  </dd>
+  <dt><dfn enum-value for=OpusSignal>music</dfn></dt>
+  <dd>
+    The audio signal is music.
+  </dd>
+  <dt><dfn enum-value for=OpusSignal>voice</dfn></dt>
+  <dd>
+    The audio signal is voice or speech.
+  </dd>
+</dl>
+
+OpusApplication {#opus-application}
+------------------------------------------
+<pre class='idl'>
+<xmp>
+enum OpusApplication {
+  "voip",
+  "audio",
+  "lowdelay",
+};
+</xmp>
+</pre>
+
+The {{OpusApplication}} describes the intended application. See
+[secion 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]].
+
+<dl>
+  <dt><dfn enum-value for=OpusApplication>voip</dfn></dt>
+  <dd>
+    Process signal for improved speech intelligibility.
+  </dd>
+  <dt><dfn enum-value for=OpusApplication>audio</dfn></dt>
+  <dd>
+    Favor faithfulness to the original input.
+  </dd>
+  <dt><dfn enum-value for=OpusApplication>lowdelay</dfn></dt>
+  <dd>
+    Configure the minimum possible coding delay by disabling certain modes of
+    operation.
+  </dd>
+</dl>
+
 Privacy Considerations {#privacy-considerations}
 ==========================================================================