WebCodecs Codec Registry

Editor’s Draft,

More details about this document
This version:
https://w3c.github.io/webcodecs/codec_registry.html
Latest published version:
https://www.w3.org/TR/webcodecs-codec-registry/
Feedback:
GitHub
Editors:
Chris Cunningham (Google Inc.)
Paul Adenot (Mozilla)
Bernard Aboba (Microsoft Corporation)
Participate:
Git Repository.
File an issue.
Version History:
https://github.com/w3c/webcodecs/commits

Abstract

This registry is intended to enhance interoperability among implementations and users of [WEBCODECS]. In particular, this registry provides the means to identify and avoid collisions among codec strings and provides a mechanism to define codec-specific members of [WEBCODECS] codec configuration dictionaries.

This registry is not intended to include any information on whether a codec format is encumbered by intellectual property claims. Implementers and users 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 any particular codec nor registry entry.

This registry is non-normative.

Status of this document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.

Feedback and comments on this specification are welcome. GitHub Issues are preferred for discussion on this specification. Alternatively, you can send comments to the Media Working Group’s mailing-list, public-media-wg@w3.org (archives). This draft highlights some of the pending issues that are still to be discussed in the working group. No decision has been taken on the outcome of these issues including whether they are valid.

This document was published by the Media Working Group as an Editor’s Draft. The group does not expect this document to become a W3C Recommendation.

Publication as an Editor’s Draft does not imply endorsement by W3C and its Members.

The W3C Patent Policy does not carry any licensing requirements or commitments on this document.

This document is governed by the 2 November 2021 W3C Process Document.

1. Organization

This registry maintains a mapping between codec strings and registration specifications as described below.

2. Registration Entry Requirements

  1. Each entry must include a unique codec string, a common name string, and a link to a public specification.

  2. The codec string must be crafted as follows:

    1. If the codec string contains a fixed prefix with variable suffix values, the suffix must be represented by an asterisk and the registration’s public specification must describe how to fully qualify the variable portion of the string.

    2. Otherwise, if the codec is recognized by multiple strings, a single preferred string should be listed and the registration’s specification must list the other allowed strings.

    3. Otherwise, the codec is identified by a simple fixed string.

  3. Each registration’s specification must include a sequence of sections describing:

    1. Recognized codec strings

    2. EncodedAudioChunk or EncodedVideoChunk internal data

    3. AudioDecoderConfig or VideoDecoderConfig description bytes

    4. Expectations for EncodedAudioChunk or EncodedVideoChunk [[type]]

  4. Where applicable, a registration specification may include a section describing extensions to VideoEncoderConfig or AudioEncoderConfig dictionaries.

  5. Candidate entries must be announced by filing an issue in the WebCodecs GitHub issue tracker so they can be discussed and evaluated for compliance before being added to the registry. If the Media Working Group reaches consensus to accept the candidate, a pull request should be drafted (either by editors or by the party requesting the candidate registration) to register the candidate. The registry editors will review and merge the pull request.

3. Audio Codec Registry

codec string common name public specification
flac Flac FLAC codec registration [WEBCODECS-FLAC-CODEC-REGISTRATION]
mp3 MP3 MP3 WebCodecs Registration [WEBCODECS-MP3-CODEC-REGISTRATION]
mp4a.* AAC AAC WebCodecs Registration [WEBCODECS-AAC-CODEC-REGISTRATION]
opus Opus Opus WebCodecs Registration [WEBCODECS-OPUS-CODEC-REGISTRATION]
vorbis Vorbis Vorbis WebCodecs Registration [WEBCODECS-VORBIS-CODEC-REGISTRATION]
ulaw u-law PCM u-law PCM WebCodecs Registration [WEBCODECS-ULAW-CODEC-REGISTRATION]
alaw A-law PCM A-law PCM WebCodecs Registration [WEBCODECS-ALAW-CODEC-REGISTRATION]
pcm-* Linear PCM Linear PCM WebCodecs Registration [WEBCODECS-PCM-CODEC-REGISTRATION]

4. Video Codec Registry

codec string common name specification
av01.* AV1 AV1 codec registration [WEBCODECS-AV1-CODEC-REGISTRATION]
avc1.*, avc3.* AVC / H.264 AVC (H.264) WebCodecs Registration [WEBCODECS-AVC-CODEC-REGISTRATION]
hev1.*, hvc1.* HEVC / H.265 HEVC (H.265) WebCodecs Registration [WEBCODECS-HEVC-CODEC-REGISTRATION]
vp8 VP8 VP8 codec registration [WEBCODECS-VP8-CODEC-REGISTRATION]
vp09.* VP9 VP9 codec registration [WEBCODECS-VP9-CODEC-REGISTRATION]

5. Privacy Considerations

Please refer to the section Privacy Considerations in [WEBCODECS].

6. Security Considerations

Please refer to the section Security Considerations in [WEBCODECS].

Index

Terms defined by reference

References

Normative References

[WEBCODECS]
Chris Cunningham; Paul Adenot; Bernard Aboba. WebCodecs. URL: https://w3c.github.io/webcodecs/

Informative References

[WEBCODECS-AAC-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. AAC WebCodecs Registration. URL: https://w3c.github.io/webcodecs/aac_codec_registration.html
[WEBCODECS-ALAW-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. A-law PCM WebCodecs Registration. URL: https://w3c.github.io/webcodecs/alaw_codec_registration.html
[WEBCODECS-AV1-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. AV1 WebCodecs Registration. URL: https://w3c.github.io/webcodecs/av1_codec_registration.html
[WEBCODECS-AVC-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. AVC (H.264) WebCodecs Registration. URL: https://w3c.github.io/webcodecs/avc_codec_registration.html
[WEBCODECS-FLAC-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. FLAC WebCodecs Registration. URL: https://w3c.github.io/webcodecs/flac_codec_registration.html
[WEBCODECS-MP3-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. MP3 WebCodecs Registration. URL: https://w3c.github.io/webcodecs/mp3_codec_registration.html
[WEBCODECS-OPUS-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. Opus WebCodecs Registration. URL: https://w3c.github.io/webcodecs/opus_codec_registration.html
[WEBCODECS-PCM-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. Linear PCM WebCodecs Registration. URL: https://w3c.github.io/webcodecs/pcm_codec_registration.html
[WEBCODECS-ULAW-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. u-law PCM WebCodecs Registration. URL: https://w3c.github.io/webcodecs/ulaw_codec_registration.html
[WEBCODECS-VORBIS-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. Vorbis WebCodecs Registration. URL: https://w3c.github.io/webcodecs/vorbis_codec_registration.html
[WEBCODECS-VP8-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. VP8 WebCodecs Registration. URL: https://w3c.github.io/webcodecs/vp8_codec_registration.html
[WEBCODECS-VP9-CODEC-REGISTRATION]
Chris Cunningham; Paul Adenot; Bernard Aboba. VP9 WebCodecs Registration. URL: https://w3c.github.io/webcodecs/vp9_codec_registration.html