Java如何实现音频循环播放 Java Sound API设置Clip循环次数【方法】_技术教程

Java Sound API中Clip的循环控制仅支持LOOP_CONTINUOUSLY、NO_LOOP及loop(int count)（表示首遍+count次重播），无法精确控制播放N次；需用LineListener监听STOP事件配合计数器实现。

Java Sound API中Clip的循环控制靠`loop()`和`setLoopPoints()`

Java原生Clip不支持“播放N次后停止”的精确循环计数，它只提供三种模式：LOOP_CONTINUOUSLY（无限循环）、NO_LOOP（不循环），以及通过loop(int count)指定**最多循环次数**——但这个count参数含义容易误解：它表示「除首次播放外，额外重复的次数」。也就是说clip.loop(2) = 播放 1（首遍） + 2（重播） = 总共3遍。

实际使用中需注意：loop(int count)必须在clip.start()前调用才生效；若已启动，调用无效且不抛异常。

clip.loop(Clip.LOOP_CONTINUOUSLY)：持续循环，直到手动stop()
clip.loop(0)：等效于播放1次（首遍 + 0次重播）
clip.loop(1)：播放2次
想实现“严格播放N次”，只能用loop(N-1)

如何用`LineListener`监听播放结束并手动控制循环次数

当需要更精细的控制（比如播放3次后触发回调、或与其他逻辑联动），不能依赖loop()，而应监听LineEvent.Type.STOP，配合计数器自行管理。这是唯一可靠的方式。

关键点在于：Clip在每次循环结束（包括最后一次）时都会触发STOP事件，但不会在循环中途触发；因此可在监听器中递增计数，并在达到目标次数后不再调用start()。

clip.addLineListener(event -> {
    if (event.getType() == LineEvent.Type.STOP && clip.isRunning()) {
        // 此处不会进入：isRunning()为false说明已自然停止
    } else if (event.getType() == LineEvent.Type.STOP && !clip.isRunning()) {
        if (++playCount < targetTimes) {
            clip.setFramePosition(0); // 重置到开头
            clip.start();
        }
    }
});

注意：clip.isRunning()在STOP事件发生时恒为false，所以判断逻辑要基于计数+状态重置，而非运行态。

`setLoopPoints()`不是设次数，而是设音频帧区间循环

setLoopPoints(int start, int end)定义的是「从哪帧播到哪帧之间反复循环」，和总播放次数无关。它常用于BGM片段循环（如背景音乐的中间8秒无缝循环），而非控制整段音频播几遍。

使用前提：必须先open()，且start/end必须落在音频总帧数范围内（可通过getFrameLength()获取）。若start >= end，调用loop()时会抛IllegalArgumentException。

设置循环区间后，loop(Clip.LOOP_CONTINUOUSLY)就只在这个区间内循环
loop(5)仍表示该区间内重播5次，不是整段音频播5次
未调用setLoopPoints()时，默认循环整段（start=0, end=getFrameLength()）

常见陷阱：加载失败、线程阻塞、资源未释放

很多“循环不工作”的问题其

实和循环逻辑无关，而是底层加载或生命周期出错：

AudioSystem.getClip()可能返回null（尤其在某些JDK版本或无音频设备时），需判空
clip.open(audioFormat, audioData, offset, length)中audioData若为byte[]，必须是完整解码后的PCM数据，不能直接传WAV文件字节流
clip.start()是非阻塞的，但若在Swing主线程频繁调用，可能因GUI线程被占用导致声音卡顿甚至无声
忘记clip.close()会导致句柄泄漏，多次创建Clip后可能抛LineUnavailableException