|
45 | 45 | Registration Entry Requirements {#registration-entry-requirements} |
46 | 46 | ================================================================== |
47 | 47 |
|
48 | | -1. Each entry must include a unique <a>codec string</a>, a common name string, and a |
49 | | - link to the codec's specification. |
50 | | -2. The <a>codec string</a> must be crafted as follows: |
| 48 | +To register an entry, file an issue in the |
| 49 | +[WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/) |
| 50 | +so it can be discussed and evaluated for compliance before being added to |
| 51 | +the registry. |
| 52 | + |
| 53 | +The Media Working Group might seek expertise from outside the |
| 54 | +Working Group as part of its evaluation, e.g., from the codec specification |
| 55 | +editors or relevant standards group. If the codec specification is not |
| 56 | +publicly available, it must be made available to the Working Group for |
| 57 | +evaluation. For the entry to be included, there needs |
| 58 | +to be interest from at least one implementer in the Working Group. If the Working Group |
| 59 | +reaches consensus to accept the candidate entry, send a pull request (either by editors |
| 60 | +or by the part requesting the candidate registration) that meets the following requirements: |
| 61 | + |
| 62 | +1. A unique <a>codec string</a>, a common name string, and a |
| 63 | + link to the codec's public <dfn>registration specification</dfn>. |
| 64 | +2. The <a>codec string</a> requirements are as follows: |
51 | 65 | 1. If the <a>codec string</a> contains a fixed prefix with variable suffix values, |
52 | 66 | the suffix must be represented by an asterisk and the registration's |
53 | | - public specification must describe how to fully qualify the variable |
| 67 | + public specification needs to describe how to fully qualify the variable |
54 | 68 | portion of the string. |
55 | 69 | 2. Otherwise, if the codec is recognized by multiple strings, a single |
56 | 70 | preferred string should be listed and the registration's specification |
57 | 71 | must list the other allowed strings. |
58 | 72 | 3. Otherwise, the codec is identified by a simple fixed string. |
59 | 73 | 3. Each registration's specification must include a sequence of sections |
60 | 74 | describing: |
61 | | - 1. Recognized codec strings |
62 | | - 2. {{EncodedAudioChunk}} or {{EncodedVideoChunk}} internal data |
63 | | - 3. {{AudioDecoderConfig}} or {{VideoDecoderConfig}} description bytes |
| 75 | + 1. Recognized codec strings. |
| 76 | + 2. {{EncodedAudioChunk}} or {{EncodedVideoChunk}} internal data. |
| 77 | + 3. {{AudioDecoderConfig}} or {{VideoDecoderConfig}} description bytes. |
64 | 78 | 4. Expectations for {{EncodedAudioChunk}} or {{EncodedVideoChunk}} |
65 | | - {{EncodedVideoChunk/[[type]]}} |
| 79 | + {{EncodedVideoChunk/[[type]]}}. |
66 | 80 | 4. Where applicable, a registration specification may include a section |
67 | 81 | describing extensions to {{VideoEncoderConfig}} or {{AudioEncoderConfig}} |
68 | 82 | dictionaries. |
69 | | -5. Candidate entries must be announced by filing an issue in the |
70 | | - [WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/) |
71 | | - so they can be discussed and evaluated for compliance before being added to |
72 | | - the registry. The Media Working Group may seek expertise from outside the |
73 | | - Working Group as part of its evaluation, e.g., from the codec specification |
74 | | - editors or relevant standards group. If the codec specification is not |
75 | | - publicly available, it must be made available to the Working Group for |
76 | | - evaluation. If the Working Group reaches consensus to accept the candidate, |
77 | | - a pull request should be drafted (either by editors or by the party |
78 | | - requesting the candidate registration) to register the candidate. |
79 | | - The registry editors will review and merge the pull request. |
80 | | -6. Existing entries cannot be deleted or deprecated. They may be changed after |
81 | | - being published through the same process as candidate entries. Possible |
82 | | - changes include expansion of the <a>codec string</a> to better qualify the codec, |
83 | | - adjustments to the codec name string, and modification of the link to the |
84 | | - codec's specification. |
85 | 83 |
|
| 84 | +Once consensus is reached by the Working Group, the registry editors will review and merge the pull request. |
| 85 | + |
| 86 | +Existing entries cannot be deleted or deprecated. They may be changed after |
| 87 | +being published through the same process as candidate entries. Possible |
| 88 | +changes include expansion of the <a>codec string</a> to better qualify the codec, |
| 89 | +adjustments to the codec name string, and modification of the link to the |
| 90 | +codec's specification. |
86 | 91 |
|
87 | 92 | Audio Codec Registry {#audio-codec-registry} |
88 | 93 | ============================================ |
89 | 94 |
|
90 | 95 | <table class='data'> |
91 | | - <tr> |
92 | | - <td>**codec string**</td> |
93 | | - <td>**common name**</td> |
94 | | - <td>**public specification**</td> |
95 | | - </tr> |
| 96 | + <thead> |
| 97 | + <tr> |
| 98 | + <th>Codec string</th> |
| 99 | + <th>Common name</th> |
| 100 | + <th>Registration specification</th> |
| 101 | + </tr> |
| 102 | + </thead> |
96 | 103 | <tr> |
97 | 104 | <td>flac</td> |
98 | 105 | <td>Flac</td> |
|
153 | 160 | ============================================ |
154 | 161 |
|
155 | 162 | <table class='data'> |
156 | | - <tr> |
157 | | - <td>**codec string**</td> |
158 | | - <td>**common name**</td> |
159 | | - <td>**specification**</td> |
160 | | - </tr> |
| 163 | + <thead> |
| 164 | + <tr> |
| 165 | + <th>Codec string</th> |
| 166 | + <th>Common name</th> |
| 167 | + <th>Registration specification</th> |
| 168 | + </tr> |
| 169 | + </thead> |
161 | 170 | <tr> |
162 | 171 | <td>av01.\*</td> |
163 | 172 | <td>AV1</td> |
|
0 commit comments