Android 正在录音权限

原创

mob649e8157aaee 2024-09-06 06:09:22 ©著作权

文章标签 Android xml 权限问题 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob649e8157aaee的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android 正在录音权限的科普文章

在Android开发中，录音能力是一项非常重要的功能，尤其在语音助手、音频备忘录及其他音频相关应用中。为了在应用中实现录音功能，开发者必须处理好权限问题。本文将介绍如何在Android中获取录音权限，并结合代码示例、类图和序列图来帮助大家更好地理解。

一、Android权限机制

Android的权限机制遵循最小权限原则，意味着应用应仅请求其正常运行所需的最少权限。对于录音功能，应用需要申请 RECORD_AUDIO 权限。

1. 权限声明

在AndroidManifest.xml文件中声明必要的权限：

<manifest xmlns:android="
    package="com.example.audiorecorder">

    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
    
    <application
        ...>
        ...
    </application>
</manifest>

2. 动态申请权限

从Android 6.0（API 23）开始，权限需要在运行时动态申请。下面的代码示例展示了如何在Activity中申请录音权限。

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Bundle;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

public class MainActivity extends AppCompatActivity {

    private static final int REQUEST_RECORD_AUDIO_PERMISSION = 200;
    private boolean permissionToRecordAccepted = false;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 动态请求录音权限
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.RECORD_AUDIO},
                    REQUEST_RECORD_AUDIO_PERMISSION);
        } else {
            permissionToRecordAccepted = true;
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (requestCode == REQUEST_RECORD_AUDIO_PERMISSION) {
            permissionToRecordAccepted = grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED;
        }
        if (!permissionToRecordAccepted) finish();
    }
}

二、代码结构与类图

为了让录音功能更具模块性，我们通常会封装一个录音管理类。下面是一个类图，展示了如何组织录音管理器。

classDiagram
    class AudioRecorder {
        +startRecording()
        +stopRecording()
        +release()
    }
    class MainActivity {
        -audioRecorder: AudioRecorder
        +onCreate()
        +onRequestPermissionsResult()
    }
    
    MainActivity "1" --> "1" AudioRecorder

三、实现录音功能

在录音管理类中，我们将实现开始录音、停止录音与释放资源等功能。

1. AudioRecorder实现

import android.media.MediaRecorder;
import java.io.IOException;

public class AudioRecorder {
    private MediaRecorder recorder;
    private String filePath;

    public AudioRecorder(String filePath) {
        this.filePath = filePath;
    }

    public void startRecording() throws IOException {
        recorder = new MediaRecorder();
        recorder.setAudioSource(MediaRecorder.AudioSource.MIC);
        recorder.setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP);
        recorder.setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB);
        recorder.setOutputFile(filePath);
        recorder.prepare();
        recorder.start();
    }

    public void stopRecording() {
        recorder.stop();
        recorder.release();
        recorder = null;
    }
}

四、序列图

下面的序列图展示了用户与应用交互以实现录音的过程。

sequenceDiagram
    participant User
    participant MainActivity
    participant AudioRecorder

    User->>MainActivity: Launch Application
    MainActivity->>MainActivity: Check Permissions
    alt Permissions Granted
        MainActivity->>AudioRecorder: Create Instance
        User->>MainActivity: Click Record
        MainActivity->>AudioRecorder: startRecording()
    else Permissions Denied
        User->>MainActivity: Request Permissions
        MainActivity->>User: Show Permission Request
    end
    User->>MainActivity: Click Stop
    MainActivity->>AudioRecorder: stopRecording()