MediaStreamTrack: unmute イベント

unmute イベントは、トラックのソースが休止時間の後、再びメディアデータを提供するようになると一度発生します。これは mute で始まった muted の状態を終了します。

バブリング なし
キャンセル 不可
インターフェイス Event
イベントハンドラープロパティ onunmute

メモ: 多くの人が「ミュート」と考える状態 (すなわち、トラックを無音にすることをユーザーが制御できる方法) は実際には MediaStreamTrack.enabled プロパティを使用して管理され、こちらではイベントが発生しません。

この例では、イベントハンドラーを mute および unmute の各イベントに設定し、 MediaStreamTrack が入った変数 musicTrack のソースからメディアが流れていない場合を検出しています。

musicTrack.addEventListener("mute", event => {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}, false);

musicTrack.addEventListener("unmute", event => {
 document.getElementById("timeline-widget").style.backgroundColor = "#fff";
}, false);

これらのイベントハンドラーのある場面で、トラック musicTrackmuted の状態になったとき、 timeline-widget の ID を持った要素の背景色が #aaa に変化します。トラックのミュート状態を抜けたことを — unmuted イベントが到着したことによって — 検出すると、背景色は白に戻ります。

onunmute イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 onmute イベントハンドラープロパティが mute イベントを設定するために利用できます。以下の例ではこれを示しています。

musicTrack.onmute = event => {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}

musicTrack.mute = event = > {
  document.getElementById("timeline-widget").style.backgroundColor = "#fff";
}

仕様書

仕様書 状態 備考
Media Capture and Streams
unmute の定義
勧告候補 初回定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
unmute eventChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 59IE 未対応 なしOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 59Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
未対応  
未対応

関連情報

  • onunmute イベントハンドラープロパティ
  • mute イベント