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.
Wwise SDK 2023.1.8

◆ PrepareGameSyncs() [1/4]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::PrepareGameSyncs ( PreparationType  in_PreparationType,
AkGroupType  in_eGameSyncType,
AkUInt32  in_GroupID,
AkUInt32 in_paGameSyncID,
AkUInt32  in_uNumGameSyncs 
)

Prepares or unprepares game syncs synchronously (by ID).
The group and game syncs are specified by ID (refer to General Information for a discussion on using strings and IDs). The game syncs definitions must already exist in the sound engine by having explicitly loaded the bank(s) that contain them (with LoadBank()). A request is posted to the Bank Manager consumer thread. It will resolve all dependencies needed to successfully set this game sync group to one of the game sync values specified, and load the required banks, if applicable. The function returns when the request has been completely processed.

Returns
  • AK_Success: Prepare/un-prepare successful.
  • AK_IDNotFound: At least one of the event/game sync identifiers passed to PrepareGameSyncs() does not exist.
  • AK_InsufficientMemory: Insufficient memory to store bank data.
  • AK_BankReadError: I/O error.
  • AK_WrongBankVersion: Invalid bank version: make sure the version of Wwise that you used to generate the SoundBanks matches that of the SDK you are currently using.
  • AK_InvalidFile: File specified could not be opened.
  • AK_InvalidParameter: Invalid parameter, invalid memory alignment.
  • AK_Fail: Load or unload failed for any other reason. (Most likely small allocation failure)
Remarks
You need to call PrepareGameSyncs() if the sound engine was initialized with AkInitSettings::bEnableGameSyncPreparation set to true. When set to false, the sound engine automatically prepares all game syncs when preparing Events, so you never need to call this function.
See also
Parameters
in_PreparationTypePreparation type ( Preparation_Load or Preparation_Unload )
in_eGameSyncTypeThe type of game sync.
in_GroupIDThe State Group ID or the Switch Group ID.
in_paGameSyncIDArray of ID of the game syncs to either support or not support.
in_uNumGameSyncsThe number of game sync ID in the array.

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