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);
});
仕様書
| 仕様書 |
|---|
| Media Session # dom-mediasession-setmicrophoneactive |