PLAY
Syntax
PLAY <filename> {, <channel>} {, WAIT}
PLAY STOP {, <channel>}
PLAY VOLUME, <channel>, <0-1000>
PLAY SPEED, <channel>, <n>
Description
[VDS7] Plays a sound or media file. A .wav file uses the fast built-in player; any other format Windows can play (MP3, WMA, MIDI, AVI audio...) is played through MCI automatically. Without WAIT the file plays asynchronously (the script continues); with WAIT the script waits until the sound has finished.
[VDS7] An optional <channel> number (1, 2, ...) opens an independent stream, so several sounds can play at the same time — one per channel, useful for mixing. With no channel the default channel is used (as before). Channels are controlled with:
| PLAY STOP {, <channel>} | Stops a channel (or the default channel). |
| PLAY VOLUME, <channel>, <0-1000> | Sets the volume of a channel. |
| PLAY SPEED, <channel>, <n> | Sets the playback speed and pitch (1000 = normal, 1100 = about 10% faster and higher, 900 = slower and lower). |
On Linux, PLAY uses ffplay/aplay, which also handle MP3. A plain play x.wav behaves exactly as in earlier versions.
OK
Unchanged.
Example
PLAY intro.wav,WAIT