MediaTrackConstraints: groupId 属性
MediaTrackConstraints 字典的 groupId 属性是一个 ConstrainDOMString,用于描述对 groupId 可约束属性值提出的请求或强制性约束。
如果需要,您可以通过调用 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.groupId 的值来确定此约束是否受支持。不过,通常这并不必要,因为浏览器会忽略它们不熟悉的任何约束。
值
一个基于 ConstrainDOMString 的对象,指定一个或多个可接受的、理想的以及/或精确的(强制性的)组 ID,这些 ID 可作为媒体内容的来源。
组 ID 在单个浏览会话期间对给定的源是唯一的,并且由来自同一物理设备的所有媒体源共享。例如,同一耳机的麦克风和扬声器将共享一个组 ID。这使得可以使用组 ID 来确保音频和输入设备在同一个耳机上,方法是检索输入设备的组 ID,并在请求输出设备时指定它。
然而,groupId 的值由轨道内容的来源决定,并且规范没有强制规定特定的格式(尽管推荐使用某种 GUID)。这意味着,当您调用 getCapabilities() 时,给定的轨道只会返回一个 groupId 值,并且请记住,这个值在每个浏览会话中都会改变。
因此,在调用 MediaStreamTrack.applyConstraints() 时,使用组 ID 没有意义,因为只有一个可能的值,并且您不能在调用 getUserMedia() 时使用它来确保跨多个浏览会话使用相同的组。
示例
请参阅 Constraint exerciser 示例。
规范
| 规范 |
|---|
| 媒体捕获和流 # dom-mediatrackconstraintset-groupid |
浏览器兼容性
加载中…