MediaSession: Methode setScreenshareActive()

Limited availability

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

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

Die setScreenshareActive()-Methode des MediaSession-Interfaces wird verwendet, um dem Benutzeragenten mitzuteilen, ob die Bildschirmübertragung des Benutzers als aktiv angesehen wird.

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

Beachten Sie, dass der Status der Bildschirmübertragung nicht in der MediaSession selbst verfolgt wird, sondern separat nachverfolgt werden muss.

Syntax

js
setScreenshareActive(active)

Parameter

active

Ein boolescher Wert, der angibt, ob die Bildschirmübertragung als aktiv angesehen wird oder nicht.

Rückgabewert

Keiner (undefined).

Beispiele

Unten finden Sie ein Beispiel dafür, wie der aktuelle Status der aktiven Bildschirmübertragung der MediaSession aktualisiert wird. Außerdem wird gezeigt, wie Anfragen zum Ändern des Bildschirmübertragungsstatus mit setActionHandler() behandelt werden.

js
let screenshareActive = false;

navigator.mediaSession.setCameraActive(cameraActive);

navigator.mediaSession.setActionHandler("togglescreenshare", () => {
  screenshareActive = !screenshareActive;
  navigator.mediaSession.setCameraActive(screenshareActive);
});

Spezifikationen

Specification
Media Session
# dom-mediasession-setscreenshareactive

Browser-Kompatibilität