アクションイベントをプリペアする（Prepare Event方式）

このメソッドは、以下の場合に適しています。

メモリの使用量を抑えるため、メディアを非常に細かく分ける必要がある。
どのメディアアセットをどのSoundBankにアサインするのかを管理する手間を省きたい場合。

Action Eventの準備とは何でしょうか。PrepareEvent()関数を呼び出す時に、システムがそのAction Eventを分析して、このEventに関連するすべての構造やメディアがメモリにロードされているかを確認します。ロードされていなければ、システムが自動的に不足情報をディスクからストリーミングします。イベントのプリペア（用意）状態は、プリペア状態を明確に解除するまで、続きます。

	注釈
	事前にプリペア（用意）できるのは、アクションイベントだけです。PrepareEvent（プリペアイベント）方式はダイアログイベントに使えません。

この方式で最低1つのSoundBankを作成する必要がありますが、構造部分はイベントと同じバンクに入れることも全く別のSoundBankに入れることもできます。

PrepareEventメカニズムを使用するSoundBankを構築するときの条件は、必要なイベントや構造が必ず1つ以上のSoundBankに存在することと、個別のメディアアセットがファイルシステムでアクセスできることです。なお、構造データを複数のSoundBankに分割して入れると、メモリ効率が改善されます。

Prior to preparing an Action Event, the Event itself must have been loaded into memory from one SoundBank (using LoadBank()). これは、イベントの中に、そのイベントをプリペアするための前提条件が入っているからです。

注釈

AK::SoundEngine::PrepareBankと組み合わせて、イベントをプリペアすることも可能です。PrepareBankメカニズムを使う最大の利点は、バンクをイベント用バンクと、メディア用バンクに分ける必要がないことです。このメソッドでは、全てのコンテンツを同じSoundBankに入れますが、AK::SoundEngine::PrepareBankが呼び出された時に、メモリにロードされるのはバンクのメタデータコンテンツだけです。ゲーム側でメディアが必要になれば、PrepareEventを使ってロードできます。

イベントをプリペアする場合に、SoundBankを設定するには:

"Event"というサウンドバンクを1つ作成して、SoundBank Editorにロードする。
「Event」サウンドバンクにプロジェクトのアクションイベントをいくつか追加するか、単純にイベントのワークユニットををいくつか追加します。

Media 列のチェックボックスを外し、Events列とStructures列のチェックボックスだけを選択したままにする。 PrepareEvent()を使用する場合は、メディアをバンクでなくディスクから直接ロードする必要がある。

注釈

今回の例では、全てのイベントと構造を1つのSoundBankに入れてあります。これは小規模なプロジェクトでは可能ですが、一般的には、コンテンツを複数のSoundBankに分割した方が良いでしょう。またそれぞれのイベントにロードすべき他のサウンドバンクへのレファレンスが含まれるため、改めてロードしたりSDKコマンドから準備しなくてもよい構造用バンクを別に作成することもできます。

これらのSoundBankを生成して、生成されたSoundBankフォルダを、ゲームアプリケーションにコピーする。

注釈

1つのSoundBankに入っている構造データを、ランタイムに分割することはできません。このため、AK::SoundEngine::PrepareEvent()を使用している時に、ほかのSoundBankに入っている構造データが必要になると、そのSoundBankに入っているすべての構造データが一度にロードされます。事前にプロジェクトの構造データを複数のSoundBankに分割すると、メモリにロードされてしまう不要な情報の量を抑えることができます。

Integration

For integration details, see Preparing Action Events in the Wwise SDK documentation.

Additional notes on this method

AK::SoundEngine::PrepareEvent() の呼び出し（Call）は、I/Oファンクションの呼び出しとして扱われます。前例では、ブロッキングファンクション（Blocking function）を使いました。AK::SoundEngine::PrepareEvent()関数の他のオーバーロードを使い、非ブロッキング呼び出しにして、別のコールバックで、完了通知を回復（Revive）できます。

The following table lists the pros and cons of preparing Action Events.

メリット	デメリット
SoundBankの生成プロセスがシンプルである。メディアを非常に細かく分割できる。全体的なメモリの節約を維持できる。プロセスを自動化しやすい。	メディアアセットを1つ1つロードするため、ディスクの読み込みとシークの回数が増える可能性がある。使用されるメモリの合計量の制御が減少します。 Interactive Music の操作は複雑になります。

メリット

デメリット

SoundBankの生成プロセスがシンプルである。

メディアを非常に細かく分割できる。

全体的なメモリの節約を維持できる。

プロセスを自動化しやすい。

メディアアセットを1つ1つロードするため、ディスクの読み込みとシークの回数が増える可能性がある。

使用されるメモリの合計量の制御が減少します。

Interactive Music の操作は複雑になります。

このページはお役に立ちましたか？

サポートは必要ですか？

ご質問や問題、ご不明点はございますか？お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう

Wwiseヘルプ