Other Documentation

Wwise SDK 2022.1.4

◆ SetMultiplePositions() [1/2]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::SetMultiplePositions ( AkGameObjectID  in_GameObjectID,
const AkChannelEmitter in_pPositions,
AkUInt16  in_NumPositions,
MultiPositionType  in_eMultiPositionType = MultiPositionType_MultiDirections,
AkSetPositionFlags  in_eFlags = AkSetPositionFlags_Default 

Sets multiple positions to a single game object, with flexible assignment of input channels. Setting multiple positions on a single game object is a way to simulate multiple emission sources while using the resources of only one voice. This can be used to simulate wall openings, area sounds, or multiple objects emitting the same sound in the same area.

Note: Calling AK::SoundEngine::SetMultiplePositions() with only one position is the same as calling AK::SoundEngine::SetPosition()
  • AK_Success when successful
  • AK_CommandTooLarge if the number of positions is too large for the command queue. Reduce the number of positions.
  • AK_InvalidParameter if parameters are not valid.
See also
in_GameObjectID Game Object identifier.
in_pPositions Array of positions to apply, each using its own channel mask.
in_NumPositions Number of positions specified in the provided array.
in_eMultiPositionType AK::SoundEngine::MultiPositionType
in_eFlags Optional flags to independently set the position of the emitter or listener component.

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