PlaySound

From NSB App Studio
Jump to navigation Jump to search

PlaySound filename

Description

PlaySound plays .mp3 and .wav sound files. Playback is immediate, with no on screen controls, making it excellent for user interactions and gaming.

The files need to be included in the project by adding them to the Project Explorer.

PlaySound returns a reference to the sound. You can use this reference to control the sound.

PlaySound is supported starting with iOS Safari 6 and Chrome 31, so it will work on all current and recent iOS and Android devices. It is not supported in the Android browser or Internet Explorer. Since PhoneGap uses the Android browser, it will not work with PhoneGap.

Properties and Methods

soundRef.start() Start playing the sound. PlaySound auto plays, so this is not normally needed.
soundRef.stop() Stop playing the sound
soundRef.loop Make the sound loop endlessly

Example (Basic)

  PlaySound "BellToll.wav"

Make sound loop

  bell = PlaySound("BellToll.wav")
  bell.loop=True

Stop playing sound

  bell.stop

Example (JavaScript)

NSB.PlaySound("BellToll.wav");

Make sound loop

  bell = NSB.PlaySound("BellToll.wav");
  bell.loop=true;

Stop playing sound

  bell.stop()

Output

(sound of a bell tolling)