Version

menu_open
Advanced Settings Tab: Music Objects

The Advanced Settings tab for music objects located in the Interactive Music Hierarchy contains a series of controls that allow you to define the advanced playback behaviors of your music objects. You can define the number of instances that can be played simultaneously per game object, specify the playback priority of each sound object, and determine whether the music will continue to play, will be killed, or will move into the virtual voice list when its volume falls below the volume threshold.

General

Interface Element

Description

Inclusion

Determines whether the element is included or excluded. When selected, the element is included. When unselected, the element is not included. By default, this applies across all platforms. Use the Link indicator (to the left of the check box) to determine or to set platform-specific customizations.

When this option is unselected, the property and behavior options in the Property Editor become unavailable.

Default value: true

[name]

The name of the object.

Notes

Any additional information about the object properties.

Controls the Mute and Solo states for the object and shows the implicit mute and solo states for the object.

Muting an object silences this object for the current monitoring session. Soloing an object silences all the other objects in the project except this one.

A bold M or S indicates that the Mute or Solo state has been explicitly set for the object. A non-bold M or S with faded color indicates that the object's Mute or Solo state was implicitly set from another object's state.

Muting an object implicitly mutes the descendant objects.

Soloing an object implicitly mutes the sibling objects and implicitly solos the descendant and ancestor objects.

[Tip] Tip

Hold the Ctrl key while clicking a solo button to exclusively solo the object for which the solo button is associated.

[Note] Note

Mute and Solo are designed to be used for monitoring purposes only and are not persisted in the project or stored in the SoundBanks.

Sets the display of the Property Editor's selected tabs. By default, there is one panel displaying only one selected tab. You can, however, click a splitter button to split the panel into two, either side by side or one on top of the other, for two different tabs. The currently selected option is highlighted with a background color.

[Note] Note

You cannot display the same tab in both panels. If you select the tab that is currently displayed in the other panel, then the other panel will automatically display another tab.

[Tip] Shortcuts for selecting tabs

Press Ctrl and the number corresponding to the number of the Property Editor tab you want. For example, Ctrl+4 would select the RTPC tab if that were the fourth visible tab.

Advanced Settings

Interface Element

Description

 

Playback Limit

Ignore Parent Playback Limit

Determines if the current object and its children are considered part of the parent’s playback limit (unchecked) or defined at this level (checked). If the object is a top-level object, this option is unavailable.

Default value: false

Limit sound instances to:

The number of sound or motion instances within the same hierarchical structure that can play simultaneously. This limit applies to the selected list option:

  • Per game object: Each game object, within this node of the hierarchy, individually.

  • Globally: All game objects, within this node of the hierarchy, combined.

When limit is reached:

Determines what happens when the playback limit is reached. You can select one of the following options:

  • Kill voice for lowest priority: Stops playing instance with the lowest priority. When an object is killed, a small fade out of a few milliseconds is performed.
  • Use virtual voice settings for lowest priority: Sets the sound with the lowest priority to adopt its virtual voice behavior. Refer to the Virtual voice behavior section in this table.

Keep in mind that each entity can override its own behavior so that the virtual behavior of a sound can still be to discard the sound or to continue to play.

Default value: Kill voice

When priority is equal:

Determines what happens when the playback limit is reached and there is more than one object with the lowest priority. You can select one of the following options:

  • Discard oldest instance to discard the oldest playing instance with the lowest priority.
  • Discard newest instance to discard the newest playing instance with the lowest priority.

Default value: Discard oldest instance

Virtual voice

Override parent

Determines whether the virtual voice settings will be inherited from the parent or defined at the current level in the hierarchy. When this option is not selected, the virtual voice controls are unavailable.

If the object is a top-level object, this option is unavailable.

Default value: false

Virtual voice behavior

Determines the behavior of objects when their volume falls below the volume threshold or when their number goes over the playback limit. You can select one of the following options:

  • Continue to play to continue playing the object even though it will no longer be heard.
  • Kill voice to stop playing the object. No fade out is applied with this option.
  • Send to virtual voice to send the object to the virtual voice list. When an object is sent to the virtual voice list, certain parameters of the object are monitored by the sound engine, but no processing for audio or motion occurs.
  • Kill if finite else virtual to stop playing the object if it’s not looping infinitely or, if it is, to send the object to the virtual voice list. For this option, the On return to physical voice behavior is automatically set to Play from elapsed time, regardless of the displayed behavior defined at a parent level.

Default value: Continue to play

On return to physical voice

[Note] Note

These options are only available if the Send to virtual voice option is enabled.

Determines the behavior of objects that move from the virtual voice list back to the physical voice.

You can select one of the following options:

  • Play from beginning to play the object from its beginning. This option resets the object’s loop count.
  • Play from elapsed time to continue playing the object as if it had never stopped playing. This option is not sample accurate, so sounds returning to the physical voice may be out of sync with other sounds playing.
  • Resume to pause the object when it moves from the physical voice to the virtual voice list and then resume playback when it moves back to the physical voice.

Default value: Play from elapsed time

Playback Priority

Override parent

If the object is a top-level object, this option is unavailable.

Determines whether the Playback Priority will be inherited from the parent or defined at the current level in the hierarchy. When this option is not selected, the Playback Priority controls are unavailable.

Default value: false

Priority

Objects with a priority of 1 have the lowest priority, and those with a priority of 100 have the highest priority.

This value determines which objects will be played when the playback limit has been reached.

The importance given to the object in relation to other objects within the same actor-mixer structure.

Default value: 50
Range: 0 to 100

Offset priority by x at max distance

Specifies a value by which the priority of an object is offset when it reaches the max distance value specified in the Attenuation Editor.

When selected, an offset is applied to the priority of the object when it falls anywhere within the attenuation max distance value. The amount of offset applied will depend on the object’s relative position to the listener.

When this option is not selected, the distance from the listener does not affect the priority of an object.

Default value: -10
Range: -100 to 100


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