Using Event Cues

Warning: you were redirected to the latest documentation corresponding to your major release ( 2022.1.17.8543 ). 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.

Using Event Cues

You can add Action Events, not Dialogue Events, anywhere on the Music Segment timeline. When the Music Segment plays, the added Events are automatically triggered when the Play Cursor reaches the point on the timeline where the Event is added. You can drag an Event from the Project Explorer's Events tab, use the shortcut menu, or copy and paste Event cues already in the timeline.

	Note
There may be a noticeable lack of synchronization between the sound played by an Event Cue and the Music Segment. This is generally most pronounced during playback in Wwise authoring, but may also be perceptible in game at runtime. If precise synchronization is required, a Stinger should be used instead of an Event Cue. Refer to Using Stingers for details. Additionally, a triggered Event could play a sound that continues to play even after the end of the Music Segment has been reached.

Note

There may be a noticeable lack of synchronization between the sound played by an Event Cue and the Music Segment. This is generally most pronounced during playback in Wwise authoring, but may also be perceptible in game at runtime. If precise synchronization is required, a Stinger should be used instead of an Event Cue. Refer to Using Stingers for details.

Additionally, a triggered Event could play a sound that continues to play even after the end of the Music Segment has been reached.

	Dragged Events auto-fit for optimal spacing.
	Icon indicates the action type of the Event.
	Here the cursor is dragging an Event into the timeline. If the Event is valid, this is confirmed by an arrow, as shown. Otherwise a prohibition symbol appears.

To drag an Event into a Music Segment:

Go to the Designer layout (Layouts > Designer, F5).
From the Project Explorer's Interactive Music Hierarchy, select or create a Music Segment with at least one child Music Track, then double-click it.
The Music Segment Editor loads with the Music Segment.
From the Project Explorer's Events tab, select or create an Event, then click and drag it into the Music Segment Editor timeline.
If the Event is valid, an arrow indicator will appear in the timeline. If it is invalid, such as the circular reference case of dragging in an Event that would call this Music Segment, a no symbol indicator will appear in the timeline.
Assuming a valid Event, release your click at the appropriate timeline position.
The Event cue appears like a small flag within the Music Track.

To add an an Event cue to a Music Segment with the shortcut menu:

Go to the Designer layout (Layouts > Designer, F5).
From the Project Explorer's Interactive Music Hierarchy, select or create a Music Segment with at least one child Music Track, then double-click it.
The Music Segment Editor loads with the Music Segment.
In the Music Segment Editor, right-click the Music Track where you want to add an Event cue.
The shortcut menu appears.
From the shortcut menu, select Add Music Event Cue….
The Project Explorer Browser is prompted with the Events tab content.

Select the desired Post Event.

A new Event cue is added to the location you selected on the timeline.

	Change the Event Cue's Post Event Target
If the type of Post Event you wanted was not available in the Browser, you can create one. You don't have to go back to the Events tab to do so, you can prompt the shortcut menu from an Event cue and click Set Post Event Target. This will prompt a submenu from which you can choose another existing Event or create a new one. After that, the Event cue will be updated to be associated with the new Post Event Target.

Change the Event Cue's Post Event Target

If the type of Post Event you wanted was not available in the Browser, you can create one. You don't have to go back to the Events tab to do so, you can prompt the shortcut menu from an Event cue and click Set Post Event Target. This will prompt a submenu from which you can choose another existing Event or create a new one. After that, the Event cue will be updated to be associated with the new Post Event Target.

	Tip
	You cannot add Events from the shortcut menu while the Music Segment is playing, even if it's paused. Be sure to stop the Music Segment first.

To copy and paste an Event cue:

Select an Event cue in the Music Track.
Press Ctrl+C to copy it.
Right-click the Music Track timeline where you want to add the copied Event cue.
Press Ctrl+V to paste it.
A new Event cue is added to the location you selected on the timeline.

Like any other Music Segment cue, you are free to drag the Event cue where you want on the timeline. If it happens to overlap with another Event cue, Wwise will automatically adjust their spacing to fit optimally. If there are more than four overlapping Event cues, their labels will disappear to allow Wwise to resize them to fit.

Related Topics

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.

Get started with Wwise

Wwise Help

Using Event Cues

Using Event Cues

Was this page helpful?

Need Support?

Tell us about your project. We're here to help.