forked from w3c/webcodecs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
mp3_codec_registration.src.html
102 lines (81 loc) · 4.17 KB
/
mp3_codec_registration.src.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
<pre class='metadata'>
Title: MP3 WebCodecs Registration
Repository: w3c/webcodecs
Status: NOTE-ED
Shortname: webcodecs-mp3-codec-registration
Level: none
Group: mediawg
ED: https://w3c.github.io/webcodecs/mp3_codec_registration.html
TR: https://www.w3.org/TR/webcodecs-mp3-codec-registration/
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/
Abstract: This registration is entered into the [[webcodecs-codec-registry]].
It describes, for MP3, the (1) fully qualified codec strings, (2)
the {{AudioDecoderConfig.description}} bytes, (3) the codec-specific
{{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] bytes, and (4)
the values of {{EncodedAudioChunk}} [=EncodedAudioChunk/[[type]]=].
The registration is not intended to include any information on whether a
codec format is encumbered by intellectual property claims. Implementers and
authors 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 the MP3 codec.
This registration 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: AudioDecoderConfig.sampleRate; url: dom-audiodecoderconfig-samplerate
text: AudioDecoderConfig.numberOfChannels; url: dom-audiodecoderconfig-numberofchannels
type: dfn
for: EncodedAudioChunkType; text: key; url: dom-encodedaudiochunktype-key
for: EncodedAudioChunk; text: [[internal data]]; url: dom-encodedaudiochunk-internal-data-slot
for: EncodedAudioChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot
type: interface
text: EncodedAudioChunk; url: encodedaudiochunk
type: dictionary
text: AudioDecoderConfig; url: dictdef-audiodecoderconfig
</pre>
<pre class='biblio'>
{
"MP3": {
"href": "https://www.iso.org/standard/26797.html",
"title": "ISO/IEC 13818-3:1998 - Information technology — Generic coding of moving pictures and associated audio information — Part 3: Audio",
"publisher": "ISO",
"date": "1998-04"
}
}
</pre>
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================
This codec has multiple equivalent codec strings:
- `"mp3"`
- `"mp4a.69"`
- `"mp4a.6B"`
- `"mp4a.69"`
EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
{{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] is expected to be
a "frame", as described in the section 2.4.2.2 of the [[MP3]] specification.
AudioDecoderConfig description {#audiodecoderconfig-description}
================================================================
{{AudioDecoderConfig.description}} is not used for this codec.
The {{AudioDecoderConfig.sampleRate}} and {{AudioDecoderConfig.numberOfChannels}}
members are ignored.
EncodedAudioChunk type {#encodedaudiochunk-type}
================================================
The [=EncodedAudioChunk/[[type]]=] for an {{EncodedAudioChunk}} containing
mp3 is always "[=EncodedAudioChunkType/key=]".
NOTE: Once the initialization has succeeded, any mp3 packet can be decoded at
any time without error, but this might not result in the expected audio
output.
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]].