Android录音功能的实现及踩坑记录

最近接到个需求，不使用第三方SDK的情况下实现IM通讯，文字聊天已经通过MQTT实现，而语音功能目前想到的较好解决方案就是进行录音文件的上传下载。可能还有更好解决方案，但我目前没想到，有建议的小伙伴劳烦指导下。

前提 ：

1、权限申请：
清单文件中加上：

对应读写文件和录音权限。

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;@Overridepublic void initView() {testBinding = ActivityTestBinding.inflate(getLayoutInflater());setContentView(testBinding.getRoot());initMsgAndSth();checkPermission();}private void initMsgAndSth(){String record_Home = this.getFilesDir()+"/Sample";//声明存储路径，用绝对路径什么都可以//btnTalk就是个ButtontestBinding.btnTalk.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {if (isRecorded)stopRecordAudio();elsestartRecordAudio(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之前要先preparemediaRecorder.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;}}}}@Overridepublic 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;}}}}@Overrideprotected 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.