MediaTrackSupportedConstraints

MediaTrackSupportedConstraints 字典建立了用户代理或浏览器在其 用户代理 或浏览器中实现 MediaStreamTrack 对象时识别的可约束属性列表。符合 MediaTrackSupportedConstraints 的对象由 MediaDevices.getSupportedConstraints() 返回。

由于 WebIDL 中接口定义的方式,如果请求了约束但不受支持,则不会发生错误。相反,将应用指定的约束,并将所有无法识别的约束从请求中删除。这会导致令人困惑且难以调试的错误,因此请务必在尝试建立约束之前使用 getSupportedConstraints() 获取此信息,如果您需要知道静默忽略约束和接受约束之间的区别。

实际约束集使用基于 MediaTrackConstraints 字典的对象来描述。

要了解有关约束工作原理的更多信息,请参阅 功能、约束和设置

实例属性

对象上将存在以下属性的某些组合(但不一定是全部)。

autoGainControl

一个布尔值,如果当前环境支持 autoGainControl 约束,则其值为 true

width

一个布尔值,如果当前环境支持 width 约束,则其值为 true

height

一个布尔值,如果当前环境支持 height 约束,则其值为 true

aspectRatio

一个布尔值,如果当前环境支持 aspectRatio 约束,则其值为 true

frameRate

一个布尔值,如果当前环境支持 frameRate 约束,则其值为 true

facingMode

一个布尔值,如果当前环境支持 facingMode 约束,则其值为 true

resizeMode

一个布尔值,如果当前环境支持 resizeMode 约束,则其值为 true

volume 已弃用 非标准

一个布尔值,如果当前环境支持 volume 约束,则其值为 true

sampleRate

一个布尔值,如果当前环境支持 sampleRate 约束,则其值为 true

sampleSize

一个布尔值,如果当前环境支持 sampleSize 约束,则其值为 true

echoCancellation

一个布尔值,如果当前环境支持 echoCancellation 约束,则其值为 true

latency

一个布尔值,如果当前环境支持 latency 约束,则其值为 true

noiseSuppression

一个布尔值,如果当前环境支持 noiseSuppression 约束,则其值为 true

channelCount

一个布尔值,如果当前环境支持 channelCount 约束,则其值为 true

deviceId

一个布尔值,如果当前环境支持 deviceId 约束,则其值为 true

groupId

一个布尔值,如果当前环境支持 groupId 约束,则其值为 true

特定于共享屏幕轨道的实例属性

对于包含来自用户屏幕内容的视频源的轨道,除了视频轨道可用的属性外,还可能包含以下附加属性。

displaySurface

一个布尔值,如果当前环境支持 displaySurface 约束,则其值为 true

logicalSurface

一个布尔值,如果当前环境支持 logicalSurface 约束,则其值为 true

另请参阅