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()。
立即学习“Java免费学习笔记（深入）”；
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
真正稳定的循环播放，核心不在“怎么写loop”，而在确保音频成功加载、线程安全调用、资源及时回收。这些环节任一出错，loop()再正确也听不到声音。
