Android开发笔记（一百二十六）自定义音乐播放器

MediaRecorder/MediaPlayer

在Android手机上面，音频的处理比视频还要复杂，这真是出人意料。在前面的博文《 Android开发笔记（五十七）录像录音与播放》中，介绍了视频/音频的录制与播放，其中录像用的是MediaRecorder类，播放用的是MediaPlayer类。虽然Android还提供了专门的视频视图VideoView，但是该控件并非新的东西，而是继承了MediaRecorder和MediaPlayer，所以严格来说，Android上面只有一种视频的录制和播放方式。可是音频就大不一样了，Android提供了两种录音方式，以及至少三种常用的播音方式。两种录音方式分别是MediaRecorder类和AudioRecord类，而播音方式包括MediaPlayer类、AudioTrack类和SoundPool类，它们的使用场合各有千秋，且待笔者下面细细道来。


首先是MediaRecorder与MediaPlayer，这对组合即可用于录像，也可单独录制音频。它们处理的音频文件是压缩过的编码文件，通常用于录制和播放音乐，是最经常用到的。MediaRecorder与MediaPlayer在处理音频和视频时，整体流程是一样的，只有在部分方法的调用上有所差异，下面分别把录音/播音有关的方法列出来。


MediaRecorder的录音相关方法：
reset : 重置录制资源
prepare : 准备录制
start : 开始录制
stop : 结束录制
release : 释放录制资源
setOnErrorListener : 设置错误监听器。可监听服务器异常以及未知错误的事件。
setOnInfoListener : 设置信息监听器。可监听录制结束事件，包括达到录制时长或者达到录制大小。
setAudioSource : 设置音频来源。一般使用麦克风AudioSource.MIC。
setOutputFormat : 设置媒体输出格式。OutputFormat.AMR_NB表示窄带格式，OutputFormat.AMR_WB表示宽带格式，AAC_ADTS表示高级的音频传输流格式。该方法要在setVideoEncoder之前调用，不然调用setAudioEncoder时会报错“java.lang.IllegalStateException”。
setAudioEncoder : 设置音频编码器。AudioEncoder.AMR_NB表示窄带编码，AudioEncoder.AMR_WB表示宽带编码，AudioEncoder.AAC表示低复杂度的高级编码，AudioEncoder.HE_AAC表示高效率的高级编码，AudioEncoder.AAC_ELD表示增强型低延迟的高级编码。
注意：setAudioEncoder应在setOutputFormat之后执行，否则会出现“setAudioEncoder called in an invalid state(2)”的异常。
setAudioSamplingRate : 设置音频的采样率，单位赫兹（Hz）。该方法为可选，AMRNB默认8khz，AMRWB默认16khz。
setAudioChannels : 设置音频的声道数。1表示单声道，2表示双声道。该方法为可选
setAudioEncodingBitRate : 设置音频每秒录制的字节数。越大则音频越清晰。该方法为可选
setMaxDuration : 设置录制时长。单位毫秒。
setMaxFileSize : 设置录制的媒体大小。单位字节。
setOutputFile : 设置输出文件的路径。


MediaPlayer的播音相关方法：
reset : 重置播放器
prepare : 准备播放
start : 开始播放
pause : 暂停播放
stop : 停止播放
setOnPreparedListener : 设置准备播放监听器。
setOnCompletionListener : 设置结束播放监听器。
setOnSeekCompleteListener : 设置播放拖动监听器。
create : 创建指定Uri的播放器。
setDataSource : 设置播放数据来源。create与setDataSource只需设置其一。
setVolume : 设置音量。第一个参数是左声道，第二个参数是右声道，取值在0-1之间。
setAudioStreamType : 设置音频流的类型。AudioManager.STREAM_MUSIC表示音乐，AudioManager.STREAM_RING表示铃声，AudioManager.STREAM_ALARM表示闹钟，AudioManager.STREAM_NOTIFICATION表示通知。
setLooping : 设置是否循环播放。
isPlaying : 判断是否正在播放。
seekTo : 拖动播放进度到指定位置。
getCurrentPosition : 获取当前播放进度所在的位置。
getDuration : 获取播放时长。


下面是MediaRecorder与MediaPlayer组合处理音频的示例代码：

import java.io.File;

import com.example.exmaudio.util.Utils;

import android.app.Activity;
import android.media.AudioManager;
import android.media.MediaPlayer;
import android.media.MediaPlayer.OnCompletionListener;
import android.media.MediaRecorder.AudioEncoder;
import android.media.MediaRecorder.AudioSource;
import android.media.MediaRecorder.OnErrorListener;
import android.media.MediaRecorder.OnInfoListener;
import android.media.MediaRecorder;
import android.media.MediaRecorder.OutputFormat;
import android.os.Bundle;
import android.os.Environment;
import android.os.Handler;
import android.util.Log;
import android.view.View.OnClickListener;
import android.view.View;
import android.view.Window;
import android.widget.Button;
import android.widget.TextView;

