MediaTrackSettings: groupId 屬性

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

MediaTrackSettings 字典的 groupId 屬性是一個瀏覽會話唯一識別符號,用於標識包含 MediaStreamTrack 源的裝置組。這可以幫助您確定為了滿足您在呼叫 getUserMedia() 時提供的 MediaTrackConstraints.groupId 屬性所指定的約束,最終選擇了哪個值。

如果需要,您可以透過呼叫 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.groupId 的值來確定是否支援此約束。但是,通常這沒有必要,因為瀏覽器會忽略它們不認識的任何約束。

由於 RTP 不包含此資訊,因此與 WebRTC RTCPeerConnection 關聯的軌道永遠不會包含此屬性。

一個字串,其值是包含軌道內容源的裝置組的瀏覽會話唯一識別符號。如果兩個裝置屬於同一個物理硬體裝置,則它們共享相同的組 ID。例如,一個耳機上有兩個裝置:一個可以作為音訊軌道源的麥克風,以及一個可以作為音訊輸出的揚聲器。

組 ID 不能在多個瀏覽會話之間使用。但是,它可以用來確保音訊輸入和輸出都在同一個耳機上執行,例如,或者確保手機上內建的攝像頭和麥克風被用於視訊會議目的。

然而,字串的實際值由軌道的源確定,並且沒有保證它會採用何種形式,儘管規範建議它應該是 GUID。

由於此屬性在瀏覽會話之間不穩定,因此在呼叫 getUserMedia() 時,它的用途通常僅限於確保在同一瀏覽會話期間執行的任務使用來自同一組的裝置(或不使用來自同一組的裝置)。在呼叫 applyConstraints() 時,groupId 沒有用武之地,因為該值無法更改。

示例

請參閱 Constraint exerciser 示例。

規範

規範
媒體捕獲和流
# dom-mediatrackconstraintset-groupid

瀏覽器相容性

另見