Merge pull request #777 from tguilbert-google/opus_signal_application

Add OpusEncoderConfig.[signal/application]

Author: Djuffin

opus_codec_registration.src.html

@@ -115,6 +115,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 +141,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 +207,66 @@
   </dd>
 </dl>
 
+OpusSignal {#opus-signal}
+------------------------------------------
+<pre class='idl'>
+<xmp>
+enum OpusSignal {
+  "auto",
+  "music",
+  "voice",
+};
+</xmp>
+</pre>
+
+The {{OpusSignal}} indicates the default value for the type of signal being encoded.
+
+<dl>
+  <dt><dfn enum-value for=OpusSignal>auto</dfn></dt>
+  <dd>
+    The audio signal is not specified 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}} indicates the default value for the encoder's intended
+application.
+
+<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}
 ==========================================================================