public class MediaRecordActivity extends Activity 
		implements OnClickListener, OnErrorListener, OnInfoListener {
	private static final String TAG = "MediaRecordActivity";
    private TextView tv_record;
    private Button btn_start;
    private Button btn_stop;
    private MediaRecorder mMediaRecorder;

    private TextView tv_play;
    private Button btn_play;
    private Button btn_pause;
    private MediaPlayer mMediaPlayer;
    private int mPosition;
    private boolean bFirstPlay = true;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        requestWindowFeature(Window.FEATURE_NO_TITLE);
        setContentView(R.layout.activity_media_record);

        tv_record = (TextView) findViewById(R.id.tv_record);
        btn_start = (Button) findViewById(R.id.btn_start);
        btn_stop = (Button) findViewById(R.id.btn_stop);
        tv_play = (TextView) this.findViewById(R.id.tv_play);
        btn_play = (Button) findViewById(R.id.btn_play);
        btn_pause = (Button) findViewById(R.id.btn_pause);

        btn_start.setOnClickListener(this);
        btn_stop.setOnClickListener(this);
        btn_play.setOnClickListener(this);
        btn_pause.setOnClickListener(this);
        btn_start.setEnabled(true);
        btn_stop.setEnabled(false);
        btn_play.setEnabled(false);
        btn_pause.setEnabled(false);
        initPlay();
    }
    
	private void initPlay() {
        mMediaPlayer = new MediaPlayer();
        mMediaPlayer.setOnCompletionListener(new OnCompletionListener() {
            @Override
            public void onCompletion(MediaPlayer mp) {
        		btn_play.setEnabled(true);
        		btn_pause.setEnabled(false);
        		bFirstPlay = true;
        		mHandler.removeCallbacks(mPlayRun);
        		mPlayTime = 0;
            }
        });
	}

	private void preplay() {
		try {
			mMediaPlayer.reset();
			//mMediaPlayer.setVolume(0.5f, 0.5f);  //设置音量，可选
			mMediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
			String path = mRecordFile.getAbsolutePath();
			mMediaPlayer.setDataSource(path);
			Log.d(TAG, "audio path = "+path);
			mMediaPlayer.prepare();
		} catch (Exception e) {
			Log.d(TAG, "mMediaPlayer.prepare error: "+e.getMessage());
		}
		mPlayTime = 0;
	}
    
    private void startPlay() {
		try {
			if (bFirstPlay == true) {
				preplay();
				bFirstPlay = false;
			}
			mMediaPlayer.start();
		} catch (Exception e) {
			Log.d(TAG, "mMediaPlayer.start error: " + e.getMessage());
		}
		btn_play.setEnabled(false);
		btn_pause.setEnabled(true);
		mHandler.post(mPlayRun);
    }
    
	@Override
	protected void onPause() {
		// 先判断是否正在播放
		if (mMediaPlayer.isPlaying()) {
			// 如果正在播放我们就先保存这个播放位置
			mPosition = mMediaPlayer.getCurrentPosition();
			mMediaPlayer.stop();
			mHandler.removeCallbacks(mPlayRun);
		}
		super.onPause();
	}

	@Override
	protected void onResume() {
		if (mMediaPlayer!=null && mPosition>0) {
			mMediaPlayer.seekTo(mPosition);
			mMediaPlayer.start();
			mHandler.post(mPlayRun);
		}
		super.onResume();
	}
	
	private void startRecord() {
		createRecordDir();
        mMediaRecorder = new MediaRecorder();
        mMediaRecorder.reset();
        mMediaRecorder.setOnErrorListener(this);
        mMediaRecorder.setOnInfoListener(this);
        mMediaRecorder.setAudioSource(AudioSource.MIC);  //音频源
        mMediaRecorder.setOutputFormat(OutputFormat.AMR_NB);
        mMediaRecorder.setAudioEncoder(AudioEncoder.AMR_NB);  //音频格式
        //mMediaRecorder.setAudioSamplingRate(8);  //音频的采样率。可选
        //mMediaRecorder.setAudioChannels(2);  //音频的声道数。可选
        //mMediaRecorder.setAudioEncodingBitRate(1024);  //音频每秒录制的字节数。可选
        mMediaRecorder.setMaxDuration(10 * 1000);  //设置录制时长
        //mMediaRecorder.setMaxFileSize(1024*1024*10);  //setMaxFileSize与setMaxDuration设置其一即可
        mMediaRecorder.setOutputFile(mRecordFile.getAbsolutePath());
        try {
            mMediaRecorder.prepare();
            mMediaRecorder.start();
        } catch (Exception e) {
			Log.d(TAG, "mMediaRecorder.start error: " + e.getMessage());
        }
		btn_start.setEnabled(false);
		btn_stop.setEnabled(true);
		mRecordTime = 0;
		mHandler.post(mRecordRun);
    }
    
	private File mRecordFile = null;
	private void createRecordDir() {
		File sampleDir = new File(Environment.getExternalStorageDirectory()
				+ File.separator + "Download" + File.separator);
		if (!sampleDir.exists()) {
			sampleDir.mkdirs();
		}
		File recordDir = sampleDir;
		try {
			mRecordFile = File.createTempFile(Utils.getNowDateTime(), ".amr", recordDir);
			Log.d(TAG, mRecordFile.getAbsolutePath());
		} catch (Exception e) {
			Log.d(TAG, "createTempFile error: " + e.getMessage());
		}
	}

	private void stopRecord() {
		if (mMediaRecorder != null) {
			mMediaRecorder.setOnErrorListener(null);
			mMediaRecorder.setPreviewDisplay(null);
			try {
				mMediaRecorder.stop();
			} catch (Exception e) {
				Log.d(TAG, "mMediaRecorder.stop error: " + e.getMessage());
			}
			mMediaRecorder.release();
			mMediaRecorder = null;
		}
		btn_start.setEnabled(true);
		btn_stop.setEnabled(false);
		btn_play.setEnabled(true);
		mHandler.removeCallbacks(mRecordRun);
	}

	@Override
	public void onClick(View v) {
		int resid = v.getId();
		if (resid == R.id.btn_start) {
			startRecord();
		} else if (resid == R.id.btn_stop) {
			stopRecord();
		} else if (resid == R.id.btn_play) {
			startPlay();
		} else if (resid == R.id.btn_pause) {
			mMediaPlayer.pause();
			btn_play.setEnabled(true);
			btn_pause.setEnabled(false);
			mHandler.removeCallbacks(mPlayRun);
		}
	}
	
	private Handler mHandler = new Handler();
	
	private int mRecordTime = 0;
	private Runnable mRecordRun = new Runnable() {
		@Override
		public void run() {
			tv_record.setText(mRecordTime+"s");
			mRecordTime++;
			mHandler.postDelayed(this, 1000);
		}
	};

	private int mPlayTime = 0;
	private Runnable mPlayRun = new Runnable() {
		@Override
		public void run() {
			tv_play.setText(mPlayTime+"s");
			mPlayTime++;
			mHandler.postDelayed(this, 1000);
		}
	};
	
    @Override
    public void onError(MediaRecorder mr, int what, int extra) {
        if (mr != null) {
            mr.reset();
        }
    }

	@Override
	public void onInfo(MediaRecorder mr, int what, int extra) {
		if (what == MediaRecorder.MEDIA_RECORDER_INFO_MAX_DURATION_REACHED
				|| what == MediaRecorder.MEDIA_RECORDER_INFO_MAX_FILESIZE_REACHED) {
			stopRecord();
		}
	}

}

