在此页

• 特性
• 浏览器兼容性
• 另请参阅
• 相关话题

MediaTrackSupportedConstraints dictionary establishes the list of constrainable properties recognized by the 用户代理 or browser in its implementation of the MediaStreamTrack object. An object conforming to MediaTrackSupportedConstraints 的返回是通过 MediaDevices.getSupportedConstraints() .

Because of the way interface definitions in WebIDL work, if a constraint is requested but not supported, no error will occur. Instead, the specified constraints will be applied, with any unrecognized constraints stripped from the request.That can lead to confusing and hard to debug errors, so be sure to use getSupportedConstraints() to retrieve this information before attempting to establish constraints if you need to know the difference between silently ignoring a constraint and a constraint being accepted.

An actual constraint set is described using an object based on the MediaTrackConstraints 字典。

To learn more about how constraints work, see Capabilities, constraints, and settings .

特性

Some combination—but not necessarily all—of the following properties will exist on the object.

autoGainControl

A Boolean whose value is true 若 autoGainControl constraint is supported in the current environment.

width

A Boolean value whose value is true 若 width constraint is supported in the current environment.

height

A Boolean value whose value is true 若 height constraint is supported in the current environment.

aspectRatio

A Boolean value whose value is true 若 aspectRatio constraint is supported in the current environment.

frameRate

A Boolean value whose value is true 若 frameRate constraint is supported in the current environment.

facingMode

A Boolean value whose value is true 若 facingMode constraint is supported in the current environment.

resizeMode

A Boolean value whose value is true 若 resizeMode constraint is supported in the current environment.

volume

A Boolean value whose value is true 若 volume constraint is supported in the current environment.

sampleRate

A Boolean value whose value is true 若 sampleRate constraint is supported in the current environment.

sampleSize

A Boolean value whose value is true 若 sampleSize constraint is supported in the current environment.

echoCancellation

A Boolean value whose value is true 若 echoCancellation constraint is supported in the current environment.

latency

A Boolean value whose value is true 若 latency constraint is supported in the current environment.

noiseSuppression

A Boolean whose value is true 若 noiseSuppression constraint is supported in the current environment.

channelCount

A Boolean value whose value is true 若 channelCount constraint is supported in the current environment.

deviceId

A Boolean value whose value is true 若 deviceId constraint is supported in the current environment.

groupId

A Boolean value whose value is true 若 groupId constraint is supported in the current environment.

Properties specific to shared screen tracks

For tracks containing video sources from the user's screen contents, the following additional properties are may be included in addition to those available for video tracks.

cursor

A Boolean value which is true 若 cursor constraint is supported in the current environment.

displaySurface

A Boolean value which is true 若 cursor constraint is supported in the current environment.

logicalSurface

A Boolean value which is true 若 logicalSurface constraint is supported in the current environment.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
MediaTrackSupportedConstraints	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
aspectRatio	Chrome 52	Edge ≤79	Firefox No	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
autoGainControl	Chrome 69	Edge ≤79	Firefox 55 55 不支持 ? — 55 Prefixed Prefixed Implemented with the vendor prefix: moz	IE ?	Opera Yes	Safari ?	WebView Android 69	Chrome Android 69	Firefox Android 55 55 不支持 ? — 55 Prefixed Prefixed Implemented with the vendor prefix: moz	Opera Android Yes	Safari iOS ?	Samsung Internet Android 10.0
channelCount	Chrome 52	Edge ≤79	Firefox 56	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 56	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
cursor	Chrome No	Edge No	Firefox No	IE No	Opera Yes	Safari ?	WebView Android No	Chrome Android No	Firefox Android No	Opera Android ?	Safari iOS ?	Samsung Internet Android No
deviceId	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
displaySurface	Chrome No	Edge No	Firefox No	IE No	Opera Yes	Safari ?	WebView Android No	Chrome Android No	Firefox Android No	Opera Android ?	Safari iOS ?	Samsung Internet Android No
echoCancellation	Chrome 52	Edge ≤79	Firefox 46	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 46	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
facingMode	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
frameRate	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
groupId	Chrome 52	Edge ≤79	Firefox 70	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
height	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
latency	Chrome 52	Edge ≤79	Firefox No	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
logicalSurface	Chrome No	Edge No	Firefox No	IE No	Opera Yes	Safari ?	WebView Android No	Chrome Android No	Firefox Android No	Opera Android ?	Safari iOS ?	Samsung Internet Android No
noiseSuppression	Chrome 69	Edge ≤79	Firefox 55 55 不支持 ? — 55 Prefixed Prefixed Implemented with the vendor prefix: moz	IE ?	Opera Yes	Safari ?	WebView Android 69	Chrome Android 69	Firefox Android 55 55 不支持 ? — 55 Prefixed Prefixed Implemented with the vendor prefix: moz	Opera Android Yes	Safari iOS ?	Samsung Internet Android 10.0
resizeMode	Chrome No	Edge No	Firefox No	IE ?	Opera No	Safari ?	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS ?	Samsung Internet Android No
sampleRate	Chrome 52	Edge ≤79	Firefox No	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
sampleSize	Chrome 52	Edge ≤79	Firefox No	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
volume 弃用 非标	Chrome 52	Edge ≤79	Firefox No	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android No	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
width	Chrome 52	Edge ≤79	Firefox 42	IE ?	Opera Yes	Safari ?	WebView Android 52	Chrome Android 52	Firefox Android 42	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

弃用。不要用于新网站。

弃用。不要用于新网站。

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

另请参阅

• Media Capture and Streams API
• Capabilities, constraints, and settings
• Screen Capture API
• Using the Screen Capture API
• MediaTrackConstraints
• MediaDevices.getUserMedia()
• MediaStreamTrack.getConstraints()
• MediaStreamTrack.applyConstraints()
• MediaStreamTrack.getSettings()

元数据

• 最后修改： 2019 年 3 月 23 日

相关话题

1. Media Streams API
2. MediaTrackSupportedConstraints
3. 特性

   1. aspectRatio
   2. autoGainControl
   3. channelCount
   4. cursor
   5. deviceId
   6. displaySurface
   7. echoCancellation
   8. facingMode
   9. frameRate
   10. groupId
   11. height
   12. latency
   13. noiseSuppression
   14. sampleRate
   15. sampleSize
   16. volume
4. Related pages for Media Capture and Streams

   1. AudioStreamTrack
   2. BlobEvent
   3. CanvasCaptureMediaStream
   4. ConstrainBoolean
   5. ConstrainDOMString
   6. ConstrainDouble
   7. ConstrainLong
   8. DoubleRange
   9. HTMLCanvasElement.captureStream()
   10. LongRange
   11. MediaDevices
   12. MediaStream
   13. MediaStreamTrack
   14. MediaStreamTrackEvent
   15. MediaTrackCapabilities
   16. MediaTrackConstraints
   17. MediaTrackSettings
   18. Navigator.mediaDevices
   19. NavigatorUserMedia
   20. NavigatorUserMediaError
   21. VideoStreamTrack
   22. navigator.mediaDevices.getUserMedia()