MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

摘要

MediaStreamTrack接口在User Agent中表示一段媒体源,比如音轨或视频。

属性

MediaStreamTrack.enabled
布尔值,为true时表示轨道有效,并且可以被渲染。为false时表示轨道失效,只能被渲染为静音或黑屏。如果该轨道连接中断,该值还是可以被改变但不会有任何效果了。
MediaStreamTrack.id 只读
返回一个由浏览器产生的DOMString类型的GUID值,作为这个轨道的唯一标识值。
MediaStreamTrack.kind 只读
返回一个DOMString类型的值。如果为“audio”表示轨道为音频轨道,为“video”则为视频轨道。如果该轨道从它的源上分离,这个值也不会改变。
MediaStreamTrack.label 只读
返回一个DOMString类型。内容为一个用户代理指定的标签,来标识该轨道的来源,比如“internal microphone”。该字符串可以为空,并且在没有源与这个轨道连接的情况下会一直为空。当该轨道从它的源上分离时,这个值也不会改变。
MediaStreamTrack.muted 只读
返回一个布尔类型的值,为true时表示轨道是静音,其它为false。
MediaStreamTrack.readonly 只读
返回一个布尔类型的值,为true时表示该轨道是只读的,比如视频文件源或一个被设置为不能修改的摄像头源,或则为false。
MediaStreamTrack.readyState 只读
返回枚举类型的值,表示轨道的当前状态。该枚举值为以下中的一个:
  • "live"表示当前输入已经连接并且在尽力提供实时数据。在这种情况下,输出数据可以通过操作MediaStreamTrack.enabled属性进行开关。
  • “ended”表示这个输出连接没有更多的数据了,而且也不会提供更多的数据了。
MediaStreamTrack.remote 只读
返回布尔值类型,当为true时表示数据是通过RTCPeerConnection提供的,否则为false。

事件处理

MediaStreamTrack.onstarted
这是started事件在这个对象上被触发时调用的事件处理器EventHandler,这时一个新的MediaStreamTrack对象被添加到轨道源上。
MediaStreamTrack.onmute
这是mute事件在这个对象被触发时调用的事件处理器EventHandler,这时这个流被中断。
MediaStreamTrack.onunmute
这是unmute事件在这个对象上被触发时调用的事件处理器EventHandler,未实现。
MediaStreamTrack.onoverconstrained
这是overconstrained事件在这个对象上被触发时调用的事件处理器overconstrained,未实现。
MediaStreamTrack.oneended
这是ended事件在这个对象被触发时调用的事件处理器EventHandler,未实现。

方法

MediaStreamTrack.getConstraints()
 
MediaStreamTrack.applyConstraints()
 
MediaStreamTrack.getSettings()
 
MediaStreamTrack.getCapabilities()
 
MediaStreamTrack.clone()
 
MediaStreamTrack.stop()
停止播放轨道对应的源,源与轨道将脱离关联,同时轨道状态将设为“ended”。

技术规范

规范 状态 说明
Media Capture and Streams
MediaStreamTrack
Editor's Draft Initial definition

浏览器支持情况

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) 未实现 未实现 ?
stop() ? 34 (34) ? ? ?
muted, onmuted, onunmuted, readonly, readyState, remote, onstarted, onended, onoverconstrained, appendConstraint(), applyConstraints(), constraints(), getConstraints() ? 未实现 未实现 未实现 ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? (Yes) 未实现 未实现 ?
stop()
? 34 (34) ? ? ?
muted, onmuted, onunmuted, readonly, readyState, remote, onstarted, onended, onoverconstrained, appendConstraint(), applyConstraints(), constraints(), getConstraints() ? 未实现 未实现 未实现 ?

相关内容

文档标签和贡献者

 此页面的贡献者: horsefaced, Wunmest
 最后编辑者: horsefaced,