Flutter音频录制插件record的使用

插件简介

record 是一个用于从麦克风录制音频到给定文件路径或流的Flutter插件。它在不同平台上依赖不同的技术实现：

• Android: 使用 AudioRecord 和 MediaCodec 或 MediaRecorder
• iOS 和 macOS: 使用 AVFoundation
• Windows: 使用 MediaFoundation
• Web: 依赖浏览器及其底层平台
• Linux: 编码由 fmedia 提供，必须单独安装

平台特性对等矩阵

文件编码支持

流编码支持

• AAC is streamed with raw AAC with ADTS headers, so it’s directly readable through a file!

使用示例

import 'package:record/record.dart';

final record = AudioRecorder();

// 检查并请求权限（如果需要）
if (await record.hasPermission()) {
  // 开始录音到文件
  await record.start(const RecordConfig(), path: 'aFullPath/myFile.m4a');
  // ... 或者开始录音到流
  final stream = await record.startStream(const RecordConfig(encoder: AudioEncoder.pcm16bits));
}

// 停止录音...
final path = await record.stop();
// ... 或者取消录音（并隐式删除文件/blob）
await record.cancel();

record.dispose(); // 不要忘记这一步

设置权限和其他配置

Android

根据需要跟随Gradle设置。

添加以下权限到 AndroidManifest.xml：

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- 可选：如果你想要使用蓝牙电话设备如耳机/耳塞 -->
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<!-- 可选：如果你想要将录音保存到公共文件夹 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

• 最低SDK版本：23 (amrNb/amrWb: 26, Opus: 29)

iOS

在 Info.plist 中添加以下内容：

<key>NSMicrophoneUsageDescription</key>
<string>描述为什么你需要这个权限</string>

• 最低SDK版本：11.0

macOS

在 Info.plist 中添加以下内容：

<key>NSMicrophoneUsageDescription</key>
<string>描述为什么你需要这个权限</string>

或者直接在 *.entitlements 文件中：

<key>com.apple.security.device.audio-input</key>
<true/>

• 最低SDK版本：10.15

Web

Web平台使用 package web >=0.5.1，这是从 Flutter >=3.22 版本开始提供的。

完整示例代码

下面是一个完整的示例代码，展示了如何使用 record 插件进行录音和播放：

import 'package:flutter/material.dart';
import 'package:record/record.dart';
import 'package:path_provider/path_provider.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool showPlayer = false;
  String? audioPath;

  final Record _audioRecorder = Record();

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    if (!await _audioRecorder.hasPermission()) {
      await _audioRecorder.requestPermission();
    }
  }

  Future<void> startRecording() async {
    try {
      final directory = await getApplicationDocumentsDirectory();
      final path = '${directory.path}/test.m4a';
      if (await _audioRecorder.isPaused()) {
        await _audioRecorder.resume();
      } else {
        await _audioRecorder.start(
          path: path,
          encoder: AudioEncoder.aacLc,
          bitRate: 128000,
          samplingRate: 44100,
        );
      }
      setState(() {
        audioPath = path;
      });
    } catch (e) {
      print('Error starting recording: $e');
    }
  }

  Future<void> stopRecording() async {
    final path = await _audioRecorder.stop();
    setState(() {
      audioPath = path;
      showPlayer = true;
    });
  }

  Future<void> cancelRecording() async {
    await _audioRecorder.cancel();
    setState(() {
      audioPath = null;
      showPlayer = false;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Audio Recorder Example'),
        ),
        body: Center(
          child: showPlayer
              ? Padding(
                  padding: const EdgeInsets.symmetric(horizontal: 25),
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Text('Recorded file path: $audioPath'),
                      ElevatedButton(
                        onPressed: () async {
                          await stopRecording();
                        },
                        child: const Text('Stop Recording'),
                      ),
                      ElevatedButton(
                        onPressed: () async {
                          await cancelRecording();
                        },
                        child: const Text('Cancel Recording'),
                      ),
                    ],
                  ),
                )
              : Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    ElevatedButton(
                      onPressed: () async {
                        await startRecording();
                      },
                      child: const Text('Start Recording'),
                    ),
                    ElevatedButton(
                      onPressed: () async {
                        await stopRecording();
                      },
                      child: const Text('Stop Recording'),
                    ),
                  ],
                ),
        ),
      ),
    );
  }
}

这个示例展示了如何使用 record 插件进行录音、停止录音以及取消录音，并在界面上显示相应的按钮和状态。希望这些信息能帮助你更好地理解和使用 record 插件！