MediaTrackConstraints: groupId-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Die groupId-Eigenschaft des MediaTrackConstraints Wörterbuchs ist ein ConstrainDOMString, das die angeforderten oder verbindlichen Einschränkungen beschreibt, die auf den Wert der groupId beschränkbaren Eigenschaft angewendet werden.

Bei Bedarf können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.groupId prüfen, der durch einen Aufruf von MediaDevices.getSupportedConstraints() zurückgegeben wird. In der Regel ist dies jedoch nicht notwendig, da Browser alle Einschränkungen ignorieren, die ihnen unbekannt sind.

Wert

Ein Objekt basierend auf ConstrainDOMString, das eine oder mehrere akzeptable, ideale und/oder exakte (verbindliche) Gruppen-IDs spezifiziert, die als Quelle für Medieninhalte infrage kommen.

Gruppen-IDs sind für einen bestimmten Ursprung während der Dauer einer einzelnen Browsersitzung eindeutig und werden von allen Medienquellen geteilt, die von demselben physischen Gerät stammen. Zum Beispiel würden das Mikrofon und der Lautsprecher an demselben Headset eine Gruppen-ID teilen. Dies ermöglicht es, die Gruppen-ID zu verwenden, um sicherzustellen, dass die Audio- und Eingabegeräte am selben Headset sind, indem die Gruppen-ID des Eingabegeräts abgerufen und beim Anfordern eines Ausgabegeräts angegeben wird.

Der Wert der groupId wird jedoch von der Quelle des Inhalts des Tracks bestimmt, und es gibt kein spezielles Format, das von der Spezifikation vorgeschrieben wird (obwohl eine Art GUID empfohlen wird). Das bedeutet, dass ein gegebener Track nur einen Wert für die groupId zurückgibt, wenn Sie getCapabilities() aufrufen. Beachten Sie, dass sich dieser Wert mit jeder Browsersitzung ändert.

Aus diesem Grund gibt es keinen Nutzen für die Gruppen-ID beim Aufruf von MediaStreamTrack.applyConstraints(), da es nur einen möglichen Wert gibt, und Sie können sie nicht verwenden, um sicherzustellen, dass dieselbe Gruppe über mehrere Browsersitzungen hinweg verwendet wird, wenn Sie getUserMedia() aufrufen.

Beispiele

Siehe das Beispiel Constraint-Übungsprogramm.

Spezifikationen

Specification
Media Capture and Streams
# dom-mediatrackconstraintset-groupid

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
groupId constraint

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch