Version
menu_open
Warning: you were redirected to the latest documentation corresponding to your major release ( 2023.1.8.8601 ). Should you wish to access your specific version's documentation, please download the offline documentation from the Audiokinetic Launcher and check the Offline Documentation option in Wwise Authoring.

Unknown/Dead game object ID used in <FunctionName>. Make sure the game object is registered before using it and do not use it once it was unregistered.

This error occur when a API function requiring a Game Object ID is called with an unrecognized ID. The name of the function is provided for reference with the game code. If the Game Object was known at some point in the past, it will be written as "Dead Game Object", with the old name of the object displayed in the "Game Object" column. The lifetime of a Game Object starts with AK::SoundEngine::RegisterGameObj and stops with AK::SoundEngine::UnregisterGameObj. If the function call was made before or after those calls, it will result in this error.

Note that it is legal to have a call sequence such as:
AK::SoundEngine::RegisterGameObj(MyGameObjID);
AK::SoundEngine::PostEvent("Play_MySound", MyGameObjID);
AK::SoundEngine::UnregisterGameObj(MyGameObjID);

[Note]Note

If you are using the Unity game engine, the lifetime of a Wwise Game Object follows the lifetime of the AkGameObj component.

Probable causes:

  • The Game Object was never registered before the function call.

  • The Game Object was unregistered prior to the function call.

  • The Game Object ID is corrupted.

  • Unity Users: The "Script Execution Order" may be wrong, causing one of the situations above.

Recommended resolution steps:

  • Enable API Calls in the Profiler Settings. Then reproduce your scenario. In the Capture Log, the faulty call with all its parameters should appear just before the error.

  • Verify the lifetime of the Game Object with the Game Object 3D Viewer.

  • Change the order of function calls to be between the related RegisterGameObj and UnregisterGameObj .

  • Unity Users: Check the "Script Execution Order" in Unity.

See also:

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