MediaTrackSettings: groupId-Eigenschaft
Die groupId
-Eigenschaft des MediaTrackSettings
Dictionaries ist eine sitzungsübergreifend eindeutige
Zeichenkette, die die Gruppe von Geräten identifiziert, welche die Quelle für den MediaStreamTrack
enthält. Dies ermöglicht es Ihnen herauszufinden, welcher Wert ausgewählt wurde, um den angegebenen Einschränkungen für den Wert dieser Eigenschaft zu entsprechen, wie in der MediaTrackConstraints.groupId
Eigenschaft beschrieben, die Sie beim Aufruf von getUserMedia()
angegeben haben.
Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.groupId
prüfen, wie er durch einen Aufruf von MediaDevices.getSupportedConstraints()
zurückgegeben wird. In der Regel ist dies jedoch nicht notwendig, da Browser alle Einschränkungen ignorieren, die sie nicht kennen.
Da RTP diese Informationen nicht enthält, werden Spuren, die mit einer WebRTC RTCPeerConnection
verbunden sind, diese Eigenschaft niemals enthalten.
Wert
Eine Zeichenkette, deren Wert eine sitzungsübergreifend eindeutige Kennung für eine Gruppe von Geräten ist, welche die Quelle der Inhalte der Spur enthält. Zwei Geräte teilen sich die gleiche Gruppen-ID, wenn sie zum selben physischen Hardwaregerät gehören. Zum Beispiel hat ein Headset zwei Geräte: ein Mikrofon, das als Quelle für Audiotracks dienen kann, und einen Lautsprecher, der als Audioausgabe dienen kann.
Die Gruppen-ID ist nicht über mehrere Sitzungssitzungen hinweg nutzbar. Sie kann jedoch verwendet werden, um sicherzustellen, dass Audioeingabe und -ausgabe beide mit demselben Headset durchgeführt werden, oder um sicherzustellen, dass die eingebaute Kamera und das Mikrofon eines Telefons für Videokonferenzen genutzt werden.
Der tatsächliche Wert der Zeichenkette wird von der Quelle des Tracks bestimmt, und es gibt keine Garantie, welche Form sie annehmen wird, obwohl die Spezifikation empfiehlt, dass sie eine GUID ist.
Da diese Eigenschaft zwischen Sitzungssitzungen nicht stabil bleibt, ist ihre Nützlichkeit beim Aufruf von getUserMedia()
im Allgemeinen darauf beschränkt, sicherzustellen, dass Aufgaben, die während derselben Sitzungssitzung ausgeführt werden, Geräte aus derselben Gruppe verwenden (oder dass sie keine Geräte aus derselben Gruppe verwenden). Es gibt keine Situation, in der die groupId
-Eigenschaft beim Aufrufen von applyConstraints()
nützlich ist, da der Wert nicht geändert werden kann.
Beispiele
Siehe das Beispiel Constraint exerciser.
Spezifikationen
Specification |
---|
Media Capture and Streams # dom-mediatrackconstraintset-groupid |
Browser-Kompatibilität
BCD tables only load in the browser