From 586ec1b20e98d8943751615c30c2c63d161ff11b Mon Sep 17 00:00:00 2001 From: Thomas Guilbert Date: Tue, 5 Mar 2024 22:53:09 +0000 Subject: [PATCH 1/3] Add OpusEncoderConfig.[signal/application] --- opus_codec_registration.src.html | 77 ++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/opus_codec_registration.src.html b/opus_codec_registration.src.html index 40704d2c..5221252a 100644 --- a/opus_codec_registration.src.html +++ b/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" } } @@ -115,6 +121,8 @@ 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", +}; + + + +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]]. + +
+
auto
+
+ The audio signal is not known to be of a particular type. +
+
music
+
+ The audio signal is music. +
+
voice
+
+ The audio signal is voice or speech. +
+
+ +OpusApplication {#opus-application} +------------------------------------------ +
+
+enum OpusApplication {
+  "voip",
+  "audio",
+  "lowdelay",
+};
+
+
+ +The {{OpusApplication}} describes the intended application. See +[secion 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]]. + +
+
voip
+
+ Process signal for improved speech intelligibility. +
+
audio
+
+ Favor faithfulness to the original input. +
+
lowdelay
+
+ Configure the minimum possible coding delay by disabling certain modes of + operation. +
+
+ Privacy Considerations {#privacy-considerations} ========================================================================== From 275965bb6f1d71bf796f503b750e92b8549e0cb4 Mon Sep 17 00:00:00 2001 From: Bernard Aboba Date: Tue, 5 Mar 2024 15:27:16 -0800 Subject: [PATCH 2/3] secion -> section Fix typos --- opus_codec_registration.src.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/opus_codec_registration.src.html b/opus_codec_registration.src.html index 5221252a..8ca43488 100644 --- a/opus_codec_registration.src.html +++ b/opus_codec_registration.src.html @@ -226,7 +226,7 @@ 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]]. +[section 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]].
auto
@@ -256,7 +256,7 @@ The {{OpusApplication}} describes the intended application. See -[secion 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]]. +[section 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]].
voip
From a1ea7d2a157c06e6c12058fd05657b1816afeb4e Mon Sep 17 00:00:00 2001 From: Thomas Guilbert Date: Wed, 6 Mar 2024 00:15:04 +0000 Subject: [PATCH 3/3] Remove references to Object RTC draft --- opus_codec_registration.src.html | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) diff --git a/opus_codec_registration.src.html b/opus_codec_registration.src.html index 8ca43488..5aeb05f9 100644 --- a/opus_codec_registration.src.html +++ b/opus_codec_registration.src.html @@ -46,12 +46,6 @@ "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" } } @@ -225,13 +219,12 @@ -The {{OpusSignal}} describes the type of audio signal being encoded. See -[section 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]]. +The {{OpusSignal}} indicates the default value for the type of signal being encoded.
auto
- The audio signal is not known to be of a particular type. + The audio signal is not specified to be of a particular type.
music
@@ -255,8 +248,8 @@ -The {{OpusApplication}} describes the intended application. See -[section 9.3.1.1](https://draft.ortc.org/#opus-codec-options*) of [[OBJECT-RTC]]. +The {{OpusApplication}} indicates the default value for the encoder's intended +application.
voip