spacer graphic
spacer graphic
Montage of games AGS Logo
spacer graphic

 

spacer graphic
Menu
spacer graphic Home
About
News
Features
Download AGS
spacer graphic Games 
Games main page
Award Winners
Picks of the month
Short games
Medium length games
Full length games
In Production
Hints & Tips
Community
Forums
AGSers World Map
Member websites
Chat
Resources
Tutorials
FAQ
Knowledge Base
Downloads
Links
AGS-related links
* AGS Manual
  * Scripting
    * Multimedia functions

PlayMusicQueued

PlayMusicQueued (int music_number)
Queues up MUSIC_NUMBER to be played after the current background music finishes.

This command allows you to build up a playlist of music to be played, one after another. You can call this up to 10 times, to add up to 10 tracks to the playlist.

NOTE: This command uses the current setting of SetMusicRepeat to determine whether the queued track will repeat or not. You can only queue one track while SetMusicRepeat is on (since it will never finish, any further queued tracks would never play).

NOTE: The playlist is cancelled if you call PlayMusic (or use any other Play Music commands such as the Play Music On Room Load feature), or if you call StopMusic.

Example:

SetMusicRepeat(0);
PlayMusic(2);
PlayMusicQueued(3);
SetMusicRepeat(1);
PlayMusicQueued(4);
will play music 2, and then play music 3 after it finishes. After that, music 4 will play and loop continuously.

See Also: PlayMusic, SetMusicRepeat, StopMusic


User comments and notes
There are currently no user comments on this page.
The user comment facility is currently disabled.