--- title: 'MediaStreamTrack: unmute イベント' slug: Web/API/MediaStreamTrack/unmute_event tags: - Audio - Event - Media - Media Capture and Streams - Media Streams - MediaStreamTrack - Reference - Video - unmute - イベント translation_of: Web/API/MediaStreamTrack/unmute_event ---
unmute イベントは、トラックのソースが休止時間の後、再びメディアデータを提供するようになると一度発生します。これは {{domxref("MediaStreamTrack/mute_event", "mute")}} で始まった {{domxref("MediaStreamTrack.muted", "muted")}} の状態を終了します。
| バブリング | なし |
|---|---|
| キャンセル | 不可 |
| インターフェイス | {{domxref("Event")}} |
| イベントハンドラープロパティ | {{domxref("MediaStreamTrack.onunmute", "onunmute")}} |
メモ: 多くの人が「ミュート」と考える状態 (すなわち、トラックを無音にすることをユーザーが制御できる方法) は実際には {{domxref("MediaStreamTrack.enabled")}} プロパティを使用して管理され、こちらではイベントが発生しません。
この例では、イベントハンドラーを {{domxref("MediaStreamTrack/mute_event", "mute")}} および unmute の各イベントに設定し、 {{domxref("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);
これらのイベントハンドラーのある場面で、トラック musicTrack が {{domxref("MediaStreamTrack.muted", "muted")}} の状態になったとき、 timeline-widget の ID を持った要素の背景色が #aaa に変化します。トラックのミュート状態を抜けたことを — unmuted イベントが到着したことによって — 検出すると、背景色は白に戻ります。
{{domxref("MediaStreamTrack.onunmute", "onunmute")}} イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 {{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティが mute イベントを設定するために利用できます。以下の例ではこれを示しています。
musicTrack.onmute = event => {
document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}
musicTrack.mute = event = > {
document.getElementById("timeline-widget").style.backgroundColor = "#fff";
}
| 仕様書 | 状態 | 備考 |
|---|---|---|
| {{SpecName('Media Capture', '#event-mediastreamtrack-unmute', 'unmute')}} | {{Spec2('Media Capture')}} | 初回定義 |
{{Compat("api.MediaStreamTrack.unmute_event")}}