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.

来源：https://juejin.cn/post/7103565497425199140