Media Source Extension官方文档(第二部分)

2. MediaSource Object

MediaSource对象表示HTMLMediaElement元素的一个媒体数据源。它会记录源的readyState和一个可以添加媒体数据去展示的SourceBuffer对象的列表。MediaSource对象由web应用创建然后绑定到HTMLMediaElement元素上。web应用通过添加SourceBuffer对象给sourceBuffers属性从而添加媒体数据到source中。当需要播放的时候,HTMLMediaElement从MediaSource对象中读取媒体数据。

每个MediaSource对象都由一个实时的可检索的range变量来存储归一化后的TimeRanges对象。当MediaSource对象创建的时候这个变量初始化为一个空的TimeRanges对象,通过setLiveSeekableRange() 和 clearLiveSeekableRange()方法来维护,然后通过HTMLMediaElement Extensions 来更改HTMLMediaElement.seekable属性。
ReadyState

状态值描述
closed表示source还没有绑定到media元素上
opensource被media元素打开并且有可用的SourceBuffer对象在sourceBuffers中
endedsource还被绑定在media元素上,但是endOfStream() 执行过了

构造函数

[Constructor]
interface MediaSource : EventTarget {
    readonly attribute SourceBufferList    sourceBuffers;
    readonly attribute SourceBufferList    activeSourceBuffers;
    readonly attribute ReadyState          readyState;
             attribute unrestricted double duration;
             attribute EventHandler        onsourceopen;
             attribute EventHandler        onsourceended;
             attribute EventHandler        onsourceclose;
    SourceBuffer addSourceBuffer(DOMString type);
    void         removeSourceBuffer(SourceBuffer sourceBuffer);
    void         endOfStream(optional EndOfStreamError error);
    void         setLiveSeekableRange(double start, double end);
    void         clearLiveSeekableRange();
    static boolean isTypeSupported(DOMString type);
};

2.1 属性值

sourceBuffers 类型:SourceBufferList,只读
MediaSource相关的SourceBuffer列表,当readyState==”closed”的时候总是空的,一旦readyState变为”open”状态时,就可以通过 addSourceBuffer()方法添加SourceBuffer对象到列表中

activeSourceBuffers 类型:SourceBufferList,只读

sourceBuffers中selected video track, the enabled audio track(s), and the “showing” or “hidden” text track(s)的一个子集。

readyState 类型:ReadyState,只读
MediaSource对象的当前状态,刚创建的时候一定是‘closed’。

duration 类型:unrestricted double
MediaSource刚创建的时候,初始化值为NaN。
如何获取?

  1. 如果readyState为closed,则返回NaN,这一步可以丢弃
  2. 返回该属性当前值
    如何设置?
  3. 如果设置了负值或者NaN,会抛出TypeError异常,并丢弃剩余步骤
  4. 如果readyState不是open,会抛出InvalidStateError异常,并丢弃剩余步骤
  5. sourceBuffers属性中的任何一个SourceBuffer的updating值为true, ,会抛出InvalidStateError异常,并丢弃剩余步骤
  6. 运行duration change algorithm算法可以设置新的duration给当前属性

Note
如果当前有更高end time的缓冲帧,duration change algorithm会调整新的更大的duration。
appendBuffer()和 endOfStream()方法会更新duration在特定的情况下。

onsourceopen 类型:EventHandler
sourceopen事件的处理回调

onsourceended 类型:EventHandler
sourceended事件的处理回调

onsourceclose 类型:EventHandler
sourceclose事件的处理回调

2.2 方法

addSourceBuffer
入参:type, 返回SourceBuffer对象,调用如:

sourceBuffer = ms.addSourceBuffer('video/mp4; codecs="avc1.4d401f"');

添加一个新的SourceBuffer对象到sourceBuffers属性,接下来ua需要执行:

  1. 如果type为空字符串(”),则抛出TypeError异常,并丢弃剩余步骤
  2. 如果type为不支持的MIME类型,则抛出 NotSupportedError异常,并丢弃剩余步骤
  3. 如果ua不能处理更多的SourceBuffer内容,则抛出QuotaExceededError异常,并丢弃剩余步骤

比如当媒体元素到了HAVE_METADATA状态的时候,ua就不支持播放中更多track的添加了

  1. 如果readyState不是open,则抛出InvalidStateError异常,并丢弃剩余步骤
  2. 常见一个新的SourceBuffer对象和相关资源
  3. 设置新对象的generate timestamps flag为相关类型的[MSE-REGISTRY] entry
  4. 如果generate timestamps flag值为true,设置新对象的mode属性为“sequence”,否则设置为“segments”
  5. 把新对象添加到sourceBuffers中,并且触发一个addsourcebuffer事件
  6. 返回这个新对象

removeSourceBuffer

endOfStream
入参:error(EndOfStreamError),无返回值

  • setLiveSeekableRange*
    更新 HTMLMediaElement Extensions元素的live seekable range变量
  • clearLiveSeekableRange*
  • isTypeSupported* static
    检测MediaSource对象是否支持创建特定MIME类型的SourceBuffer

只代表浏览器是否支持的能力,不代表addSourceBuffer()方法有足够的资源创建新的SourceBuffer

2.3 事件

事件名称描述
sourceopenreadyState 从close到open 或 从ended到open
sourceendedreadyState 从open到ended
sourceclosereadyState 从open到closed 或 从open到ended

2.4 算法(待补充)

    原文作者:九瑶
    原文地址: https://segmentfault.com/a/1190000011266646
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