nmpPlaySound (Function)

This function will play a sound on the NMP.

The file to play must be a .wav file (Waveform Audio File Format) and must be located on the NMP device - e.g on the SD-CARD.

Only one sound can be played at the same time.

Input:

loop : BOOL (Default: FALSE)

filename : STRING

The path to the sound file to play. Use an empty string to stop playing a looping sound. The string must be less than 200 characters. If the file can not be found, the default sound will be played.

Returns: INT

Declaration:

FUNCTION nmpPlaySound : INT;
VAR_INPUT
   loop     : BOOL := FALSE;
   filename : STRING := "";
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
BEGIN
   ...
   //Play sound for 5 seconds
   nmpPlaySound(loop := TRUE, filename := "\SD Card\NMP\msg.wav");
   sleep(delay := 5000);
   nmpPlaySound();
   ...
END;
END_PROGRAM;