Flutter音频录制插件flutter_audio_recorder4的使用

flutter_audio_recorder4 是一个支持录制、暂停、恢复和停止音频，并且提供音频级别表属性访问的插件。它基于 flutter_audio_recorder1/2/3 进行了改进。

主要原因

1. 其他仓库没有跟上时代的步伐。
2. 修复以下 Android 警告：

   The plugin flutter_audio_recorder3 uses a deprecated version of the Android embedding.
   

3. 修复在 Mac Sonoma 上的 Android Gradle 插件错误：

   The Android Gradle plugin supports only Kotlin Gradle plugin version 1.5.20 and higher.
   

支持平台

该插件支持 Android 和 iOS 平台。

安装

在 pubspec.yaml 文件中添加 flutter_audio_recorder4：

dependencies:
  flutter_audio_recorder4: ^版本号

然后运行 flutter pub get 来安装依赖。

iOS权限

1. 添加描述到 Info.plist

<key>NSMicrophoneUsageDescription</key>
<string>Can We Use Your Microphone Please</string>

2. 使用 hasPermission API 请求权限

bool hasPermission = await FlutterAudioRecorder4.hasPermissions;

Android权限

1. 在 AndroidManifest.xml 中添加权限

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

2. 使用 hasPermission API 请求权限

bool hasPermission = await FlutterAudioRecorder4.hasPermissions;

配置

iOS

确保 iOS 的部署目标为 8.0 或更高版本。

Android

• 使用最新版本的 AndroidX（0.5.x）
• 使用旧版本的 Legacy Android（0.4.9）

使用方法

推荐的 API 使用顺序：hasPermission => init => start -> (pause <-> resume) * n -> stop。在开始新的录音之前，再次调用 init。

检查权限

bool hasPermission = await FlutterAudioRecorder4.hasPermissions;

初始化

var recorder = FlutterAudioRecorder4("file_path.mp4"); // .wav .aac .m4a
await recorder.initialized;

或者指定音频格式：

var recorder = FlutterAudioRecorder4("file_path", audioFormat: AudioFormat.AAC); // 或者 AudioFormat.WAV
await recorder.initialized;

设置采样率：

var recorder = FlutterAudioRecorder4("file_path", audioFormat: AudioFormat.AAC, sampleRate: 22000); // 默认采样率为 16000
await recorder.initialized;

开始录音

await recorder.start();
var recording = await recorder.current(channel: 0);

获取录音详情

var current = await recording.current(channel: 0);
// 打印当前状态
// print(current.status);

// 使用定时器每 50ms 访问一次详情
new Timer.periodic(tick, (Timer t) async {
    var current = await recording.current(channel: 0);
    // 打印当前状态
    // print(current.status);
    setState(() {});
});

录音对象属性

录音对象计量属性

录音状态

暂停

await recorder.pause();

恢复

await recorder.resume();

停止

var result = await recorder.stop();
File file = widget.localFileSystem.file(result.path);

示例代码

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:flutter_audio_recorder4/flutter_audio_recorder4.dart';
import 'package:flutter_audio_recorder4_example/RecorderExample.dart';
import 'package:package_info_plus/package_info_plus.dart';

void main() {
  // 确保在 runApp() 之前初始化
  WidgetsFlutterBinding.ensureInitialized();

  SystemChrome.setEnabledSystemUIMode(SystemUiMode.manual, overlays: []);
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  String _appName = "Unknown";
  String _packageName = "Unknown";
  String _version = "Unknown";
  String _buildNumber = "Unknown";

  String _platformVersion = "Unknown";

  final _flutterAudioRecorder4Plugin = FlutterAudioRecorder4(null);

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 异步初始化平台状态
  Future<void> initPlatformState() async {
    PackageInfo packageInfo = await PackageInfo.fromPlatform();

    String platformVersion;
    try {
      platformVersion = await _flutterAudioRecorder4Plugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _appName = packageInfo.appName;
      _packageName = packageInfo.packageName;
      _version = packageInfo.version;
      _buildNumber = packageInfo.buildNumber;
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Column(
            children: [
              Text(_appName),
              Text(' $_version +$_buildNumber on $_platformVersion'),
            ],
          )
        ),
        body: const SafeArea(
          child: RecorderExample()
        )
      ),
    );
  }
}