バージョン
Wwise SDK 2018.1.11
|
ゲームオブジェクトは、インターフェース、サウンド、トリガーなどの要素をアタッチすることのできるエンティティです。
ゲームオブジェクトは、 AkGameObjectID
(符号なし64ビットフィールド)として定義できます。IDは、0から0xFFFFFFFFFFFFFFDF(つまり符号付き整数として -33)までの範囲で、自由に選択できます。 ゲームオブジェクトID範囲0xFFFFFFFFFFFFFFE0(-32)から0xFFFFFFFFFFFFFFFF (-1) は、内部使用のために予約されています。オーサリングツールによって登録されたトランスポート・ゲーム・オブジェクトは、ゲームオブジェクトID 0xFFFFFFFFFFFFFFFE(-2)を使用するようになりました。
サウンドエンジンでトリガーされる各イベントは、ゲームオブジェクトに関連付けられています。イベントアクションが特定のゲームオブジェクトをターゲットとする場合、これらはすべて、 c\ AK::SoundEngine::PostEvent() 関数のパラメータとして渡されるゲームオブジェクトに関連付けられます。イベントアクションがゲームオブジェクトをターゲットとしない場合、これらは指定されたゲームオブジェクトを無視します。アクションが単一のゲームオブジェクトに影響を与える必要がある場合に、 AK::SoundEngine::PostEvent()
で指定されるゲームオブジェクトが有効でないと、アクションは実行されません。
各ゲームオブジェクトごとに関連付けられた3Dポジション、各スイッチグループごとにスイッチ、各 RTPC ごとに RTPC 値、特定のゲームオブジェクトごとに特定のアイテム(サウンドSFX、アクターミキサー、バスなど)に設定された複数の値(例えばボリュームなど)がある可能性があります。サウンドエンジンは、これらの値に関連付けられているゲームオブジェクトが登録解除されるまでこの情報を格納します。
ゲームオブジェクトを使用する前に、これらを登録する必要があります。ゲームオブジェクトが不要になった場合は、これらの登録を解除しなければなりません。ゲームオブジェクトの登録を解除しなくてもエラーは発生しませんが、(3Dポジション、RTPC、スイッチなどの)情報を格納することによりメモリが浪費されます。
AK::SoundEngine::RegisterGameObj()
関数が2バージョン存在します:
および
2番目の関数バージョンは監視を目的としています。これを使用すると、再生しているオブジェクトに関連付けられている実際名を表示するよう Wwise に指示が出されます。AK_OPTIMIZED
モードでは、2番目のバージョンはオブジェクト名を無視します。
以下2つの関数により、ゲームオブジェクトの登録が解除されます:
および
AK::SoundEngine::UnregisterAllGameObj()
は、各ゲームオブジェクトに設定されているすべてのパラメータの完全なクリーンアップを実行し、すべてのゲームオブジェクト関連付けを削除します。UnregisterGameObj()
は、単一のゲームオブジェクトに対して同様の処理を実行します。登録が解除されたゲームオブジェクトを再度使用する場合は、これを再登録する必要があります。
ゲームオブジェクトの統合例は、ゲームオブジェクト統合例 をご覧ください。