AudioRecord/AudioTrack

话说Android搞出这么多种录音/播音方式，到底有什么用处呢？其实这还是跟不同的需求和用途有关，譬如说语音通话，要求实时传输，手机这边说一句话，那边厢就同步听到一句话。如果是MediaRecorder与MediaPlayer组合，只能整句话都录完编码好了，才能传给对方去播放，这个实效性就太差了。于是适用于音频实时处理的AudioRecord与AudioTrack组合就应运而生，该组合的音频为原始的二进制音频数据，没有文件头和文件尾，故而可以实现边录边播的实时语音。


MediaRecorder录制的音频格式有amr、aac等，MediaPlayer支持播放的音频格式除了amr、aac之外，还支持常见的mp3、wav、mid、ogg等经过压缩编码的音频。AudioRecord录制的音频格式只有pcm，AudioTrack可直接播放的也只有pcm。pcm格式有个缺点，在播放过程中不能直接暂停，因为二进制流；但pcm格式有个好处，就是iOS不能播放amr音频，但能播放pcm音频；所以如果Android手机录制的音乐需要传给iOS手机播放，还是得采用pcm格式。


下面是AudioRecord与AudioTrack组合的录音/播音相关说明。


AudioRecord的录音相关方法：
getMinBufferSize : 根据采样频率、声道配置、音频格式获得合适的缓冲区大小。该函数为静态方法。
构造函数 : 可设置录音来源、采样频率、声道配置、音频格式与缓冲区大小。其中录音来源一般是AudioSource.MIC，采样频率可取值8000或者16000，声道配置可取值AudioFormat.CHANNEL_IN_STEREO或者AudioFormat.CHANNEL_OUT_STEREO，音频格式可取值AudioFormat.ENCODING_PCM_16BIT或者AudioFormat.ENCODING_PCM_8BIT。
startRecording : 开始录音。
read : 从缓冲区中读取音频数据，此数据用于保存到音频文件中。
stop : 停止录音。
release : 停止录音并释放资源。
setNotificationMarkerPosition : 设置需要通知的标记位置。
setPositionNotificationPeriod : 设置需要通知的时间周期。
setRecordPositionUpdateListener : 设置录制位置变化的监听器对象。该监听器从OnRecordPositionUpdateListener扩展而来，需要实现onMarkerReached和onPeriodicNotification两个方法；其中onMarkerReached事件的触发对应于setNotificationMarkerPosition方法，onPeriodicNotification事件的触发对应于setPositionNotificationPeriod方法。


AudioTrack的播音相关方法：
getMinBufferSize : 根据采样频率、声道配置、音频格式获得合适的缓冲区大小。该函数为静态方法。
构造函数 : 可设置音频类型、采样频率、声道配置、音频格式、播放模式与缓冲区大小。其中音频类型一般是AudioManager.STREAM_MUSIC，采样频率、声道配置、音频格式与录音时保持一致，播放模式一般是AudioTrack.MODE_STREAM。
setStereoVolume : 设置立体声的音量。第一个参数是左声道音量，第二个参数是右声道音量。
play : 开始播放。
write : 把缓冲区的音频数据写入音轨中。调用该函数前要先从音频文件中读取数据写入缓冲区。
stop : 停止播放。
release : 停止播放并释放资源。
setNotificationMarkerPosition : 设置需要通知的标记位置。
setPositionNotificationPeriod : 设置需要通知的时间周期。
setPlaybackPositionUpdateListener : 设置播放位置变化的监听器对象。该监听器从OnPlaybackPositionUpdateListener扩展而来，需要实现onMarkerReached和onPeriodicNotification两个方法；其中onMarkerReached事件的触发对应于setNotificationMarkerPosition方法，onPeriodicNotification事件的触发对应于setPositionNotificationPeriod方法。


下面是AudioRecord与AudioTrack组合处理音频的示例代码：

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;

import com.example.exmaudio.util.Utils;

import android.app.Activity;
import android.media.AudioFormat;
import android.media.AudioManager;
import android.media.AudioRecord;
import android.media.AudioRecord.OnRecordPositionUpdateListener;
import android.media.AudioTrack.OnPlaybackPositionUpdateListener;
import android.media.AudioTrack;
import android.media.MediaRecorder.AudioSource;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.Environment;
import android.os.Handler;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;

