Flutter无安卓权限录音插件record_without_android的使用

Flutter无安卓权限录音插件record_without_android的使用

简介

record_without_android 插件允许从麦克风录制音频到指定的文件路径或流。它支持多种平台，无需外部依赖。

平台功能对比矩阵

文件编码支持

流编码支持

• AAC以原始AAC格式（带ADTS头）流式传输，可以直接通过文件读取！

使用方法

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(AudioEncoder.pcm16bits));
}

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

record.dispose(); // 别忘了这个

设置权限和其他配置

Android

<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

<key>NSMicrophoneUsageDescription</key>
<string>Some message to describe why you need this permission</string>

• 最低SDK版本：11.0

macOS

<key>NSMicrophoneUsageDescription</key>
<string>Some message to describe why you need this permission</string>

• 在能力选项卡中，激活“音频输入”在调试和发布方案中。
• 或直接在*.entitlements文件中添加：

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

• 最低SDK版本：10.15

示例代码

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

import 'package:record_example/audio_player.dart';
import 'package:record_example/audio_recorder.dart';

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

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

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

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

  [@override](/user/override)
  void initState() {
    showPlayer = false;
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: showPlayer
              ? Padding(
                  padding: const EdgeInsets.symmetric(horizontal: 25),
                  child: AudioPlayer(
                    source: audioPath!,
                    onDelete: () {
                      setState(() => showPlayer = false);
                    },
                  ),
                )
              : Recorder(
                  onStop: (path) {
                    if (kDebugMode) print('Recorded file path: $path');
                    setState(() {
                      audioPath = path;
                      showPlayer = true;
                    });
                  },
                ),
        ),
      ),
    );
  }
}