_Audio.js

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

init() 関数内で以下の設定を有効にすることで、機能を付加できます。

_USE_AUDIOEX | HTML5 Audio オブジェクトをサポートしていない場合に <audio>／<bgsound>／<embed> のいずれかの要素を使用します。 audioExElement() 関数を実装する必要があります。

| canUseAudio

canUseAudio()

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

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

| canPlayType

canPlayType(type)

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

パラメータ：

type | MIMEタイプ

戻り値：
指定された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" のいずれかの文字列を返してください。