Mscape Help


How To: Use the Playlist

The playlist is a very useful tool that allows you to queue media objects so that they get played in the order that they are added to the playlist. It appears under the Tools menu. (To add a playlist right click on Tools).

The playlist has several important properties and actions.

1. The AllowDuplicates property determines whether you can add the same audio to the playlist or not. If it is set to false then if an audio is already playing or on the playlist it will not add it again.

2. The playlist actions are shown when you add the playlist object to the script window
playlistactions.GIF

Particularly useful actions are

AddIfNotPlayed – this ensures that you only ever play a media item once. It is really useful if you want to prevent the same thing being played over and over every time you re-enter a region. GPS can often jump in and out of a region even if the user is stationary so it is a good idea to use AddIfNotPlayed to avoid a frustrating experience.

Clear – clearing the playlist will remove all items in the queue but will not stop the currently playing item. It is most often used on Exit from a region so that the media retains its relevance to a location. Please read the following example to learn how to use the Playlist effectively. EffectiveUseOfPlaylist.

Pause, Resume and Repeat last instruction. These are most commonly mapped to hardware buttons to give the user more control over their experience. Please read the following example to learn how to implement Pause, Resume and Repeat the last instruction. PauseResumeSkip.

Remember not to put a looped piece of audio on the playlist as it will never finish and so anything queued after it will never play

-- JoReid? - 25 May 2007

Ready to
get started?

Download Mscape Suite Version 2.1 | 10.5 MB

Download Mscape Beta

Experimental Beta Version 2.5 | 10.5 MB

Ask the Mscape Community

Forums