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 MediaTrackConstraints-Dictionaries ist ein ConstrainDOMString, der die gewünschten oder verpflichtenden 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. Prüfen Sie dazu den Wert von groupId, 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 (verpflichtende) Gruppen-IDs angibt, die für die Quelle der Medieninhalte infrage kommen.
Gruppen-IDs sind für einen bestimmten Origin während einer einzelnen Browsersitzung eindeutig. Alle Medienquellen, die vom selben physischen Gerät stammen, haben dieselbe Gruppen-ID. Beispielsweise hätten das Mikrofon und der Lautsprecher desselben Headsets dieselbe Gruppen-ID. So können Sie anhand der Gruppen-ID sicherstellen, dass sich das Audioausgabe- und das Eingabegerät am selben Headset befinden: Dazu könnten Sie die Gruppen-ID des Eingabegeräts abrufen und sie bei der Anforderung eines Ausgabegeräts angeben.
Der Wert von groupId wird jedoch von der Quelle der Track-Inhalte bestimmt. Die Spezifikation schreibt dafür kein bestimmtes Format vor, empfiehlt aber eine Art GUID. Das bedeutet, dass ein bestimmter Track beim 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 bei einem Aufruf von MediaStreamTrack.applyConstraints() nicht nützlich, da nur ein Wert möglich ist. Ebenso können Sie sie bei einem Aufruf von getUserMedia() nicht verwenden, um sicherzustellen, dass über mehrere Browsersitzungen hinweg dieselbe Gruppe verwendet wird.
Beispiele
Sehen Sie sich das Beispiel Constraint exerciser an.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-groupid |