playSoundAsync

playSoundAsync(waveFileName: String);

The playSoundAsync method of the Application class starts the playing of the .wav file specified in the waveFileName parameter and returns immediately. (The app.playSound method waits for the complete sound file to be played before returning.)

In JADE thin client mode, the playSoundAsync method always executes on the presentation client.

Calling this method causes any existing sound that is playing to be cancelled. Calling this method with a null file name also cancels any sound that is being played.

The waveFileName parameter must include the full path and file name, as shown in the code fragment in the following example.

app.playSoundAsync("s:\jademedia\arlo.wav");

This method does not raise an exception if the sound cannot be played or the specified file is invalid, so that code can function silently on a workstation without a sound card. (See also the Sound class play method, which transfers a sound wave image from the receiver object to memory and then creates a thread to play the sound.)