MediaSource：endOfStream() 方法

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

注意：此功能在专用 Web Workers 中可用。

MediaSource 接口的 endOfStream() 方法用于标识流的结束。

语法

endOfStream()
endOfStream(endOfStreamError)

参数

endOfStreamError 可选

当到达流的末尾时引发的错误的字符串表示。可能的值为：

network: 终止播放并指示发生了网络错误。这可用于创建与媒体流相关的自定义错误处理程序。例如，您可能有一个处理媒体块请求的函数，该函数独立于其他网络请求。当您使用 fetch() 请求媒体块并收到网络错误时，您可能希望调用 endOfStream('network')，在 UI 中显示描述性消息，甚至立即重试网络请求，或者等待网络恢复（通过某种轮询）。
decode: 终止播放并指示发生了解码错误。这可用于表明在获取媒体数据时发生了解析错误；可能是数据已损坏，或者使用了浏览器无法解码的编解码器进行编码。

返回值

无（undefined）。

异常

InvalidStateError DOMException: 如果 MediaSource.readyState 不等于 open，或者 MediaSource.sourceBuffers 中的一个或多个 SourceBuffer 对象正在更新（即，它们的 SourceBuffer.updating 属性为 true），则抛出此错误。

示例

以下代码段来自 Nick Desaulniers 编写的示例（在线查看完整演示，或下载源代码以供进一步研究）。函数 getMediaSource()（此处未定义）返回一个 MediaSource。

const assetURL = "frag_bunny.mp4";
// Need to be specific for Blink regarding codecs
// ./mp4info frag_bunny.mp4 | grep Codec
const mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';

let mediaSource;

if ("MediaSource" in window && MediaSource.isTypeSupported(mimeCodec)) {
  mediaSource = getMediaSource();
  console.log(mediaSource.readyState); // closed
  video.src = URL.createObjectURL(mediaSource);
  mediaSource.addEventListener("sourceopen", sourceOpen);
} else {
  console.error("Unsupported MIME type or codec: ", mimeCodec);
}

function sourceOpen() {
  console.log(this.readyState); // open
  const sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
  fetchAB(assetURL, (buf) => {
    sourceBuffer.addEventListener("updateend", () => {
      mediaSource.endOfStream();
      video.play();
      console.log(mediaSource.readyState); // ended
    });
    sourceBuffer.appendBuffer(buf);
  });
}

规范

规范
Media Source Extensions™ # dom-mediasource-endofstream

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025 年 6 月 23 日，由 MDN 贡献者进行。

在 GitHub 上查看此页面 • 报告此内容的麻烦