public class AudioRecordActivity extends Activity implements OnClickListener {
	private static final String TAG = "AudioRecordActivity";

	private TextView tv_record, tv_play;
	private Button btn_start, btn_stop, btn_play, btn_finish;
	private boolean isRecording, isPlaying;
	private Handler mHandler = new Handler();
	private int mRecordTime, mPlayTime;

	private int frequence = 8000;
	private int channelConfig = AudioFormat.CHANNEL_IN_STEREO; //只能取值CHANNEL_OUT_STEREO
	//如果取值CHANNEL_OUT_DEFAULT，会报错“getMinBufferSize(): Invalid channel configuration.”
	//如果取值CHANNEL_OUT_MONO，会报错“java.lang.IllegalArgumentException: Unsupported channel configuration.”
	private int audioFormat = AudioFormat.ENCODING_PCM_16BIT; //AudioRecord只能录制PCM格式

	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_audio_record);

		tv_record = (TextView) findViewById(R.id.tv_record);
		btn_start = (Button) findViewById(R.id.btn_start);
		btn_stop = (Button) findViewById(R.id.btn_stop);
		tv_play = (TextView) findViewById(R.id.tv_play);
		btn_play = (Button) findViewById(R.id.btn_play);
		btn_finish = (Button) findViewById(R.id.btn_finish);

		btn_start.setEnabled(true);
		btn_stop.setEnabled(false);
		btn_play.setEnabled(false);
		btn_finish.setEnabled(false);
		btn_start.setOnClickListener(this);
		btn_stop.setOnClickListener(this);
		btn_play.setOnClickListener(this);
		btn_finish.setOnClickListener(this);
		createRecordDir();
	}

    private File mRecordFile = null;
	private void createRecordDir() {
		File sampleDir = new File(Environment.getExternalStorageDirectory()
				+ File.separator + "Download" + File.separator);
		if (!sampleDir.exists()) {
			sampleDir.mkdirs();
		}
		File recordDir = sampleDir;
		try {
			mRecordFile = File.createTempFile(Utils.getNowDateTime(), ".pcm", recordDir);
			Log.d(TAG, mRecordFile.getAbsolutePath());
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	@Override
	public void onClick(View v) {
		int resid = v.getId();
		if (resid == R.id.btn_start) {
			isRecording = true;
			new RecordTask().execute();
		} else if (resid == R.id.btn_stop) {
			isRecording = false;
		} else if (resid == R.id.btn_play) {
			isPlaying = true;
			new PlayTask().execute();
		} else if (resid == R.id.btn_finish) {
			isPlaying = false;
		}
	}

	private void refreshStatus(boolean isRecord, boolean isPlay) {
		if (isRecord || isPlay) {
			btn_start.setEnabled(false);
			btn_stop.setEnabled(isRecord?true:false);
			btn_play.setEnabled(false);
			btn_finish.setEnabled(isPlay?true:false);
		} else {
			btn_start.setEnabled(true);
			btn_stop.setEnabled(false);
			btn_play.setEnabled(true);
			btn_finish.setEnabled(false);
		}
	}

	private class RecordTask extends AsyncTask {
		@Override
		protected Void doInBackground(Void... arg0) {
			try {
				// 开通输出流到指定的文件
				DataOutputStream dos = new DataOutputStream(
						new BufferedOutputStream(new FileOutputStream(mRecordFile)));
				// 根据定义好的几个配置，来获取合适的缓冲大小
				int bsize = AudioRecord.getMinBufferSize(frequence, channelConfig, audioFormat);
				AudioRecord record = new AudioRecord(AudioSource.MIC, 
						frequence, channelConfig, audioFormat, bsize);
				// 定义缓冲区
				short[] buffer = new short[bsize];
				//record.setNotificationMarkerPosition(1000);
				record.setPositionNotificationPeriod(1000);
				record.setRecordPositionUpdateListener(new RecordUpdateListener());
				record.startRecording();

				while (isRecording) {
					int bufferReadResult = record.read(buffer, 0, buffer.length);
					// 循环将buffer中的音频数据写入到OutputStream中
					for (int i = 0; i < bufferReadResult; i++) {
						dos.writeShort(buffer[i]);
					}
				}
				record.stop();
				dos.close();
				Log.d(TAG, "mRecordFile.length()=" + mRecordFile.length());
			} catch (Exception e) {
				e.printStackTrace();
			}
			return null;
		}

		@Override
		protected void onPreExecute() {
			refreshStatus(true, false);
			mRecordTime = 0;
			mHandler.postDelayed(mRecordRun, 1000);
		}

		@Override
		protected void onPostExecute(Void result) {
			refreshStatus(false, false);
			mHandler.removeCallbacks(mRecordRun);
		}

	}
	
	private Runnable mRecordRun = new Runnable() {
		@Override
		public void run() {
			mRecordTime++;
			mHandler.postDelayed(this, 1000);
		}
	};
	
	private class RecordUpdateListener implements OnRecordPositionUpdateListener {

		@Override
		public void onMarkerReached(AudioRecord recorder) {
		}

		@Override
		public void onPeriodicNotification(AudioRecord recorder) {
			tv_record.setText(mRecordTime+"s");
		}
		
	}
	
	private class PlayTask extends AsyncTask {
		@Override
		protected Void doInBackground(Void... arg0) {
			try {
				// 定义输入流，将音频写入到AudioTrack类中，实现播放
				DataInputStream dis = new DataInputStream(
						new BufferedInputStream(new FileInputStream(mRecordFile)));
				int bsize = AudioTrack.getMinBufferSize(frequence, channelConfig, audioFormat);
				short[] buffer = new short[bsize / 4];
				AudioTrack track = new AudioTrack(AudioManager.STREAM_MUSIC,
						frequence, channelConfig, audioFormat, bsize, AudioTrack.MODE_STREAM);
				//track.setNotificationMarkerPosition(1000);
				track.setPositionNotificationPeriod(1000);
				track.setPlaybackPositionUpdateListener(new PlaybackUpdateListener());
				track.play();
				// 由于AudioTrack播放的是流，所以，我们需要一边播放一边读取
				while (isPlaying && dis.available() > 0) {
					int i = 0;
					while (dis.available() > 0 && i < buffer.length) {
						buffer[i] = dis.readShort();
						i++;
					}
					// 然后将数据写入到AudioTrack中
					track.write(buffer, 0, buffer.length);
				}
				track.stop();
				dis.close();
			} catch (Exception e) {
				e.printStackTrace();
			}
			return null;
		}

		@Override
		protected void onPreExecute() {
			refreshStatus(false, true);
			mPlayTime = 0;
			mHandler.postDelayed(mPlayRun, 1000);
		}

		@Override
		protected void onPostExecute(Void result) {
			refreshStatus(false, false);
			mHandler.removeCallbacks(mPlayRun);
		}

	}

	private Runnable mPlayRun = new Runnable() {
		@Override
		public void run() {
			mPlayTime++;
			mHandler.postDelayed(this, 1000);
		}
	};
	
	private class PlaybackUpdateListener implements OnPlaybackPositionUpdateListener {

		@Override
		public void onMarkerReached(AudioTrack track) {
		}

		@Override
		public void onPeriodicNotification(AudioTrack track) {
			tv_play.setText(mPlayTime+"s");
		}
		
	}
	
}

SoundPool

App使用过程中经常有些短小的提示声音，比如拍照的咔嚓声、扫一扫的吡一声，还有玩游戏击中目标的嗒嗒声，这些片段声音基本是系统自带的。如果使用MediaPlayer来播放，便存在诸如下面的不足之处：资源占用量较高、延迟时间较长、不支持多个音频同时播放等等。因此，我们需要一个短声音专用的播放器，这个播放器在Android中就是SoundPool。


SoundPool在使用时可以事先加载多个音频，然后在需要的时候播放指定编号的音频，这样处理有几个好处：
1、资源占用量小，不像MediaPlayer那么重；
2、延迟时间相对MediaPlayer延迟非常小；
3、可以同时播放多个音频，从而实现游戏过程中多个有效叠加的情景；
当然，SoundPool带来方便的同时也做了一部分牺牲，下面是使用它的一些限制：
1、SoundPool最大只能申请1M的内存，这意味着它只能播放一些很短的声音片段，不能用于播放歌曲或者游戏背景音乐；
2、虽然SoundPool提供了pause和stop方法，但是轻易不要使用这两个方法，因为它们可能会让你的App异常或崩溃；
3、SoundPool播放的音频格式建议使用ogg格式，据说它对wav格式的支持不太好；
4、待播放的音频要提前加载进SoundPool，不要等到要播放的时候才加载。因为SoundPool不会等音频加载完了才播放，所以它的延迟才比较小；而MediaPlayer会等待加载完毕才播放，所以延迟会比较大。


下面是SoundPool的常用方法说明：
构造函数 : 可设置最大个数、音频类型、音频质量。其中音频类型一般是AudioManager.STREAM_MUSIC，质量取值为0到100。
load : 加载指定的音频，该音频可以是个磁盘文件，也可以是资源文件。返回值为该音频的编号。
unload : 卸载指定编号的音频。
play : 播放指定编号的音频。可同时设置左右声道的音量（取值为0.0到1.0）、优先级（0为最低）、是否循环播放（0为只播放一次，-1为无限循环）、播放速率（取值为0.5-2.0，其中1.0为正常速率）。
setVolume : 设置指定编号音频的音量大小。
setPriority : 设置指定编号音频的优先级。
setLoop : 设置指定编号的音频是否循环播放。
setRate : 设置指定编号音频的播放速率。
pause : 暂停播放指定编号的音频。
resume : 恢复播放指定编号的音频。
autoPause : 暂停所有正在播放的音频。
autoResume : 恢复播放所有被暂停的音频。
stop : 停止播放指定编号的音频。
release : 释放所有音频资源。
setOnLoadCompleteListener : 设置音频加载完毕的监听器。该监听器扩展自OnLoadCompleteListener，需要重写onLoadComplete方法。


下面是SoundPool播放音频的示例代码：

import java.util.HashMap;

import android.app.Activity;
import android.media.AudioManager;
import android.media.SoundPool;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class SoundPlayActivity extends Activity implements OnClickListener {

	private SoundPool mSoundPool;
	private HashMap mSoundMap;
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_sound_play);

		Button btn_play_all = (Button) findViewById(R.id.btn_play_all);
		Button btn_play_first = (Button) findViewById(R.id.btn_play_first);
		Button btn_play_second = (Button) findViewById(R.id.btn_play_second);
		Button btn_play_third = (Button) findViewById(R.id.btn_play_third);
		btn_play_all.setOnClickListener(this);
		btn_play_first.setOnClickListener(this);
		btn_play_second.setOnClickListener(this);
		btn_play_third.setOnClickListener(this);
		
		mSoundMap = new HashMap();
		mSoundPool = new SoundPool(3, AudioManager.STREAM_MUSIC, 100);
		loadSound(1, R.raw.beep1);
		loadSound(2, R.raw.beep2);
		loadSound(3, R.raw.ring);
	}
	
	private void loadSound(int seq, int resid) {
		int soundID = mSoundPool.load(this, resid, 1);
		mSoundMap.put(seq, soundID);
	}

	private void playSound(int seq) {
		int soundID = mSoundMap.get(seq);
		mSoundPool.play(soundID, 1.0f, 1.0f, 1, 0, 1.0f);
	}

	@Override
	public void onClick(View v) {
		if (v.getId() == R.id.btn_play_all) {
			playSound(1);
			playSound(2);
			playSound(3);
		} else if (v.getId() == R.id.btn_play_first) {
			playSound(1);
		} else if (v.getId() == R.id.btn_play_second) {
			playSound(2);
		} else if (v.getId() == R.id.btn_play_third) {
			playSound(3);
		}
	}
	
	@Override
	protected void onDestroy() {
		if (mSoundPool != null) {
			mSoundPool.release();
		}
		super.onDestroy();
	}

}

