# Sounds Sound is a great way to provide feedback to player actions and events, background sounds can also give your scene more context and improve the player's immersion into it. {% hint style="warning" %} **📔 Note**: Keep in mind that sounds are only heard by players who are standing within the parcels that make up the scene where the sound was generated, even if they would otherwise be in hearing range. Players can also chose to turn off all sounds on their settings. {% endhint %} Supported sound formats vary depending on the browser, but it's recommended to use *.mp3*. *.wav* files are also supported but not generally recommended as they are significantly heavier. ## Play sounds The easiest way to play a sound is to add an **Audio Source** component visually on the [Scene Editor in Creator Hub](https://github.com/decentraland/docs/blob/main/creator/sdk7/scene-editor/get-started/about-editor.md) and set it to **Start Playing** and **Loop**. See [Add Components](https://github.com/decentraland/docs/blob/main/creator/sdk7/scene-editor/build/components.md#add-components). ![](https://45449780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ae588633ad20c357cfcb71a63216e4b8e02802ae%2FAudioSource-component.png?alt=media) You can also trigger the playing of a sound in a no-code way via **Actions**, see [Make any item smart](https://github.com/decentraland/docs/blob/main/creator/sdk7/scene-editor/interactivity/make-any-item-smart.md). To play a sound via code, use the `AudioSource.playSound` function. ```ts // Create entity const sourceEntity = engine.addEntity() // Play sound AudioSource.playSound(sourceEntity, 'assets/sounds/sound-effect.mp3') ``` The sound file must be inside the project folder. In the example above, the audio file is located in an `assets/sounds` folder, which is located at root level of the scene project folder. {% hint style="warning" %} **📔 Note**: The `AudioSource` component must be imported via > `import { AudioSource } from "@dcl/sdk/ecs"` See [Imports](https://github.com/decentraland/docs/blob/main/creator/sdk7/sdk7/getting-started/coding-scenes.md#imports) for how to handle these easily. {% endhint %} The `AudioSource.playSound()` function takes the following arguments: * `entity`: On what entity to apply the sound. The sound will be heard from this entity's position, meaning it gets louder as the player approaches it. * `src`: The location of the sound file within your project. {% hint style="info" %} **💡 Tip**: For more clarity, we recommend keeping your sound files separate in a `assets/sounds` folder inside your scene. {% endhint %} * `resetCursor`: *(optional)* If true, the sound always starts from the beginning. Otherwise it continues from the current cursor position. Useful for pausing and resuming. Another way to play sounds is to manually create an `AudioSource` component on an entity. Use this approach to have more control over the sound, for example to make it loop or set the volume. ```ts // Create entity const sourceEntity = engine.addEntity() // Create AudioSource component AudioSource.create(sourceEntity, { audioClipUrl: 'sounds/sound-effect.mp3', loop: true, playing: true, }) ``` The following properties can be set: * `audioClipUrl`: The location of the sound file within your project. * `playing`: If true, the sound starts playing. You can create a sound with `playing` set to false, and then set it to true at a later time. * `volume`: *(optional)* The volume of the sound file. 1 by default, which is full volume. * `pitch`: *(optional)* Modify the pitch of a sound. 1 is the default, make it lower for a deeper sound and higher for a higher pitch sound. {% hint style="info" %} **💡 Tip**: To prevent a sound effect from becoming too repetitive during a game, it's useful to randomize some slight variations to the sound's pitch every time it plays. {% endhint %} * `currentTime`: *(optional)* 0 by default. Set this value to avoid starting from the beginning of the sound file. Each entity can only have a single `AudioSource` component, that can only play a single clip at a time. This limitation can be easily overcome by modifying the audio source at the time of playing a new sound, or by including multiple invisible child entities, each with their own sound. {% hint style="warning" %} **📔 Note**: Sounds are played on each player's local instance. Other nearby players won't hear the same sounds unless their local scene explicitly plays them too. {% endhint %} ### Pre Loading a Sound If an entity uses a sound, but is not played immediately at scene runtime, it might take some time to download. It can be available at scene runtime by using the `AssetLoad` component. ```ts import { AssetLoad } from "@dcl/sdk/ecs" AssetLoad.create(engine.RootEntity, { assets: [ "assets/scene/bundle1/explosionSound.mp3", ], }) ``` For more information, check the [Pre Load Resources](https://github.com/decentraland/docs/blob/main/creator/sdk7/optimizing/pre-load-resources.md) documentation. ## Stopping sounds To stop an entity from playing its sound, use the `AudioSource.stopSound()` function. You only need to specify the entity, since each entity has a single `AudioSource` component, and each `AudioSource` component plays a single file at a time. ```ts AudioSource.stopSound(sourceEntity) ``` Another way to stop a sound is to set the `playing` property to false. ```ts // Create entity const sourceEntity = engine.addEntity() // Create AudioSource component AudioSource.create(sourceEntity, { audioClipUrl: 'sounds/explosion.mp3', playing: true, }) // Define a simple function function stopSound(entity: Entity) { // fetch mutable version of audio source component const audioSource = AudioSource.getMutable(entity) // modify its playing value audioSource.playing = false } // call function stopSound(sourceEntity) ``` ## Looping To keep a sound playing in a continuous loop, set the `loop` field of the `AudioSource` component to *true* before you start playing it. ```ts // Create entity const sourceEntity = engine.addEntity() // Create AudioSource component AudioSource.create(sourceEntity, { audioClipUrl: 'sounds/sound-effect.mp3', playing: true, loop: true, }) ``` Looping sounds is especially useful for adding background music or other background sounds. ## Set volume You can set the `volume` property of the `AudioSource` component to change the volume of a sound. The volume is expressed as a number from *0* to *1*. ```ts // Create entity const sourceEntity = engine.addEntity() // Create AudioSource component AudioSource.create(sourceEntity, { audioClipUrl: 'sounds/sound-effect.mp3', playing: true, volume: 0.5, }) ``` {% hint style="warning" %} **📔 Note**: Of course, the volume of a sound is also affected by the distance of the player from the audio source. As the player walks away, the volume will be lower. {% endhint %} ## Global sounds By default, all sounds from an `AudioSource` are positional. This means they appear to generate from the position of the `Transform` component, and will sound louder as the player walks closer. But you can also configure a sound to be global, so that the volume is constant, no matter where the player is standing. This is ideal for using on background music, notification sounds, and other non-positional sound. {% hint style="warning" %} **📔 Note**: Global Sounds are a feature that's only supported in the DCL 2.0 desktop client. {% endhint %} To make a sound global, set the `global` property to *true*. ```ts AudioSource.create(sourceEntity, { audioClipUrl: 'sounds/music.mp3', playing: true, global: true, }) ``` ## Play a segment of a sound To play a segment of a longer sound file, use the `playSoundSegment()` in the SDK Utils library. See [SDK7 Utils](https://github.com/decentraland/sdk7-utils). You can also achieve this by explicitly set the `currentTime` property on an `AudioSource` component, and then stopping it after waiting for a period of time. ## Audio streaming See [Audio streaming](https://github.com/decentraland/docs/blob/main/creator/sdk7/sdk7/media/audio-streaming.md) to learn how you can play a live audio stream from an external source.