MediaSession.setMicrophoneActive()

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

MediaSession の setMicrophoneActive() メソッドは、ユーザーエージェントに対して、ユーザーのマイクが現在ミュートされていると見なされるかどうかを示すために使用します。

このメソッドは 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);
});

仕様書

Specification
Media Session Standard
# dom-mediasession-setmicrophoneactive

ブラウザーの互換性

BCD tables only load in the browser