MediaSession: setMicrophoneActive() Methode

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die setMicrophoneActive()-Methode des MediaSession-Interfaces wird verwendet, um dem User-Agent anzuzeigen, ob das Mikrofon des Benutzers derzeit als stummgeschaltet angesehen wird.

Rufen Sie diese Methode am navigator-Objekt im mediaSession-Objekt auf.

Beachten Sie, dass der Status des Mikrofons nicht im MediaSession selbst verfolgt wird, sondern separat erfasst werden muss.

Syntax

js
setMicrophoneActive(active)

Parameter

active

Ein Boolean, der angibt, ob das Mikrofon als stummgeschaltet angesehen wird oder nicht.

Rückgabewert

Keiner (undefined).

Beispiele

Nachfolgend ein Beispiel zum Aktualisieren des Mikrofon-Stummschaltungszustandes der aktuellen MediaSession und zum Zuhören von Anforderungen zur Änderung des Stummschaltungsstatus mit setActionHandler().

js
let microphoneActive = false;

navigator.mediaSession.setMicrophoneActive(microphoneActive);

navigator.mediaSession.setActionHandler("togglemicrophone", () => {
  microphoneActive = !microphoneActive;
  navigator.mediaSession.setMicrophoneActive(microphoneActive);
});

Spezifikationen

Specification
Media Session
# dom-mediasession-setmicrophoneactive

Browser-Kompatibilität

BCD tables only load in the browser