De interface van VDS Renaissance is in meerdere talen beschikbaar. De officiële documentatie wordt in het Engels onderhouden om één consistente en altijd actuele referentie te garanderen.

PLAY

Windows ✓Linux ✓macOS ⏳

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

See also