HTMLAudioElement インターフェイスは <audio> 要素のプロパティと、操作するメソッドを提供します。 HTMLMediaElement インターフェイスから派生しています。

プロパティ

固有のプロパティはありません。親である HTMLMediaElement および HTMLElement からプロパティを継承しています。

メソッド

HTMLMediaElement および HTMLElement からメソッドを継承しています。

コンストラクター

構文

mySound = new Audio([URLString]);

説明

audio 要素のコンストラクターです。返されるオブジェクトの preload プロパティは auto に設定され、 src プロパティは引数の値が設定されます。ブラウザーはオブジェクトを返す前、非同期的にリソースの選択を始めます。

メモ: new Audio() で作成された audio 要素は、音声を再生中にガベージコレクションされることはありません。 pause() メソッドが呼ばれるか、再生が終了するまで、再生を続けます。

引数

URLString (期待される型: DOMString; 任意)
構築される HTMLAudioElementsrc プロパティ

通常メソッド

名前と引数 返値 説明
mozCurrentSampleOffset() unsigned long long mozWriteAudio() によって作成された音声ストリームの、現在のオフセットを示します。このオフセットは、ストリームの先頭からのサンプル番号で指定されます。

mozSetup(in PRUint32 channels, in PRUint32 rate)

void 書き込み用の音声ストリームを初期化します。引数でチャンネル数 (1 でモノラル、 2 でステレオ) とサンプリング周波数 (例えば 44.1kHz の場合は 44100) を指定できます。
mozWriteAudio(in jsval data) unsigned long ストリームの現在のオフセットに音声を書き込みます。実際にストリームに書き込まれたバイト数を返します。

基本的な使用

HTMLAudioElement を完全に JavaScript で生成します。

var flush = new Audio('toilet_flush.wav');
flush.play();

audio 要素でもっと一般的に使用されるプロパティとしては、 src, currentTime, duration, paused, muted, volume などがあります。

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  
})

仕様書

仕様書 状態 備考
HTML Living Standard
HTMLAudioElement の定義
現行の標準  
HTML5
HTMLAudioElement の定義
勧告  

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOS 版 SafariSamsung Internet
基本対応Chrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 3.5IE 完全対応 9Opera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありEdge Mobile 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
mozCurrentSampleOffset
非推奨非標準
Chrome 未対応 なしEdge 未対応 なしFirefox 完全対応 4IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしEdge Mobile 未対応 なしFirefox Android 完全対応 ありOpera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android 未対応 なし
mozSetup
非推奨非標準
Chrome 未対応 なしEdge 未対応 なしFirefox 完全対応 4IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしEdge Mobile 未対応 なしFirefox Android 完全対応 ありOpera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android 未対応 なし
mozWriteAudio
非推奨非標準
Chrome 未対応 なしEdge 未対応 なしFirefox 完全対応 4IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしEdge Mobile 未対応 なしFirefox Android 完全対応 ありOpera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。

関連情報

  • このインタフェースを実装した HTML 要素: <audio>

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, chikoski
最終更新者: mfuji09,