在此页

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

MediaStreamConstraints dictionary is used when calling getUserMedia() to specify what kinds of tracks should be included in the returned MediaStream , and, optionally, to establish constraints for those tracks' settings.

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.

Track constraints

audio

Either a Boolean (which indicates whether or not an audio track is requested) or a MediaTrackConstraints object providing the constraints which must be met by the audio track included in the returned MediaStream . If constraints are specified, an audio track is inherently requested.

视频

Either a Boolean (which indicates whether or not a video track is requested) or a MediaTrackConstraints object providing the constraints which must be met by the video track included in the returned MediaStream . If constraints are specified, a video track is inherently requested.

安全性

peerIdentity

DOMString identifying the peer who has sole access to the stream. If this property is specified, only the indicated peer can receive and use the stream. Streams isolated in this way can only be displayed in a media element ( <audio> or <video> ) where the content is protected just as if CORS cross-origin rules were in effect. When a peer identity is set, MediaStreamTrack s from that peer have their isolated flag set to true .

浏览器兼容性

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
MediaStreamConstraints	Chrome 53	Edge ≤79	Firefox 38	IE No	Opera Yes	Safari ?	WebView Android 53	Chrome Android 53	Firefox Android 38	Opera Android Yes	Safari iOS ?	Samsung Internet Android 6.0
audio	Chrome Yes	Edge ≤79	Firefox 38	IE No	Opera Yes	Safari ?	WebView Android Yes	Chrome Android Yes	Firefox Android 38	Opera Android Yes	Safari iOS ?	Samsung Internet Android Yes
视频	Chrome Yes	Edge ≤79	Firefox 38	IE No	Opera Yes	Safari ?	WebView Android Yes	Chrome Android Yes	Firefox Android 38	Opera Android Yes	Safari iOS ?	Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

另请参阅

• MediaDevices.getUserMedia()
• MediaStreamTrack.getConstraints()
• MediaStreamTrack.applyConstraints()
• MediaDevices.getSupportedConstraints()
• MediaTrackSupportedConstraints
• MediaStreamTrack.getSettings()

元数据

• 最后修改： Mar 18, 2019

相关话题

1. Media Streams API
2. MediaStreamConstraints
3. 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. MediaTrackSupportedConstraints
   19. Navigator.mediaDevices
   20. NavigatorUserMedia
   21. NavigatorUserMediaError
   22. VideoStreamTrack
   23. navigator.mediaDevices.getUserMedia()