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
。