MediaSession:setMicrophoneActive() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

MediaSession 接口的 setMicrophoneActive() 方法用于向用户代理(user agent)指示用户的麦克风当前是否被认为是处于静音状态。

navigator 对象的 mediaSession 对象上调用此方法。

请注意,麦克风的状态并非由 MediaSession 本身跟踪,而必须单独跟踪。

语法

js
setMicrophoneActive(active)

参数

激活

一个布尔值,指示麦克风是否被认为是静音状态。

返回值

无(undefined)。

示例

下面是一个示例,演示如何更新当前 MediaSession 的麦克风静音状态,以及如何使用 setActionHandler() 监听更改静音状态的请求。

js
let microphoneActive = false;

navigator.mediaSession.setMicrophoneActive(microphoneActive);

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

规范

规范
媒体会话
# dom-mediasession-setmicrophoneactive

浏览器兼容性