Android 錄音功能直接拿去用
前言
最近專案中需要用到錄音的功能，借鑑了外國一位哥們的專案https://github.com/dkim0419/SoundRecorder ，搞定需求之後，花了些時間封裝成一個錄音的工具包，分享給大家，需要原始碼的 點選這裡
先貼個效果圖給大家看一下，看看這個錄音包的功能
SoundRecorderUtils.gif一、實現錄音的 Service
這個類可以說是這個包的核心了，如果理解了這個 Service，錄音這一塊基本就沒什麼問題了。
錄音主要是利用 MediaRecoder 這個類，進行聲音的記錄，接下來我們一起來看看具體的實現。
public class RecordingService extends 可以看到在 onStartCommand() 裡面有一個 startRecording() 方法，在外部啟動這個 RecordingService 的時候，便會呼叫這個 startRecording() 方法開始錄音。
在 startRecording() 方法中先呼叫了 setFileNameAndPath 方法，初始化了錄音檔案的名字和儲存的路徑，為了讓每個錄音檔案都有唯一的名字，我呼叫 System.currentMillis()拼接到錄音檔案的名字裡面。
public void setFileNameAndPath() {
File f;
do {
count++;
mFileName = getString(R.string.default_file_name)
+ "_" + (System.currentTimeMillis()) + ".mp4";
mFilePath = Environment.getExternalStorageDirectory().getAbsolutePath();
mFilePath += "/SoundRecorder/" + mFileName;
f = new File(mFilePath);
} while (f.exists() && !f.isDirectory());
}
設定好了檔案的名字和儲存路徑之後，對 mRecorder 進行一系列引數的設定，這個mRecorder 是 MediaRecorder 的一個例項，專門用於錄音的儲存。
mRecorder = new MediaRecorder();
mRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);
mRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4); //錄音檔案儲存的格式，這裡儲存為 mp4
mRecorder.setOutputFile(mFilePath); // 設定錄音檔案的儲存路徑
mRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AAC);
mRecorder.setAudioChannels(1);
// 設定錄音檔案的清晰度
mRecorder.setAudioSamplingRate(44100);
mRecorder.setAudioEncodingBitRate(192000);
try {
mRecorder.prepare();
mRecorder.start();
mStartingTimeMillis = System.currentTimeMillis();
} catch (IOException e) {
Log.e(LOG_TAG, "prepare() failed");
}
設定好引數之後，啟動 mRecorder 開始錄音，可以看到啟動 mRecorder 開始錄音後，我還將當前的時間賦值給 mStartingTimeMills，這裡主要是為了記錄錄音的時長，等到錄音結束後再獲取一次當前的時間，然後將兩個時間進行相減，就能得到錄音的具體時長了。
等到錄音結束，停止服務後，便會回撥 RecordingService 的 onDestroy() 方法，這時候便會呼叫 stopRecording() 方法，關閉 mRecorder，並用 SharedPreferences 保存錄音檔案的資訊，最後將 mRecorder 置空，防止記憶體洩露
public void stopRecording() {
mRecorder.stop();
mElapsedMillis = (System.currentTimeMillis() - mStartingTimeMillis);
mRecorder.release();
getSharedPreferences("sp_name_audio", MODE_PRIVATE)
.edit()
.putString("audio_name", mFileName)
.putString("audio_path", mFilePath)
.putLong("elpased", mElapsedMillis)
.apply();
if (mIncrementTimerTask != null) {
mIncrementTimerTask.cancel();
mIncrementTimerTask = null;
}
mRecorder = null;
}
二、顯示錄音介面的 RecordAudioDialogFragment
使用者進行的時候，總不能讓 App 跳轉到另外一個介面吧，這樣使用者體驗並不是很好，比較好的方法是顯示一個對話方塊，讓使用者進行操作，既然要用對話方塊，必然離不開 DialogFragment，對於 DialogFragment 不是很瞭解，可以先看看我這篇文章 Android 擼起袖子，自己封裝 DialogFragment。
public class RecordAudioDialogFragment extends DialogFragment {
private boolean mStartRecording = true;
long timeWhenPaused = 0;
private FloatingActionButton mFabRecord;
private Chronometer mChronometerTime;
public static RecordAudioDialogFragment newInstance(int maxTime) {
RecordAudioDialogFragment dialogFragment = new RecordAudioDialogFragment();
Bundle bundle = new Bundle();
bundle.putInt("maxTime", maxTime);
dialogFragment.setArguments(bundle);
return dialogFragment;
}
@NonNull
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
Dialog dialog = super.onCreateDialog(savedInstanceState);
final AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
View view = getActivity().getLayoutInflater().inflate(R.layout.fragment_record_audio, null);
mFabRecord.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.WRITE_EXTERNAL_STORAGE)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(getActivity()
, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.RECORD_AUDIO}, 1);
}else {
onRecord(mStartRecording);
mStartRecording = !mStartRecording;
}
}
});
builder.setView(view);
return builder.create();
}
private void onRecord(boolean start) {
Intent intent = new Intent(getActivity(), RecordingService.class);
if (start) {
File folder = new File(Environment.getExternalStorageDirectory() + "/SoundRecorder");
if (!folder.exists()) {
folder.mkdir();
}
mChronometerTime.setBase(SystemClock.elapsedRealtime());
mChronometerTime.start();
getActivity().startService(intent);
} else {
mChronometerTime.stop();
timeWhenPaused = 0;
getActivity().stopService(intent);
}
}
}
可以看到在 RecordAudioDialogFragment 有一個 newInstance(int maxTime) 的靜態方法供外部呼叫，如果想設定錄音的最大時長，直接傳引數進去就行了。
好的，敲黑板，重點來了，其實這個對話方塊的重點部分就是在 onCreateDialog()中，我們先載入了我們自定義的對話方塊的佈局，當點選錄音的按鈕的時候，先進行相關許可權的申請，這裡有個巨坑，錄音許可權 android.permission.RECORD_AUDIO 在不久前還是普通許可權的，不知道什麼時候突然變成了危險許可權，需要我們進行申請，Google 真是會玩。
public Dialog onCreateDialog(Bundle savedInstanceState) {
Dialog dialog = super.onCreateDialog(savedInstanceState);
final AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
View view = getActivity().getLayoutInflater().inflate(R.layout.fragment_record_audio, null);
mFabRecord.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.WRITE_EXTERNAL_STORAGE)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(getActivity()
, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.RECORD_AUDIO}, 1);
}else {
onRecord(mStartRecording);
mStartRecording = !mStartRecording;
}
}
});
builder.setView(view);
return builder.create();
}
申請好許可權之後便會呼叫 onRecord() 這個方法，然後將 boolean mStartRecording 進行反轉，這樣就不用寫難看的 if else 了，直接改變 mStartRecording 的值，然後在 onRecord() 裡面進行處理
接下來看下 onRecord 幹了什麼
private void onRecord(boolean start) {
Intent intent = new Intent(getActivity(), RecordingService.class);
if (mStartRecording) {
File folder = new File(Environment.getExternalStorageDirectory() + "/SoundRecorder");
if (!folder.exists()) {
folder.mkdir();
}
mChronometerTime.setBase(SystemClock.elapsedRealtime());
mChronometerTime.start();
getActivity().startService(intent);
} else {
mChronometerTime.stop();
timeWhenPaused = 0;
getActivity().stopService(intent);
}
}
好吧，其實並沒有幹了什麼大事，只是建立了保存錄音檔案的資料夾，然後根據 mStartRecording 的值進行 RecordingService 的啟動和關閉罷了。在啟動時還順便開始了 mChronometer 的計時顯示，這是一個 Android 原生的顯示計時的一個控制元件。
三、播放錄音的 PlaybackDialogFragment
其實，如果只是錄音這一塊的話，寫個 MediaPlayer 就可以了，然而還要寫播放的時間進度，以及顯示一個稍微好看點的進度條，我能怎樣，我也很煩啊。
外部呼叫這個對話方塊的時候，只需要傳入一個包含錄音檔案資訊的 RecordingItem，因為包含的資訊比較多，所以最好將 RecordingItem 進行序列化。
public static PlaybackDialogFragment newInstance(RecordingItem item) {
PlaybackDialogFragment fragment = new PlaybackDialogFragment();
Bundle bundle = new Bundle();
bundle.putParcelable(ARG_ITEM, item);
fragment.setArguments(b);
return fragment;
}
好，重點又來了，來看看 onCreateDialog() 方法，在載入了佈局之後，給 mSeekBar 設定監聽，mSeekBar 是一個顯示進度條的控制元件，當開始播放錄音時候，將錄音檔案的時長，設定進 mSeekBar 裡面，播放錄音的同時，執行 mSeekBar，通過監聽 mSeekBar 的進度，重新整理顯示的播放進度。
public Dialog onCreateDialog(Bundle savedInstanceState) {
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
View view = getActivity().getLayoutInflater().inflate(R.layout.fragment_media_playback, null);
mTvFileLength.setText(String.valueOf(mFileLength));
mSeekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
@Override
public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
if(mMediaPlayer != null && fromUser) {
mMediaPlayer.seekTo(progress);
mHandler.removeCallbacks(mRunnable);
long minutes = TimeUnit.MILLISECONDS.toMinutes(mMediaPlayer.getCurrentPosition());
long seconds = TimeUnit.MILLISECONDS.toSeconds(mMediaPlayer.getCurrentPosition())
- TimeUnit.MINUTES.toSeconds(minutes);
mCurrentProgressTextView.setText(String.format("%02d:%02d", minutes,seconds));
updateSeekBar();
} else if (mMediaPlayer == null && fromUser) {
prepareMediaPlayerFromPoint(progress);
updateSeekBar();
}
}
});
mPlayButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
onPlay(isPlaying);
isPlaying = !isPlaying;
}
});
mTvFileLength.setText(String.format("%02d:%02d", minutes,seconds));
builder.setView(view);
return builder.create();
}
當點選播放錄音的按鈕之後，會呼叫 onPlay() 方法，然後根據 isPlaying（標識當前是否播放錄音）的值，來呼叫不同的方法
private void onPlay(boolean isPlaying){
if (!isPlaying) {
if(mMediaPlayer == null) {
startPlaying(); //start from beginning
}
} else {
pausePlaying();
}
}
我們最關心的，莫過於 startPlaying() 這個方法，這個方法便是來開啟播放錄音的，我們首先將外部傳入的有關的錄音資訊，設定給 MediaPlayer，然後開始呼叫 mMediaPlayer.start() 進行錄音的播放，然後呼叫 updateSeekbar() 實時更新進度條的內容。當 MediaPlayer 的內容播放完成後，呼叫 stopPlaying() 方法，關閉 mMediaPlayer。
private void startPlaying() {
mMediaPlayer = new MediaPlayer();
mMediaPlayer.setDataSource(item.getFilePath());
mMediaPlayer.prepare();
mSeekBar.setMax(mMediaPlayer.getDuration());
mMediaPlayer.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
@Override
public void onPrepared(MediaPlayer mp) {
mMediaPlayer.start();
}
});
mMediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
@Override
public void onCompletion(MediaPlayer mp) {
stopPlaying();
}
});
updateSeekBar();
}
以上便是本文的全部內容，有關的程式碼我已經上傳到 Github 上了，需要的 點選這裡，喜歡的話，歡迎來波 star 和 fork