Wwise SDK 2023.1.9

ゲームオブジェクト統合例

ゲームオブジェクトの概要については、ゲームオブジェクトを理解するをご覧ください。

ゲームオブジェクトをイベントのPost（送出）やポジション設定に使用する前に、これらを登録しておく必要があります。以下のコードにより、事前定義されたIDを持つゲームオブジェクトが2つ登録されます。なお、インクリメントカウンタやAkGameObjectID にキャストされるオブジェクトポインタなど、0から0x‭FFFFFFFFFFFFFFDFの範囲で、64ビットの符号なしの任意の整数IDを使用できます。

const AkGameObjectID GAME_OBJECT_ID_CAR = 100;
const AkGameObjectID GAME_OBJECT_ID_HUMAN = 200;
const AkGameObjectID GAME_OBJECT_ID_MARKERS = 300;
 
(...)
 
//
// Register game objects. Some global game objects might be registered
// at initialization time, but most of your game objects will probably
// be dynamically registered/unregistered as they appear/disappear in
// the game.
//
 
AK::SoundEngine::RegisterGameObj( GAME_OBJECT_ID_CAR, "Car" );
AK::SoundEngine::RegisterGameObj( GAME_OBJECT_ID_HUMAN, "Human" );
AK::SoundEngine::RegisterGameObj( GAME_OBJECT_ID_MARKERS, "MarkerTest" );

例えば、対応するエンティティがゲームから削除された場合など、ゲームオブジェクトが不要になると、ゲームオブジェクトの登録を解除してこれらに関連付けられている可能性のあるリソースを解放する必要があります：

AK::SoundEngine::UnregisterGameObj( GAME_OBJECT_ID_CAR );
AK::SoundEngine::UnregisterGameObj( GAME_OBJECT_ID_HUMAN );
AK::SoundEngine::UnregisterGameObj( GAME_OBJECT_ID_MARKERS );

ゲームオブジェクトに関する詳細は、統合の詳細 - ゲームオブジェクトをご覧ください。