Struct rrise::sound_engine::PostEvent

pub struct PostEvent<'a> { /* private fields */ }

Helper to post events to the sound engine.

Use PostEvent::post to post your event to the sound engine.

The callback function can be used to be noticed when markers are reached or when the event is finished.

An array of Wave file sources can be provided to resolve External Sources triggered by the event.

Return The playing ID of the event launched, or AK_INVALID_PLAYING_ID if posting the event failed

Remarks

• If used, the array of external sources should contain the information for each external source triggered by the event. When triggering an Event with multiple external sources, you need to differentiate each source by using the cookie property in the External Source in the Wwise project and in AkExternalSourceInfo.
• If an event triggers the playback of more than one external source, they must be named uniquely in the project (therefore have a unique cookie) in order to tell them apart when filling the AkExternalSourceInfo structures.

See also

• render_audio
• [get_source_play_position]

Implementations

impl<'a> PostEvent<'a>

pub fn from_event_name(
    game_obj_id: AkGameObjectID,
    name: &'a str
) -> PostEvent<'_>

Select an event by name, to play on a given game object.

pub fn from_event_id(
    game_obj_id: AkGameObjectID,
    id: AkUniqueID
) -> PostEvent<'a>

Select an event by id, to play on a given game object.

pub fn add_flags(&mut self, flags: AkCallbackType) -> &mut Self

Add flags before posting. Bitmask: see [AkCallbackType].

pub fn flags(&mut self, flags: AkCallbackType) -> &mut Self

Set flags before posting. Bitmask: see [AkCallbackType]

pub fn playing_id(&mut self, id: AkPlayingID) -> &mut Self

Advanced users only. Specify the playing ID to target with the event. Will Cause active actions in this event to target an existing Playing ID. Let it be AK_INVALID_PLAYING_ID or do not specify any for normal playback.

pub fn post(&self) -> Result<AkPlayingID, AkResult>

Posts the event to the sound engine.

Trait Implementations

impl<'a> Clone for PostEvent<'a>

fn clone(&self) -> PostEvent<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for PostEvent<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Copy for PostEvent<'a>