MediaSource.duration

Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

MediaSource 接口的属性 duration 用来获取或者设置当前媒体展示的时长。

以秒为单位的双精度浮点数。

异常

设置新的值的时候可能会有下面的错误抛出。

InvalidAccessError DOMException

时长尝试设置一个负数,或者为 NaN 则抛出。

InvalidStateError DOMException

MediaSource.readyState 的状态不是 open,或者有一个或多个在 MediaSource.sourceBuffers 中的 SourceBuffer 对象被更新(例如它们的 SourceBuffer.updating 属性是 true),则抛出该错误。

示例

以下片段基于 Nick Desaulniers 编写的一个简单示例(查看完整的在线演示,或者下载源代码进行进一步研究)。

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

// …

规范

Specification
Media Source Extensions™
# dom-mediasource-duration

浏览器兼容性

BCD tables only load in the browser

参见