MediaSession:setMicrophoneActive() 方法

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

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

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

请注意,麦克风的狀態不会在 MediaSession 本身中跟踪,而是必须单独跟踪。

语法

js
setMicrophoneActive(active)

参数

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。