Copyright © 2024 World Wide Web Consortium . W3C ® liability , trademark and permissive document license rules apply.
This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
The working group maintains a list of all bug reports that the editors have not yet tried to address ; there may also be related open bugs in the GitHub repository of the Media Source Extensions™ specification.
This document was published by the Media Working Group as an Editor's Draft.
Publication as an Editor's Draft does not imply endorsement by W3C and its Members.
This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
This document was produced by a group operating under the W3C Patent Policy . W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy .
This document is governed by the 03 November 2023 W3C Process Document .
This specification describes a byte stream format based on the WebM container format [ WEBM ].
It defines the MIME-type parameters used to signal codecs, and provides the necessary format specific definitions for initialization segments , media segments , and random access points required by the Byte Stream Formats section of the Media Source Extensions™ specification.
This
section
specifies
the
parameters
that
can
be
used
in
the
MIME-type
passed
to
isTypeSupported
()
or
addSourceBuffer
()
.
| Codec ID | Valid with "audio/webm" | Valid with "video/webm" |
|---|---|---|
| vorbis | true | true |
| opus | true | true |
| vp8 | false | true |
| vp9 | false | true |
| vp09... as described in the VP Codec ISO Media File Format Binding document [ VP09CODECSPARAMETERSTRING ] | false | true |
Examples of valid MIME-types with a codecs parameter.
A WebM initialization segment MUST contain a subset of the elements at the start of a typical WebM file.
The user agent MUST run the append error algorithm if any of the following conditions are not met:
The user agent MUST accept and ignore any elements other than an EBML Header or a Cluster that occur before, in between, or after the Segment Information and Track elements.
The
user
agent
MUST
source
attribute
values
for
id
,
kind
,
label
and
language
for
AudioTrack
,
VideoTrack
and
TextTrack
objects
as
described
for
WebM
in
the
in-band
tracks
spec
[
INBANDTRACKS
].
A WebM media segment is a single Cluster element.
The user agent uses the following rules when interpreting content in a Cluster :
The user agent MUST run the append error algorithm if any of the following conditions are not met:
The user agent MUST accept and ignore Cues or Chapters elements that follow a Cluster element.
Either a SimpleBlock element with its Keyframe flag set, or a BlockGroup element having no ReferenceBlock elements, signals the location of a random access point for that track. The order of multiplexed blocks within a media segment MUST conform to the WebM Muxer Guidelines .
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.
The key words MAY , MUST , and SHOULD in this document are to be interpreted as described in BCP 14 [ RFC2119 ] [ RFC8174 ] when, and only when, they appear in all capitals, as shown here.