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
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 sowohltrue
als auchfalse
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 sowohltrue
als auchfalse
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 sowohltrue
als auchfalse
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.
// 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
MediaStreamTrack.getCapabilities()
, das ebenfalls einMediaTrackCapabilities
-Objekt zurückgibt.