ActionScript: The Definitive Guide

Name

Sound Class — control over sounds in a movie

Availability

Flash 5

Constructor

new Sound( )
new Sound(target)

Arguments

target

A string indicating the path to the movie clip or document level whose sound is to be controlled. May also be a reference to a movie clip or document level (references are converted to paths when used in a string context).

Methods

attachSound( )

Associate a sound from the Library with the Sound object.

getPan( )

Retrieve the current pan setting.

getTransform( )

Determine the current distribution of the channels of a sound to the left and right speakers (i.e., balance).

getVolume( )

Retrieve the current volume.

setPan( )

Set the pan across a sound’s left and right channels.

setTransform( )

Distribute the left and right channels between the left and right speakers (i.e., balance).

setVolume( )

Set the sound volume.

start( )

Start playing an attached sound.

stop( )

Silence all sounds or a specified attached sound.

Description

Objects of the Sound class are used to control the existing sounds in a movie or to control sounds added to a movie programmatically. Sound objects have several distinct applications. They can control:

• All the sounds in the Flash Player

• All the sounds in a particular movie clip instance or main movie (including all sounds in any nested clips)

• An individual programmatically attached sound

To create a Sound object that controls all the sounds in the Player (including sounds in .swf files on document levels), use the Sound constructor without any parameters. ...