---
title: 'MediaStreamTrack: mute イベント'
slug: Web/API/MediaStreamTrack/mute_event
tags:
  - API
  - Audio
  - Event
  - Media
  - Media Capture and Streams
  - MediaStreamTrack
  - Reference
  - Video
  - mute
  - イベント
translation_of: Web/API/MediaStreamTrack/mute_event
---
<div>{{APIRef("Media Capture and Streams")}}</div>

<p><span class="seoSummary"><code><strong>mute</strong></code> イベントは、トラックのソースが一時的にメディアデータを提供することができなくなったときに {{domxref("MediaStreamTrack")}} へ送られます。</span>トラックがメディア出力可能になると、 {{domxref("MediaStreamTrack/unmute_event", "unmute")}} が送られます。</p>

<p><code>mute</code> イベントと <code>unmute</code> イベントとの間、トラックの {{domxref("MediaStreamTrack.muted", "muted")}} プロパティの値は <code>true</code> になります。</p>

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

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">バブリング</th>
   <td>なし</td>
  </tr>
  <tr>
   <th scope="row">キャンセル</th>
   <td>不可</td>
  </tr>
  <tr>
   <th scope="row">インターフェイス</th>
   <td>{{domxref("Event")}}</td>
  </tr>
  <tr>
   <th scope="row">イベントハンドラープロパティ</th>
   <td>{{domxref("MediaStreamTrack.onmute", "onmute")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Examples" name="Examples">例</h2>

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

<pre class="brush: js">musicTrack.addEventListener("mute", event =&gt; {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}, false);

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

<p>これらのイベントハンドラーのある場面で、トラック <code>musicTrack</code> が {{domxref("MediaStreamTrack.muted", "muted")}} の状態になったとき、 <code>timeline-widget</code> の ID を持った要素の背景色が <code>#aaa</code> に変化します。トラックのミュート状態を抜けたことを — <code>unmute</code> イベントが到着したことによって — 検出すると、背景色は白に戻ります。</p>

<p>{{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 {{domxref("MediaStreamTrack.onunmute", "onunmute")}} イベントハンドラープロパティが <code>unmute</code> イベントを設定するために利用できます。以下の例ではこれを示しています。</p>

<pre class="brush: js">musicTrack.onmute = event =&gt; {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}

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

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Media Capture', '#event-mediastreamtrack-unmute', 'unmute')}}</td>
   <td>{{Spec2('Media Capture')}}</td>
   <td>初回定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("api.MediaStreamTrack.mute_event")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティ</li>
 <li>{{domxref("MediaStreamTrack/unmute_event", "unmute")}} イベント</li>
</ul>