Android 錄音涉及權限動態申請、MediaRecorder 狀態機管理、音頻源/編碼/輸出格式配置、文件命名存儲、播放驗證、資源釋放等完整鏈路。本文提供一個健壯、可復用的 AudioRecorderManager 單例封裝,覆蓋核心邏輯與異常處理,可直接集成至項目。
<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.javapublic 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); }
}
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; }
}
}
MIC (通話/錄音)、VOICE_COMMUNICATION (VoIP, 含回聲消除)、UNPROCESSED (原始數據)。Initial -> setAudioSource -> setOutputFormat -> setAudioEncoder -> setOutputFile -> prepare -> start -> stop -> reset/release。順序錯誤拋 IllegalStateException。stop() 必須調用寫入文件頭,否則文件損壞不可播放。getExternalFilesDir() 或 MediaStore;避免硬編碼路徑。此架構分離了錄音邏輯與 UI,支持多入口調用、狀態回調、錯誤恢復,是生產級語音功能的穩健基石。