按住左键说一句话，松开后 CoverArt Mini 就会在 Roon 里找到并播放你想听的音乐。可以说具体的歌手、专辑和歌名，也可以只说“来点爵士”“来点放松的”。
这项功能需要 0.8.0 或更新的软件，和你自己的阿里云百炼 API Key。识别和大模型的费用记在你自己的百炼账号上。
1. 开始之前
- 一台 CoverArt Mini，已经连上 Wi-Fi，并在 Roon 里启用。
- 设备所在的网络能访问互联网。语音识别和理解请求都在阿里云百炼上完成。
- 一个阿里云百炼账号。
2. 设置
2.1 升级软件
用电脑的 Chrome 或 Edge 打开升级页面，按提示操作：https://www.epochaudio.cn/coverart/update/。升级会保留 Wi-Fi、Roon 配对、Zone 和亮度。
升级后，如果 Roon 提示需要重新启用，到 设置 → 扩展 启用一次即可，因为语音选曲需要新的浏览权限。
2.2 获取 API Key
在阿里云百炼控制台创建北京地域的 API Key：https://bailian.console.aliyun.com/?tab=model#/api-key。
2.3 填入 Roon
- 打开 Roon → 设置 → 扩展，点 CoverArt 扩展的“设置”。
- 把 Key 粘贴到 阿里云百炼密钥 Bailian API Key。
- 确认 Select playback zone 已选好要播放的 Zone，然后保存。
保存后这一栏只显示 **** 加 Key 的后四位。之后想关闭语音选曲，清空这一栏并保存就行。
3. 怎么用
- 按住左键，约半秒后屏幕显示 LISTENING，开始说话。一次最长 15 秒。
- 说完松开左键，屏幕显示 THINKING。
- 通常 10–20 秒后音乐开始，屏幕换成新的封面。
音乐在扩展设置所选的 Zone 播放，通常会替换正在播放的内容。短按左键仍然是上一首。
4. 可以怎么说
找具体的音乐
| 可以这样说 | 播放内容 |
|---|---|
| 放张学友 | 随机播放这位艺人的歌 |
| 张学友电台 | 这位艺人的 Roon 电台 |
| 播放专辑《吻别》 | 这张专辑 |
| 放张学友的《吻别》 | 这首歌 |
| 直接说歌单的名字 | 这个歌单 |
按类型听
| 可以这样说 | 播放内容 |
|---|---|
| 听点爵士、来点摇滚 | 这个类别或子类的电台 |
| 爵士电台 | 这个类别的 Roon 电台 |
| 来点古典音乐、来点室内乐、来点交响乐 | 从这一类里随机挑一张专辑，从头播放 |
只有个大概的想法
| 可以这样说 | 播放内容 |
|---|---|
| 听点小提琴 | 随机挑一张符合描述的专辑 |
| 来点放松的、工作时听点什么 | 优先挑符合的 TIDAL 场景歌单，否则挑专辑 |
| 随便听听 | 随机挑一个歌单，随机播放 |
| 来点推荐（需要 TIDAL） | 随机挑一个 TIDAL 推荐歌单，随机播放 |
| 来点新歌（需要 TIDAL） | 随机挑一个 TIDAL 新歌单，随机播放 |
说得更准的小窍门
- 歌名连着歌手说。 “放孙燕姿的《逃亡》”比只说“放《逃亡》”更准，也不容易播放到翻唱版本。
- 想听专辑就说“专辑”。 否则同名时会优先当作歌曲。
- 不用纠结繁简和译名。 设备会用简体、繁体和艺人的英文名去搜索，曲库里的英文歌名通常也能对上中文说法。
- 没听清也没关系。 明显的同音错字通常会被纠正。结果不对时，靠近设备再说一次。
- 一次说一件事。 语音只用来选音乐，不能切歌、暂停或调音量。
5. 屏幕提示
| 屏幕显示 | 含义 | 你需要做什么 |
|---|---|---|
| SET API KEY / in Roon | 还没有填写 Key | 按第 2.3 节填写 |
| NO SPEECH | 没有听到说话 | 靠近设备再说一次 |
| NOT MUSIC | 这句话与放音乐无关 | 换个说法 |
| NOT FOUND | 曲库里没有合适的内容，当前音乐不受影响 | 换个说法，或说出艺人名 |
| NO ZONE / in Roon | 还没有选择 Zone | 在扩展设置中选择 Zone |
| PLAY FAILED | Roon 拒绝播放，或 Zone 没有开始播放 | 检查该 Zone 的输出设备 |
| API KEY / REJECTED | 百炼拒绝了这个 Key | 检查 Key 是否为北京地域、是否有效 |
| NETWORK / ERROR | 连不上百炼 | 检查设备所在网络能否访问互联网 |
| NO ANSWER / Try again | 百炼没有及时返回结果 | 再试一次 |
| ROON / ERROR | Roon Core 没有响应 | 确认 Roon Core 在运行 |
| SPEECH / ERROR、AI ERROR | 百炼返回了无法使用的结果 | 再试一次 |
| MIC ERROR | 麦克风启动失败 | 重启设备 |
6. 目前的限制
- 一次请求处理完之前，再次按住左键不会录音。短按上一首不受影响。
- 没有说艺人时，可能播放到翻唱版本。
- 古典作品可能只播放其中一个乐章。
- 只读取前 50 个歌单，“随便听听”也只从这些歌单里挑。
- 不能播放 Roon 首页的推荐内容，也没有 TIDAL 的“每日推荐”，Roon 没有向扩展开放它们。
- 只在英文界面的 Roon 上验证过。
- 不能指定以哪个 Roon 用户（Profile）播放。
7. 常见问题
要花多少钱？
费用由阿里云百炼按你的实际用量收取，记在你自己的账号上，具体价格以百炼控制台为准。
为什么有时候要等比较久？
每次请求都要经过语音识别、大模型理解和曲库搜索。其中曲库搜索的耗时变化较大，同一首歌也可能时快时慢。
队列里“由谁添加”是空的？
不影响播放。我们在删除一个 Roon 配置文件（Profile）后遇到过这种情况，恢复删除前的 Roon 备份并清除 Roon 客户端的缓存后恢复了正常。删除配置文件前，建议先做一次备份。
没有 TIDAL 能用吗？
能。只有“来点推荐”“来点新歌”和场景歌单需要 TIDAL，其他说法都从你的 Roon 曲库和已连接的服务里找。
8. 隐私
- 只有按住左键时才录音。短按或没有填写 Key 时，录音留在设备内存中并被丢弃，不会发送。
- 填写 Key 后，按住左键录下的语音会发送到阿里云百炼做识别；识别出的文字、你的歌单名和曲库搜索结果会发送到百炼的大模型。
- API Key 只保存在设备本机，Roon 中只显示后四位，恢复出厂时一并清除。
- 不使用语音选曲时，设备只与家里的 Roon Core 通信，不连接任何云服务。