SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-16 03:06

技能介绍

Sonos CLI 用于在本地网络控制 Sonos 音箱。

用途与主要能力:发现设备、查询状态、播放/暂停/停止、设置音量、分组(status/join/unjoin/party/solo)、收藏(list/open)、队列(list/play/clear),并可通过 SMAPI 搜索 Spotify(smapi search --service "Spotify" --category tracks "query")。

必要用法示例: sonos discover sonos status --name "Kitchen" sonos play|pause|stop --name "Kitchen" sonos volume set 15 --name "Kitchen"

若 SSDP 发现失败,可指定 --ip <speaker-ip>。Spotify Web API 搜索为可选项,需要 SPOTIFY_CLIENT_ID/SECRET。

故障排查:

  1. sonos discover 报 no route to host:在 Mac OS 直连(无 Docker 沙箱)模式下,需为 Gateway 的父进程开启设置 -> 隐私与安全性 -> 本地网络,例如经 launchd 运行则为 node,终端直接运行则为 Terminal,VS Code 内运行则为 Visual Studio Code;也可改用允许网络访问的沙箱(Docker 容器)。
  2. sonos discover 报 bind: operation not permitted:可能处于不允许网络访问的 Codex 等沙箱中,需要批准提权或改用允许网络的环境。

限制:需在本地网络环境运行;SSDP 发现可能受网络与沙箱限制;Spotify 搜索依赖额外凭据;资料未提供平台、收费与价格信息。