Flutter音频处理插件 wav_io 的使用

wav_io 是一个用于读取和写入 WAVE 文件的简单插件。它支持多种PCM格式（16位、24位、32位）以及浮点格式（32位、64位），并支持RIFX格式（大端版本）。该插件适用于编写WAV实用程序。

主要功能

• 支持读取/写入 16bit/24bit/32bit PCM 文件。
• 支持读取/写入 32bit/64bit 浮点文件。
• 支持读取/写入 RIFX 格式（大端版本）。
• 可以用于编写 WAV 实用程序。

开始使用

首先，在你的 pubspec.yaml 文件中添加 wav_io 包：

dependencies:
  wav_io: ^0.1.0

然后运行以下命令来安装依赖：

flutter pub get

使用示例

示例1：生成正弦波并存储为WAV文件 (sine.dart)

这个例子展示了如何生成一个正弦波并将它存储在WAV文件中。你可以通过命令行参数指定采样率、持续时间、频率和输出格式。

命令行使用方法：

dart example/lib/sine.dart --samplerate <sr> --duration <duration in seconds> --freq <note frequency> --format <i16|i24|i32|f32|f64> -o output.wav

示例代码：

import 'package:wav_io/wav_io.dart';

void main(List<String> arguments) {
  // 解析命令行参数
  final parser = ArgParser();
  parser.addOption('samplerate', abbr: 'r', defaultsTo: '44100');
  parser.addOption('duration', abbr: 'd', defaultsTo: '5');
  parser.addOption('freq', abbr: 'f', defaultsTo: '440');
  parser.addOption('format', abbr: 'fmt', defaultsTo: 'f32');
  parser.addOption('output', abbr: 'o', defaultsTo: 'output.wav');

  final results = parser.parse(arguments);

  final sampleRate = int.parse(results['samplerate']);
  final duration = double.parse(results['duration']);
  final freq = double.parse(results['freq']);
  final format = results['format'];
  final outputPath = results['output'];

  // 生成正弦波数据
  final waveData = generateSineWave(sampleRate, duration, freq, format);

  // 创建WAV文件
  final wavFile = WavFile(
    format: _getFormat(format),
    channels: [waveData],
    sampleRate: sampleRate,
  );

  // 写入文件
  wavFile.write(outputPath);
}

List<double> generateSineWave(int sampleRate, double duration, double freq, String format) {
  final samples = (sampleRate * duration).toInt();
  final data = List<double>.generate(samples, (index) {
    return sin(2 * pi * freq * index / sampleRate);
  });

  if (format == 'i16') {
    return data.map((e) => (e * 32767).toInt()).cast<double>().toList();
  } else if (format == 'i24' || format == 'i32') {
    return data.map((e) => (e * 8388607).toInt()).cast<double>().toList();
  } else {
    return data;
  }
}

AudioFormat _getFormat(String format) {
  switch (format) {
    case 'i16':
      return AudioFormat.int16;
    case 'i24':
      return AudioFormat.int24;
    case 'i32':
      return AudioFormat.int32;
    case 'f32':
      return AudioFormat.float32;
    case 'f64':
      return AudioFormat.float64;
    default:
      throw ArgumentError('Unsupported format $format');
  }
}

示例2：合并多个WAV文件 (concat.dart)

这个例子展示了如何将多个WAV文件合并成一个长的WAV文件。

命令行使用方法：

dart example/lib/concat.dart <in1> <in2> <in3> ... -o output.wav

示例代码：

import 'package:wav_io/wav_io.dart';
import 'dart:io';

void main(List<String> arguments) {
  final parser = ArgParser();
  parser.addOption('output', abbr: 'o', defaultsTo: 'output.wav');

  final results = parser.parse(arguments);
  final inputFiles = results.rest;
  final outputPath = results['output'];

  if (inputFiles.isEmpty) {
    print('No input files specified.');
    return;
  }

  // 读取所有输入文件
  final waves = inputFiles.map((file) => WavFile.read(File(file).readAsBytesSync())).toList();

  // 检查所有文件是否具有相同的采样率和通道数
  for (var i = 1; i < waves.length; i++) {
    if (waves[i].sampleRate != waves[0].sampleRate ||
        waves[i].channels.length != waves[0].channels.length) {
      print('Input files must have the same sample rate and number of channels.');
      return;
    }
  }

  // 合并通道数据
  final combinedChannels = List.generate(waves[0].channels.length, (_) => <double>[]);

  for (var wave in waves) {
    for (var i = 0; i < wave.channels.length; i++) {
      combinedChannels[i].addAll(wave.channels[i]);
    }
  }

  // 创建新的WAV文件
  final newWave = WavFile(
    format: waves[0].format,
    channels: combinedChannels,
    sampleRate: waves[0].sampleRate,
  );

  // 写入文件
  newWave.write(outputPath);
}