此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

MediaStreamTrack.getConstraints()

基线 广泛可用

自 2017年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

MediaStreamTrack 接口的 getConstraints() 方法接口返回 MediaTrackConstraints 包含集使用现有呼叫最近的轨道建立约束来 applyConstraints()。这些约束指示网站或应用程序指定的值和值范围对于包含的可约束属性是必需的或可接受的。

约束条件可以用来确保媒体符合你喜欢的某些指导方针。例如,你可能更喜欢高清视频,但要求帧率略低,以帮助保持足够低的数据速率而不会使网络负担过重。约束还可以指定理想和/或可接受的尺寸或尺寸范围。有关如何使用可约束属性的详细信息请参阅能力,约束和设置

语法

js
getConstraints()

参数

没有。

返回值

指示使用applyConstraints()最近设置的网站或应用程序的可约束属性的MediaTrackConstraints对象。返回对象中的属性按照与设置时相同的顺序列出,并且未包含未由网站或应用专门设置的属性。

备注:返回的一组约束条件不一定描述媒体的实际状态; 如果任何约束无法满足,它们仍然包含在网站代码最初设置的返回对象中。要获得所有可约束属性的当前活动设置,你应该调用getSettings()

本示例获取当前轨道约束,设置facingMode,并应用更新的约束。

js
function switchCameras(track,camera){
  let constraints = track.getConstraints();
  constraints.facingMode = camera;
  track.applyConstraints(约束);
}

规范

规范
Media Capture and Streams
# dom-mediastreamtrack-getconstraints

浏览器兼容性