MediaStreamTrack:getCapabilities() 方法

getCapabilities() 方法是 MediaStreamTrack 接口的方法,它返回一个 MediaTrackCapabilities 对象,该对象指定每个可约束属性的值或值的范围,这些值基于平台和 用户代理

一旦您知道了浏览器的功能,您的脚本就可以使用 applyConstraints() 来请求将轨道配置为匹配理想或可接受的设置。有关如何使用可约束属性的详细信息,请参阅 功能、约束和设置

语法

js
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 的浏览器中加载。

另请参阅