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

瀏覽器相容性