MediaStreamTrack:getCapabilities() 方法
getCapabilities()
方法是 MediaStreamTrack
接口的方法,它返回一个 MediaTrackCapabilities
对象,该对象指定每个可约束属性的值或值的范围,这些值基于平台和 用户代理。
一旦您知道了浏览器的功能,您的脚本就可以使用 applyConstraints()
来请求将轨道配置为匹配理想或可接受的设置。有关如何使用可约束属性的详细信息,请参阅 功能、约束和设置。
语法
getCapabilities()
参数
无。
返回值
一个 MediaTrackCapabilities
对象,它指定用户代理支持的每个可约束属性支持的值或值的范围,包含以下成员
deviceId
-
一个包含设备 ID 的
ConstrainDOMString
对象。 groupId
-
一个包含组 ID 的
ConstrainDOMString
对象。 autoGainControl
-
一个
ConstrainBoolean
对象,报告源是否可以进行自动增益控制。如果该功能可以由脚本控制,则源将报告 true 和 false 作为可能的值。 channelCount
-
一个包含通道数或通道数范围的
ConstrainULong
。 echoCancellation
-
一个
ConstrainBoolean
对象,报告源是否可以进行回声消除。如果该功能可以由脚本控制,则源将报告 true 和 false 作为可能的值。 latency
-
一个包含延迟或延迟范围的
ConstrainDouble
。 noiseSuppression
-
一个
ConstrainBoolean
对象,报告源是否可以进行降噪。如果该功能可以由脚本控制,则源将报告 true 和 false 作为可能的值。 sampleRate
-
一个包含采样率或采样率范围的
ConstrainULong
。 sampleSize
-
一个包含样本大小或样本大小范围的
ConstrainULong
。 aspectRatio
-
一个包含视频 纵横比(以像素为单位的宽度除以以像素为单位的高度)或纵横比范围的
ConstrainDouble
。 facingMode
-
一个包含摄像头朝向模式的
ConstrainDOMString
对象。摄像头可能会报告多个朝向,例如“left”和“user”。 frameRate
-
一个包含帧率或可接受的帧率范围的
ConstrainDouble
。 height
-
一个包含视频高度或以像素为单位的高度范围的
ConstrainULong
。 width
-
一个包含视频宽度或以像素为单位的宽度范围的
ConstrainULong
。 resizeMode
-
一个包含 UA 可用于推导出视频轨道分辨率的模式或模式数组的
ConstrainDOMString
对象。
规范
规范 |
---|
媒体捕获和流 # dom-mediastreamtrack-getcapabilities |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
另请参阅
InputDeviceInfo.getCapabilities()
,它也返回一个MediaTrackCapabilities
对象。