MediaTrackConstraints: deviceId-Eigenschaft

Das deviceId-Eigenschaftswörterbuch von MediaTrackConstraints ist ein ConstrainDOMString, das die angeforderten oder zwingenden Einschränkungen beschreibt, die auf den Wert der deviceId beschränkbaren Eigenschaft angewendet werden.

Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.deviceId überprüfen, wie er 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.

Da RTP diese Informationen nicht enthält, werden Tracks, die mit einer WebRTC RTCPeerConnection verbunden sind, diese Eigenschaft niemals enthalten.

Wert

Ein Objekt basierend auf ConstrainDOMString, das eine oder mehrere akzeptable, ideale und/oder genaue (zwingende) Geräte-IDs angibt, die als Quelle für Medieninhalte akzeptabel sind.

Geräte-IDs sind für einen bestimmten Ursprung eindeutig und sind garantiert in derselben Weise über Browsersitzungen hinweg auf demselben Ursprung gleich. Der Wert des deviceId wird jedoch durch die Quelle des Inhalts des Tracks bestimmt, und es gibt kein bestimmtes Format, das von der Spezifikation vorgeschrieben wird (obwohl eine Art GUID empfohlen wird). Das bedeutet, dass ein bestimmter Track nur einen Wert für das deviceId zurückgibt, wenn Sie getCapabilities() aufrufen.

Aus diesem Grund gibt es keinen Nutzen für die Geräte-ID beim Aufruf von MediaStreamTrack.applyConstraints(), da es nur einen möglichen Wert gibt; Sie können jedoch ein deviceId aufzeichnen und verwenden, um sicherzustellen, dass Sie dieselbe Quelle für mehrere Aufrufe von getUserMedia() erhalten.

Hinweis: Eine Ausnahme von der Regel, dass Geräte-IDs über Browsersitzungen hinweg gleich sind: Der private Browsing-Modus verwendet eine andere ID und ändert sie in jeder Browsersitzung.

Beispiele

Siehe das Beispiel Constraint-Übungsprogramm.

Spezifikationen

Specification
Media Capture and Streams
# dom-mediatrackconstraintset-deviceid

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch