MediaSource: endOfStream() 方法

endOfStream() 方法是 MediaSource 接口的方法，用于表示流的结束。

语法

js
endOfStream()
endOfStream(endOfStreamError)

参数

endOfStreamError 可选

表示在流结束时抛出的错误的字符串。可能的值包括：

network

终止播放并表示发生了网络错误。这可以用于创建与媒体流相关的自定义错误处理程序。例如，您可能有一个处理媒体块请求的函数，它与其他网络请求分开。当您向媒体块发出 fetch() 请求并收到网络错误时，您可能希望调用 endOfStream('network')，在 UI 中显示描述性消息，并可能立即重试网络请求或等到网络恢复（通过某种轮询方式）。

decode

终止播放并表示发生了解码错误。这可以用来表示在获取媒体数据时发生了解析错误；也许数据已损坏，或者使用浏览器无法解码的编解码器进行编码。

返回值

无 (undefined).

异常

InvalidStateError DOMException

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

示例

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

js
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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