Flash CS3 Documentation

Programming ActionScript 3.0 > Working with sound > Basics of working with sound

Basics of working with sound

Introduction to working with sound

Just as computers can encode images in a digital format, store them on a computer, and retrieve them to display on the screen, computers can capture and encode digital audio--computer representation of sound information--and can store it and retrieve it to play back over speakers connected to the computer. One way to play back sound is using Adobe Flash Player and ActionScript.

When sound data is converted to digital form, it has various characteristics, such as the sound's volume and whether it is stereo or mono sound. When you play back a sound in ActionScript, you can adjust these characteristics as well--make the sound louder, or make it seem to be coming from a certain direction, for instance.

Before you can control a sound in ActionScript, you need to have the sound information loaded into Flash Player. There are four ways you can get audio data into Flash Player so that you can work with it using ActionScript. You can load an external sound file such as an mp3 file into the SWF; you can embed the sound information into the SWF file directly when it's being created; you can get audio input using a microphone attached to a user's computer, and you can access sound data that's streamed from a server.

When you load sound data from an external sound file, you can begin playing back the start of the sound file while the rest of the sound data is still loading.

Although there are various sound file formats used to encode digital audio, ActionScript 3.0 and Flash Player support sound files that are stored in the mp3 format. They cannot directly load or play sound files in other formats like WAV or AIFF.

While you're working with sound in ActionScript, you'll likely work with several classes from the flash.media package. The Sound class is the class you use to get access to audio information by loading a sound file and starting playback. Once you start playing a sound, Flash Player gives you access to a SoundChannel object. Since an audio file that you've loaded may only be one of several sounds that you play on a user's computer, each individual sound that's playing uses its own SoundChannel object; the combined output of all the SoundChannel objects mixed together is what actually plays over the computer's speakers. You use this SoundChannel instance to control properties of the sound and to stop its playback. Finally, if you want to control the combined audio, the SoundMixer class gives you control over the mixed output.

You can also use several other classes to perform more specific tasks when you're working with sound in ActionScript; for more information on all the sound-related classes, see Understanding the sound architecture.

Common tasks for working with sound

This chapter describes the following sound-related tasks that you will likely want to perform:

• Loading external mp3 files and tracking their loading progress
• Playing, pausing, resuming, and stopping sounds
• Playing streaming sounds while they are being loaded
• Manipulating sound volume and panning
• Retrieving ID3 metadata from an mp3 file
• Using raw sound wave data
• Capturing and replaying sound input from a user's microphone

Important concepts and terms

The following reference list contains important terms that you will encounter in this chapter:

• Amplitude: The distance of a point on the sound waveform from the zero or equilibrium line.
• Bit rate: The amount of data that is encoded or streamed for each second of a sound file. For mp3 files, the bit rate is usually stated in terms of thousands of bits per second (kbps). A higher bit rate generally means a higher quality sound wave.
• Buffering: The receiving and storing of sound data before it is played back.
• mp3: MPEG-1 Audio Layer 3, or mp3, is a popular sound compression format.
• Panning: The positioning of an audio signal between the left and right channels in a stereo soundfield.
• Peak: The highest point in a waveform.
• Sampling rate: Defines the number of samples per second taken from an analog audio signal to make a digital signal. The sampling rate of standard compact disc audio is 44.1 kHz or 44,100 samples per second.
• Streaming: The process of playing the early portions of a sound file or video file while later portions of that file are still being loaded from a server.
• Volume: The loudness of a sound.
• Waveform: The shape of a graph of the varying amplitudes of a sound signal over time.

Working through in-chapter examples

As you're working through this chapter, you may want to try out some of the example code listings. Since this chapter covers working with sound in ActionScript, many of the examples do something that involves working with a sound file--making it play, stopping playback, or adjusting the sound in some way. To test the examples in this chapter:

1. Create a new Flash document and save it on your computer.
2. In the Timeline, select the first keyframe and open the Actions panel.
3. Copy the example code listing into the Script pane.
4. If the code involves loading an external sound file, it will have a line of code that looks something like this:

   var req:URLRequest = new URLRequest("click.mp3");
   var s:Sound = new Sound(req);
   

   where "click.mp3" is the name of the sound file being loaded. In order to test these examples, you'll need to have an mp3 file to use. You should put the mp3 file in the same folder as your Flash document. You should then alter the code to use the name of your mp3 file instead of the name in the code listing (for example, in the code above you'd change "click.mp3" to the name of your mp3 file).

5. From the main menu, choose Control > Test Movie to create the SWF file and preview (and hear) the output of the example.

In addition to playing audio, some of the examples display values using the trace() function; when you're testing those examples, you'll see the results of those values in the Output panel. Some examples also draw content to the screen, so for those examples you'll see the content in the Flash Player window as well.

For more information about testing the example code listings in this manual, see Testing in-chapter example code listings.

Flash CS3