Audio Design for Android games

Audio Design for Android games
Audio Design for Android games

 

1. Basic Knowledge:

A. setVolumeControlStream (AudioManager. STREAM_MUSIC );
T)

Public final void setVolumeControlStream (int streamType)
Added in API level 1

Suggests an audio stream whose volume shocould be changed by the hardware volume controls.
The suggested audio stream will be tied to the window of this Activity. Volume requests which are already ed while the Activity is in

Foreground will affect this stream.
It is not guaranteed that the hardware volume controls will always change this stream's volume (for example, if a call is in progress, its

Stream's volume may be changed instead). To reset back to the default, use USE_DEFAULT_STREAM_TYPE.

Parameters

StreamType
The type of the audio stream whose volume shocould be changed by the hardware volume controls.

Value of AudioManager: http://developer.android.com/reference/android/media/AudioManager.html
Int STREAM_MUSIC The audio stream for music playback

B. getAssets ()
Http://developer.android.com/reference/android/content/res/Resources.html#getAssets ()
Public final AssetManager getAssets ()
Added in API level 1

Retrieve underlying AssetManager storage for these resources.
C. AssetManager
Http://developer.android.com/reference/android/content/res/AssetManager.html
D. AssetFileDescriptor
Http://developer.android.com/reference/android/content/res/AssetFileDescriptor.html
E. SoundPool
Http://developer.android.com/reference/android/media/SoundPool.html
The SoundPool class manages and plays audio resources for applications.
A SoundPool is a collection of samples that can be loaded into memory from a resource inside the APK or from a file in the file system.

SoundPool library uses the MediaPlayer service to decode the audio into a raw 16-bit PCM mono or stereo stream. This allows applications

Ship with compressed streams without having to suffer the CPU load and latency of decompressing playback.
Http://developer.android.com/reference/android/media/SoundPool.html#SoundPool (int, int, int)
Parameters

MaxStreams
The maximum number of simultaneous streams for this SoundPool object
StreamType
The audio stream type as described in AudioManager For example, game applications will normally use STREAM_MUSIC.
SrcQuality
The sample-rate converter quality. Currently has no effect. Use 0 for the default.

Returns
A SoundPool object, or null if creation failed
F. MediaPlayer
Http://developer.android.com/reference/android/media/MediaPlayer.html
G. MediaPlayer. OnCompletionListener
Http://developer.android.com/reference/android/media/MediaPlayer.OnCompletionListener.html

2. design three interfaces: Sound, Music, Audio, and Audio, which are composed of Sound and Music.

package com.badlogic.androidgames.framework;public interface Sound {    public void play(float volume);    public void dispose();}

package com.badlogic.androidgames.framework;public interface Music {    public void play();    public void stop();    public void pause();    public void setLooping(boolean looping);    public void setVolume(float volume);    public boolean isPlaying();    public boolean isStopped();    public boolean isLooping();    public void dispose();}

package com.badlogic.androidgames.framework;public interface Audio {    public Music newMusic(String filename);    public Sound newSound(String filename);}

3. implement each corresponding class for the three interfaces

package com.badlogic.androidgames.framework.impl;import java.io.IOException;import android.content.res.AssetFileDescriptor;import android.media.MediaPlayer;import android.media.MediaPlayer.OnCompletionListener;import com.badlogic.androidgames.framework.Music;public class AndroidMusic implements Music, OnCompletionListener {    MediaPlayer mediaPlayer;    boolean isPrepared = false;    public AndroidMusic(AssetFileDescriptor assetDescriptor) {        mediaPlayer = new MediaPlayer();        try {            mediaPlayer.setDataSource(assetDescriptor.getFileDescriptor(),                    assetDescriptor.getStartOffset(),                    assetDescriptor.getLength());            mediaPlayer.prepare();            isPrepared = true;            mediaPlayer.setOnCompletionListener(this);        } catch (Exception e) {            throw new RuntimeException(Couldn't load music);        }    }    @Override    public void dispose() {        if (mediaPlayer.isPlaying())            mediaPlayer.stop();        mediaPlayer.release();    }    @Override    public boolean isLooping() {        return mediaPlayer.isLooping();    }    @Override    public boolean isPlaying() {        return mediaPlayer.isPlaying();    }    @Override    public boolean isStopped() {        return !isPrepared;    }    @Override    public void pause() {        if (mediaPlayer.isPlaying())            mediaPlayer.pause();    }    @Override    public void play() {        if (mediaPlayer.isPlaying())            return;        try {            synchronized (this) {                if (!isPrepared)                    mediaPlayer.prepare();                mediaPlayer.start();            }        } catch (IllegalStateException e) {            e.printStackTrace();        } catch (IOException e) {            e.printStackTrace();        }    }    @Override    public void setLooping(boolean isLooping) {        mediaPlayer.setLooping(isLooping);    }    @Override    public void setVolume(float volume) {        mediaPlayer.setVolume(volume, volume);    }    @Override    public void stop() {        mediaPlayer.stop();        synchronized (this) {            isPrepared = false;        }    }    @Override    public void onCompletion(MediaPlayer arg0) {        synchronized (this) {            isPrepared = false;        }    }}

 

package com.badlogic.androidgames.framework.impl;import android.media.SoundPool;import com.badlogic.androidgames.framework.Sound;public class AndroidSound implements Sound {    int soundId;    SoundPool soundPool;        public AndroidSound(SoundPool soundPool,int soundId) {        this.soundId = soundId;        this.soundPool = soundPool;    }    @Override    public void play(float volume) {        soundPool.play(soundId, volume, volume, 0, 0, 1);    }    @Override    public void dispose() {        soundPool.unload(soundId);    }}

 

package com.badlogic.androidgames.framework.impl;import java.io.IOException;import android.app.Activity;import android.content.res.AssetFileDescriptor;import android.content.res.AssetManager;import android.media.AudioManager;import android.media.SoundPool;import com.badlogic.androidgames.framework.Audio;import com.badlogic.androidgames.framework.Music;import com.badlogic.androidgames.framework.Sound;public class AndroidAudio implements Audio {    AssetManager assets;    SoundPool soundPool;    public AndroidAudio(Activity activity) {        activity.setVolumeControlStream(AudioManager.STREAM_MUSIC);        this.assets = activity.getAssets();        this.soundPool = new SoundPool(20, AudioManager.STREAM_MUSIC, 0);    }    @Override    public Music newMusic(String filename) {        try {            AssetFileDescriptor assetDescriptor = assets.openFd(filename);            return new AndroidMusic(assetDescriptor);        } catch (IOException e) {            throw new RuntimeException(Couldn't load music ' + filename + ');        }    }    @Override    public Sound newSound(String filename) {        try {            AssetFileDescriptor assetDescriptor = assets.openFd(filename);            int soundId = soundPool.load(assetDescriptor, 0);            return new AndroidSound(soundPool, soundId);        } catch (IOException e) {            throw new RuntimeException(Couldn't load sound ' + filename + ');        }    }   }