PreloadJSオブジェクト.installPlugin(plugin)概要プラグインを登録する。ロードの種類(サウンドやイメージなど)、あるいは拡張子(pngやmp3など)ごとに、ひとつのプラグインを定める。プラグインを定めるクラスは、プロパティとしてcallbackとtypes、およびextensionsが含まれたオブジェクトを返す。プロパティtypesとextensionsは、それぞれロードの種類と拡張子を文字列エレメントとして含む配列。"wav"]という配列をもつ。インストールするプラグインを定めるFunctionオブジェクト(クラス)。サウンドを再生し、コントロールするSoundInstanceオブジェクトを返す。サウンドが再生できない場合でも、SoundInstanceオブジェクトは返される。そのSoundInstance.playStateプロパティの値がSoundJS.PLAY_FAILEDになる。サウンドが再生できなくても、SoundJS.play()メソッドは呼出せる。再生できないのは、チャネルが足りないことによる場合もあるため。再生するサウンドのパス(src)または識別子(id)を示す文字列。同じサウンドを再生している別インスタンスを止めるかどうか決める文字列。SoundJS定数で定める(表001)。サウンドの再生が始まるまでの待ち時間を定めるミリ秒数。サウンドの再生開始位置を定めるミリ秒数。サウンドが最後まで再生されたとき、初めに戻って繰返す回数。デフォルト値は0で、繰返さない。-1を定めると、繰返し続ける。サウンドの音量を定める0から1(デフォルト値)までの数値。サウンドのパンがサポートされるとき、その低位を定める-1から1までの数値。-1が左で、1が右を示す。コントロールするSoundInstanceオブジェクト。すべてのインスタンスを一時停止する。コントロールするサウンドを定めた識別子(id)。コントロールするSoundInstanceオブジェクト。すべてのインスタンスを再開する。SoundJS.pause()メソッドの呼出しにより一時停止していたインスタンスが再開される。コントロールするサウンドを定めた識別子(id)。コントロールするSoundInstanceオブジェクト。SuiteのSoundJSクラスを使うと、さまざまな種類のサウンドが再生できます。外部のサウンドファイルを読込むには、PreloadJSクラスが使えます。PreloadJSクラスでサウンドファイルをロードする手順は、画像など他の形式のデータの読込み方と基本的に同じです。詳しくは、「PreloadJSで外部画像ファイルの読込みを待つ」をお読みください。SoundJSクラスが扱うサウンドのデータ形式はいくつかあり、それぞれについて異なるプラグインを定めなければなりません。そこで、サウンドファイルを読込むときに、PreloadJS.installPlugin()メソッドによりプラグインを登録します。メソッドの引数には、読込んだデータを扱うクラスが渡されます。ここで用いるのはSoundJSですから、このクラスそのものを引数に定めます。PreloadJSオブジェクト.installPlugin(SoundJS)読込んだサウンドを再生するのは、静的メソッドSoundJS.play()です。引数には、再生するサウンドのパスもしくは識別子(id)を渡します。SoundJSクラスは、静的なプロパティとメソッドから成立ちます。SoundJS.play(サウンドの指定)SoundJSクラスは、すべてのサウンドをまとめて操作します。ひとつひとつのサウンドはSoundInstanceオブジェクトとして扱われ、SoundJS.play()メソッドが返す値です。再生されているサウンドの一時停止とその再開には、それぞれ静的メソッドSoundJS.pause()とUSoundJS.resume()を呼出します。引数はいずれも、再生するサウンドを定める識別子です(SoundJS.play()メソッドの第1引数と同じ)。例HTMLドキュメントと同じ場所のフォルダ(sounds)に納めたMP3サウンドファイル(music.mp3)を、読込んで再生します。body要素にはinput要素のボタンを置き(図001)、そのonLoadハンドラで初期設定の関数(initialize())を呼出します。body要素には、JavaScriptで取得するためのid属性(control)が定めてあります。id="control"></body>script要素で読込むJavaScript(JS)ファイルは、PreloadJSとSoundJSからつぎの6つのクラスになります。Canvasはとくに使いませんので、EaselJSは要りません。行番号は、後にscript要素全体を掲げるコード001にもとづきます。src="soundjs/HTMLAudioPlugin.js"></script>まず、ロードしたMP3サウンドファイルを再生する処理です。初期設定の関数(initialize())は、PreloadJSインスタンス(loader)にPreloadJS.installPlugin()メソッドでプラグインを登録してから、AbstractLoader.onFileLoadイベントにハンドラ(soundLoaded())を定めたうえで、サウンドファイルを読込みます(第14〜17行目)。PreloadJS.loadFile()メソッドの引数に渡すオブジェクトには、ファイルのパス(src)と併せて、識別子(id)も定めました(第17行目)。ファイルのロードが済んで呼出されるハンドラ(soundLoaded())は、引数に受取ったイベントオブジェクト(eventObject)からサウンドファイルの識別子(id)を取出し、サウンドを再生する関数(startSound())の引数に渡して呼出します(第22〜23行目)。サウンド再生の関数(startSound())は、引数の識別子(sound)をそのままSoundJS.play()メソッドに渡して、サウンドの再生が始まります(第27行目)。{SoundJS.play(sound);}つぎに、再生されたサウンドを一時停止したり、再開する処理です。前述のとおり、SoundJS.pause()とSoundJS.resume()メソッドには、いずれも引数としてサウンドの識別子が要ります。そこで、その値(id)は、ボタンの参照(control)に変数(sound)として定めました(第22および第24行目)。サウンドを再生する関数(startSound())は、別に定めた関数(pauseNext())の呼出しにより、ボタンのonclickイベントに一時停止の関数(pauseSound())をハンドラとして定めます(第28行目)。ボタンをクリックするとハンドラが呼出されて、SoundJS.pause()メソッドで一時停止するとともに、ボタンのonclickイベントのハンドラを再開の関数(resumeSound())に書替えます(第31〜32行目)。サウンド再開のハンドラ(resumeSound())は、SoundJS.resume()メソッドでサウンドの続きを再生するとともに、ボタンクリックのハンドラを一時停止の関数(pauseSound())に戻します(第36〜37行目)。SoundJS.pause()とSoundJS.resume()メソッドを呼出すときには、前述のとおりボタンの変数(sound)に定めたサウンドの識別子を引数に用いています(第31および第36行目)。pauseSound;}上述の組立てで書き上がったscript要素全体は、以下のコード001のとおりです。サウンドの読込み・再生・一時停止の状況がわかるように、ボタンのラベルにテキストを加えています(第19、第33および第41行目)。SoundJS.play()メソッドの呼出しでループ(第5引数)を定めていませんので、サウンドが再生し終わると一時停止と再開のボタンは効果がなくなります。"一時停止";}</script>確認されている問題SoundJS.play()メソッドの呼出しによりつくられた(戻り値の)SoundInstanceオブジェクトは、サウンドが再生し終わってもメモリに残ったまま消えません[*1]。同じサウンドを改めて再生するとき、SoundJS.play()メソッドを呼出すことは避けましょう。一度再生したいサウンドは、SoundJS.play()メソッドの戻り値からとっておき、SoundInstance.play()メソッドを呼出せばインスタンスが使い回せます。again?」をご参照ください。