MediaDevices: enumerateDevices() Methode

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die enumerateDevices() Methode der MediaDevices Schnittstelle fordert eine Liste der aktuell verfügbaren Medien-Eingangs- und Ausgangsgeräte an, wie Mikrofone, Kameras, Headsets und so weiter. Die zurückgegebene Promise wird mit einem Array von MediaDeviceInfo Objekten aufgelöst, die die Geräte beschreiben.

Die zurückgegebene Liste wird alle Geräte auslassen, die durch die Dokumenten-Permission Policy blockiert sind: microphone, camera, speaker-selection (für Ausgabegeräte) und so weiter. Der Zugriff auf bestimmte Nicht-Standard-Geräte wird auch durch die Permissions API geregelt, und die Liste wird Geräte auslassen, für die der Benutzer keine explizite Erlaubnis erteilt hat.

Syntax

js
enumerateDevices()

Parameter

Keine.

Rückgabewert

Eine Promise, die mit einem Array von MediaDeviceInfo Objekten erfüllt wird. Jedes Objekt im Array beschreibt eines der verfügbaren Medien-Eingangs- und Ausgangsgeräte. Die Reihenfolge ist bedeutend — die Standardaufnahmegeräte werden zuerst aufgelistet.

Abgesehen von Standardgeräten sind nur Geräte verfügbar, für die eine Erlaubnis erteilt wurde.

Wenn das Mediengerät ein Eingabegerät ist, wird ein InputDeviceInfo Objekt zurückgegeben.

Wenn die Aufzählung fehlschlägt, wird die Promise abgelehnt.

Sicherheitsanforderungen

Der Zugriff auf die API unterliegt den folgenden Einschränkungen:

  • Die Methode muss in einem sicheren Kontext aufgerufen werden.
  • Das Dokument muss vollständig aktiv sein und seine Sichtbarkeit muss "visible" sein.

Beispiele

Hier ist ein Beispiel für die Verwendung von enumerateDevices(). Es gibt eine Liste der Geräte-IDs aus, mit ihren Bezeichnungen, falls verfügbar.

js
if (!navigator.mediaDevices?.enumerateDevices) {
  console.log("enumerateDevices() not supported.");
} else {
  // List cameras and microphones.
  navigator.mediaDevices
    .enumerateDevices()
    .then((devices) => {
      devices.forEach((device) => {
        console.log(`${device.kind}: ${device.label} id = ${device.deviceId}`);
      });
    })
    .catch((err) => {
      console.error(`${err.name}: ${err.message}`);
    });
}

Das könnte folgendes erzeugen:

videoinput: id = csO9c0YpAf274OuCPUA53CNE0YHlIr2yXCi+SqfBZZ8=
audioinput: id = RKxXByjnabbADGQNNZqLVLdmXlS0YkETYCIbg+XxnvM=
audioinput: id = r2/xw1xUPIyZunfV1lGrKOma5wTOvCkWfZ368XCndm0=

oder wenn ein oder mehrere MediaStreams aktiv sind oder dauerhafte Berechtigungen erteilt wurden:

videoinput: FaceTime HD Camera (Built-in) id=csO9c0YpAf274OuCPUA53CNE0YHlIr2yXCi+SqfBZZ8=
audioinput: default (Built-in Microphone) id=RKxXByjnabbADGQNNZqLVLdmXlS0YkETYCIbg+XxnvM=
audioinput: Built-in Microphone id=r2/xw1xUPIyZunfV1lGrKOma5wTOvCkWfZ368XCndm0=

Spezifikationen

Specification
Media Capture and Streams
# dom-mediadevices-enumeratedevices

Browser-Kompatibilität

Siehe auch