WASAPI 独占模式说明

1 什么是独占模式

Lycia Player 提供共享与 WASAPI 独占两种输出模式。独占模式尝试独占所选播放设备；是否成功取决于设备、驱动和当前播放条件。

2 如何选择

需要尝试独占设备输出时可开启。不要把它理解为“一定音质更好”“固定几毫秒延迟”或“任何设置下都原样输出”：播放器自身的音量、音量平衡和均衡器处理仍需考虑。

3 对其他软件的影响

成功独占期间，其他软件通过同一设备播放可能无声。需要同时听到浏览器、通话或系统通知时，建议使用共享模式，或给不同软件选择不同输出设备。

4 如何开启或关闭

进入设置 → 常规 → WASAPI 独占模式。关闭表示请求共享模式，打开表示请求独占模式。切换时会向播放后端请求更新输出，不必一律等到下一首歌曲。

请同时确认选择了正确的输出设备。开关表示期望模式，不保证设备已成功进入独占；发生回退或切换错误时，以实际输出状态和错误提示为准。

5 回退与失败

独占初始化失败时，播放器会尝试共享输出并记录回退原因。设备被占用、格式不支持、初始化超时或设备断开，都可能影响播放。回退也依赖可用设备，不能保证任何故障下都无声中断地继续播放。

WASAPI 独占属于 Windows 输出路径。不要仅凭歌曲来自本地或 WebDAV 判断是否可用；应结合实际播放路径、缓存与报错排查。

6 常见问题

没有声音或切换失败

1. 先关闭独占模式，确认共享输出能否正常播放。
2. 检查输出设备、音量及连接状态；关闭可能占用同一设备的其他播放或录音程序。
3. 换一首已知正常的本地歌曲，区分音频文件、网络与输出设备问题。
4. 记录软件版本、设备名称及完整错误信息，再通过 GitHub Issues 反馈。

有杂音或爆音

先比较共享模式表现，并暂时关闭均衡器及额外增益，确认是否与处理设置有关。不要直接认定是歌词、文件格式或某一种声卡驱动的问题。

其他软件没有声音

关闭独占模式后重试，或将其他软件切换到不同设备。

切换设备后无法播放

确认设备仍在线，重新选择输出设备并重试播放。若继续失败，先使用共享模式，保留错误信息供排查。

提示格式不支持

先用共享模式或另一首歌曲验证。设备支持范围与当前播放条件有关，不应仅根据文件标注的采样率推断一定可用。

7 日常使用建议

日常多任务听歌可以保持共享模式。只有在需要独占输出、且接受同设备其他软件可能无声时，再开启并确认实际效果。