MediaTrackSettings
MediaTrackSettings 字典用于返回 MediaStreamTrackMediaTrackConstraintsapplyConstraints()
要了解有关约束和设置工作原理的更多信息,请参阅 功能、约束和设置。
实例属性
以下一项或多项将包含在该对象中,原因可能是浏览器不支持,也可能是由于上下文不可用。例如,由于 RTP 在 WebRTC 连接的协商过程中不提供其中某些值,因此与 RTCPeerConnectionfacingMode 或 groupId。
所有媒体轨道的实例属性
- deviceId
- 
一个字符串,指示 deviceIdMediaDevices.getUserMedia()
- groupId
- 
一个字符串,指示 groupIddeviceIdMediaDevices.getUserMedia()
音频轨道的实例属性
- autoGainControl
- 
一个布尔值,指示 autoGainControltrue,否则为false。
- channelCount
- 
一个长整数值,指示 channelCount
- echoCancellation
- 
一个布尔值,指示 echoCancellationtrue,否则为false。
- latency
- 
一个双精度浮点数值,指示 latency
- noiseSuppression
- 
一个布尔值,指示 noiseSuppressiontrue,否则为false。
- restrictOwnAudio
- 
一个布尔值,指示 restrictOwnAudiotrue,否则为false。
- sampleRate
- 
一个长整数值,指示 sampleRate
- sampleSize
- 
一个长整数值,指示 sampleSize
- suppressLocalAudioPlayback
- 
控制在捕获标签时,标签中正在播放的音频是否会继续通过用户的本地扬声器播放。 
- volume已弃用 非标准
- 
一个双精度浮点数值,指示 volume
视频轨道的实例属性
- aspectRatio
- 
一个双精度浮点数值,指示 aspectRatio
- facingMode
- 
一个字符串,指示 facingMode- "user"
- 
面向用户的摄像头(俗称“自拍相机”),用于自拍和视频通话。 
- "environment"
- 
面向远离用户的摄像头(当用户查看屏幕时)。这通常是设备上质量最高的摄像头,用于一般摄影。 
- "left"
- 
面向用户左侧环境的摄像头。 
- "right"
- 
面向用户右侧环境的摄像头。 
 
- frameRate
- 
一个双精度浮点数值,指示 frameRate
- height
- 
一个长整数值,指示 height
- width
- 
一个长整数值,指示 width
- resizeMode
- 
一个字符串,指示 resizeMode- "none"
- 
轨道具有摄像头、驱动程序或操作系统提供的分辨率。 
- "crop-and-scale"
- 
轨道的分辨率可能是用户代理从更高的摄像头分辨率进行裁剪或下缩的结果。 
 
共享屏幕轨道的实例属性
包含用户屏幕共享视频的轨道(无论屏幕数据是来自整个屏幕还是屏幕的一部分,例如窗口或标签)通常被视为视频轨道,但它们还支持以下附加设置:
- cursor
- 
一个字符串,指示鼠标光标是否包含在生成的流中以及在什么条件下。可能的值为: 
- displaySurface
- 
一个字符串,指定轨道包含的源类型;可以是以下之一: 
- logicalSurface
- 
一个布尔值,如果为 true,则表示流的视频轨道中包含的视频包含后台渲染上下文,而不是用户可见的上下文。如果捕获的视频来自前台(用户可见)源,则为false。
- screenPixelRatio
- 
一个数字,表示捕获显示表面的像素物理尺寸(以物理分辨率显示)与捕获屏幕上的 CSS 像素逻辑尺寸(以逻辑分辨率显示)之比。它不能用作约束或功能。 
规范
| 规范 | 
|---|
| 媒体捕获和流 # media-track-settings | 
| 屏幕捕获 # extensions-to-mediatracksettings |