自定义音乐播放器

大家常见的音乐播放器，不外乎主要有三项功能：
1、展示音乐/歌曲列表；
2、滚动展示歌词，并高亮显示当前正在播放的词句；
3、展示控制栏显示播放进度，并提供开始/暂停、拖动播放的功能，以及同时控制歌词的滚动情况；


对于第一点的展示歌曲列表，通过手工添加很费时费力，而且用户往往搞不清楚手机上的歌曲都放在哪个目录。我们假设用户是傻白甜，那自己开发的App就得智能贴心，主动帮用户把手机上的歌曲找出来。要实现这个功能，就到系统自带的媒体库中去查找，媒体库里音频资源的详细路径是MediaStore.Audio.Media.EXTERNAL_CONTENT_URI这个Uri，访问里面的音频记录，可以通过ContentResolver来完成。有关ContentResolver的具体用法参见《 Android开发笔记（五十四）数据共享接口ContentProvider》。下面是MediaStore.Audio.Media.EXTERNAL_CONTENT_URI里的主要字段信息说明：
Audio.Media._ID : 歌曲编号。
Audio.Media.TITLE : 歌曲的标题名称。
Audio.Media.ALBUM : 歌曲的专辑名称。
Audio.Media.DURATION : 歌曲的播放时间。
Audio.Media.SIZE : 歌曲文件的赌大小。
Audio.Media.ARTIST : 歌曲的演唱者。
Audio.Media.DATA : 歌曲文件的完整路径。


