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.

相关推荐
皮皮高2 分钟前
itvbox绿豆影视tvbox手机版影视APP源码分享搭建教程
android·前端·后端·开源·tv
EnzoRay34 分钟前
MotionEvent
android
玲小珑1 小时前
Auto.js 入门指南(七)定时任务调度
android·前端
墨狂之逸才1 小时前
adb常用命令调试
android
YoungForYou1 小时前
Android端部署NCNN
android
移动开发者1号2 小时前
Jetpack Compose瀑布流实现方案
android·kotlin
移动开发者1号2 小时前
Android LinearLayout、FrameLayout、RelativeLayout、ConstraintLayout大混战
android·kotlin
移动开发者1号2 小时前
ListView与RecyclerView区别总结
android·kotlin
移动开发者1号2 小时前
OkHttp 3.0源码解析:从设计理念到核心实现
android·kotlin
小草帽学编程5 小时前
鸿蒙Next开发真机调试签名申请流程
android·华为·harmonyos