MediaTrackConstraints: groupId 屬性

Baseline 已廣泛支援

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

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

瀏覽器相容性

另見