Stage Music
stage_musicPlay, stop, or set the volume of a single audio source in a scene, including positional playback from a point in the room and starting at a chosen time.
Instructions
Play one audio file from a place in the room, positional (louder as the person walks up), or stop it, or set
its volume (page command: music). action: play | stop | volume (any value other than stop or volume plays). at is
an object to play from (its position, lifted by lift metres; none: the room origin). One music source at a time:
play replaces it. volume with nothing playing falls through to play and needs url. start: begin this many seconds
into the song. The song's time as heard is in the page state (music: {playing, url, t, duration, loop}) and from
stage_music_time; takes can play on it (stage_actor_play at_music). Page replies {playing, at, seconds, from} |
{stopped: true} | {volume}. Emits: music_start {url, from, seconds, at}, music_stop {url, at_s}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| ref | No | ||
| url | No | ||
| lift | No | ||
| loop | No | ||
| scene | Yes | ||
| start | No | ||
| action | No | play | |
| volume | No | ||
| rolloff | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |