Motorola C550, C450, C370 BackgroundMusic Class, BackgroundMusic Methods, Using BackgroundMusic

8

Gaming API and Sound

BackgroundMusic Class

The BackgroundMusic class encapsulates the data for a game's background music. A game may create several BackgroundMusic objects, but only one can be playing at any one time. The sound data can 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.

BackgroundMusic is played by a GameScreen.

BackgroundMusic Methods

The BackgroundMusic class defines the following methods:

•public static BackgroundMusic createBackgroundMusic(java.lang.String name) throws

FileFormatNotSupportedException – Creates a BackgroundMusic for the sound data stored in the specified named resource or URL. This method currently supports the use of MIDI format 0 and format 1 only.

Using BackgroundMusic

The following code sample shows implementation of BackgroundMusic:

Using BackgroundMusic

BackgroundMusic bgm1 = BackgroundMusic.createBackgroundMusic("/FunkyTunes.mid");

BackgroundMusic bgm2 = BackgroundMusic.createBackgroundMusic("http://www.motorola.com/sounds/JazzyTunes.mid");

The following code sample shows implementation of the Gaming API that contains a sound API:

Gaming API containing a sound API

import com.motorola.game.*;

public class GS extends GameScreen {

public BackgroundMusic bgm;

public GS()

{

bgm = BackgroundMusic.createBackgroundMusic("vinovata.mid"); playBackgroundMusic(bgm, true);

}

}

39