playSound
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
playSound(asset)
Arguments
| Parameter | Type | Requirement |
|---|---|---|
asset |
Text | Nonempty packaged project-relative asset path, normally under assets/. |
Return value
None.
Example
# language: en
playSound("assets/chime.wav")
say "Pliro"
Import assets/chime.wav and use the desktop IDE sound host. The output statement follows the playback request.
Notes and common mistakes
Use the function name for your source language. Its canonical ID 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 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 command pliro run shows text but does not draw these graphics. The host support table 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 · Programming guides · Host support · Calls and arguments