HTMLMediaElement: setSinkId()-Methode

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

Die setSinkId()-Methode des HTMLMediaElement-Interfaces legt die ID des Audiogeräts fest, das für die Ausgabe verwendet werden soll, und gibt ein Promise zurück.

Dies funktioniert nur, wenn die Anwendung berechtigt ist, das angegebene Gerät zu verwenden. Weitere Informationen finden Sie unter den Sicherheitsanforderungen unten.

In diesem Artikel

Syntax

setSinkId(sinkId)

Parameter

sinkId

Die MediaDeviceInfo.deviceId des Audioausgabegeräts.

Rückgabewert

Ein Promise, das sich zu undefined auflöst.

Ausnahmen

NotAllowedError DOMException

Wird zurückgegeben, wenn eine speaker-selection Berechtigungsrichtlinie verwendet wird, um die Verwendung von Audioausgaben zu blockieren.

NotFoundError DOMException

Wird zurückgegeben, wenn die deviceId keinem Audioausgabegerät entspricht.

AbortError DOMException

Wird zurückgegeben, wenn das Umschalten des Audioausgabegeräts auf das neue Audiogerät fehlgeschlagen ist.

Sicherheitsanforderungen

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

Die Methode muss in einem sicheren Kontext aufgerufen werden.
Der Zugriff kann durch die speaker-selection HTTP-Berechtigungsrichtlinie eingeschränkt werden.
Es ist die Zustimmung des Nutzers erforderlich, um auf ein nicht standardmäßiges Gerät zuzugreifen. Der Nutzer erteilt die Erlaubnis durch Auswahl des mit der ID verknüpften Geräts im Dialogfeld, das von MediaDevices.selectAudioOutput() angezeigt wird.

Dieses Beispiel zeigt, wie man ein Audioausgabegerät aus dem Array auswählt, das von MediaDevices.enumerateDevices() zurückgegeben wird, und es als Audioausgabe festlegt. Beachten Sie, dass das Ergebnis von enumerateDevices() nur Geräte umfasst, für die keine Benutzererlaubnis erforderlich ist oder die bereits erteilt wurde.

js
const devices = await navigator.mediaDevices.enumerateDevices();
const audioDevice = devices.find((device) => device.kind === "audiooutput");
const audio = document.createElement("audio");
await audio.setSinkId(audioDevice.deviceId);
console.log(`Audio is being output on ${audio.sinkId}`);

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Audio Output Devices API
HTMLMediaElement
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
Verwandte Seiten für Audio Output Devices API

HTMLMediaElement: setSinkId()-Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Ausnahmen

Sicherheitsanforderungen

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN