JavaSwing录音保存WAV文件教程

哈喽！今天心血来潮给大家带来了《Java Swing实现录音并保存WAV文件【源码分享】》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

Java录音必须用TargetDataLine，需指定AudioFormat、open后start，并在独立线程中read；保存WAV须手动写RIFF头，Swing中应使用SwingWorker避免EDT阻塞。

Java录音用 TargetDataLine 而不是 AudioSystem.getLine() 直接开线程读取

Java标准音频 API 中，录音必须通过 TargetDataLine 获取音频流。它代表“输入设备”的数据通道，不能用 Clip 或 SourceDataLine 替代。常见错误是调用 AudioSystem.getLine() 后没 cast 成 TargetDataLine，或忘记调用 line.open() 就 start —— 这会抛 IllegalStateException。

关键步骤：

• 用 AudioFormat 明确指定采样率（如 44100）、位深（16）、声道数（1 或 2），WAV 要求 PCM_SIGNED
• AudioSystem.getTargetDataLine(format) 获取 line，检查是否为 null（设备不可用时返回 null）
• 调用 line.open(format, bufferSize)，bufferSize 建议设为 format.getFrameSize() * format.getFrameRate() / 10（约 100ms 缓冲）
• 必须在单独线程中调用 line.start() 后循环 line.read(buffer, 0, buffer.length)，主线程阻塞会导致 UI 冻结

保存为 WAV 文件必须手动写 RIFF 头，AudioSystem.write() 不支持实时流

很多人误以为 AudioSystem.write() 能直接把正在录音的 TargetDataLine 写成 WAV —— 它只接受 AudioInputStream，而录音过程是持续写入字节数组，没有现成流。所以必须自己构造 WAV 文件头（44 字节 RIFF/WAVE 格式），再追加原始 PCM 数据。

WAV 头关键字段（小端序）：

• Riff chunk ID："RIFF"（4 字节）
• 文件总大小 = 36 + dataLength（4 字节，注意：不包含前 8 字节）
• Wave chunk ID："WAVE"（4 字节）
• fmt subchunk："fmt " + 长度 16 + 1（PCM）+ 通道数 + 采样率 + 字节率 + 块对齐 + 位深度
• data subchunk："data" + dataLength（4 字节）+ 实际音频字节

漏写或字节序错位会导致 Windows 播放器提示“无法播放此文件”。

Swing 界面需用 SwingWorker 控制录音启停，避免 EDT 阻塞

录音线程和 Swing UI 不能混在同一上下文。点击“开始”就 new Thread().start() 是危险的 —— 如果用户快速连点“开始/停止”，可能触发 line.start() 在已运行状态下调用，抛异常；更糟的是，stop 逻辑若在 EDT 中调用 line.stop() + line.close()，但录音线程还在 read，会引发 IOException 或数据截断。

正确做法：

• 定义一个 volatile boolean isRecording 标志位
• 录音线程里用 while (isRecording && line.isOpen()) 循环读取
• “停止”按钮触发 isRecording = false，再等线程自然退出（不要 interrupt）
• 用 SwingWorker 把录音数据异步传给 UI（比如更新波形图），但保存文件操作仍应在 done() 里做

完整可运行示例（精简核心逻辑）

import javax.sound.sampled.*;
import java.io.*;
import java.util.Arrays;
<p>public class SimpleRecorder {
private TargetDataLine line;
private ByteArrayOutputStream audioData = new ByteArrayOutputStream();
private volatile boolean isRecording = false;</p><pre class="brush:java;toolbar:false;">public void startRecording() throws LineUnavailableException {
    AudioFormat format = new AudioFormat(
        AudioFormat.Encoding.PCM_SIGNED,
        44100, 16, 1, 2, 44100, false);
    DataLine.Info info = new DataLine.Info(TargetDataLine.class, format);
    if (!AudioSystem.isLineSupported(info)) {
        throw new LineUnavailableException("Microphone not supported");
    }
    line = (TargetDataLine) AudioSystem.getLine(info);
    line.open(format, 8192);
    line.start();

    isRecording = true;
    new Thread(() -> {
        byte[] buffer = new byte[1024];
        while (isRecording && line.isOpen()) {
            int bytesRead = line.read(buffer, 0, buffer.length);
            if (bytesRead > 0) audioData.write(buffer, 0, bytesRead);
        }
        try {
            saveAsWav(audioData.toByteArray(), "recording.wav");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }).start();
}

public void stopRecording() {
    isRecording = false;
    if (line != null) {
        line.stop();
        line.close();
    }
}

private void saveAsWav(byte[] audioBytes, String filename) throws IOException {
    try (DataOutputStream out = new DataOutputStream(new FileOutputStream(filename))) {
        // RIFF header
        writeString(out, "RIFF");
        out.writeInt(36 + audioBytes.length); // file size - 8
        writeString(out, "WAVE");
        // fmt subchunk
        writeString(out, "fmt ");
        out.writeInt(16); // subchunk1Size
        out.writeShort((short) 1); // audioFormat (PCM)
        out.writeShort((short) 1); // channels
        out.writeInt(44100); // sampleRate
        out.writeInt(44100 * 2); // byteRate
        out.writeShort((short) 2); // blockAlign
        out.writeShort((short) 16); // bitsPerSample
        // data subchunk
        writeString(out, "data");
        out.writeInt(audioBytes.length);
        out.write(audioBytes);
    }
}

private void writeString(DataOutputStream out, String s) throws IOException {
    for (char c : s.toCharArray()) out.writeByte((byte) c);
}

}

这个类可直接集成进 Swing 主窗口，绑定 JButton 的 actionPerformed。注意：真实项目中要加异常弹窗、录音时禁用按钮、支持取消保存等，但 WAV 头构造和线程模型这两处，错一个就录出来打不开。

理论要掌握，实操不能落！以上关于《JavaSwing录音保存WAV文件教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！