Sonoscli Skill

Sonoscli Skill 是什么？

Sonoscli Skill 通过 sonos 命令行工具控制同一局域网中的 Sonos 音箱。它可以发现设备、读取播放状态、控制播放和音量，也能管理分组、收藏与播放队列。这个 Skill 本身是一份操作说明，实际执行依赖本地安装的 sonos CLI。

主要功能

• 发现局域网中的 Sonos 设备并查看状态。
• 播放、暂停、停止以及设置指定音箱的音量。
• 查看、加入、退出或调整音箱分组。
• 打开收藏内容，查看和清理播放队列。
• 通过 Sonos 的服务接口搜索 Spotify 内容。

安装与环境

目录给出的安装方式使用 Go 模块安装 sonos 命令。运行设备发现时，电脑需要与音箱位于可互相访问的局域网。若 SSDP 自动发现失败，可以在明确知道设备地址时直接指定音箱 IP。

账户与权限

大多数局域网控制不需要额外云端密钥。Spotify 搜索属于可选功能，需要单独配置 Spotify 客户端凭据。控制命令会真实改变家庭音响的播放状态和音量，执行前应确认目标设备，尤其是在多房间或共享环境中。

限制与安全

防火墙、访客网络、VLAN 或路由器隔离可能阻止设备发现。音箱名称相近时应先读取状态再操作，避免控制错误房间。不要把 Spotify 密钥写入公开脚本或日志。

许可证

ClawHub 当前版本没有声明许可证。公开可查看不等于允许任意复制或再分发，使用前应核对作者主页和上游项目的授权条款。

常见问题 FAQ

1. 必须安装 Sonos 桌面应用吗？

Skill 依赖 sonos 命令行工具，是否同时需要桌面应用取决于设备的初始配置。

2. 为什么发现不到音箱？

常见原因是电脑和音箱不在同一可访问网络，或防火墙阻止了 SSDP。

3. 可以直接指定音箱吗？

可以按名称选择，自动发现失败时也可在确认地址后指定 IP。

4. 能同时控制多个房间吗？

可以通过分组命令加入、退出或统一控制多台音箱。

5. 可以管理播放队列吗？

可以查看、播放和清理队列。

6. Spotify 搜索必须配置密钥吗？

该搜索功能需要可选的 Spotify 客户端凭据，普通局域网控制不依赖它。

7. 操作会真实影响正在播放的音乐吗？

会，播放、暂停、分组和音量命令都会直接改变设备状态。

8. 适合远程控制家庭音箱吗？

它主要面向本地网络，远程访问需要额外的安全网络方案，不应直接暴露控制端口。

来源与核验说明

本条目根据 ClawHub 上 steipete 发布的 Sonoscli 1.0.0 内容整理，发布前已核对依赖与操作范围。