SoundWait
SoundWait (Statement)
Format
soundwait
soundwait player#
Description
Blocks the program until the sound has finished playing, while keeping the application (and the sound system's event loop) alive — so you will hear the sound through to the end.
- soundwait with no argument waits for the most recently played sound.
- soundwait player# waits for a specific sound instance, where player# is the integer id returned by SoundPlayer.
A backend-independent fallback is pause soundlength, which parks the program for the clip's length while the background player renders.
Example
soundplay "song.mp3"
print "waiting for the song to finish..."
soundwait
print "done."
See Also
Pause, Sound, SoundLength, SoundPlay, SoundPlayer, SoundState, SoundStop
Availability
BASIC-256 2.0 and later. Documented from the BASIC-256 v2.1 continuation project.