forked from w3c/webcodecs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'origin/main' into registry-av1
- Loading branch information
Showing
7 changed files
with
251 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,8 +1,10 @@ | ||
| avc_codec_registration.html | ||
| av1_codec_registration.src.html | ||
| codec_registry.html | ||
| vorbis_codec_registration.html | ||
| flac_codec_registration.src.html | ||
| av1_codec_registration.src.html | ||
| mp3_codec_registration.html | ||
| flac_codec_registration.html | ||
| opus_codec_registration.html | ||
| /index.html | ||
| out/ | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,96 @@ | ||
| <pre class='metadata'> | ||
| Title: MP3 WebCodecs Registration | ||
| Repository: w3c/webcodecs | ||
| Status: NOTE-ED | ||
| Shortname: webcodecs-mp3-codec-registration | ||
| Level: none | ||
| Group: mediawg | ||
| ED: https://w3c.github.io/webcodecs/mp3_codec_registration.html | ||
| TR: https://www.w3.org/TR/webcodecs-mp3-codec-registration/ | ||
| Editor: Chris Cunningham, w3cid 114832, Google Inc. https://www.google.com/ | ||
| Editor: Paul Adenot, w3cid 62410, Mozilla https://www.mozilla.org/ | ||
| Editor: Bernard Aboba, w3cid 65611, Microsoft Corporation https://www.microsoft.com/ | ||
|
|
||
| Abstract: This registration is entered into the [[webcodecs-codec-registry]]. | ||
| It describes, for MP3, the (1) fully qualified codec strings, (2) | ||
| the {{AudioDecoderConfig.description}} bytes, (3) the codec-specific | ||
| {{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] bytes, and (4) | ||
| the values of {{EncodedAudioChunk}} [=EncodedAudioChunk/[[type]]=]. | ||
|
|
||
| The registration is not intended to include any information on whether a | ||
| codec format is encumbered by intellectual property claims. Implementers and | ||
| authors are advised to seek appropriate legal counsel in this matter if they | ||
| intend to implement or use a specific codec format. Implementers of | ||
| WebCodecs are not required to support the MP3 codec. | ||
|
|
||
| This registration is non-normative. | ||
|
|
||
| Markup Shorthands:css no, markdown yes, dfn yes | ||
| !Participate: <a href="https://github.com/w3c/webcodecs">Git Repository.</a> | ||
| !Participate: <a href="https://github.com/w3c/webcodecs/issues/new">File an issue.</a> | ||
| !Version History: <a href="https://github.com/w3c/webcodecs/commits">https://github.com/w3c/webcodecs/commits</a> | ||
| </pre> | ||
|
|
||
| <pre class='anchors'> | ||
| spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/# | ||
| type: attribute | ||
| text: AudioDecoderConfig.description; url: dom-audiodecoderconfig-description | ||
| text: AudioDecoderConfig.sampleRate; url: dom-audiodecoderconfig-samplerate | ||
| text: AudioDecoderConfig.channelCount; url: dom-audiodecoderconfig-channelcount | ||
| type: dfn | ||
| for: EncodedAudioChunkType; text: key; url: dom-encodedaudiochunktype-key | ||
| for: EncodedAudioChunk; text: [[internal data]]; url: dom-encodedaudiochunk-internal-data-slot | ||
| for: EncodedAudioChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot | ||
| type: interface | ||
| text: EncodedAudioChunk; url: encodedaudiochunk | ||
| type: dictionary | ||
| text: AudioDecoderConfig; url: dictdef-audiodecoderconfig | ||
| </pre> | ||
|
|
||
| <pre class='biblio'> | ||
| { | ||
| "MP3": { | ||
| "href": "https://www.iso.org/standard/26797.html", | ||
| "title": "ISO/IEC 13818-3:1998 - Information technology — Generic coding of moving pictures and associated audio information — Part 3: Audio", | ||
| "publisher": "ISO", | ||
| "date": "1998-04" | ||
| } | ||
| } | ||
| </pre> | ||
|
|
||
| Fully qualified codec strings {#fully-qualified-codec-strings} | ||
| ============================================================== | ||
|
|
||
| The codec string is `"mp3"`. | ||
|
|
||
| EncodedAudioChunk data {#encodedaudiochunk-data} | ||
| ================================================ | ||
|
|
||
| {{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] is expected to be | ||
| a "frame", as described in the section 2.4.2.2 of the [[MP3]] specification. | ||
|
|
||
| AudioDecoderConfig description {#audiodecoderconfig-description} | ||
| ================================================================ | ||
|
|
||
| {{AudioDecoderConfig.description}} is not used for this codec. | ||
|
|
||
| The {{AudioDecoderConfig.sampleRate}} and {{AudioDecoderConfig.channelCount}} | ||
| members are ignored. | ||
|
|
||
|
|
||
| EncodedAudioChunk type {#encodedaudiochunk-type} | ||
| ================================================ | ||
|
|
||
| The [=EncodedAudioChunk/[[type]]=] for an {{EncodedAudioChunk}} containing | ||
| mp3 is always "[=EncodedAudioChunkType/key=]". | ||
|
|
||
| NOTE: Once the initialization has succeeded, any mp3 packet can be decoded at | ||
| any time without error, but this might not result in the expected audio | ||
| output. | ||
|
|
||
| Privacy and Security Considerations {#privacy-and-security-considerations} | ||
| ========================================================================== | ||
|
|
||
| Please refer to the [[WEBCODECS#privacy-considerations|Privacy Considerations]] | ||
| and [[WEBCODECS#security-considerations|Security Considerations]] sections in | ||
| [[WEBCODECS]]. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,110 @@ | ||
| <pre class='metadata'> | ||
| Title: Opus WebCodecs Registration | ||
| Repository: w3c/webcodecs | ||
| Status: NOTE-ED | ||
| Shortname: webcodecs-opus-codec-registration | ||
| Level: none | ||
| Group: mediawg | ||
| ED: https://w3c.github.io/webcodecs/opus_codec_registration.html | ||
| TR: https://www.w3.org/TR/webcodecs-opus-codec-registration/ | ||
| Editor: Chris Cunningham, w3cid 114832, Google Inc. https://www.google.com/ | ||
| Editor: Paul Adenot, w3cid 62410, Mozilla https://www.mozilla.org/ | ||
| Editor: Bernard Aboba, w3cid 65611, Microsoft Corporation https://www.microsoft.com/ | ||
|
|
||
| Abstract: This registration is entered into the [[webcodecs-codec-registry]]. | ||
| It describes, for Opus, the (1) fully qualified codec strings, (2) | ||
| the {{AudioDecoderConfig.description}} bytes, (3) the codec-specific | ||
| {{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] bytes, and (4) | ||
| the values of {{EncodedAudioChunk}} [=EncodedAudioChunk/[[type]]=]. | ||
|
|
||
| The registration is not intended to include any information on whether a | ||
| codec format is encumbered by intellectual property claims. Implementers and | ||
| authors are advised to seek appropriate legal counsel in this matter if they | ||
| intend to implement or use a specific codec format. Implementers of | ||
| WebCodecs are not required to support the Opus codec. | ||
|
|
||
| This registration is non-normative. | ||
|
|
||
| Markup Shorthands:css no, markdown yes, dfn yes | ||
| !Participate: <a href="https://github.com/w3c/webcodecs">Git Repository.</a> | ||
| !Participate: <a href="https://github.com/w3c/webcodecs/issues/new">File an issue.</a> | ||
| !Version History: <a href="https://github.com/w3c/webcodecs/commits">https://github.com/w3c/webcodecs/commits</a> | ||
| </pre> | ||
|
|
||
| <pre class='anchors'> | ||
| spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/# | ||
| type: attribute | ||
| text: AudioDecoderConfig.description; url: dom-audiodecoderconfig-description | ||
| type: dfn | ||
| for: EncodedAudioChunkType; text: key; url: dom-encodedaudiochunktype-key | ||
| for: EncodedAudioChunk; text: [[internal data]]; url: dom-encodedaudiochunk-internal-data-slot | ||
| for: EncodedAudioChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot | ||
| type: method | ||
| for: AudioDecoder; text: AudioDecoder.decode; url: dom-audiodecoder-decode | ||
| type: interface | ||
| text: EncodedAudioChunk; url: encodedaudiochunk | ||
| type: dictionary | ||
| text: AudioDecoderConfig; url: dictdef-audiodecoderconfig | ||
| </pre> | ||
|
|
||
| <pre class='biblio'> | ||
| { | ||
| "OPUS": { | ||
| "href": "https://datatracker.ietf.org/doc/html/rfc6716", | ||
| "title": "RFC 6716: Definition of the Opus Audio Codec", | ||
| "publisher": "IETF", | ||
| "date": "September 2012" | ||
| }, | ||
| "OPUS-IN-OGG": { | ||
| "href": "https://datatracker.ietf.org/doc/html/rfc7845", | ||
| "title": "RFC 7845: Ogg Encapsulation for the Opus Audio Codec", | ||
| "publisher": "IETF", | ||
| "date": "April 2016" | ||
| } | ||
| } | ||
| </pre> | ||
|
|
||
| Fully qualified codec strings {#fully-qualified-codec-strings} | ||
| ============================================================== | ||
|
|
||
| The codec string is `"opus"`. | ||
|
|
||
| EncodedAudioChunk data {#encodedaudiochunk-data} | ||
| ================================================ | ||
|
|
||
| An {{EncodedAudioChunk}} containing Opus can be in two different formats, | ||
| depending on if {{AudioDecoderConfig.description}} has been set during | ||
| initialization. | ||
|
|
||
|
|
||
| AudioDecoderConfig description {#audiodecoderconfig-description} | ||
| ================================================================ | ||
|
|
||
| {{AudioDecoderConfig.description}} can optionally set to an Identification | ||
| Header, described in section 5.1 of [[OPUS-IN-OGG]]. | ||
|
|
||
| If an {{AudioDecoderConfig.description}} has been set, the | ||
| {{EncodedAudioChunk}}s passed to the {{AudioDecoder.decode}}} method have to be | ||
| in audio data packets, as described in [section | ||
| 2](https://datatracker.ietf.org/doc/html/rfc7845#section-3) of [[OPUS-IN-OGG]]. | ||
|
|
||
| If an {{AudioDecoderConfig.description}} has not been set, then the | ||
| {{EncodedAudioChunk}}s passed to the {{AudioDecoder.decode}} method have to be | ||
| Opus packets, as described in [section | ||
| 3](https://datatracker.ietf.org/doc/html/rfc6716#section-3) of [[OPUS]]. | ||
|
|
||
| EncodedAudioChunk type {#encodedaudiochunk-type} | ||
| ================================================ | ||
|
|
||
| The [=EncodedAudioChunk/[[type]]=] for an {{EncodedAudioChunk}} containing | ||
| Opus is always "[=EncodedAudioChunkType/key=]". | ||
|
|
||
| NOTE: Once the initialization has succeeded, any packet can be decoded at any | ||
| time without error, but this might not result in the expected audio output. | ||
|
|
||
| Privacy and Security Considerations {#privacy-and-security-considerations} | ||
| ========================================================================== | ||
|
|
||
| Please refer to the [[WEBCODECS#privacy-considerations|Privacy Considerations]] | ||
| and [[WEBCODECS#security-considerations|Security Considerations]] sections in | ||
| [[WEBCODECS]]. |