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