MediaTrackConstraints: deviceId-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Eigenschaft deviceId des Dictionaries MediaTrackConstraints ist ein ConstrainDOMString, der die gewünschten oder zwingenden Einschränkungen für den Wert der einschränkbaren Eigenschaft deviceId beschreibt.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von deviceId untersuchen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist dies jedoch nicht nötig, da Browser ihnen unbekannte Einschränkungen ignorieren.
Da RTP diese Information nicht enthält, weisen Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, diese Eigenschaft nie auf.
Wert
Ein auf ConstrainDOMString basierendes Objekt, das eine oder mehrere akzeptable, bevorzugte und/oder exakte (zwingende) Geräte-IDs angibt, die als Quelle für Medieninhalte infrage kommen.
Geräte-IDs sind für einen bestimmten Origin eindeutig und bleiben über Browsersitzungen hinweg für denselben Origin gleich. Der Wert von deviceId wird jedoch durch die Quelle des Track-Inhalts bestimmt. Die Spezifikation schreibt dafür kein bestimmtes Format vor (empfohlen wird allerdings eine Art GUID). Das bedeutet, dass ein bestimmter Track bei einem Aufruf von getCapabilities() nur einen Wert für deviceId zurückgibt.
Deshalb ist die Geräte-ID bei einem Aufruf von MediaStreamTrack.applyConstraints() nicht nützlich, da nur ein Wert möglich ist. Sie können eine deviceId jedoch speichern und damit sicherstellen, dass Sie bei mehreren Aufrufen von getUserMedia() dieselbe Quelle erhalten.
Hinweis: Eine Ausnahme von der Regel, dass Geräte-IDs über Browsersitzungen hinweg gleich bleiben, ist der private Modus: Er verwendet eine andere ID, die sich mit jeder Browsersitzung ändert.
Beispiele
Siehe das Beispiel zum Ausprobieren von Einschränkungen.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-deviceid |