萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android MediaRecorder 錄音功能完整實現:從權限申請到文件管理的生產級代碼架構

Android 錄音涉及權限動態申請、MediaRecorder 狀態機管理、音頻源/編碼/輸出格式配置、文件命名存儲、播放驗證、資源釋放等完整鏈路。本文提供一個健壯、可復用的 AudioRecorderManager 單例封裝,覆蓋核心邏輯與異常處理,可直接集成至項目。

一、 權限聲明 (AndroidManifest.xml)

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- API 28 以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />  <!-- API 28 以下 -->
<!-- Android 10+ (Q) 針對性存儲適配 -->
<application android:requestLegacyExternalStorage="true" ... > ... </application>

二、 核心錄音管理器 AudioRecorderManager.java

public class AudioRecorderManager {
    private static final String TAG = "AudioRecorderManager";
    private static AudioRecorderManager instance;
    private MediaRecorder mediaRecorder;
    private String currentFilePath;
    private boolean isRecording = false;
    private OnRecorderStateListener listener;

    public interface OnRecorderStateListener {
        void onStart(String filePath);
        void onStop(String filePath, long durationMs, long fileSize);
        void onError(String errorMsg);
    }

    private AudioRecorderManager() {}

    public static synchronized AudioRecorderManager getInstance() {
        if (instance == null) instance = new AudioRecorderManager();
        return instance;
    }

    public void setListener(OnRecorderStateListener listener) {
        this.listener = listener;
    }

    /** 開始錄音 */
    public void startRecording(Context context) {
        if (isRecording) {
            notifyError("已在錄音中");
            return;
        }
        // 1. 動態權限檢查 (API 23+)
        if (ContextCompat.checkSelfPermission(context, Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED) {
            notifyError("缺少錄音權限");
            return;
        }

        try {
            // 2. 生成唯一文件路徑
            File dir = new File(context.getExternalFilesDir(Environment.DIRECTORY_MUSIC), "Recordings");
            if (!dir.exists()) dir.mkdirs();
            String fileName = "REC_" + new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date()) + ".m4a";
            currentFilePath = new File(dir, fileName).getAbsolutePath();

            // 3. 配置 MediaRecorder
            mediaRecorder = new MediaRecorder();
            mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);           // 麥克風
            mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);      // MP4 容器
            mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AAC);         // AAC 編碼 (高質量、兼容好)
            mediaRecorder.setAudioEncodingBitRate(128000);                         // 128kbps
            mediaRecorder.setAudioSamplingRate(44100);                             // 44.1kHz
            mediaRecorder.setOutputFile(currentFilePath);

            // 4. 準備與啟動
            mediaRecorder.prepare();
            mediaRecorder.start();
            isRecording = true;
            notifyStart(currentFilePath);
            Log.d(TAG, "錄音開始: " + currentFilePath);
        } catch (IOException | IllegalStateException e) {
            Log.e(TAG, "啟動失敗", e);
            releaseRecorder();
            notifyError("啟動失敗: " + e.getMessage());
        }
    }

    /** 停止錄音 */
    public void stopRecording() {
        if (!isRecording || mediaRecorder == null) {
            notifyError("未在錄音狀態");
            return;
        }
        try {
            mediaRecorder.stop(); // 關鍵:寫入文件頭,最終化文件
            long duration = System.currentTimeMillis() - getStartTime(); // 需自行記錄開始時間
            long fileSize = new File(currentFilePath).length();
            notifyStop(currentFilePath, duration, fileSize);
            Log.d(TAG, "錄音結束: " + currentFilePath + " 大小: " + fileSize);
        } catch (RuntimeException e) { // 文件太短/損壞會拋異常
            Log.e(TAG, "停止異常", e);
            notifyError("錄音文件損壞: " + e.getMessage());
            deleteCurrentFile();
        } finally {
            releaseRecorder();
        }
    }

    /** 取消錄音 (刪除文件) */
    public void cancelRecording() {
        if (isRecording) {
            try { mediaRecorder.stop(); } catch (Exception ignored) {}
            releaseRecorder();
            deleteCurrentFile();
            notifyError("錄音已取消");
        }
    }

    private void releaseRecorder() {
        if (mediaRecorder != null) {
            mediaRecorder.reset();
            mediaRecorder.release();
            mediaRecorder = null;
        }
        isRecording = false;
    }

    private void deleteCurrentFile() {
        if (currentFilePath != null) new File(currentFilePath).delete();
        currentFilePath = null;
    }

    private long getStartTime() { /* 需在 startRecording 時記錄 startTime = System.currentTimeMillis() */ return 0; }
    
    // 回調分發
    private void notifyStart(String path) { if (listener != null) listener.onStart(path); }
    private void notifyStop(String path, long dur, long size) { if (listener != null) listener.onStop(path, dur, size); }
    private void notifyError(String msg) { if (listener != null) listener.onError(msg); }
}

