Media Source Extensionswindow_and_dedicated
The ManagedMediaSource interface of the Media Source Extensions API is a MediaSource that actively manages its memory content. Unlike a regular MediaSource, the user agent can evict content from its ManagedSourceBuffer objects at any time, for reasons such as memory or hardware limitations. This makes it suitable for power-efficient streaming scenarios where the user agent needs more control over buffered media data.
When MediaSource.addSourceBuffer is called on a ManagedMediaSource, it creates ManagedSourceBuffer objects (instead of SourceBuffer objects), which fire ManagedSourceBuffer.bufferedchange_event events to notify the application when buffered ranges are modified by the user agent.
[!NOTE] On Safari,
ManagedMediaSourceonly activates when remote playback is explicitly disabled on the media element (by setting HTMLMediaElement.disableRemotePlayback totrue), or when an AirPlay source alternative is provided (for example, an HLS source element). Without either of these, the MediaSource.sourceopen_event event will not fire.
Constructor
- ManagedMediaSource.ManagedMediaSource
- : Creates and returns a new
ManagedMediaSourceobject instance with no associated source buffers.
- : Creates and returns a new
Instance properties
Also inherits properties from its parent interface, MediaSource.
- ManagedMediaSource.streaming
- : A boolean indicating whether the
ManagedMediaSourceobject is currently streaming. Whentrue, the application should actively fetch and append media data. Whenfalse, the application can stop fetching new data.
- : A boolean indicating whether the
Instance methods
Inherits methods from its parent interface, MediaSource.
Events
Also inherits events from its parent interface, MediaSource.
- ManagedMediaSource.startstreaming_event
- : Fired when the
ManagedMediaSource's ManagedMediaSource.streaming property changes fromfalsetotrue, meaning the media source has started streaming.
- : Fired when the
- ManagedMediaSource.endstreaming_event
- : Fired when the
ManagedMediaSource's ManagedMediaSource.streaming property changes fromtruetofalse, meaning the media source has stopped streaming.
- : Fired when the
Examples
Setting up a managed media source
The following example sets up a ManagedMediaSource, connects it to a video element, and listens for the ManagedMediaSource.startstreaming_event and ManagedMediaSource.endstreaming_event events to control when media data is fetched. ManagedSourceBuffer.bufferedchange_event events are logged below the video.
const videoUrl =
"https://mdn.github.io/shared-assets/videos/flower-fragmented.mp4";
const mediaType = 'video/mp4; codecs="avc1.64001F, mp4a.40.2"';
const video = document.querySelector("video");
if (!window.ManagedMediaSource?.isTypeSupported(mediaType)) {
console.log("ManagedMediaSource is not supported in this browser.");
} else {
const source = new ManagedMediaSource();
video.disableRemotePlayback = true;
video.src = URL.createObjectURL(source);
source.addEventListener("sourceopen", () => {
const sourceBuffer = source.addSourceBuffer(mediaType);
sourceBuffer.addEventListener("bufferedchange", (event) => {
for (let i = 0; i < event.addedRanges.length; i++) {
console.log(
`Buffered: ${event.addedRanges.start(i).toFixed(2)}s – ${event.addedRanges.end(i).toFixed(2)}s`,
);
}
});
source.addEventListener("startstreaming", async () => {
console.log("startstreaming — fetching media data…");
const response = await fetch(videoUrl);
const data = await response.arrayBuffer();
sourceBuffer.appendBuffer(data);
});
source.addEventListener("endstreaming", () => {
console.log("endstreaming — enough data buffered");
});
});
}
dom-examples/media-source-extensions/managed-media-source/
Specifications
Browser compatibility
See also
- MediaSource
- ManagedSourceBuffer
- BufferedChangeEvent
- SourceBuffer
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
