媒体流(MediaStream) - Web API 接口参考 编辑

属性

MediaStream.active 只读

布尔型。如果这个流处于活动状态值为true，反之为false

MediaStream.ended 只读

布尔型。如果 ended 事件在这个对象上触发了，也就是说这个流已经被完全读取，值为true。 如果还没有到达这个流的尾部，值为false。

MediaStream.id 只读

这是一个包含36个字符的 DOMString ，用来作为这个对象的唯一标识符 (GUID) 。

事件处理

MediaStream.onaddtrack

这是addtrack事件在这个对象上触发时调用的事件处理器[EventHandler]，这时一个MediaStreamTrack对象被添加到这个流。

MediaStream.onended

这是当流终止[ended]时触发的事件。

MediaStream.onremovetrack

这是removetrack事件在这个对象上触发事调用的事件处理器[EventHandler]，这时一个对象从流上移除。

方法

MediaStream.addTrack()

存储传入参数 MediaStreamTrack 的一个副本。如果这个轨道已经被添加到了这个媒体流，什么也不会发生; 如果目标轨道为“完成”状态（也就是已经到尾部了），一个INVALID_STATE_RAISE异常会产生。

MediaStream.clone()

返回这个MediaStream对象的克隆版本。返回的版本会有一个新的ID。

返回给定ID的轨道。如果没有参数或者没有指定ID的轨道，将返回null。如果有几个轨道有同一个ID，将返回第一个。

MediaStream.getTracks()

返回流中所有的MediaStreamTrack列表。

MediaStream.getAudioTracks()

返回流中kind属性为"audio"的MediaStreamTrack列表。顺序是不确定的，不同浏览器间会有不同，每次调用也有可能不同。

MediaStream.getTrackById()

返回给定ID的轨道。如果没有参数或者没有指定ID的轨道，将返回null。如果有几个轨道有同一个ID，将返回第一个。

MediaStream.getVideoTracks()

返回流中kind属性为"video"的MediaStreamTrack列表。顺序是不确定的，不同浏览器间会有不同，每次调用也有可能不同。

MediaStream.removeTrack()

移除作为参数传入的 MediaStreamTrack。 如果这个轨道不在MediaStream对象中什么也不会发生； 如果目标轨道为“完成”状态，一个INVALID_STATE_RAISE异常会产生。

说明

浏览器支持情况

BCD tables only load in the browser

相关内容

• Using the MediaStream API