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 |
瀏覽器相容性
載入中…