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

浏览器兼容性