Motorola C450, C550, C370 SoundEffect Class, Sprite Class, SoundEffect Methods, Using SoundEffect

8

Gaming API and Sound

SoundEffect Class

The SoundEffect class encapsulates the data for a game sound effect. A game may create several SoundEffect objects, one for each of the sounds that it needs to play. The sound data may be stored on the device as a named resource in the application JAR file, or it can be stored on a server and retrieved via the network. SoundEffect instances are played by a GameScreen.

SoundEffect Methods

The SoundEffect class implements the following method:

•public static SoundEffect createSoundEffect(String resource) throws FileFormatNotSupportedException – Creates a SoundEffect for the sound data stored in the specified named resource or URL. The data must be in a sound format that is supported by the device. Though additional formats may be supported, all devices must support some format yet to be determined.

Using SoundEffect

As described above, a game can need several different sound effects. The code below exemplifies the creation of some SoundEffect objects:

The following is a code sample to show the creation of SoundEffect objects:

SoundEffect Objects

try{

//Create a SoundEffect using a wave file inside the JAR SoundEffect s1 = createSoundEffect("/jump.wav");

//Create a SoundEffect using a wave located

//on a web site

SoundEffect s2= createSoundEffect("http://www.motorola.com/sound/mp.wav");

}catch(FileFormatNotSupportedException fe){}

Sprite Class

The Sprite class is used to create graphic images, animated or non-animated, that a user can interact with and move around.

55