Vorbis WebCodecs 注册

W3C 小组说明草案,

关于本文档的更多详细信息
此版本:
https://www.w3.org/TR/2026/DNOTE-webcodecs-vorbis-codec-registration-20260608/
最新发布版本:
https://www.w3.org/TR/webcodecs-vorbis-codec-registration/
编辑草案:
https://w3c.github.io/webcodecs/vorbis_codec_registration.html
先前版本:
历史:
https://www.w3.org/standards/history/webcodecs-vorbis-codec-registration/
反馈:
GitHub
编辑:
Paul Adenot (Mozilla)
Eugene Zemtsov (Google LLC)
前任编辑:
Bernard Aboba (Microsoft Corporation)
Chris Cunningham (Google LLC)
参与:
Git 仓库。
提交 issue。
版本历史:
https://github.com/w3c/webcodecs/commits

摘要

此注册被录入到 [webcodecs-codec-registry] 中。 它描述了 Vorbis 的:(1) 完全限定的 编解码器字符串、 (2) 特定于编解码器的 EncodedAudioChunk [[internal data]] 字节,(3) AudioDecoderConfig.description 字节, 以及 (4) EncodedAudioChunk [[type]] 的值。

此注册无意包含关于某种 编解码器格式是否受知识产权权利主张约束的任何信息。如果实现者和 作者打算实现或使用某种特定的编解码器格式,建议他们就此事项 寻求适当的法律顾问意见。WebCodecs 的实现者 无需支持 Vorbis 编解码器。

此注册是非规范性的。

本文档状态

本节描述本文档在发布时的状态。当前 W3C 出版物列表以及此 技术报告的最新修订版可在 W3C 标准和草案索引中找到。

欢迎对此规范提供反馈和评论。 关于此规范的讨论首选使用 GitHub Issues。或者,你也可以将评论发送到 Media Working Group 的邮件列表:public-media-wg@w3.org归档)。 此草案突出显示了一些仍有待工作组讨论的待处理问题。 对于这些问题的结果,包括它们是否有效,尚未作出决定。

本文档由 Media Working Group 作为 小组说明草案发布,使用的是 说明 轨道

小组说明草案未获得 W3C 或其成员的认可。

这是草案文档,可能在任何时候被其他文档更新、取代或废弃。 不应将本文档作为进行中工作以外的内容来引用。

W3C 专利政策不会对此文档附带任何许可 要求或承诺。

本文档受 2025年8月18日 W3C 流程文档管辖。

1. 完全限定的编解码器字符串

编解码器字符串"vorbis"

2. EncodedAudioChunk 数据

EncodedAudioChunk [[internal data]] 预期为 一个“音频包”,如 [VORBIS] 规范第 4.3 节所述。

3. AudioDecoderConfig description

description 是必需的。它被假定为 Xiph extradata 格式,如 [OGG-FRAMING] 所述。此格式由 page_segments 字段,后跟 segment_table 字段,再后跟 三个 Vorbis 头包组成,分别是 identification header、comments header 和 setup header,按此顺序排列,如 [VORBIS] 第 4.2 节所述。

sampleRatenumberOfChannels 成员会被解码器在 identification header 中找到的内容覆盖。

注: comments header 内容不会被 [WEBCODECS] 使用。

4. EncodedAudioChunk type

对于包含 Vorbis 的 EncodedAudioChunk, 其 [[type]] 始终是 “key”。

注: 一旦初始化成功,任何 Vorbis 数据包都可以在 任何时候解码且不会出错,但这可能不会产生预期的音频输出。

5. 隐私考量

请参阅 隐私 考量一节,见 [WEBCODECS]

6. 安全考量

请参阅 安全 考量一节,见 [WEBCODECS]

一致性

文档 约定

一致性要求通过 描述性断言 和 RFC 2119 术语的组合来表达。 规范性部分中的关键词 “MUST”、“MUST NOT”、“REQUIRED”、“SHALL”、“SHALL NOT”、“SHOULD”、“SHOULD NOT”、“RECOMMENDED”、 “MAY” 和 “OPTIONAL” 应按 RFC 2119 中的描述解释。 但是,为了可读性, 这些词在本规范中并不全部以大写字母出现。

本规范的所有文本均为规范性文本, 但显式标记为非规范性的章节、示例和注除外。[RFC2119]

本规范中的示例以 “for example” 一词引入, 或通过 class="example" 与规范性文本分开设置, 如下所示:

这是一个信息性示例的例子。

信息性注以 “Note” 一词开头,并通过 class="note" 与规范性文本分开设置, 如下所示:

注,这是一个信息性注。

索引

由引用定义的 术语

参考文献

规范性参考文献

[RFC2119]
S. Bradner. 用于在 RFC 中指示 要求级别的关键词。1997年3月。最佳当前实践。URL: https://datatracker.ietf.org/doc/html/rfc2119
[WEBCODECS]
Paul Adenot; Eugene Zemtsov. WebCodecs。2026年5月5日。WD。URL: https://www.w3.org/TR/webcodecs/

非规范性参考文献

[OGG-FRAMING]
Ogg 逻辑比特流成帧。URL: https://xiph.org/vorbis/doc/framing.html
[VORBIS]
Vorbis I 规范。2020年7月4日。URL: https://xiph.org/vorbis/doc/Vorbis_I_spec.html
[WEBCODECS-CODEC-REGISTRY]
Paul Adenot; Eugene Zemtsov. WebCodecs 编解码器 注册表。2026年2月12日。DRY。URL: https://www.w3.org/TR/webcodecs-codec-registry/