User Guide

ManualsBrandsMacromedia ManualsOtherDIRECTOR MX 2004-DIRECTOR SCRIPTING REFERENCE

451

452

453

454

455

456

457

458

459

460

playFile() 453

playFile()

Usage

-- Lingo syntax

soundChannelObjRef.playFile(stringFilePath)

// JavaScript syntax

soundChannelObjRef.playFile(stringFilePath);

Description

Sound Channel method; plays the AIFF, SWA, AU, or WAV sound in a sound channel.

For the sound to be played properly, the correct MIX Xtra must be available to the movie, usually

in the Xtras folder of the application.

When the sound file is in a different folder than the movie,

stringFilePath must specify the full

path to the file.

To play sounds obtained from a URL, it’s usually a good idea to use

downloadNetThing() or

preloadNetThing() to download the file to a local disk first. This approach can minimize

problems that may occur while the file is downloading.

The

playFile() method streams files from disk rather than playing them from RAM. As

a result, using

playFile() when playing digital video or when loading cast members into

memory can cause conflicts when the computer tries to read the disk in two places at once.

Parameters

stringFilePath

Required. A string that specifies the name of the file to play. When the sound

file is in a different folder than the currently playing movie,

stringFilePath must also specify

the full path to the file.

Example

This statement plays the file named Thunder in channel 1:

-- Lingo syntax

sound(1).playFile("Thunder.wav")

// JavaScript syntax

sound(1).playFile("Thunder.wav");

This statement plays the file named Thunder in channel 3:

-- Lingo syntax

sound(3).playFile(_movie.path & "Thunder.wav")

// JavaScript syntax

sound(3).playFile(_movie.path + "Thunder.wav");