aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/mediastreamtrack/unmute_event/index.html
blob: d720f299e49ce469b5e4a941cb40c84fcda1ef12 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
---
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
---
<div>{{APIRef("Media Capture and Streams")}}</div>

<p><span class="seoSummary"><code><strong>unmute</strong></code> イベントは、トラックのソースが休止時間の後、再びメディアデータを提供するようになると一度発生します。</span>これは {{domxref("MediaStreamTrack/mute_event", "mute")}} で始まった {{domxref("MediaStreamTrack.muted", "muted")}} の状態を終了します。</p>

<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.onunmute", "onunmute")}}</td>
  </tr>
 </tbody>
</table>

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

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

<p>この例では、イベントハンドラーを {{domxref("MediaStreamTrack/mute_event", "mute")}} および <code>unmute</code> の各イベントに設定し、 {{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>unmuted</code> イベントが到着したことによって — 検出すると、背景色は白に戻ります。</p>

<p>{{domxref("MediaStreamTrack.onunmute", "onunmute")}} イベントハンドラープロパティを使用してこのイベントのハンドラーを設定することもできます。同様に、 {{domxref("MediaStreamTrack.onmute", "onmute")}} イベントハンドラープロパティが <code>mute</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.unmute_event")}}</p>

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

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