Version
menu_open
Wwise SDK 2024.1.0
Quick Start Sample Integration - Game Objects

Game Object Example

For an overview of Game Objects, please refer to Understanding game objects.

Game objects must be registered before you can use them to post events, set positions, and so on. The following code registers two game objects with predefined IDs. Note that you can use any 64-bit unsigned integer ID ranging from 0 to 0x‭FFFFFFFFFFFFFFDF you want, such as an incremented counter or an object pointer cast into an AkGameObjectID.

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" );

When a game object becomes obsolete, for example when the corresponding entities are removed from the game's world, you should unregister them to free up any resources that might be associated with them:

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

Refer to Integration Details - Game Objects for more information on game objects.

Note: This sample code comes from the Sound Engine Integration Sample Project available in the Samples section. Refer to Integration Demo Sample for more information.
AkGameObjectID
AkUInt64 AkGameObjectID
Game object ID.
Definition: AkTypes.h:60
AK::SoundEngine::RegisterGameObj
AKSOUNDENGINE_API AKRESULT RegisterGameObj(AkGameObjectID in_gameObjectID)
AK::SoundEngine::UnregisterGameObj
AKSOUNDENGINE_API AKRESULT UnregisterGameObj(AkGameObjectID in_gameObjectID)

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise