MediaStreamTrack:getConstraints() 方法

getConstraints() 方法是 MediaStreamTrack 接口的一个方法,它返回一个 MediaTrackConstraints 对象,该对象包含使用之前对 applyConstraints() 的调用为音轨建立的约束集。这些约束指示网站或应用程序指定为必需或可接受的包含可约束属性的值和值范围。

约束可用于确保媒体满足您偏好的某些准则。例如,您可能偏好高清视频,但要求帧率略低,以帮助将数据速率保持在足够低的水平,以免过分占用网络。约束还可以指定大小或大小范围的理想值和/或可接受值。有关如何处理可约束属性的详细信息,请参阅 功能、约束和设置

语法

js
getConstraints()

参数

无。

返回值

一个 MediaTrackConstraints 对象,指示网站或应用程序最近使用 applyConstraints() 设置的可约束属性。返回的对象中的属性按设置时的顺序排列,并且仅包含网站或应用程序专门设置的属性。

注意:返回的约束集不一定描述媒体的实际状态。即使任何约束都无法满足,它们仍作为网站代码最初设置的那样包含在返回的对象中。要获取所有可约束属性的当前活动设置,您应该改为调用 getSettings()

示例

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

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

规范

规范
媒体捕获和流
# dom-mediastreamtrack-getconstraints

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。