# startSound

[Built-ins](README.md)

Canonical ID: `media.startSound`. Nederlands: `startGeluid`.

Starts a project sound on a named track. Reusing the name replaces its audio and preserves its volume.

## Signature

```text
startSound(track, asset, loop = false)
```

## Example

```pliro
# language: en
startSound("wind", "assets/wind.wav", true)
wait(3)
stopTrack("wind")
```

## Values and host support

Audio calls return `None` and do not block. Volumes are finite numbers from 0 to 100. Track names are case-sensitive text, 1–64 Unicode code points, with no control characters and not only whitespace. There are at most 16 named tracks and 32 simultaneous voices. Notes use `C4`, `C#4`, `Bb3` or `R`; a score adds `:beats`. Beats range from 1/64 to 64; tempo is 20–400. Instruments include `chip`, `bell`, `pluck`, `flute`, `drums` and the 128 exact `gm.` instrument IDs in the instrument picker. See the music guide for score bounds and lifetime.

Sounds use packaged project paths, not arbitrary files or URLs. A WAV example requires that asset in the `.bipli` project. Native Windows/Linux/Pi supports bounded PCM WAV; other codecs depend on the IDE/browser. Synthesis requires no asset. The text-only CLI and phone preview do not play this audio.

[Music and sound](../guides/music.md)