Flutter音频处理插件pro_miniaudio的使用

pro_miniaudio

一个使用Dart FFI进行高级音频管理的Flutter插件。

该插件提供了全面的API来管理音频上下文、查询设备、生成波形并控制播放。它基于Dart的Foreign Function Interface (FFI)，在Flutter和原生音频库之间架起了桥梁。

特性

• 音频上下文管理：初始化、查询和管理音频设备。
• 播放控制：开始、停止并向播放设备推送音频缓冲区。
• 波形生成：创建和播放过程性波形（正弦波、方波、三角波、锯齿波）。
• Dart FFI集成：高性能绑定到原生音频库。

入门

该插件使用Dart的Foreign Function Interface (FFI)与本地C库通信。它提供了一个易于使用的Dart API来管理音频播放和波形生成。

安装

在pubspec.yaml文件中添加pro_miniaudio依赖：

dependencies:
  pro_miniaudio: 0.0.11

然后运行以下命令：

flutter pub get

使用

音频上下文

AudioContext类是管理音频设备的入口点。使用它可以查询可用的播放和捕获设备。

示例：初始化和查询设备

import 'package:pro_miniaudio/pro_miniaudio.dart';

void main() {
  final context = AudioContext();

  // 刷新设备
  context.refreshDevices();

  final playbackDevices = context.getDeviceInfos(type: DeviceType.playback);
  final captureDevices = context.getDeviceInfos(type: DeviceType.capture);

  print('Playback Devices: $playbackDevices');
  print('Capture Devices: $captureDevices');

  // 结束时释放资源
  context.dispose();
}

播放设备

PlaybackDevice类允许对音频播放进行精确的缓冲区和播放状态控制。

示例：播放自定义音频

import 'dart:typed_data';
import 'package:pro_miniaudio/pro_miniaudio.dart';

void main() {
  final context = AudioContext()..refreshDevices();

  final deviceInfos = context.getDeviceInfos(type: DeviceType.playback);

  final chunkDuration = 100; // 毫秒

  final device = PlaybackDevice(
    context: context,
    id: deviceInfos.first.id,
    config: PlaybackConfig.basedChunkDuration(
      audioFormat: audioFormat,
      chunkMs: chunkDuration,
    ),
  );

  // 生成一个波形（正弦波）
  final waveform = Waveform(
    config: WaveformSineConfig(
      sampleFormat: PcmFormat.f32,
      sampleRate: audioFormat.sampleRate,
      channels: audioFormat.channels,
      amplitude: 0.5,
      frequency: 440.0,
    ),
  );

  final framesCount = (audioFormat.sampleRate * chunkDuration / 1000).toInt();

  // 生成一个样本音频缓冲区（立体声正弦波）
  final result = waveform.readWaveformPcmFrames(frameCount: framesCount);

  // 将缓冲区推送到设备
  device.pushBuffer(buffer: result.frames, framesCount: result.framesRead);

  // 开始播放
  device.start();

  // 在一段时间后停止播放（此处未展示）
  device.stop();

  // 清理
  device.dispose();
}

波形生成

Waveform类提供了一种简单的方式来生成音频波形，如正弦波、方波、锯齿波和三角波。

示例：生成并使用正弦波

import 'package:pro_miniaudio/pro_miniaudio.dart';

void main() {
  final waveform = Waveform(
    config: WaveformSineConfig(
      sampleFormat: PcmFormat.f32,
      sampleRate: 44100,
      channels: 2,
      amplitude: 0.5,
      frequency: 440.0,
    ),
  );

  final result = waveform.readWaveformPcmFrames(frameCount: 1024);

  print('Read ${result.framesRead} frames');
  print('Buffer length: ${result.frames.length}');

  // 结束时释放资源
  waveform.dispose();
}