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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getCapabilities

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch