InputDeviceInfo: getCapabilities() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getCapabilities() Methode der InputDeviceInfo Schnittstelle gibt ein MediaTrackCapabilities Objekt zurück, das die primäre Audio- oder Videospur des Geräts in einem MediaStream beschreibt.
Syntax
getCapabilities()
Parameter
Keine.
Rückgabewert
Ein MediaTrackCapabilities Objekt, das den Wert oder Bereich von Werten angibt, die für jede der vom User-Agent unterstützten beschränkbaren Eigenschaften unterstützt werden. Es muss identische Informationen zurückgeben wie der Aufruf von getCapabilities() auf der ersten MediaStreamTrack gleichen Typs (Video oder Audio) in dem MediaStream, das durch getUserMedia({ deviceId: deviceInfo.deviceId }) zurückgegeben wird.
Siehe MediaStreamTrack.getCapabilities() für eine Liste der häufig unterstützten Eigenschaften und deren Typen.
Hinweis: Wenn der Benutzer nicht die Erlaubnis zur Nutzung des Eingabegeräts erteilt hat, wird ein leeres Objekt zurückgegeben.
Beispiele
Im folgenden Beispiel bitten wir um Erlaubnis, auf Audio- und Videogeräte mit mediaDevices.getUserMedia() zuzugreifen, da wir zum Verwenden 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 dessen Fähigkeiten repräsentieren. Ein Videostream wird keine automatischen Eigenschaften wie noiseSuppression enthalten, zum Beispiel.
// Get permission to access audio or video devices
navigator.mediaDevices
.getUserMedia({ audio: true, video: true })
// Enumerate media devices
.then(() => navigator.mediaDevices.enumerateDevices())
.then((devices) => {
devices.forEach((device) => {
if (typeof device.getCapabilities === "function") {
console.log("Capabilities:", device.getCapabilities()); // A MediaTrackCapabilities object.
} else {
console.log("Device does not support getCapabilities:", device);
}
});
})
.catch((mediaError) => {
console.error("Error accessing media devices:", mediaError);
});
Spezifikationen
| Specification |
|---|
| Media Capture and Streams # dom-inputdeviceinfo-getcapabilities |
Browser-Kompatibilität
Loading…
Siehe auch
MediaStreamTrack.getCapabilities(), das ebenfalls einMediaTrackCapabilitiesObjekt zurückgibt.