Version

menu_open
Advanced category: music objects

The properties in the Advanced category for music objects located in the Interactive Music Hierarchy include 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.

Advanced

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

The number of sound or motion instances within the same hierarchical structure that can play simultaneously.

Default value: false

Sound Instance Limit

Default value: 50

Range: 1 to 1000

Limitation 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.

Default value: Per game object

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 music objects, if Send to virtual voice or Kill if finite else virtual is selected, the object plays from elapsed time upon return to physical voice.

Default value: Continue to play

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

Use Priority Distance Factor

Default value: false

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