InputDeviceInfo: Methode getCapabilities()

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

Die getCapabilities()-Methode des InputDeviceInfo-Interfaces gibt ein MediaTrackCapabilities-Objekt zurück, das die primäre Audio- oder Videospur des Geräts im MediaStream beschreibt.

Syntax

js
getCapabilities()

Parameter

Keine.

Rückgabewert

Ein MediaTrackCapabilities-Objekt, das den Wert oder Wertebereich angibt, die für jede von der Benutzeroberfläche unterstützte einschränkbare Eigenschaft unterstützt werden. Es enthält die folgenden Mitglieder:

deviceId

Ein ConstrainDOMString-Objekt, das die Geräte-ID enthält.

groupId

Ein ConstrainDOMString-Objekt, das eine Gruppen-ID enthält.

autoGainControl

Ein ConstrainBoolean-Objekt, das angibt, ob die Quelle eine automatische Verstärkungsregelung durchführen kann. Wenn das Feature durch ein Skript gesteuert werden kann, wird die Quelle sowohl true als auch false als mögliche Werte melden.

channelCount

Ein ConstrainULong-Objekt, das die Kanalanzahl oder den Bereich der Kanalanzahlen enthält.

echoCancellation

Ein ConstrainBoolean-Objekt, das angibt, ob die Quelle eine Echounterdrückung durchführen kann. Wenn das Feature durch ein Skript gesteuert werden kann, wird die Quelle sowohl true als auch false als mögliche Werte melden.

latency

Ein ConstrainDouble-Objekt, das die Latenz oder den Bereich der Latenzen enthält.

noiseSuppression

Ein ConstrainBoolean-Objekt, das angibt, ob die Quelle eine Rauschunterdrückung durchführen kann. Wenn das Feature durch ein Skript gesteuert werden kann, wird die Quelle sowohl true als auch false als mögliche Werte melden.

sampleRate

Ein ConstrainULong-Objekt, das die Abtastrate oder den Bereich der Abtastraten enthält.

sampleSize

Ein ConstrainULong-Objekt, das die Abtastgröße oder den Bereich der Abtastgrößen enthält.

aspectRatio

Ein ConstrainDouble-Objekt, das das Video- Seitenverhältnis (Breite in Pixel geteilt durch Höhe in Pixel) oder den Bereich der Seitenverhältnisse enthält.

facingMode

Ein ConstrainDOMString-Objekt, das den Kamerablickmodus enthält. Eine Kamera kann mehrere Ausrichtungen melden, zum Beispiel "left" und "user".

frameRate

Ein ConstrainDouble-Objekt, das die Bildrate oder den Bereich der akzeptablen Bildraten enthält.

height

Ein ConstrainULong-Objekt, das die Videohöhe oder den Bereich der Höhen in Pixel enthält.

width

Ein ConstrainULong-Objekt, das die Videobreite oder den Bereich der Breiten in Pixel enthält.

resizeMode

Ein ConstrainDOMString-Objekt, das den Modus oder ein Array von Modi enthält, die die Benutzeroberfläche verwenden kann, um die Auflösung der Videospur abzuleiten.

Hinweis: Wenn der Benutzer keine Berechtigung zum Zugriff auf das Eingabegerät erteilt hat, wird ein leeres Objekt zurückgegeben.

Beispiele

Im folgenden Beispiel fragen wir um Erlaubnis zum Zugriff auf Audio- und Videogeräte mit mediaDevices.getUserMedia(), da wir zur Verwendung von getCapabilities() die Erlaubnis zum Zugriff auf die Geräte benötigen.

Wenn device ein InputDeviceInfo-Objekt ist, gibt getCapabilities() ein Objekt mit Mitgliedern zurück, die seine Fähigkeiten repräsentieren. Ein Videostream wird zum Beispiel keine automatischen Eigenschaften wie noiseSuppression enthalten.

js
// Get permission to access audio or video devices
navigator.mediaDevices.getUserMedia({ audio: true, video: true });

navigator.mediaDevices.enumerateDevices().then((devices) => {
  devices.forEach((device) => {
    console.log(device.getCapabilities()); // a MediaTrackCapabilities object.
  });
});

Spezifikationen

Specification
Media Capture and Streams
# dom-inputdeviceinfo-getcapabilities

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch