Dart/Flutter使用flutter_blue保存BLE音频流为WAV有噪音如何解决

以下是按问题出现概率排序的排查步骤和可直接复用的代码，适配flutter_blue的实现逻辑：

核心踩坑点优先排查 #

• MTU未提前协商：flutter_blue连接设备后默认MTU仅为23字节，扣除3字节BLE协议头，单包最多传20字节有效数据，音频流传输时会被强制拆成大量小包，如果没提前协商更大的MTU，很容易出现丢包、字节错位，直接导致全文件爆音。
• 字节序不匹配：90%以上的嵌入式BLE音频设备输出16位PCM时使用小端序（Little Endian），网上流传的大量WAV生成代码默认按大端序写头、解析数据，会直接导致音频数据解析完全错误。
• WAV头参数硬编码错误：很多教程里的WAV头参数是硬编码的44.1kHz/16位/双声道，和你实际的8kHz/单声道参数不匹配，播放器按错误参数解码自然全是噪音。
• 数据流拼接逻辑错误：BLE特征值的value流每一次回调只返回单包切片数据，不是完整的连续流，如果没有按接收顺序严格追加字节，或者在回调里做了错误的类型转换，会直接破坏PCM数据的连续性。

分步修复实现 #

1. 连接成功后第一时间协商MTU
   必须在订阅音频特征通知前调用MTU协商接口，建议设置为512，兼容绝大多数消费级BLE设备的最大支持值：

   // 设备连接成功后立即调用，不要放在订阅通知之后
   await connectedDevice.requestMtu(512);
   

2. 无转换缓存原始音频字节
   订阅通知时不要对回调返回的字节做任何位转换、数值偏移操作，直接按接收顺序追加到缓存列表，避免提前处理破坏字节结构：

   // 全局/页面级缓存，存储原始PCM字节
   final List<int> rawPcmCache = [];
   
   // 订阅音频特征
   await targetAudioCharacteristic.setNotifyValue(true);
   targetAudioCharacteristic.value.listen((packet) {
     // 直接追加原始包数据，不要做任何转换
     rawPcmCache.addAll(packet);
   });
   

3. 使用正确的小端序WAV生成逻辑
   以下代码完全适配8kHz/16bit/单声道参数，WAV头严格按标准格式用小端序生成，直接调用即可：

   import 'dart:io';
   import 'dart:typed_data';
   
   /// 将缓存的PCM原始字节保存为标准WAV文件
   Future<File> exportWavFile(String savePath, List<int> pcmRawData) async {
     const int sampleRate = 8000;
     const int bitDepth = 16;
     const int channelCount = 1;
   
     // 计算WAV格式标准参数
     final int byteRate = sampleRate * channelCount * bitDepth ~/ 8;
     final int blockAlign = channelCount * bitDepth ~/ 8;
     final int pcmDataLength = pcmRawData.length;
     final int totalFileLength = 44 + pcmDataLength; // WAV头固定44字节
   
     final BytesBuilder wavBuilder = BytesBuilder();
     // 写入RIFF文件头
     wavBuilder.add([0x52, 0x49, 0x46, 0x46]); // 固定标识"RIFF"
     wavBuilder.add(_intToLittleEndian(totalFileLength - 8, 4));
     wavBuilder.add([0x57, 0x41, 0x56, 0x45]); // 固定标识"WAVE"
     // 写入fmt格式块
     wavBuilder.add([0x66, 0x6D, 0x74, 0x20]); // 固定标识"fmt "
     wavBuilder.add(_intToLittleEndian(16, 4)); // PCM格式块固定长度16
     wavBuilder.add(_intToLittleEndian(1, 2)); // 编码格式1=无压缩PCM
     wavBuilder.add(_intToLittleEndian(channelCount, 2));
     wavBuilder.add(_intToLittleEndian(sampleRate, 4));
     wavBuilder.add(_intToLittleEndian(byteRate, 4));
     wavBuilder.add(_intToLittleEndian(blockAlign, 2));
     wavBuilder.add(_intToLittleEndian(bitDepth, 2));
     // 写入data数据块头
     wavBuilder.add([0x64, 0x61, 0x74, 0x61]); // 固定标识"data"
     wavBuilder.add(_intToLittleEndian(pcmDataLength, 4));
     // 拼接PCM原始数据
     wavBuilder.add(pcmRawData);
   
     // 写入文件
     final File wavFile = File(savePath);
     await wavFile.writeAsBytes(wavBuilder.takeBytes());
     return wavFile;
   }
   
   /// 整数转指定长度小端序字节数组工具
   Uint8List _intToLittleEndian(int value, int byteLength) {
     final Uint8List bytes = Uint8List(byteLength);
     for (int i = 0; i < byteLength; i++) {
       bytes[i] = (value >> (i * 8)) & 0xFF;
     }
     return bytes;
   }
   

补充校验方法 #

如果按上述步骤操作后仍有噪音，做两个快速校验：

• 取缓存中连续2个字节，分别按小端、大端拼接为16位有符号整数：正常语音场景下数值范围在-32768~32767之间，静音时数值在0附近小幅波动；如果拼出的数值长期固定在30000左右的极端值，说明字节序反了，把每两个字节调换位置再写入即可。
• 检查设备协议是否给每个BLE音频包加了自定义包头（比如前2字节是包序号、校验位）：如果有包头，需要在追加缓存前把每个包的包头字节剔除，否则包头混入音频数据会出现周期性爆音。

注意：不要在特征值回调中直接执行文件写入操作，BLE音频流回调频率很高，磁盘写入延迟会直接导致丢包，建议录音结束后统一调用导出函数生成WAV文件。

内容的提问来源于stack exchange，提问作者Raja Hafiz