diff --git a/codec_registry.src.html b/codec_registry.src.html index afb5c1a5..789664a8 100644 --- a/codec_registry.src.html +++ b/codec_registry.src.html @@ -45,9 +45,23 @@ Registration Entry Requirements {#registration-entry-requirements} ================================================================== -1. Each entry must include a unique codec string, a common name string, and a - link to the codec's specification. -2. The codec string must be crafted as follows: +To register an entry, file an issue in the +[WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/) +so it can be discussed and evaluated for compliance before being added to +the registry. + +The Media Working Group might seek expertise from outside the +Working Group as part of its evaluation, e.g., from the codec specification +editors or relevant standards group. If the codec specification is not +publicly available, it must be made available to the Working Group for +evaluation. For the entry to be included, there needs +to be interest from at least one implementer in the Working Group. If the Working Group +reaches consensus to accept the candidate entry, send a pull request (either by editors +or by the party requesting the candidate registration) that meets the following requirements: + +1. A unique codec string, a common name string, and a + link to the codec's public registration specification. +2. The codec string requirements are 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 @@ -58,41 +72,34 @@ 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 + 1. Recognized codec strings. + 2. {{EncodedAudioChunk}} or {{EncodedVideoChunk}} internal data. + 3. {{AudioDecoderConfig}} or {{VideoDecoderConfig}} description bytes. 4. Expectations for {{EncodedAudioChunk}} or {{EncodedVideoChunk}} - {{EncodedVideoChunk/[[type]]}} + {{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](https://github.com/w3c/webcodecs/issues/) - so they can be discussed and evaluated for compliance before being added to - the registry. The Media Working Group may seek expertise from outside the - Working Group as part of its evaluation, e.g., from the codec specification - editors or relevant standards group. If the codec specification is not - publicly available, it must be made available to the Working Group for - evaluation. If the 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. -6. Existing entries cannot be deleted or deprecated. They may be changed after - being published through the same process as candidate entries. Possible - changes include expansion of the codec string to better qualify the codec, - adjustments to the codec name string, and modification of the link to the - codec's specification. +Once consensus is reached by the Working Group, the registry editors will review and merge the pull request. + +Existing entries cannot be deleted or deprecated. They may be changed after +being published through the same process as candidate entries. Possible +changes include expansion of the codec string to better qualify the codec, +adjustments to the codec name string, and modification of the link to the +codec's specification. Audio Codec Registry {#audio-codec-registry} ============================================ - - - - - + + + + + + + @@ -153,11 +160,13 @@ ============================================
**codec string****common name****public specification**
Codec stringCommon nameRegistration specification
flac Flac
- - - - - + + + + + + +
**codec string****common name****specification**
Codec stringCommon nameRegistration specification
av01.\* AV1