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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
---
title: HTMLAudioElement
slug: Web/API/HTMLAudioElement
tags:
- API
- HTML DOM
- HTMLAudioElement
- Interface
- Reference
translation_of: Web/API/HTMLAudioElement
---
<p><strong><code>HTMLAudioElement</code></strong> インターフェイスは {{HTMLElement("audio")}} 要素のプロパティと、操作するメソッドを提供します。 {{domxref("HTMLMediaElement")}} インターフェイスから派生しています。</p>
<p>{{InheritanceDiagram(600, 120)}}</p>
<h2 id="Properties" name="Properties">プロパティ</h2>
<p><em>固有のプロパティはありません。親である {{domxref("HTMLMediaElement")}} および {{domxref("HTMLElement")}} からプロパティを継承しています。</em></p>
<h2 id="Methods" name="Methods">メソッド</h2>
<p><em>{{domxref("HTMLMediaElement")}} および {{domxref("HTMLElement")}} からメソッドを継承しています。</em></p>
<h3 id="Constructor" name="Constructor">コンストラクター</h3>
<h4 id="Syntax" name="Syntax">構文</h4>
<pre class="syntaxbox">mySound = new Audio([<em>URLString</em>]);
</pre>
<h4 id="Description" name="Description">説明</h4>
<p>audio 要素のコンストラクターです。返されるオブジェクトの <code>preload</code> プロパティは <code>auto</code> に設定され、 <code>src</code> プロパティは引数の値が設定されます。ブラウザーはオブジェクトを返す前、<em>非同期的に</em>リソースの選択を始めます。</p>
<p><em>メモ: <code>new Audio()</code> で作成された audio 要素は、音声を再生中にガベージコレクションされることはありません。 <code>pause()</code> メソッドが呼ばれるか、再生が終了するまで、再生を続けます。</em></p>
<h4 id="Parameters" name="Parameters"><em>引数</em></h4>
<dl>
<dt><em><code>URLString</code> (期待される型: {{domxref("DOMString")}}; 任意)</em></dt>
<dd><em>構築される <code>HTMLAudioElement</code> の <code>src </code> プロパティ</em></dd>
</dl>
<h3 id="Regular_methods" name="Regular_methods"><em>通常メソッド</em></h3>
<table class="standard-table">
<tbody>
<tr>
<th scope="col"><em>名前と引数</em></th>
<th scope="col"><em>返値</em></th>
<th scope="col"><em>説明</em></th>
</tr>
<tr>
<td><em><code>mozCurrentSampleOffset()</code> {{non-standard_inline}}</em></td>
<td><em><code>unsigned long long</code></em></td>
<td><em><code>mozWriteAudio()</code> によって作成された音声ストリームの、現在のオフセットを示します。このオフセットは、ストリームの先頭からのサンプル番号で指定されます。</em></td>
</tr>
<tr>
<td>
<p><em><code>mozSetup(in PRUint32 channels, in PRUint32 rate)</code> {{non-standard_inline}}</em></p>
</td>
<td><em><code>void</code></em></td>
<td><em>書き込み用の音声ストリームを初期化します。引数でチャンネル数 (<code>1</code> でモノラル、 <code>2</code> でステレオ) とサンプリング周波数 (例えば 44.1kHz の場合は <code>44100</code>) を指定できます。</em></td>
</tr>
<tr>
<td><em><code>mozWriteAudio(in jsval data) </code>{{non-standard_inline}}</em></td>
<td><em><code>unsigned long</code></em></td>
<td><em>ストリームの現在のオフセットに音声を書き込みます。実際にストリームに書き込まれたバイト数を返します。</em></td>
</tr>
</tbody>
</table>
<h2 id="Examples" name="Examples"><em>例</em></h2>
<h3 id="Basic_usage" name="Basic_usage"><em>基本的な使用</em></h3>
<p><em><code>HTMLAudioElement</code> を完全に JavaScript で生成します。</em></p>
<pre><em>var flush = new Audio('toilet_flush.wav');
flush.play();
</em></pre>
<p><em>audio 要素でもっと一般的に使用されるプロパティとしては、 <code>src</code>, <code>currentTime</code>, <code>duration</code>, <code>paused</code>, <code>muted</code>, <code>volume</code> などがあります。</em></p>
<pre><em>var flush = new Audio('toilet_flush.wav');
flush.addEventListener('loadeddata',() => {
var duration = flush.duration; // the duration variable now holds the duration (in seconds) of the audio clip
})</em></pre>
<h2 id="Specifications" name="Specifications"><em>仕様書</em></h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col"><em>仕様書</em></th>
<th scope="col"><em>状態</em></th>
<th scope="col"><em>備考</em></th>
</tr>
</thead>
<tbody>
<tr>
<td><em>{{SpecName('HTML WHATWG', "#htmlaudioelement", "HTMLAudioElement")}}</em></td>
<td><em>{{Spec2('HTML WHATWG')}}</em></td>
<td> </td>
</tr>
<tr>
<td><em>{{SpecName('HTML5 W3C', "embedded-content-0.html#the-audio-element", "HTMLAudioElement")}}</em></td>
<td><em>{{Spec2('HTML5 W3C')}}</em></td>
<td><em> </em></td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility"><em>ブラウザーの対応</em></h2>
<p><em>{{Compat("api.HTMLAudioElement")}}</em></p>
<h2 id="See_also" name="See_also"><em>関連情報</em></h2>
<ul>
<li><em>このインタフェースを実装した HTML 要素: {{HTMLElement("audio")}}</em></li>
</ul>
<div><em>{{APIRef("HTML DOM")}}</em></div>
|
