PlaySound: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
Line 16: Line 16:
{| class="wikitable"
{| class="wikitable"
|-
|-
| soundRef.start() || Start playing the sound. PlaySound auto plays, so this is not normally needed.
| soundRef.start(0) || Start playing the sound. PlaySound auto plays, so this is not normally needed.
|-
|-
| soundRef.stop() || Stop playing the sound
| soundRef.stop(0) || Stop playing the sound.
|-
|-
| soundRef.loop || Make the sound loop endlessly
| soundRef.loop || Make the sound loop endlessly

Revision as of 14:09, 15 October 2014

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(0) Start playing the sound. PlaySound auto plays, so this is not normally needed.
soundRef.stop(0) 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)