如何通过SignalR将JavaScript Float32Array转换为C# FileStream并保存为WAV文件

我之前处理过好几起SignalR传输WebRTC音频数据的案例，你遇到的类型转换失败问题其实是SignalR序列化机制导致的小坑——咱们一步步来解决它：

为什么直接强转(float[])o会失败？ #

当你从Angular端发送Float32Array时，SignalR会自动把它序列化为普通的JavaScript数组，传到.NET Core后端后，这个参数对应的类型是object[]，而不是float[]。直接用(float[])o强转肯定会抛出类型转换异常。

第一步：正确转换object到float[] #

修改你的SendStream方法，先把传入的object转成object[]，再通过Array.ConvertAll转换成float[]：

public void SendStream(object o)
{
    // 先校验输入类型，避免空值或非数组类型导致的异常
    if (o is not object[] objArray)
    {
        Console.WriteLine("Invalid input: expected an array");
        return;
    }

    // 将object[]转换为float[]
    float[] floatArray = Array.ConvertAll(objArray, item => Convert.ToSingle(item));

    // 把float数组转换成字节数组
    byte[] bytes = new byte[floatArray.Length * sizeof(float)];
    Buffer.BlockCopy(floatArray, 0, bytes, 0, bytes.Length);

    // 处理WAV文件写入——这里要注意：直接写字节是不够的，必须加WAV头才能播放
    string wavFilePath = "./mywavfile.wav";
    bool isNewFile = !File.Exists(wavFilePath);
    
    using (FileStream fs = new FileStream(wavFilePath, FileMode.Append))
    {
        // 第一次写入时先写WAV文件头
        if (isNewFile)
        {
            WriteWavHeader(fs, floatArray.Length);
        }
        fs.Write(bytes, 0, bytes.Length);
    }
}

第二步：添加WAV文件头生成方法 #

WAV文件必须包含标准的文件头才能被播放器识别，下面是一个适配32位浮点音频的头生成方法（你需要根据Angular端的录制参数调整采样率、声道数）：

private void WriteWavHeader(FileStream fs, int sampleCount)
{
    // 这里的参数要和你前端录制的音频参数一致！
    int channels = 1; // 单声道，如果你录的是立体声改成2
    int sampleRate = 44100; // 常用采样率，前端如果是48000就改成48000
    int bitsPerSample = 32; // Float32对应32位
    int byteRate = sampleRate * channels * bitsPerSample / 8;
    int blockAlign = channels * bitsPerSample / 8;
    int dataSize = sampleCount * channels * bitsPerSample / 8;
    int fileSize = 36 + dataSize;

    // 写入RIFF头标识
    fs.Write(Encoding.ASCII.GetBytes("RIFF"), 0, 4);
    // 写入文件总大小
    fs.Write(BitConverter.GetBytes(fileSize), 0, 4);
    // 写入WAVE标识
    fs.Write(Encoding.ASCII.GetBytes("WAVE"), 0, 4);
    // 写入fmt子块标识
    fs.Write(Encoding.ASCII.GetBytes("fmt "), 0, 4);
    // 写入fmt子块大小（16代表PCM格式）
    fs.Write(BitConverter.GetBytes(16), 0, 4);
    // 写入音频格式（3表示浮点型PCM，1是整型PCM）
    fs.Write(BitConverter.GetBytes((short)3), 0, 2);
    // 写入声道数
    fs.Write(BitConverter.GetBytes((short)channels), 0, 2);
    // 写入采样率
    fs.Write(BitConverter.GetBytes(sampleRate), 0, 4);
    // 写入字节率
    fs.Write(BitConverter.GetBytes(byteRate), 0, 4);
    // 写入块对齐
    fs.Write(BitConverter.GetBytes((short)blockAlign), 0, 2);
    // 写入每样本位数
    fs.Write(BitConverter.GetBytes((short)bitsPerSample), 0, 2);
    // 写入data子块标识
    fs.Write(Encoding.ASCII.GetBytes("data"), 0, 4);
    // 写入音频数据大小
    fs.Write(BitConverter.GetBytes(dataSize), 0, 4);
}

几个额外的小提示 #

• 参数一致性：一定要确保后端WAV头的采样率、声道数和前端录制时的参数完全一致，否则播放时会出现声音变调、杂音或者无法播放的问题。
• 流式传输优化：如果你的音频录制时长较长，频繁追加写入文件可能会影响性能。SignalR支持流式传输（IAsyncEnumerable），可以考虑用流式传输来替代单次发送数组，这样处理大文件更高效。
• 异常处理：建议在代码中添加更多异常捕获逻辑，比如转换Convert.ToSingle时的格式异常，文件写入时的IO异常等，避免程序崩溃。

内容的提问来源于stack exchange，提问作者Cedric Arnould