常见问题 / FAQ
连接问题 / Connection Issues
Q: 添加服务器时提示"连接失败"？
A: 请检查以下几点：
- 服务器地址格式是否正确：
协议://地址:端口（如http://192.168.1.100:4533） - 用户名和密码是否正确（注意大小写）
- 网络连通性：手机/电脑是否能访问服务器地址（用浏览器测试）
- 防火墙设置：服务器端口是否已放行
- HTTPS 自签证书：如果使用自签 SSL 证书，请在设置中开启「忽略证书验证」
使用场景：无论是初次添加还是之前正常后来失败的连接，都可以先检查以上几点。
Q: 如何在不同网络环境下自动切换连接地址？
A: 箭头音乐 支持局域网和广域网自动切换（v1.0.17+）：
- 使用方法：在添加连接时，分别填写局域网地址和公网地址
- 工作原理：连接到 Wi-Fi 时自动使用局域网地址；使用移动数据时自动切换为公网地址
- 注意事项：需要服务器同时配置了内网和外网访问；切换可能带来短暂的加载延迟
Q: 可以同时连接多个服务器吗？
A: 可以。箭头音乐 支持添加多个服务器连接：
- 使用方法：在设置中多次点击「添加连接」
- 切换方式：在连接页面或首页切换当前使用的服务器
- 注意事项：免费版和多连接数有限制；不同服务器的数据独立管理
Q: 首页有红点或数据没有刷新怎么办？
A: 需要在平台连接处手动更新数据：
- 使用方法：设置 → 服务器 → 点击对应平台的「更新」按钮
- 效果：强制刷新该平台的音乐库数据，包括歌曲、专辑、艺术家等
- 注意事项：更新过程可能需要几分钟，取决于音乐库大小
播放问题 / Playback Issues
Q: 为什么有些歌曲无法播放？
A: 可能的原因：
- 音频格式不支持：确认文件格式（MP3/FLAC/AAC/OGG 等）是否被支持
- 文件损坏：尝试用其他播放器测试该文件
- 转码问题：服务器转码可能失败，可尝试关闭转码或更换格式
- iOS FLAC 杂音：v1.0.15 已修复 iOS 部分 FLAC 歌曲有杂音的问题，请更新 App
- AAC 播放异常：v1.0.14 已修复，请更新 App
Q: 播放过程中出现卡顿或中断？
A:
- 网络检查：切换到更稳定的 Wi-Fi 或降低转码比特率
- 缓存检查：在设置中检查并调整缓存限额
- 后台限制：检查手机是否有省电模式限制后台应用
- 解码慢：播放按钮外圈进度条表示解码进度，解码太慢会影响播放
Q: 无缝播放怎么开启？
A: v1.2.1 实验室功能：
- 使用方法：设置 → 实验室 → 无缝播放 → 开启
- 注意事项：双播放器切换机制；无缝播放可能增加电量消耗；与某些音效设置可能有冲突
歌词问题 / Lyrics Issues
Q: 歌词不显示怎么办？
A:
- 确保服务器端的歌曲文件带有歌词元数据
- 外部歌词文件需要与歌曲同目录、同名
- Subsonic 平台歌词可能无时间轴（v1.0.20 已修复部分问题）
- Emby 外部歌词可能无法显示（v1.0.14 已修复）
- Plex 歌词可能有兼容性问题（参考各版本修复说明）
Q: 歌词与歌曲不同步？
A:
- 使用方法：设置 → 歌词 → 全局歌词提前/延迟 → 调整偏移量
- 注意事项：偏移值以毫秒为单位，一般调整范围在 -500 到 +500 之间
下载/离线问题 / Download/Offline Issues
Q: 下载的歌曲找不到？
A:
- 下载位置：导航栏 → 设置 → 已下载页面查看
- v1.2.1 优化：已下载歌曲列表显示优化（需重新下载生效）
- 清理缓存：在缓存管理中查看是否误清理
Q: 离线模式怎么用？
A:
- 使用方法：设置 → 离线模式 → 一键切换
- 前置条件：需要先在有网络时下载好歌曲
- 功能范围：支持离线歌曲、专辑、艺术家、歌单、有声书、MV、文件夹浏览
- AI 推荐：离线模式下 AI 推荐使用本地缓存
Q: 下载失败或卡住？
A:
- 检查存储空间是否充足
- 检查服务器网络是否稳定
- Android 特殊字符文件名可能导致下载失败（v1.0.17 已修复）
- Android 部分机型下载失败（v1.2.0 已修复）
平台特定问题 / Platform-Specific Issues
Q: 不同服务器平台有什么区别？
A: 详见支持的服务器，主要差异：
- 收藏/打分支持：Navidrome/Subsonic/Gonic 完整支持；Plex 不支持收藏
- 删除支持：Emby/Jellyfin/Koel/Plex 支持；Subsonic/Navidrome 不支持
- 歌单支持：各平台差异较大
- 有声书：道理鱼、Audiobookshelf 专用支持
Q: Navidrome 多库怎么选择？
A: v1.2.0 起支持：
- 使用方法：首页头像长按 → 选择媒体库
- 多选支持：可以任意选择多项媒体库组合
桌面版问题 / Desktop Issues
Q: 桌面版如何更新？
A: 目前需手动从官网下载页面下载最新版本。
其他问题 / Other Issues
Q: 如何分享我的服务器连接？
A: 设置 → 连接页面 → 生成分享链接/二维码 → 好友扫码即可自动添加。
Q: 怎么报告 bug 或提建议？
A: 通过 GitHub Issues 提交。
Q: 有应用小组件吗？
A: 桌面小组件正在规划中，iOS/Android 都将在后续版本支持。
Q: 设备发热怎么办？
A: v1.0.18 起已优化：关闭黑胶封面效果可有效降低 CPU 占用。
Q: 我的数据在哪里？安全吗？
A: 所有听歌数据、缓存、设置均保存在本地设备；分享服务器时只传输连接信息，不会泄露账号密码。