播放失败或没有声音？常见原因与解决方案

如果您遇到点击播放无反应、进度条不走或提示播放错误，请按照以下步骤进行排查。

1. 访问环境与网络排查（最常见原因）

⚠️ 禁止开启 Basic Auth (HTTP 基本认证)

现象：网页端正常，但 App 端无法播放。
原因：Leelaa Reader App 暂时不支持通过 Basic Auth 进行流媒体认证。
解决：请在 Lucky、Nginx 或反向代理中关闭针对 Leelaa Reader 服务的 Basic Auth 认证。

🏠 内网与外网访问冲突

现象：在家里能听，出门就不能听；或者反之。
排查：
- 检查 App 设置中的「服务器地址」是否正确。
- 如果使用域名访问，请确认您的 SSL 证书 是否已过期或配置错误。
- 如果是在国内环境，请确认是否因为使用了 443 端口 被运营商拦截（建议改用 10000 以上的高位端口）。

2. 存储源 (WebDAV) 响应问题

⏳ WebDAV 响应过慢

现象：点击播放后要转圈很久，甚至直接报错。
排查：
- 确认您的 WebDAV 服务或第三方 WebDAV 桥接工具是否稳定。
- 云端网盘用户：请务必在存储库设置中开启 「网盘模式」，这会显著优化播放时的文件预读逻辑。
- 尝试直接在 WebDAV 客户端中打开同一个文件，看加载速度是否正常。

3. 音频文件与格式排查

如果某个特定文件无法播放，请检查其格式和编码。

格式是否受支持：系统官方支持 .mp3、.m4a、.m4b、.wav、.flac；.wma 通过服务端 FFmpeg 转码播放。
不支持的格式：请注意，.aac（裸流）、.ogg、.opus 等格式完全不被支持，客户端可能无法解码或无法正确获取进度。请将这些文件使用工具转换为 .mp3。
Web 端 HLS 转码限制：当 Web 端使用 HLS 在线转码播放 .wma 或部分 .m4b 章节时，当前仅保证基础播放，不支持快进、快退或任意拖动进度条跳转。如需这些控制能力，请提前转换为 .mp3 或 .m4a。
排查损坏文件：尝试用电脑自带的播放器打开该文件。如果电脑也无法播放，说明文件本身已损坏或被加密（如某些网盘下载的专有格式）。

4. 客户端与系统设置

🔋 后台运行限制与通知权限 (Android)

现象：熄屏后播放几分钟就断开，或通知栏不显示媒体控制面板。
解决 1（电池优化）：在手机系统设置中，将 Leelaa Reader 的电池优化设置为 “不限制” 或 “允许后台运行”。
解决 2（通知权限）：针对 Android 13 及以上系统，必须主动允许/授予“通知权限”，否则系统级媒体控制面板与后台持续播放功能将无法正常运行。

🎧 音频焦点冲突

现象：播放时没有声音，但进度条在走。
解决：检查手机是否处于静音模式，或者是否有其他音视频应用抢占了音频输出。

🆘 还是无法解决？

请在播放失败后，查看服务器端的日志文件 info.log。如果看到 404 Not Found 或 401 Unauthorized，通常意味着存储源连接已断开或权限失效，请重新校验存储库设置。