MediaTrackSettings:groupId 属性

MediaTrackSettings 字典的groupId 属性是一个浏览器会话唯一的字符串,用于标识包含 MediaStreamTrack 源的设备组。这使您可以确定为符合此属性值的指定约束而选择的哪个值,如您在调用 getUserMedia() 时提供的 MediaTrackConstraints.groupId 属性中所述。

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

因为 RTP 不包含此信息,所以与 WebRTC RTCPeerConnection 关联的轨道永远不会包含此属性。

一个字符串,其值为一个浏览器会话唯一的标识符,用于标识包含轨道内容源的设备组。如果两个设备属于同一物理硬件设备,则它们共享相同的组 ID。例如,一个耳机上有两个设备:一个麦克风,可以作为音频轨道的源;一个扬声器,可以作为音频的输出。

组 ID 在多个浏览器会话之间不可用。但是,它可以用于确保音频输入和输出都在同一耳机上执行,例如,或确保手机上的内置摄像头和麦克风用于视频会议目的。

但是,字符串的实际值由轨道的源决定,并且无法保证它将采用什么形式,尽管规范建议它是一个 GUID。

由于此属性在浏览器会话之间不稳定,因此在调用 getUserMedia() 时,其用处通常仅限于确保在同一浏览器会话期间执行的任务使用同一组中的设备(或不使用同一组中的设备)。在调用 applyConstraints() 时,groupId 没有任何用处,因为该值无法更改。

示例

请参阅 约束练习器 示例。

规范

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

浏览器兼容性

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

另请参阅