_Audio.js

オーディオの再生機能を提供します。

init() 関数内で以下の設定を有効にすることで、機能を付加できます。
_USE_AUDIOEXHTML5 Audio オブジェクトをサポートしていない場合に <audio>/<bgsound>/<embed> のいずれかの要素を使用します。
audioExElement() 関数を実装する必要があります。

canUseAudio

canUseAudio()

HTML5 Audio オブジェクトをサポートしているかどうかチェックします。

戻り値:
HTML5 Audio オブジェクトをサポートしている場合 true、サポートしていない場合 false

canPlayType

canPlayType(type)

指定されたMIMEタイプをサポートしているかどうかチェックします。

パラメータ:
typeMIMEタイプ

戻り値:
指定されたMIMEタイプをサポートしている場合 true、サポートしていない場合 false

loadAudio

loadAudio(src)

オーディオオブジェクトを構築します。

パラメータ:
srcオーディオリソースURL

戻り値:
構築されたオーディオオブジェクトを返します。構築に失敗した場合 null を返します。

isLoaded

isLoaded(audio)

オーディオの読み込みが完了したかどうかチェックします。

パラメータ:
audioオーディオオブジェクト

戻り値:
読み込みが完了して再生可能な場合 true、そうでない場合 false

補足説明:
HTML5 Audio オブジェクトで有効です。
<audio>、<bgsound>、<embed> 要素では無効です。

loadAndPlayAudio

loadAndPlayAudio(src,loop)

オーディオオブジェクトを構築して再生します。

パラメータ:
srcオーディオリソースURL
loopループさせる場合 true、そうでない場合 false

戻り値:
構築されたオーディオオブジェクトを返します。構築に失敗した場合 null を返します。

補足説明:
ブラウザによっては loop が機能しない場合もあります。その場合、isPlaying() で停止を確認して手動で再生する必要があります。

stopAudio

stopAudio(audio)

オーディオを停止します。

パラメータ:
audioオーディオオブジェクト

reloadAudio

reloadAudio(audio)

オーディオを再読み込みします。

パラメータ:
audioオーディオオブジェクト

補足説明:
PCブラウザでは、ループ状態を変更して再生する前に本関数を呼び出す必要があります。スマートフォンでは必要ありません。スマートフォンで本関数を呼び出すと、再生が不安定になります。

playAudio

playAudio(audio,loop)

オーディオを再生します。

パラメータ:
audioオーディオオブジェクト
loopループさせる場合 true、そうでない場合 false

補足説明:
ブラウザによっては loop が機能しない場合もあります。その場合、isPlaying() で停止を確認して手動で再生する必要があります。

isPlaying

isPlaying(audio)

オーディオが再生中かどうかチェックします。

パラメータ:
audioオーディオオブジェクト

戻り値:
再生中の場合 true、そうでない場合 false

補足説明:
HTML5 Audio オブジェクトと <audio> 要素で有効です。
<bgsound>、<embed> 要素では無効です。

pauseAudio

pauseAudio(audio)

オーディオを一時停止します。

パラメータ:
audioオーディオオブジェクト

補足説明:
HTML5 Audio オブジェクトで有効です。
<audio>、<bgsound>、<embed> 要素では無効です。

restartAudio

restartAudio(audio)

オーディオの再生を再開します。

パラメータ:
audioオーディオオブジェクト

補足説明:
HTML5 Audio オブジェクトで有効です。
<audio>、<bgsound>、<embed> 要素では無効です。

getCurrentTime

getCurrentTime(audio)

曲頭からの演奏時間を取得します。

パラメータ:
audioオーディオオブジェクト

戻り値:
曲頭からの演奏時間をミリ秒単位で返します。

補足説明:
HTML5 Audio オブジェクトで有効です。
<audio>、<bgsound>、<embed> 要素では無効です。

audioExElement

audioExElement()

_USE_AUDIOEX を有効にした場合、本関数を実装して、"audio"/"bgsound"/"embed" のいずれかの文字列を返してください。