Java中Clip无法直接设置播放位置，因其不支持精确跳转，setMicrosecondPosition()在多数JVM中对正在播放的Clip不可靠；正确做法是stop→setMicrosecondPosition→setFramePosition→start。
Java中Clip无法直接设置播放位置的真相
Java标准库的javax.sound.sampled.Clip接口**不支持精确跳转到任意毫秒位置**——它没有setMicrosecondPosition()以外的可靠定位方法，而该方法在多数JVM实现（尤其是Windows上的HotSpot）中对正在播放的Clip行为不可靠，常导致卡顿、跳帧甚至静音。这不是你代码写错了，是API设计限制。
用getMicrosecondPosition()读取进度时的陷阱
这个方法返回的是自Clip启动以来的微秒数，但有三个关键约束：
- 仅在
Clip.isRunning() == true或Clip.isActive() == true时有意义；暂停后调用可能返回陈旧值 - 返回值是近似值，受系统音频缓冲区和线程调度影响，误差通常在±10ms内
- 如果Clip已循环播放多次，
getMicrosecondPosition()会持续累加，不会自动对齐单次循环长度
正确读取示例：
if (clip.isRunning() || clip.isActive()) {
long posUs = clip.getMicrosecondPosition(); // 单位：微秒
double posMs = posUs / 1000.0; // 转为毫秒
int durationMs = (int) (clip.getMicrosecondLength() / 1000.0);
int progressPercent = (int) ((posMs / durationMs) * 100);
}真正可行的“跳转”方案：停止+重置+重新播放
绕过Clip定位缺陷的唯一稳定方式是放弃“边播边跳”，改用“停→重置→跳→再播”流程。核心是用clip.setFramePosition()配合clip.setMicrosecondPosition()双保险：
立即学习“Java免费学习笔记（深入）”；
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
-
clip.stop()必须调用，否则setMicrosecondPosition()无效 - 先调
clip.setMicrosecondPosition(targetUs)，再调clip.setFramePosition(clip.getFramePosition())（强制同步帧位置） - 最后
clip.start()，而非clip.loop()——loop会覆盖位置设置
实操代码：
public void seekToMs(Clip clip, int ms) {
if (!clip.isOpen()) return;
clip.stop(); // 必须先停
long targetUs = ms * 1000L;
clip.setMicrosecondPosition(targetUs);
// 强制刷新帧位置缓存
clip.setFramePosition((int) (targetUs / 1000 * clip.getFormat().getFrameRate() / 1000));
clip.start();
}为什么不用SourceDataLine替代Clip？
虽然SourceDataLine能完全控制音频流并支持任意seek（需自己解码+缓冲），但它带来三重复杂度：
- 必须手动解析WAV/MP3等格式，Java原生只支持WAV/PCM/AU，MP3需额外库（如TarsosDSP）
- 进度条需自行维护当前播放字节偏移，与采样率、位深、通道数强耦合
- 实时播放时的缓冲区管理稍有不慎就会爆音或卡顿
除非你需要逐帧处理、变速播放或高精度同步，否则坚持用Clip+stop+seek+start组合更轻量、更稳。
最易被忽略的一点：每次clip.start()后，getMicrosecondPosition()从跳转位置开始计数，但如果你在跳转前没clip.stop()，后续所有位置读取都可能失效——这问题不会报错，只会让进度条“看起来动了，实际没动”。
