錄製或串流音訊輸入

本教學示範如何使用 record 套件 為你的 Flutter 應用程式新增 音訊錄製與串流功能。 請依照下列步驟開始使用此套件：

若要將 package:record 新增為相依套件，請使用 flutter pub add：

$ flutter pub add record

初始化一個 AudioRecorder 物件。這是控制錄製流程的主要物件。

import 'package:record/record.dart';
​
final recorder = AudioRecorder();

錄製前，你必須請求使用者授權。 你可能還需要新增特定平台的權限設定。 詳情請參閱 record 套件 文件。

final recorder = AudioRecorder();
if (await recorder.hasPermission()) {
  // Permission granted, proceed with recording.
} else {
  // Permission denied.
}

建立並設定一個 RecordConfig 物件，以指定錄製參數， 例如編碼器、取樣率與聲道數量。 你也可以啟用自動增益、回音消除及 噪音抑制等功能。

final recordConfig = RecordConfig(
  encoder: AudioEncoder.pcm16bits,
  sampleRate: 24000,
  numChannels: 1,
  autoGain: true,
  echoCancel: true,
  noiseSuppress: true,
);

若要開始錄製至檔案， 請呼叫 AudioRecorder 的 start 方法， 並傳入你定義的 recordConfig 以及檔案的儲存路徑。

// TODO: Specify the path where the audio file should be saved.
final audioFilePath = 'myRecording.wav';
await recorder.start(recordConfig, path: audioFilePath);

你可以透過 AudioRecorder 的 pause、resume 和 stop 方法來控制進行中的錄製。

await recorder.pause();
await recorder.resume();
await recorder.stop();

若要串流音訊，請使用 startStream 方法。 這會回傳一個音訊資料的串流 (stream)。

final stream = await recorder.startStream(recordConfig);
stream.listen((audioChunk) {
  // Process the audio data. For example, send it to a server.
});

若要停止錄製並取得已儲存檔案的路徑， 請呼叫 AudioRecorder 的非同步 stop 方法。

final path = await recorder.stop();
print('Recording stopped. File saved to: $path');

當你使用完 AudioRecorder 後， 請記得呼叫其 dispose 方法以釋放資源。

await recorder.dispose();

record 套件支援多種編碼器與檔案格式， 但各平台的支援程度不同。 若要查看各平台完整的支援編碼器清單， 請查閱套件的編碼支援表。

如需更詳細的資訊與範例， 請造訪 pub.dev 上的 record 套件 頁面，或 觀看 record 套件本週精選影片。