对于第二点的滚动歌词显示，通用的歌词文件是lrc格式的文本文件，内容主要是每句歌词的文字与开始时间。文本文件的解析并不复杂，难点主要在滚动显示上面。乍看起来歌词从下往上滚动，采用平移动画TranslateAnimation正合适；可是歌词滚动可不是匀速的，因为每句歌词的间隔时间并不固定，只能把整个歌词滚动分解为若干个动画，每个平移动画只负责前后两行歌词之间的滚动效果，前一行歌词的平移动画滚动完毕，马上开始下一行歌词的平移动画。另外，高亮显示当前演奏的歌词，这等于一段文字内的部分文字风格改变，虽然可以让每行文字都用单独的TextView来展示，但是一堆的TextView控件同时滚动很影响UI性能，所以建议采用可变字符串SpannableString直接处理段内文字，它的具体说明参见《 Android开发笔记（六）可变字符串》。


对于第三点的歌曲控制栏，总体上复用前一篇博文提到的视频控制栏VideoController，博文名称是《 Android开发笔记（一百二十五）自定义视频播放器》。不过歌曲控制栏还要更复杂，因为除了控制音频的播放，还要控制歌词动画的播放。更要命的是，平移动画TranslateAnimation居然不支持暂停和恢复操作，而且不只是平移动画，所有补间动画都不支持暂停和恢复。难道又要自己重定义动画了吗？刚想到这个的时候，不要说读者，就连笔者自己都想撞墙了。山穷水尽疑无路，柳暗花明又一村，幸好Android还给我们提供了属性动画这么一个好东东，属性动画不但支持所有的补间动画效果，而且也支持暂停和恢复操作，所以还等什么，赶紧把TranslateAnimation换成了ObjectAnimator。有关属性动画的详细介绍参见《 Android开发笔记（九十六）集合动画与属性动画》。


弄完以上三点功能，一个主流音乐播放器的雏形便出来了，下面是音乐播放器的歌曲列表截图：



下面是音乐播放器的歌曲详情页的效果截图：
  


下面是音乐播放器的歌曲详情页面的代码例子：

import java.io.BufferedInputStream;
import java.io.DataInputStream;
import java.io.FileInputStream;
import java.util.ArrayList;

import com.example.exmaudio.bean.LrcContent;
import com.example.exmaudio.bean.MusicInfo;
import com.example.exmaudio.util.LyricsLoader;
import com.example.exmaudio.util.Utils;
import com.example.exmaudio.widget.AudioController;
import com.example.exmaudio.widget.AudioController.onSeekChangeListener;

import android.animation.Animator;
import android.animation.Animator.AnimatorListener;
import android.animation.ObjectAnimator;
import android.annotation.TargetApi;
import android.app.Activity;
import android.graphics.Color;
import android.media.AudioFormat;
import android.media.AudioManager;
import android.media.AudioTrack;
import android.media.MediaPlayer;
import android.media.MediaPlayer.OnCompletionListener;
import android.os.AsyncTask;
import android.os.Build;
import android.os.Bundle;
import android.os.Handler;
import android.text.SpannableString;
import android.text.Spanned;
import android.text.style.ForegroundColorSpan;
import android.util.Log;
import android.view.View;
import android.view.animation.AnimationUtils;
import android.widget.TextView;

