MediaTrackSettings: Eigenschaft groupId
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
Die Eigenschaft groupId des MediaTrackSettings-Dictionaries ist eine innerhalb einer Browsersitzung eindeutige Zeichenfolge. Sie identifiziert die Gerätegruppe, zu der die Quelle des MediaStreamTrack gehört. Damit können Sie feststellen, welcher Wert ausgewählt wurde, um die von Ihnen für diese Eigenschaft angegebenen Constraints zu erfüllen. Diese sind in der Eigenschaft MediaTrackConstraints.groupId beschrieben, die Sie beim Aufruf von getUserMedia() angegeben haben.
Bei Bedarf können Sie prüfen, ob dieses Constraint unterstützt wird, indem Sie den Wert von groupId überprüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. Normalerweise ist das jedoch nicht nötig, da Browser unbekannte Constraints ignorieren.
Da RTP diese Information nicht enthält, weisen Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, diese Eigenschaft nie auf.
Wert
Eine Zeichenfolge, deren Wert eine innerhalb einer Browsersitzung eindeutige Kennung für eine Gerätegruppe ist, zu der die Quelle des Track-Inhalts gehört. Zwei Geräte haben dieselbe Gruppen-ID, wenn sie zum selben physischen Gerät gehören. Ein Headset umfasst beispielsweise zwei Geräte: ein Mikrofon, das als Quelle für Audio-Tracks dienen kann, und einen Lautsprecher, der Audio ausgeben kann.
Die Gruppen-ID kann nicht über mehrere Browsersitzungen hinweg verwendet werden. Sie kann jedoch beispielsweise dazu dienen, sicherzustellen, dass Audioeingabe und -ausgabe über dasselbe Headset erfolgen oder dass bei einer Videokonferenz die integrierte Kamera und das integrierte Mikrofon eines Smartphones verwendet werden.
Der tatsächliche Wert der Zeichenfolge wird von der Quelle des Tracks bestimmt. Es gibt keine Garantie dafür, welches Format er hat, auch wenn die Spezifikation eine GUID empfiehlt.
Da diese Eigenschaft nicht über Browsersitzungen hinweg stabil ist, beschränkt sich ihr Nutzen bei Aufrufen von getUserMedia() im Allgemeinen darauf, sicherzustellen, dass Aufgaben innerhalb derselben Browsersitzung Geräte aus derselben Gruppe verwenden – oder gerade nicht. Beim Aufruf von applyConstraints() ist die groupId nicht nützlich, da sich ihr Wert nicht ändern lässt.
Beispiele
Sehen Sie sich das Beispiel Constraint exerciser an.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-groupid |