SourceBufferList

可用性有限

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

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

SourceBufferList 接口代表一个简单的容器列表,用于存放多个 SourceBuffer 对象。

包含已添加到特定 MediaSourceSourceBuffer 的源缓冲区列表可以通过 MediaSource.sourceBuffers 属性检索。

可以使用 方括号表示法 [] 访问单个源缓冲区。

EventTarget SourceBufferList

实例属性

SourceBufferList.length 只读

返回列表中 SourceBuffer 对象的数量。

实例方法

继承其父接口 EventTarget 的方法。

事件

addsourcebuffer

当一个 SourceBuffer 添加到列表时触发。

removesourcebuffer

当一个 SourceBuffer 从列表移除时触发。

示例

此示例展示了如何访问与正在播放的 HTMLVideoElement 连接的 MediaSource 的活动源缓冲区。

js
// Video is an already playing video using a MediaSource srcObject
const video = document.querySelector("video");
const mediaSource = video.srcObject;
const sourceBufferList = mediaSource.activeSourceBuffers;
for (const sourceBuffer of sourceBufferList) {
  // Do something with each SourceBuffer, such as call abort()
  sourceBuffer.abort();
}

规范

规范
Media Source Extensions™
# sourcebufferlist

浏览器兼容性

另见