Please be advised that the Audiokinetic offices will close at 5:00 p.m. EST on December 21st, 2018 for the holiday period, and will reopen on Thursday January 3rd, 2019 at 08:30 a.m. EST. Learn more.

Community Q&A

Where Wwise users help each other out!

Audiokinetic's Community Q&A is the forum where Wwise users ask and answer questions within the Wwise community. Contact Sales if your project requires a support plan.

Documentation: Valid AkGameObjectID range

0 votes
What is the valid range of values that an AkGameObjectID can have in Wwise SDK 2017.X.X?

In the Migration Notes it mentions that AkGameObjectID is now a 64-bit unsigned on all platforms, and that it can range from 0 to 0x‭FFFFFFFFFFFFFFDF‬ (-33).  See here ("The valid game object ID range has changed"):

https://www.audiokinetic.com/library/edge/?source=SDK&id=whatsnew__2017__1__migration.html

In the Integration Details for Game Objects, however, it seems to tell a different story.  It says AkGameObjectID is an unsigned 32-bit integer and that you can use any ID that is not 0x00000000, 0x00000001 or 0xFFFFFFFF (-1).  See here:

https://www.audiokinetic.com/library/edge/?source=SDK&id=soundengine__gameobj.html

This is probably just a case of documentation that wasn't updated.  I assume that the Migration Notes for 2017 takes precedent since AkGameObjectID is an AkUInt64 in the SDK, but I couldn't find any other values in the SDK that defines the valid/invalid ID range.  Should we enforce this ID range in our engine code?

Thanks,

Eric
asked Mar 12 in General Discussion by Eric P. (100 points)

1 Answer

0 votes

What is the valid range of values that an AkGameObjectID can have in Wwise SDK 2017.X.X?

There was some confusion and a slight change of direction when listener ids initially became part of the game object id address space. The answer to your question depends on X.X. from 2017.1.1 the answer is 0x0-0x‭FFFFFFFFFFFFFFDF for example.

| In the Integration Details for Game Objects, however, it seems to tell a different story.

This resource is out of date and should be updated.

Should we enforce this ID range in our engine code?

I'd strongly recommend it, I'd go lower than the current max for when they run out of space next i.e 0x0-0x‭‭7FFFFFFFFFFFFFFF is probably a reasonable max.

-

dan

answered Mar 26 by Dan M. (360 points)
Yes, the Integration Details - Game Objects page of the SDK doc needs to be updated. For our next patch release, Wwise 2017.2.3, it will be.
...