# playSound

[Built-ins](README.md)

Canonical ID: `media.playSound`. Nederlands: `speelGeluid`.

Requests playback of a packaged project sound. The desktop project importer accepts WAV, MP3, OGG, and M4A; actual playback belongs to the host. There is no returned sound handle, volume parameter, pause/stop API, or guarantee that playback completes before the next statement. Current native builds reject this capability instead of silently dropping sound.

## Signature

```text
playSound(asset)
```

## Arguments

| Parameter | Type | Requirement |
|---|---|---|
| `asset` | Text | Nonempty packaged project-relative asset path, normally under assets/. |

## Return value

`None`.

## Example

```pliro
# language: en
playSound("assets/chime.wav")
say "Pliro"
```

Import `assets/chime.wav` and use the desktop [IDE](../concepts/ide.md) sound host. The output statement follows the playback request.

## Notes and common mistakes

Use the function name for your source language. Its [canonical ID](../concepts/canonical-identity.md) is a shared documentation label; you do not type that ID as a call. Giving your own variable or function the same name can hide the built-in. Supply the documented [arguments](../concepts/parameters-and-arguments.md) and value types. Pliro reports mismatches when checking can detect them, or when the call runs.

A **host** is the app or environment running your program. To see a drawing, it needs a **renderer**, the part that draws on screen. The [command-line](../concepts/command-line.md) command `pliro run` shows text but does not draw these graphics. The [host support table](../guides/hosts.md) explains which effects work in the IDE, browser, native app, and phone preview. A native build reports an unsupported capability instead of leaving it out.

The example requires the named files inside a .bipli project. Packaged assets are currently limited to 12 MiB each. Paths under assets/ are project references, not arbitrary files or URLs. Current native export does not implement playSound.

## Related entries

[showImage](showImage.md) · [Programming guides](../guides/assets.md) · [Host support](../guides/hosts.md) · [Calls and arguments](../syntax/calls.md)