From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/mediastreamtrack/index.html | 181 ++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 files/zh-cn/web/api/mediastreamtrack/index.html (limited to 'files/zh-cn/web/api/mediastreamtrack/index.html') diff --git a/files/zh-cn/web/api/mediastreamtrack/index.html b/files/zh-cn/web/api/mediastreamtrack/index.html new file mode 100644 index 0000000000..28db2b0b25 --- /dev/null +++ b/files/zh-cn/web/api/mediastreamtrack/index.html @@ -0,0 +1,181 @@ +--- +title: MediaStreamTrack +slug: Web/API/MediaStreamTrack +translation_of: Web/API/MediaStreamTrack +--- +
{{APIRef("WebRTC")}}
+ +

摘要

+ +

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

+ +

属性

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

事件处理

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

方法

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

技术规范

+ + + + + + + + + + + + + + +
规范状态说明
{{SpecName('Media Capture', '#mediastreamtrack', 'MediaStreamTrack')}}{{Spec2('Media Capture')}}Initial definition
+ +

浏览器支持情况

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatUnknown}}
stop(){{CompatUnknown}}{{CompatGeckoDesktop(34)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
muted, onmuted, onunmuted, readonly, readyState, remote, onstarted, onended, onoverconstrained, appendConstraint(), applyConstraints(), constraints(), getConstraints(){{CompatUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatUnknown}}
+ + + + + + +
stop()
+ 		{{CompatUnknown}}{{CompatGeckoDesktop(34)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
muted, onmuted, onunmuted, readonly, readyState, remote, onstarted, onended, onoverconstrained, appendConstraint(), applyConstraints(), constraints(), getConstraints(){{CompatUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatUnknown}}
+
+ +

相关内容

+ + -- cgit v1.2.3-54-g00ecf