SourceBuffer: changeType() method
The changeType()
method of the
SourceBuffer
interface sets the MIME type that future calls to
appendBuffer()
should expect the new media
data to conform to. This makes it possible to change codecs or container type
mid-stream.
One scenario in which this is helpful is to support adapting the media source to changing bandwidth availability, by transitioning from one codec to another as resource constraints change.
Syntax
js
changeType(type)
Parameters
type
-
A string specifying the MIME type that future buffers will conform to.
Return value
None (undefined
).
Exceptions
TypeError
-
Thrown if the specified string is empty, rather than indicating a valid MIME type.
InvalidStateError
DOMException
-
Thrown if the
SourceBuffer
is not a member of the parent media source'ssourceBuffers
list, or the buffer'supdating
property indicates that a previously queuedappendBuffer()
orremove()
is still being processed. NotSupportedError
DOMException
-
Thrown if the specified MIME type is not supported, or is not supported with the types of
SourceBuffer
objects present in theMediaSource.sourceBuffers
list.
Usage notes
If the readyState
property of the parent MediaSource
is set to "ended"
, calling changeType()
will set the readyState
property to"open"
and
fire a simple event named sourceopen
at the parent media source.
Browser compatibility
BCD tables only load in the browser