Android录音功能的实现及踩坑记录
最近接到个需求,不使用第三方SDK的情况下实现IM通讯,文字聊天已经通过MQTT实现,而语音功能目前想到的较好解决方案就是进行录音文件的上传下载。可能还有更好解决方案,但我目前没想到,有建议的小伙伴劳烦指导下。
前提 :
1、权限申请:
清单文件中加上:
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
对应读写文件和录音权限。
2、录音文件要写到相应文件夹中,此文件夹要先创建,丢到Application或Activity的onCreate()中都可以,但一定要先创建。
代码实现流程 :
1、创建MediaRecorder对象;
2、调用setAudioSource()方法设置声音的来源,一般传入MediaRecorder.MIC;
3、调用setOutputFormat()设置所录制的音频文件的格式;
4、调用setAudioRncoder()、setAudioEncodingBitRate(int bitRate)、setAudioSamlingRate(int SamplingRate)设置所录音的编码格式、编码位率、采样率等,当然不是每个都需要,根据具体业务调整(setAudioEncodingBitRate(96000),编码位率一般是96000);
5、调用setOutputFile(String path)方法设置录制的音频文件的保存位置;
6、调用MediaRecoder对象的Prepare()方法准备录制;
7、调用MediaRecoder对象的start()方法开始录制;
8、结束后调用MediaRecoder对象的stop()方法停止录制,并调用release()方法释放资源。
示例如下:
public class TestActivity extends BaseActivity {
private ActivityChatBinding testBinding;
private MediaRecorder mediaRecorder;
private boolean isRecorded;
@Override
public void initView() {
testBinding = ActivityTestBinding.inflate(getLayoutInflater());
setContentView(testBinding.getRoot());
initMsgAndSth();
checkPermission();
}
private void initMsgAndSth(){
String record_Home = this.getFilesDir()+"/Sample"; //声明存储路径,用绝对路径什么都可以
//btnTalk就是个Button
testBinding.btnTalk.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (isRecorded)
stopRecordAudio();
else
startRecordAudio(record_Home);
}
});
}
private void stopRecordAudio() {
//有的5.0机型上MediaRecorder.stop会报错,这里建议抓取一下异常
if(mediaRecorder !=null){
try {
mediaRecorder.stop();//停止录音
mediaRecorder.release();//释放资源
mediaRecorder =null;
}catch (Exception exception){
mediaRecorder.reset();//重置
mediaRecorder.release();//释放资源
mediaRecorder =null;
}
Toast.makeText(this,"停止录音",Toast.LENGTH_SHORT).show();
}
}
private void startRecordAudio(String path) {
//文件夹一定要先创建,不然报错的bug信息中是找不到这里的
File audioFile = new File(path);
if (!audioFile.exists()) {
audioFile.mkdirs();
} else if (!audioFile.isDirectory()) {
audioFile.delete();
audioFile.mkdirs();
}
File file = new File(path + "Sample.amr");
if(!file.exists()){
try {
file.createNewFile();
} catch (IOException e) {
e.printStackTrace();
}
}
if(mediaRecorder == null){
mediaRecorder = new MediaRecorder();
mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);//设置麦克风
/*
* 设置保存输出文件的格式:THREE_GPP/MPEG-4/RAW_AMR/Default THREE_GPP(3gp格式
* ,H263视频/ARM音频编码)、MPEG-4、RAW_AMR(只支持音频且音频编码要求为AMR_NB)
*/
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.AMR_NB);
mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB);//设置音频文件编码格式
mediaRecorder.setOutputFile(path+"Sample.amr");
}
try {
mediaRecorder.prepare(); //start之前要先prepare
mediaRecorder.start();
isRecorded = true;
Toast.makeText(this,"开始录音",Toast.LENGTH_SHORT).show();
} catch (IllegalStateException el){
el.printStackTrace();
} catch (RuntimeException e){
e.printStackTrace();
} catch (Exception e){
e.printStackTrace();
}
}
/**
* 简单的权限申请逻辑
*/
private void checkPermission() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
String[] permissions = new String[]{Manifest.permission.RECORD_AUDIO,Manifest.permission.WRITE_EXTERNAL_STORAGE};
for (String permission : permissions) {
if (ContextCompat.checkSelfPermission(this, permission) != PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(this, permissions, 200);
return;
}
}
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[]
grantResults) {
super.onRequestPermissionsResult(requestCode,permissions,grantResults);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && requestCode == 200) {
for (int i = 0; i < permissions.length; i++) {
if (grantResults[i] != PackageManager.PERMISSION_GRANTED) {
Intent intent = new Intent();
intent.setAction(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
Uri uri = Uri.fromParts("package", getPackageName(), null);
intent.setData(uri);
startActivityForResult(intent, 200);
return;
}
}
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (resultCode == RESULT_OK && requestCode == 200) {
checkPermission();
}
}
}
相关API差异已经写的很详细了,布局很简单,这里就不贴出来了。这里要特别注意的是调用顺序不能改变,否则容易报错,且因为调用顺序不对而报错的提示信息也不一定足够去定位问题。
踩坑
按照前面的提示,觉得避开所有坑能愉快的玩耍了,结果运行报错,有的机型还不打印特定日志,只能自己去鼓捣。
1、Android Q:
有的时候根据报错分类,还是能抓到点蛛丝马迹。如果是Android Q的设备,报IO异常或者Permission Denied错误,则要检查下清单文件中application标签里有没有这句:
android:requestLegacyExternalStorage="true"
没有的话一定要加上。
原因在于安卓10开始,要想访问外部存储的所有文件,除了动态申请权限 和 权限申明外,必须在主工程AndroidManifest.xml中加上这句,用于申请外部存储所有文件的权限。
2、RuntimeException:setAudioSource failed
如果程序运行看到
RuntimeException: setAudioSource failed
报错,请确保申请权限相关逻辑正确,还有清单文件中相关权限的申请,但如果(虽然是极少概率,但我碰到了)添加权限后,依旧还报这个错,请进入手机设置-应用,找到你发布上去的应用,给其授权。部分机型在调试过程中除了第一次会提示授权外,再次安装则不会再提示,这就相当于用户没有授予相关的录音和sdcard读写权限,程序依然会报错。所以,建议每次开始进行录音等逻辑前,进行一次逻辑判断。
此外还有一种情况会出现此报错,在录音结束后没有调用mediaRecorder.release()去释放资源,而又处于stop状态,这时候再去prepare、start容易报此错,此时报错打印堆栈与原先堆栈报错信息差别不大,较难定位,因此要格外注意。
3、MediaRecorder: stop failed
在调用start()后,马上进行调用stop()的操作,由于没有生成有效的音频或是视频数据,会报此错误。这个情景在即时通讯过程中很常见,可以通过让其线程睡眠小段时间(建议最少1秒),再stop()。官方文档注释对此也有解释:Note that a RuntimeException is intentionally thrown to the application, if no valid audio/video data has been received when stop() is called.