codec_registry.src.html

<pre class='metadata'>
Title: WebCodecs Codec Registry
Repository: w3c/webcodecs
Status: NOTE-ED
Shortname: webcodecs-codec-registry
Level: none
Group: mediawg
ED: https://w3c.github.io/webcodecs/codec_registry.html
TR: https://www.w3.org/TR/webcodecs-codec-registry/
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/

Boilerplate: omit conformance

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.

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: VideoDecoderConfig.description; url: dom-videodecoderconfig-description
    type: dfn
        for: EncodedVideoChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot
    type: interface
        text: EncodedAudioChunk; url: encodedaudiochunk
        text: EncodedVideoChunk; url: encodedvideochunk
    type: dictionary
        text: AudioDecoderConfig; url: dictdef-audiodecoderconfig
        text: AudioEncoderConfig; url: dictdef-audioencoderconfig
        text: VideoDecoderConfig; url: dictdef-videodecoderconfig
        text: VideoEncoderConfig; url: dictdef-videoencoderconfig
</pre>


Organization {#organization}
============================

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

Registration Entry Requirements {#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}}
        [=EncodedVideoChunk/[[type]]=]
3. Where applicable, a registration specification may include a section
    describing extensions to {{VideoEncoderConfig}} or {{AudioEncoderConfig}}
    dictionaries.
4. Candidate entries must be announced by filing an issue in the
    [WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/)
    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.

Audio Codec Registry {#audio-codec-registry}
============================================

<table class='data'>
  <tr>
    <td>**codec string**</td>
    <td>**common name**</td>
    <td>**public specification**</td>
  </tr>
  <tr>
    <td>flac</td>
    <td>Flac</td>
    <td>[FLAC codec registration](https://www.w3.org/TR/webcodecs-flac-codec-registration/) [[WEBCODECS-FLAC-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>mp3</td>
    <td>MP3</td>
    <td>[MP3 WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-mp3-codec-registration/)
    [[WEBCODECS-MP3-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>mp4a.\*</td>
    <td>AAC</td>
    <td>[AAC WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-aac-codec-registration/)
    [[WEBCODECS-AAC-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>opus</td>
    <td>Opus</td>
    <td>[Opus WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-opus-codec-registration/)
    [[WEBCODECS-OPUS-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>vorbis</td>
    <td>Vorbis</td>
    <td>[Vorbis WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-vorbis-codec-registration/)
    [[WEBCODECS-VORBIS-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>ulaw</td>
    <td>u-law PCM</td>
    <td>[u-law PCM WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-ulaw-codec-registration/)
    [[WEBCODECS-ULAW-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>alaw</td>
    <td>A-law PCM</td>
    <td>[A-law PCM WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-alaw-codec-registration/)
    [[WEBCODECS-ALAW-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>pcm-\*</td>
    <td>Linear PCM</td>
    <td>[Linear PCM WebCodecs
      Registration](https://www.w3.org/TR/webcodecs-pcm-codec-registration/)
    [[WEBCODECS-PCM-CODEC-REGISTRATION]]</td>
  </tr>
</table>

Video Codec Registry {#video-codec-registry}
============================================

<table class='data'>
  <tr>
    <td>**codec string**</td>
    <td>**common name**</td>
    <td>**specification**</td>
  </tr>
  <tr>
    <td>av01.\*</td>
    <td>AV1</td>
    <td>[AV1 codec registration](https://www.w3.org/TR/webcodecs-av1-codec-registration/) [[WEBCODECS-AV1-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>avc1.\*, avc3.\*</td>
    <td>AVC / H.264</td>
    <td>[AVC (H.264) WebCodecs Registration](https://www.w3.org/TR/webcodecs-avc-codec-registration/) [[WEBCODECS-AVC-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>hev1.\*, hvc1.\*</td>
    <td>HEVC / H.265</td>
    <td>[HEVC (H.265) WebCodecs Registration](https://www.w3.org/TR/webcodecs-hevc-codec-registration/) [[WEBCODECS-HEVC-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>vp8</td>
    <td>VP8</td>
    <td>[VP8 codec registration](https://www.w3.org/TR/webcodecs-vp8-codec-registration/) [[WEBCODECS-VP8-CODEC-REGISTRATION]]</td>
  </tr>
  <tr>
    <td>vp09.\*</td>
    <td>VP9</td>
    <td>[VP9 codec registration](https://www.w3.org/TR/webcodecs-vp9-codec-registration/) [[WEBCODECS-VP9-CODEC-REGISTRATION]]</td>
  </tr>
</table>

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]].