常见问题

ECHO 提供音乐下载服务吗？

不提供。ECHO 严格遵守 DMCA 以及适用的版权法律。ECHO 官方不托管、分发、售卖、镜像或提供任何音乐下载服务，也不会提供用于获取音乐内容的下载功能，更不会帮助用户绕过版权保护、会员权限或访问控制。

远程源、在线元数据、插件或用户自填 URL 只应用于你有权访问和使用的内容。任何第三方侵权来源都不代表 ECHO 官方行为，也不在支持范围内。

更完整的边界说明见 下载与插件音源法律边界。

远程源和在线源有什么区别？

远程源通常是你自己的 WebDAV、NAS、Jellyfin、Emby、Subsonic 或类似服务，用来浏览和播放你有权访问的内容。

在线源更多用于元数据、封面、歌词候选或其它信息补全。它们不应该覆盖你已经整理好的本地标签，也不应该被理解为 ECHO 官方内容库。

ECHO 支持 AirPlay 2 吗？

暂不支持。ECHO 当前按 AirPlay 1 / RAOP 兼容链路维护 AirPlay 能力，不能把 AirPlay 1 能连接等同于 AirPlay 2 已支持。

AirPlay 2、多房间同步、HomePod / Apple TV 专有行为、屏幕镜像、DRM 或平台权限绕过都不属于当前支持范围。详细说明见 AirPlay 支持边界。

什么时候支持手机版？

手机版在做，但不会给没有验收把握的日期。

手机版不是一句“支持一下”就能稳定上线的东西，涉及界面、播放链路、曲库、权限、系统差异和维护成本。该出的时候自然会出；没出之前，反复催不会让它更快。

Linux 和 macOS 怎么办？

Windows 是主要支持平台。Linux 保留基础构建和基础播放边界，但请按文档自行构建和验证；没有清晰复现、日志和低风险修复路径的 Linux 问题，不会进入优先维护队列。

macOS 暂不做官方包，也不承诺维护。作者没有稳定的 macOS 开发、签名和验收环境，不能把没法长期验证的包当作正式支持。

什么时候支持某某音源？

不会为了个人喜好单独支持某个来源。每个人想要的源都不一样，如果官方对个人偏好逐个适配，最后只会变成不可维护的泥潭。

插件能力已经开放了自定义音源。你需要某个来源，可以通过插件构建自己的音源接入；前提是你有权访问和使用对应内容，并且不要绕过平台授权、会员限制或版权限制。

插件接口只是技术扩展点，不代表 ECHO 官方提供、背书或验证第三方音源。第三方插件、脚本、接口、账号、URL 或内容来源产生的法律责任，由插件作者、使用者或服务提供方自行承担，ECHO 项目和维护者不承担相关法律责任。

会增加酷狗音乐源吗？

不会。ECHO 不会增加酷狗音乐源。请不要再把“接入酷狗音乐源”当成官方路线图问题。

文档或设置里出现酷狗字样时，通常指歌词、元数据候选或历史兼容边界，不代表 ECHO 会提供酷狗音乐播放源、下载源或平台内容接入。

蓝牙能开独占吗？

不建议，也不维护这类问题。蓝牙耳机、蓝牙音箱请使用 System 或 WASAPI Shared 这类稳定路径，不要折腾 WASAPI Exclusive、ASIO、DSD 或 bit-perfect。

蓝牙链路由 Windows 蓝牙栈、设备驱动、耳机固件、编码器、无线环境和电量状态共同决定。任何使用蓝牙出现的断连、延迟、爆音、音量异常、音质变化、设备切换、独占失败等问题，都不作为 ECHO 官方维护范围。

首次导入曲库卡顿正常吗？

正常，尤其是大曲库。首次导入需要枚举文件、读取标签、提取封面、计算时长和编码信息、写入索引并刷新专辑分组。CPU、磁盘占用升高或进度阶段性变慢都可能出现。

建议先导入 3 到 10 首歌的小文件夹确认基本功能，再导入完整曲库。导入期间尽量不要同时运行全量远程同步、大量下载或其它重型后台任务。

没声音先查什么？

按这个顺序：

1. Windows 音量、默认输出设备和应用音量混音器。
2. ECHO 底部音量、静音状态和播放队列。
3. Settings -> Playback 里切回 System 或 WASAPI Shared。
4. 关闭 EQ、ReplayGain、变速、声道工具和重采样。
5. 播放一首确定正常的 MP3 或 FLAC。

确认基础播放正常后，再测试 WASAPI Exclusive、ASIO、DSD 或 HQPlayer。

ECHO 支持 ASIO4ALL、FlexASIO、Voicemeeter 吗？

不支持。ECHO 不为第三方驱动、虚拟声卡、ASIO 包装层、系统级音效驱动或虚拟路由工具提供兼容性承诺，也不会针对它们做专门适配。

如果你需要 ASIO，请使用声卡或 DAC 厂商提供的原厂驱动。第三方包装层能不能工作取决于你的系统环境，不属于 ECHO 官方支持范围。

为什么打开 DSP 后不再是 bit-perfect？

因为 DSP 会改变音频信号。EQ、Preamp、ReplayGain、变速、声道平衡、重采样、Crossfade 和 Automix 都会影响原始输出。

想验证原始输出时，请先关闭所有 DSP 和增益处理，并使用稳定的有线输出设备。

远程源同步慢是不是 bug？

不一定。远程源速度受服务器、硬盘、网络、证书、代理、转码、限速和目录规模影响。大型 NAS 或媒体服务器首次索引慢是常见情况。

先测试小目录和单首歌曲，再扩大范围。遇到异常时截图连接状态、目录页面、同步进度和错误提示。

反馈问题要发什么？

请尽量提供：

• 当前页面截图。
• ECHO 版本号、系统版本和安装渠道。
• 复现步骤。
• 错误提示、日志、诊断或复制报告。
• 音频问题请附输出模式、设备名、文件格式、采样率和位深。
• 曲库问题请附导入路径类型、本地盘/移动盘/NAS、扫描阶段和错误信息。

截图和报告能显著减少来回确认。

官网更新会影响播放器吗？

不会。官网是静态站点。桌面端自动更新读取发布 feed 和安装包，不会解析文档页面来决定播放行为。

发版需要改前端代码吗？

通常不需要。新增 release Markdown、上传安装包、生成更新 feed 即可。只有下载页、文档结构或视觉样式变化时才需要改前端代码。