@TargetApi(Build.VERSION_CODES.KITKAT)
public class MusicDetailActivity extends Activity 
		implements AnimatorListener, onSeekChangeListener {
	private static final String TAG = "MusicDetailActivity";

	private TextView tv_title;
	private TextView tv_artist;
	private TextView tv_music;
	private MusicInfo mMusic;
    private MediaPlayer mMediaPlayer;
	private AudioController ac_play;
	private LyricsLoader mLoader;
	private ArrayList mLrcList;
	private Handler mHandler = new Handler();

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_music_detail);

		tv_title = (TextView) findViewById(R.id.tv_title);
		tv_artist = (TextView) findViewById(R.id.tv_artist);
		tv_music = (TextView) findViewById(R.id.tv_music);
		ac_play = (AudioController) findViewById(R.id.ac_play);
		
		ac_play.setonSeekChangeListener(this);
		mMusic = getIntent().getParcelableExtra("music");
		tv_title.setText(mMusic.getTitle());
		tv_artist.setText(mMusic.getArtist());
		mLoader = LyricsLoader.getInstance(mMusic.getUrl());
		mLrcList = mLoader.getLrcList();
        mMediaPlayer = new MediaPlayer();
        playMusic(mMusic.getUrl());
	}

    private void playMusic(String file_path) {
		if (mMediaPlayer.isPlaying()) {
			mMediaPlayer.stop();
		}
		if (Utils.getExtendName(file_path).equals("pcm")) {
			ac_play.setVisibility(View.GONE);
			PlayTask playTask = new PlayTask();
			playTask.execute(file_path);
		} else {
			playMedia(file_path);
		}
    }

	private void playMedia(String filePath) {
		try {
			mMediaPlayer.reset();
			//mMediaPlayer.setVolume(0.5f, 0.5f);  //设置音量，可选
			mMediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
			mMediaPlayer.setDataSource(filePath);
			mMediaPlayer.prepare();
			mMediaPlayer.start();
			mHandler.post(mRefreshCtrl);
			mMediaPlayer.setOnCompletionListener(new OnCompletionListener() {
				@Override
				public void onCompletion(MediaPlayer mp) {
					ac_play.setCurrentTime(0, 0);
				}
			});
			ac_play.setMediaPlayer(mMediaPlayer);

			//以下处理歌词
			if (mLoader.getLrcList()!=null && mLrcList.size()>0) {
				mLrcStr = "";
				for (int i=0; i0?mNextPos:mLrcStr.length()-1, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
			mCount++;
			tv_music.setText(spanText);
			if (mNextPos > 0 && mNextPos < mLrcStr.length()-1) {
				mPrePos = mLrcStr.indexOf("\n", mNextPos);
				mHandler.postDelayed(mRefreshLrc, 50);
			}
		}
	}

	@Override
	public void onAnimationCancel(Animator animation) {
	}

	@Override
	public void onAnimationRepeat(Animator animation) {
	}
	
	private int frequence = 8000;
	private int channelConfig = AudioFormat.CHANNEL_IN_STEREO; //只能取值CHANNEL_OUT_STEREO
	private int audioFormat = AudioFormat.ENCODING_PCM_16BIT;
	private class PlayTask extends AsyncTask {
		@Override
		protected Void doInBackground(String... arg0) {
			try {
				// 定义输入流，将音频写入到AudioTrack类中，实现播放
				DataInputStream dis = new DataInputStream(
						new BufferedInputStream(new FileInputStream(arg0[0])));
				int bsize = AudioTrack.getMinBufferSize(frequence, channelConfig, audioFormat);
				short[] buffer = new short[bsize / 4];
				AudioTrack track = new AudioTrack(AudioManager.STREAM_MUSIC,
						frequence, channelConfig, audioFormat, bsize, AudioTrack.MODE_STREAM);
				track.play();
				// 由于AudioTrack播放的是流，所以，我们需要一边播放一边读取
				while (dis.available() > 0) {
					int i = 0;
					while (dis.available() > 0 && i < buffer.length) {
						buffer[i] = dis.readShort();
						i++;
					}
					// 然后将数据写入到AudioTrack中
					track.write(buffer, 0, buffer.length);
				}
				track.stop();
				dis.close();
			} catch (Exception e) {
				e.printStackTrace();
			}
			return null;
		}

	}

}

下面是音乐播放器的歌曲控制栏的代码例子：

import com.example.exmaudio.R;
import com.example.exmaudio.util.Utils;

import android.content.Context;
import android.graphics.Color;
import android.media.MediaPlayer;
import android.util.AttributeSet;
import android.util.TypedValue;
import android.view.Gravity;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.ImageView;
import android.widget.RelativeLayout;
import android.widget.SeekBar;
import android.widget.SeekBar.OnSeekBarChangeListener;
import android.widget.TextView;

public class AudioController extends RelativeLayout implements OnClickListener, OnSeekBarChangeListener {
	private static final String TAG = "AudioController";

	private Context mContext;
	private ImageView mImagePlay;
	private TextView mCurrentTime;
	private TextView mTotalTime;
	private SeekBar mSeekBar;
	private int mBeginViewId = 0x7F24FFF0;
	private int dip_10, dip_40;

	private MediaPlayer mMediaPlayer;
	private int mCurrent = 0;
	private int mBuffer = 0;
	private int mDuration = 0;
	private boolean bPause = false;
	
	public AudioController(Context context) {
		this(context, null);
	}

	public AudioController(Context context, AttributeSet attrs) {
		super(context, attrs);
		mContext = context;
		dip_10 = Utils.dip2px(mContext, 10);
		dip_40 = Utils.dip2px(mContext, 40);
		initView();
	}

	private TextView newTextView(Context context, int id) {
		TextView tv = new TextView(context);
		tv.setId(id);
		tv.setGravity(Gravity.CENTER);
		tv.setTextColor(Color.WHITE);
		tv.setTextSize(TypedValue.COMPLEX_UNIT_SP, 14);
		RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams(
				LayoutParams.WRAP_CONTENT, LayoutParams.MATCH_PARENT);
		params.addRule(RelativeLayout.CENTER_VERTICAL);
		tv.setLayoutParams(params);
		return tv;
	}
	
	private void initView() {
		mImagePlay = new ImageView(mContext);
		RelativeLayout.LayoutParams imageParams = new RelativeLayout.LayoutParams(dip_40, dip_40);
		imageParams.addRule(RelativeLayout.CENTER_VERTICAL);
		mImagePlay.setLayoutParams(imageParams);
		mImagePlay.setId(mBeginViewId);
		mImagePlay.setOnClickListener(this);
		
		mCurrentTime = newTextView(mContext, mBeginViewId+1);
		RelativeLayout.LayoutParams currentParams = (LayoutParams) mCurrentTime.getLayoutParams();
		currentParams.setMargins(dip_10, 0, 0, 0);
		currentParams.addRule(RelativeLayout.RIGHT_OF, mImagePlay.getId());
		mCurrentTime.setLayoutParams(currentParams);

		mTotalTime = newTextView(mContext, mBeginViewId+2);
		RelativeLayout.LayoutParams totalParams = (LayoutParams) mTotalTime.getLayoutParams();
		totalParams.addRule(RelativeLayout.ALIGN_PARENT_RIGHT);
		mTotalTime.setLayoutParams(totalParams);
		
		mSeekBar = new SeekBar(mContext);
		RelativeLayout.LayoutParams seekParams = new RelativeLayout.LayoutParams(
				LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
		totalParams.setMargins(dip_10, 0, dip_10, 0);
		seekParams.addRule(RelativeLayout.CENTER_IN_PARENT);
		seekParams.addRule(RelativeLayout.RIGHT_OF, mCurrentTime.getId());
		seekParams.addRule(RelativeLayout.LEFT_OF, mTotalTime.getId());
		mSeekBar.setLayoutParams(seekParams);
		mSeekBar.setMax(100);
		mSeekBar.setMinimumHeight(100);
		mSeekBar.setThumbOffset(0);
		mSeekBar.setId(mBeginViewId+3);
		mSeekBar.setOnSeekBarChangeListener(this);
	}

	private void reset() {
		if (mCurrent == 0 || bPause) {
			mImagePlay.setImageResource(R.drawable.audio_btn_down);
		} else {
			mImagePlay.setImageResource(R.drawable.audio_btn_on);
		}
		mCurrentTime.setText(Utils.formatTime(mCurrent));
		mTotalTime.setText(Utils.formatTime(mDuration));
		mSeekBar.setProgress((mCurrent==0)?0:(mCurrent*100/mDuration));
		mSeekBar.setSecondaryProgress(mBuffer);
	}
	
	private void refresh() {
		invalidate();
		requestLayout();
	}
	
	@Override
	protected void onLayout(boolean changed, int l, int t, int r, int b) {
		super.onLayout(changed, l, t, r, b);
		removeAllViews();
		reset();
		addView(mImagePlay);
		addView(mCurrentTime);
		addView(mTotalTime);
		addView(mSeekBar);
	}

	@Override
	public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
		if (fromUser) {
			int time = progress * mDuration / 100;
			mMediaPlayer.seekTo(time);
		}
	}

	@Override
	public void onStartTrackingTouch(SeekBar seekBar) {
	}

	@Override
	public void onStopTrackingTouch(SeekBar seekBar) {
		int time = seekBar.getProgress() * mDuration / 100;
		mSeekListener.onMusicSeek(mMediaPlayer.getCurrentPosition(), time);
	}
	
	private onSeekChangeListener mSeekListener;
	public static interface onSeekChangeListener {
		public void onMusicSeek(int current, int seekto);
		public void onMusicPause();
		public void onMusicResume();
	}
	public void setonSeekChangeListener(onSeekChangeListener listener) {
		mSeekListener = listener;
	}

	@Override
	public void onClick(View v) {
		if (v.getId() == mImagePlay.getId()) {
			if (mMediaPlayer.isPlaying()) {
				mMediaPlayer.pause();
				bPause = true;
				mSeekListener.onMusicPause();
			} else {
				if (mCurrent == 0) {
					mSeekListener.onMusicSeek(0, 0);
				}
				mMediaPlayer.start();
				bPause = false;
				mSeekListener.onMusicResume();
			}
		}
		refresh();
	}
	
	public void setMediaPlayer(MediaPlayer view) {
		mMediaPlayer = view;
		mDuration = mMediaPlayer.getDuration();
	}
	
	public void setCurrentTime(int current_time, int buffer_time) {
		mCurrent = current_time;
		mBuffer = buffer_time;
		refresh();
	}

}

点击下载本文用到的自定义音乐播放器的工程代码



点此查看Android开发笔记的完整目录