Flutter音频流播放插件audio_streamer的使用

描述

audio_streamer 是一个用于从Android和iOS流式传输脉冲编码调制（PCM）音频的Flutter插件，支持自定义采样率。

权限设置

使用此插件需要获取访问麦克风的权限。请求此权限不是插件的一部分，应该由应用程序处理。为了使应用程序能够访问麦克风，您需要在Android和iOS上分别添加以下权限：

Android

在 AndroidManifest.xml 文件中添加录音权限：

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

iOS

1. 使用XCode启用以下功能：
   • 功能 > 后台模式 > 音频、AirPlay 和画中画
2. 编辑 Info.plist 文件，添加以下条目以提供麦克风使用说明：

<key>NSMicrophoneUsageDescription</key>
<string>YOUR DESCRIPTION</string>
<key>UIBackgroundModes</key>
<array>
  <string>audio</string>
</array>

1. 编辑 Podfile 文件，为麦克风添加权限：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'PERMISSION_MICROPHONE=1',
      ]
    end
  end
end

使用插件

该插件作为单例工作，并提供一个简单的 audioStream 供监听。

AudioStreamer().audioStream.listen(
  (List<double> buffer) {
    print('Max amp: ${buffer.reduce(max)}');
    print('Min amp: ${buffer.reduce(min)}');
  },
  onError: (Object error) {
    print(error);
  },
  cancelOnError: true,
);

可以通过 samplingRate 和 actualSampleRate 属性设置和读取采样率。

// 设置采样率。必须在监听 audioStream 之前完成。
AudioStreamer().sampleRate = 22100;

// 获取实际采样率 - 可能与请求的采样率不同。
int sampleRate = await AudioStreamer().actualSampleRate;

示例代码

下面是一个完整的示例代码，展示了如何使用 audio_streamer 插件以及如何请求麦克风权限。

import 'dart:math';
import 'dart:async';

import 'package:flutter/material.dart';
import 'package:audio_streamer/audio_streamer.dart';
import 'package:permission_handler/permission_handler.dart';

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

class AudioStreamingApp extends StatefulWidget {
  @override
  AudioStreamingAppState createState() => AudioStreamingAppState();
}

class AudioStreamingAppState extends State<AudioStreamingApp> {
  int? sampleRate;
  bool isRecording = false;
  List<double> audio = [];
  List<double>? latestBuffer;
  double? recordingTime;
  StreamSubscription<List<double>>? audioSubscription;

  /// 检查是否已授予麦克风权限。
  Future<bool> checkPermission() async => await Permission.microphone.isGranted;

  /// 请求麦克风权限。
  Future<void> requestPermission() async =>
      await Permission.microphone.request();

  /// 音频样本回调。
  void onAudio(List<double> buffer) async {
    audio.addAll(buffer);

    // 如果还不知道实际采样率，则获取它。
    sampleRate ??= await AudioStreamer().actualSampleRate;
    recordingTime = audio.length / sampleRate!;

    setState(() => latestBuffer = buffer);
  }

  /// 错误回调。
  void handleError(Object error) {
    setState(() => isRecording = false);
    print(error);
  }

  /// 开始音频采样。
  void start() async {
    // 检查是否已授予麦克风权限。
    if (!(await checkPermission())) {
      await requestPermission();
    }

    // 设置采样率 - 仅适用于Android。
    AudioStreamer().sampleRate = 22100;

    // 开始监听音频流。
    audioSubscription =
        AudioStreamer().audioStream.listen(onAudio, onError: handleError);

    setState(() => isRecording = true);
  }

  /// 停止音频采样。
  void stop() async {
    audioSubscription?.cancel();
    setState(() => isRecording = false);
  }

  @override
  Widget build(BuildContext context) => MaterialApp(
        home: Scaffold(
          body: Center(
              child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: <Widget>[
                Container(
                    margin: EdgeInsets.all(25),
                    child: Column(children: [
                      Container(
                        child: Text(isRecording ? "Mic: ON" : "Mic: OFF",
                            style: TextStyle(fontSize: 25, color: Colors.blue)),
                        margin: EdgeInsets.only(top: 20),
                      ),
                      Text(''),
                      Text('Max amp: ${latestBuffer?.reduce(max)}'),
                      Text('Min amp: ${latestBuffer?.reduce(min)}'),
                      Text('${recordingTime?.toStringAsFixed(2)} seconds recorded.'),
                    ])),
              ])),
          floatingActionButton: FloatingActionButton(
            backgroundColor: isRecording ? Colors.red : Colors.green,
            child: isRecording ? Icon(Icons.stop) : Icon(Icons.mic),
            onPressed: isRecording ? stop : start,
          ),
        ),
      );
}

这个示例应用展示了如何请求麦克风权限、开始和停止音频流的录制，并实时显示录制状态及音频的最大和最小振幅。请注意，在iOS上，采样率可能不会改变，因为只有设置首选项的选项。