三、 Activity/Fragment 中調用示例

public class RecordActivity extends AppCompatActivity implements AudioRecorderManager.OnRecorderStateListener {
    private Button btnRecord, btnStop, btnPlay;
    private AudioRecorderManager recorder;
    private MediaPlayer player;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_record);
        recorder = AudioRecorderManager.getInstance();
        recorder.setListener(this);
        
        btnRecord = findViewById(R.id.btn_record);
        btnStop = findViewById(R.id.btn_stop);
        btnPlay = findViewById(R.id.btn_play);

        btnRecord.setOnClickListener(v -> requestPermissionAndRecord());
        btnStop.setOnClickListener(v -> recorder.stopRecording());
        btnPlay.setOnClickListener(v -> playLastRecording());
    }

    private void requestPermissionAndRecord() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO) == PackageManager.PERMISSION_GRANTED) {
            recorder.startRecording(this);
        } else {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.RECORD_AUDIO}, 100);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (requestCode == 100 && grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            recorder.startRecording(this);
        } else {
            Toast.makeText(this, "需要錄音權限", Toast.LENGTH_SHORT).show();
        }
    }

    @Override
    public void onStart(String filePath) {
        runOnUiThread(() -> {
            btnRecord.setEnabled(false);
            btnStop.setEnabled(true);
            btnPlay.setEnabled(false);
            Toast.makeText(this, "錄音中...", Toast.LENGTH_SHORT).show();
        });
    }

    @Override
    public void onStop(String filePath, long duration, long size) {
        runOnUiThread(() -> {
            btnRecord.setEnabled(true);
            btnStop.setEnabled(false);
            btnPlay.setEnabled(true);
            Toast.makeText(this, "保存至: " + filePath, Toast.LENGTH_LONG).show();
        });
    }

    @Override
    public void onError(String msg) {
        runOnUiThread(() -> {
            btnRecord.setEnabled(true);
            btnStop.setEnabled(false);
            Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
        });
    }

    private void playLastRecording() {
        // 簡易播放驗證
        if (player != null) { player.release(); player = null; }
        player = new MediaPlayer();
        try {
            player.setDataSource(recorder.getLastFilePath()); // 需 Manager 暴露方法
            player.prepare();
            player.start();
        } catch (IOException e) { e.printStackTrace(); }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        recorder.cancelRecording();
        if (player != null) { player.release(); player = null; }
    }
}

四、 關鍵技術點總結

  1. 音頻源選擇:MIC (通話/錄音)、VOICE_COMMUNICATION (VoIP, 含回聲消除)、UNPROCESSED (原始數據)。
  2. 編碼格式:AAC (.m4a/.aac) 最佳平衡質量/體積/兼容性;AMR-NB (.amr) 極小但質量差;Opus (.opus) 高質量低碼率但舊設備兼容性弱。
  3. 狀態機:Initial -> setAudioSource -> setOutputFormat -> setAudioEncoder -> setOutputFile -> prepare -> start -> stop -> reset/release。順序錯誤拋 IllegalStateException。
  4. 文件最終化:stop() 必須調用寫入文件頭,否則文件損壞不可播放。
  5. 前台服務:長時間錄音 (如通話記錄、語音筆記) **必須**啟動前台服務 (Notification),防止進程被殺導致文件損壞。
  6. 存儲適配:Android 10+ 使用 getExternalFilesDir() 或 MediaStore;避免硬編碼路徑。

此架構分離了錄音邏輯與 UI,支持多入口調用、狀態回調、錯誤恢復,是生產級語音功能的穩健基石。

copyright © 萬盛學電腦網 all rights reserved