org.mini2Dx.core

Interface Audio

All Known Implementing Classes:

LibgdxAudio

public interface Audio

Provides audio functionality

Method Summary

Modifier and Type	Method and Description
void	addMusicCompletionListener(MusicCompletionListener completionListener) Adds a MusicCompletionListener
void	addSoundCompletionListener(SoundCompletionListener completionListener) Adds a SoundCompletionListener
Music	newMusic(FileHandle fileHandle) Creates a new Music instance used to play back an audio stream from a file.
Sound	newSound(FileHandle fileHandle) Creates a new Sound instance used to play back audio sound effects (e.g.
void	removeMusicCompletionListener(MusicCompletionListener completionListener) Removes a MusicCompletionListener
void	removeSoundCompletionListener(SoundCompletionListener completionListener) Removes a SoundCompletionListener

Method Detail

newSound

Sound newSound(FileHandle fileHandle)
        throws java.io.IOException

Creates a new Sound instance used to play back audio sound effects (e.g. explosions, gunshots, etc.). Note that the complete audio data is loaded into RAM and you should avoid loading large files. The current upper limit for decoded audio is 1 MB.

Currently supported formats are WAV, MP3 and OGG.

When the Sound instance is no longer needed, call the Disposable.dispose() method

Parameters:

fileHandle - The FileHandle to load the audio from

Returns:

The new Sound instance

Throws:

java.io.IOException - Thrown when the sound could not be loaded

newMusic

Music newMusic(FileHandle fileHandle)
        throws java.io.IOException

Creates a new Music instance used to play back an audio stream from a file. Music instances are automatically paused when the application is paused and resumed when the application is resumed.

Currently supported formats are WAV, MP3 and OGG.

When the Music instance is no longer needed, call the Disposable.dispose() method

Parameters:

fileHandle - The FileHandle to stream the audio from

Returns:

The new Music instance

Throws:

java.io.IOException - Thrown when the music could not be loaded

addMusicCompletionListener

void addMusicCompletionListener(MusicCompletionListener completionListener)

Adds a MusicCompletionListener

Parameters:

completionListener - The MusicCompletionListener to be notified of Music completion events.

removeMusicCompletionListener

void removeMusicCompletionListener(MusicCompletionListener completionListener)

Removes a MusicCompletionListener

Parameters:

completionListener - The MusicCompletionListener to be removed

addSoundCompletionListener

void addSoundCompletionListener(SoundCompletionListener completionListener)

Adds a SoundCompletionListener

Parameters:

completionListener - The SoundCompletionListener to be notified of Sound completion events.

removeSoundCompletionListener

void removeSoundCompletionListener(SoundCompletionListener completionListener)

Removes a SoundCompletionListener

Parameters:

completionListener - The SoundCompletionListener to be removed