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 的浏览器中加载。