MediaTrackSettings: 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 MediaTrackSettings ist eine Zeichenfolge, die die Quelle des zugehörigen MediaStreamTrack für den Origin der Browsersitzung eindeutig identifiziert. Damit können Sie feststellen, welcher Wert ausgewählt wurde, um die von Ihnen angegebenen Einschränkungen für diese Eigenschaft zu erfüllen. Diese Einschränkungen haben Sie über die Eigenschaft MediaTrackConstraints.deviceId beim Aufruf von getUserMedia() angegeben.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird: Überprüfen Sie dazu den Wert von deviceId, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist das jedoch nicht erforderlich, da Browser unbekannte Einschränkungen ignorieren.
Da RTP diese Information nicht enthält, ist diese Eigenschaft bei Tracks, die einer WebRTC-RTCPeerConnection zugeordnet sind, niemals vorhanden.
Wert
Eine Zeichenfolge, deren Wert die Quelle des Tracks für einen Origin eindeutig identifiziert. Diese ID bleibt über mehrere Browsersitzungen desselben Origins hinweg gültig und ist für alle anderen Origins garantiert verschieden. Sie können sie daher beispielsweise verwenden, um in mehreren Sitzungen dieselbe Quelle anzufordern.
Der tatsächliche Wert der Zeichenfolge wird jedoch von der Quelle des Tracks bestimmt. Es gibt keine Garantie für sein Format, obwohl die Spezifikation eine GUID empfiehlt.
Da jeder Quelle genau eine ID zugeordnet ist, haben alle Tracks mit derselben Quelle für einen bestimmten Origin dieselbe ID. Deshalb gibt MediaStreamTrack.getCapabilities() für deviceId immer genau einen Wert zurück. Die Geräte-ID ist somit nicht hilfreich, wenn Sie Einschränkungen durch einen Aufruf von MediaStreamTrack.applyConstraints() ändern möchten.
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
Sehen Sie sich das Beispiel Constraint exerciser an.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-deviceid |