MediaSession: setMicrophoneActive() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die setMicrophoneActive() Methode der MediaSession Schnittstelle wird verwendet, um dem Benutzeragenten anzuzeigen, ob das Mikrofon des Benutzers derzeit als stummgeschaltet angesehen wird.

Rufen Sie diese Methode auf dem navigator Objekt mediaSession Objekt auf.

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

Syntax

js
setMicrophoneActive(active)

Parameter

active

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

Rückgabewert

Keiner (undefined).

Beispiele

Unten ist ein Beispiel für das Aktualisieren des Mikrofon-Stummschaltstatus der aktuellen MediaSession sowie für das Annehmen von Anfragen zur Änderung des Stummschaltstatus 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