MediaSession: setScreenshareActive() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

setScreenshareActive()MediaSession 介面的一個方法,用於向用戶代理(user agent)指示使用者的螢幕共享是否被認為是活躍的。

navigator 物件的 mediaSession 物件上呼叫此方法。

請注意,螢幕共享的狀態並未在 MediaSession 自身中進行跟蹤,而是必須單獨跟蹤。

語法

js
setScreenshareActive(active)

引數

啟用

一個布林值,表示螢幕共享是否被認為是活躍的。

返回值

無(undefined)。

示例

下面是一個示例,展示如何更新當前 MediaSession 的螢幕共享活躍狀態,以及如何使用 setActionHandler() 監聽更改螢幕共享狀態的請求。

js
let screenshareActive = false;

navigator.mediaSession.setCameraActive(cameraActive);

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

規範

規範
媒體會話
# dom-mediasession-setscreenshareactive

瀏覽器相容性