MediaTrackConstraints: 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 Dictionaries MediaTrackConstraints ist ein ConstrainDOMString, der die gewünschten oder zwingenden Einschränkungen für den Wert der einschränkbaren Eigenschaft groupId beschreibt.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von groupId überprüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist das jedoch nicht nötig, da Browser unbekannte Einschränkungen ignorieren.
Wert
Ein auf ConstrainDOMString basierendes Objekt, das eine oder mehrere zulässige, bevorzugte und/oder exakte (zwingende) Gruppen-IDs angibt, die für die Quelle des Medieninhalts infrage kommen.
Gruppen-IDs sind für einen bestimmten Ursprung während einer einzelnen Browsersitzung eindeutig und werden von allen Medienquellen gemeinsam verwendet, die vom selben physischen Gerät stammen. Beispielsweise hätten das Mikrofon und der Lautsprecher desselben Headsets dieselbe Gruppen-ID. Dadurch lässt sich sicherstellen, dass sich Audio- und Eingabegerät am selben Headset befinden: Sie können die Gruppen-ID des Eingabegeräts abrufen und sie bei der Anforderung eines Ausgabegeräts angeben.
Der Wert von groupId wird jedoch durch die Quelle des Track-Inhalts bestimmt. Die Spezifikation schreibt dafür kein bestimmtes Format vor, empfiehlt aber eine Art GUID. Das bedeutet, dass ein bestimmter Track bei einem Aufruf von getCapabilities() nur einen Wert für groupId zurückgibt. Beachten Sie außerdem, dass sich dieser Wert mit jeder Browsersitzung ändert.
Deshalb ist die Gruppen-ID beim Aufruf von MediaStreamTrack.applyConstraints() nicht nützlich, da es nur einen möglichen Wert gibt. Ebenso können Sie damit bei Aufrufen von getUserMedia() nicht sicherstellen, dass über mehrere Browsersitzungen hinweg dieselbe Gruppe verwendet wird.
Beispiele
Siehe das Beispiel zum Ausprobieren von Einschränkungen.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-groupid |