MP3 WebCodecs 注册

W3C 小组说明草案,

关于本文档的更多详细信息
此版本:
https://www.w3.org/TR/2026/DNOTE-webcodecs-mp3-codec-registration-20260924/
最新发布版本:
https://www.w3.org/TR/webcodecs-mp3-codec-registration/
编辑草案:
https://w3c.github.io/webcodecs/mp3_codec_registration.html
先前版本:
历史:
https://www.w3.org/standards/history/webcodecs-mp3-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] 中。 它描述了 MP3 的:(1) 完全限定的 编解码器字符串、(2) AudioDecoderConfig.description 字节、 (3) 特定于编解码器的 EncodedAudioChunk [[internal data]] 字节,以及 (4) EncodedAudioChunk [[type]] 的值。

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

此注册是非规范性的。

本文档状态

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

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

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

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

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

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

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

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

此编解码器具有多个等效的 编解码器 字符串:

2. EncodedAudioChunk 数据

EncodedAudioChunk [[internal data]] 应为 一个“帧”,如 [MP3] 规范的第 2.4.2.2 节中所述。

3. AudioDecoderConfig 描述

description 不用于此编解码器。

sampleRate 和 numberOfChannels 成员会被忽略。

4. EncodedAudioChunk 类型

包含 mp3 的 EncodedAudioChunk 的 [[type]] 始终为“key”。

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

5. 预填充样本

AudioDecoder 的 [[priming samples to discard]] 内部槽位 在配置时被初始化为 0。

如果配置或重置后的初始 EncodedAudioChunk 包含 指定编码器延迟的 Info 或 Xing 头帧, 则 [[priming samples to discard]] 被设置为相应数量的 预填充样本。

如果后续的 EncodedAudioChunk 包含 Info 或 Xing 头帧(例如 在串联的 MP3 流或互联网广播中),则它不得更新 [[priming samples to discard]]。 在活动的解码会话期间,[[priming samples to discard]] 仅会在调用 reset() 或 configure() 后重新初始化。

6. 隐私注意事项

请参阅 隐私 注意事项一节,见 [WEBCODECS]。

7. 安全注意事项

请参阅 安全 注意事项一节,见 [WEBCODECS]。

一致性

文档 约定

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

除明确标记为非规范性的章节、示例和注释外,本规范的所有文本均为规范性内容。[RFC2119]

本规范中的示例以“例如”等词语引入, 或通过 class="example" 与规范性文本区分开来, 如下所示:

这是一个资料性示例的例子。

资料性注释以“注”一词开头, 并通过 class="note" 与规范性文本区分开来, 如下所示:

注,这是一个资料性注释。

索引

通过引用定义的 术语

参考文献

规范性参考文献

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

非规范性参考文献

[MP3]
ISO/IEC 13818-3:1998 - 信息技术 — 运动图像及其伴音信息的通用编码 — 第 3 部分:音频。 1998-04。URL:https://www.iso.org/standard/26797.html
[WEBCODECS-CODEC-REGISTRY]
Paul Adenot; Eugene Zemtsov. WebCodecs 编解码器 注册表。2026 年 2 月 12 日。DRY。URL:https://www.w3.org/TR/webcodecs-codec-registry/