Version: 2023.2
Language : English
Audio Random Container fundamentals
Audio Profiler

Create a randomized playlist with the Audio Random Container

To create a randomized playlist, you must create an Audio Random Container and then play it in the game.

You can use a randomized playlist to randomize and play almost any sound, such as footsteps, impacts, and AI dialog.

Prerequisites

You can create and use a randomized playlist if you know how to do the following:

  • Create a GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
    See in Glossary
  • Add a button to the scene

Create an Audio Random Container

You can create an Audio Random Container from more than one place.

Note: If you drag an existing Audio Random Container to the Hierarchy, you create a GameObject at the Transform location (0,0,0) with an Audio Source component that references the dragged Audio Random Container.

From the menu

In the Unity Editor, do the following:

  1. Select Assets > Create > Audio > Audio Random Container.

An empty Audio Random Container asset appears in the Project windowA window that shows the contents of your Assets folder (Project tab) More info
See in Glossary
under Assets.

From the Project view

In the Unity Editor, do the following:

  1. Right click in the Project window to bring up the asset menu that contains a working menu item.
  2. Select Create.
  3. Select Audio.
  4. Select Audio Random Container.

An empty Audio Random Container asset appears in the Project window under Assets.

From the window

In the Unity Editor, do the following:

  1. Select Window.
  2. Select Audio.
  3. Select Audio Random Container.

An empty Audio Random Container asset appears in the Project window under Assets.

Play an Audio Random Container in the game

To play an Audio Random Container, you must integrate it with the Audio Source component and then play it, such as with one of the game trigger options.

Integrate with the Audio Source component

You can only use the Audio Random Container in conjunction with the Audio Source component. It’s the emitter for the Audio Random Container and determines whether the Audio Random Container has a position in the world or sounds like it doesn’t have a position. For more information, refer to Audio SourceA component which plays back an Audio Clip in the scene to an audio listener or through an audio mixer. More info
See in Glossary
.

To integrate, do the following:

  1. Create an Audio Random Container from the menu, the Project view, or the window.
  2. Create a GameObject.
  3. In the InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
    See in Glossary
    window, select Add Component.
  4. Select Audio > Audio Source.
  5. Next to AudioResource, choose the Audio Random Container you created.

You have integrated the Audio Random Container with the Audio Source component. You can play it with the PlayOnAwake bool, the API, or the different game trigger options.

Use game triggers

Sounds in games are often triggered by a game event or by a trigger. You can use game triggers, such as buttons, to play the Audio Random Container\:

  1. Add a button to a sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
    See in Glossary
    .
  2. In the Inspector window, select + to add an On Click event.
  3. Select the Audio Random Container.

Additional resources

Audio Random Container fundamentals
Audio Profiler