Audio Source Component
The audio source component is an Audio Component that can play sound from a point in the scene. It can also play sounds with no in-world position, such as background music.
The component includes a button in the inspector to preview the sound relative to the camera's position. This can be used to hear how the component's settings will affect the sound without needing to enter play mode.
Component Settings
| Property | Description |
|---|---|
| General | |
| Audio Source Type | The type of the audio source. Choose SFX for any sound that play in the scene and Music for any music tracks. This affects which volume settings will apply to this audio source. |
| Audio Clip | The audio clip or sound file to play. |
| Playing | |
| Play On Awake | The audio source will start playback as soon as the game starts. |
| Loop | Should the audio source play the audio clip on repeat once it has started. |
| Pitch | Adjust the pitch of the audio clip playback. This will also change the speed of playback, with higher pitches playing the sound faster and lower pitches taking longer to play. |
| Sound | |
| Volume | The loudness of the sound. |
| 2D/3D Sound Blend | The ratio of the sound being played in "2D" vs "3D". 2D sounds can be heard from anywhere and will be heard with no direction. I.e. the position of the audio source doesn't influence the sound. |
| Stereo panning | (2D sound only) How the sound should be split between the left and right ear.
|
| Rolloff Mode | (3D sound only) How the volume of the sound should decrease off over time. The volume will follow this type of curve from the Min Distance to the Max Distance. |
| Min Distance | (3D sound only) The minimum distance before the volume begins to drop off. When closer than this distance the full volume is used. After this distance, the volume drops off according to the Rolloff Mode until the Max Distance. |
| Max Distance | (3D sound only) The maximum distance before the audio source cannot be heard anymore. (Note: When using Logarithmic rolloff mode, the audio will still be audible beyond this point, but will be extremely quiet). |
| Use Doppler Effect | (3D sound only) Should this audio source use the Doppler Effect. |
Example Usage
Playing spatial music or ambience
You can use the audio source to play music or ambience in one part of the scene. You could play the sound of frogs croaking near a pond, or some music near a radio, but set the 3D sound Max Distance small so that it drops off when not nearby.
If you instead want general looping background music or ambience that can be heard from everywhere, you can set these using the Mod Settings.
Playing sound mid-game
You can make an audio source play while the game is running at a specific time by using a Play Sound Action. The play sound action will play a sound globally by default, but if you set the action's Target to Advanced and set an Audio Source as the advanced target, it will cause the audio source to play the sound, or cause the audio source to play its own sound if no clip is provided to the play sound action.