MediaTrackConstraints: groupId 属性

MediaTrackConstraints 字典的 groupId 属性是一个 ConstrainDOMString,它描述了对 groupId 可约束属性的值所施加的请求或强制约束。

如果需要,你可以通过检查 MediaTrackSupportedConstraints.groupId 的值来确定此约束是否受支持,该值由对 MediaDevices.getSupportedConstraints() 的调用返回。但是,通常情况下,这是不必要的,因为浏览器会忽略任何他们不熟悉的约束。

一个基于 ConstrainDOMString 的对象,指定一个或多个可接受的、理想的和/或精确的(强制)组 ID,这些组 ID 作为媒体内容源是可接受的。

组 ID 在给定来源的单个浏览会话期间是唯一的,并且由来自同一物理设备的所有媒体源共享。例如,同一耳机的麦克风和扬声器将共享一个组 ID。这使得可以使用组 ID 来确保音频和输入设备在同一耳机上,方法是检索输入设备的组 ID 并将其指定在请求输出设备时,例如。

但是,groupId 的值由轨道的源内容决定,并且规范没有强制执行任何特定格式(尽管建议使用某种 GUID)。这意味着给定的轨道在调用 getCapabilities() 时只会返回一个 groupId 值,并请记住,此值在每次浏览会话中都会更改。

因此,在调用 MediaStreamTrack.applyConstraints() 时,组 ID 没有用处,因为只有一个可能的值,并且你不能使用它来确保在调用 getUserMedia() 时跨多个浏览会话使用相同的组。

示例

请参阅 约束练习器 示例。

规范

规范
媒体捕获和流
# dom-mediatrackconstraintset-groupid

浏览器兼容性

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

另请参阅