sonoscli

Sonos CLI 技能讓您能透過簡潔的命令列介面，順暢地控制區域網路內的 Sonos 音訊系統。此工具專為進階使用者與開發者設計，無需使用原生 Sonos 應用程式即可執行常見的音訊管理工作。它透過 SSDP 協議進行網路探索，並與喇叭節點直接通訊，提供對單一裝置或同步喇叭群組的細緻控制。無論您是想自動化執行早晨播放清單、為派對同步房間音樂，或是進行快速狀態檢查，此技能都提供了將音訊控制整合至自動化工作流或個人 AI 助理所需的基礎功能。

• 完整的播放控制功能，包含對特定房間或區域執行播放、暫停與停止指令。

• 智慧型喇叭群組功能，支援加入、退出、派對模式與獨立模式設定。

• 進階播放清單管理，可直接從命令列列出、播放或清除曲目。

• 內建我的最愛管理功能，可快速存取並播放您儲存的 Sonos 預設內容。

• 透過 SMAPI 整合 Spotify，可對曲目與類別進行進階搜尋。

• 狀態監控功能，提供即時的當前曲目中繼資料與喇叭音量等級檢視。

• 靈活的音量控制，允許對特定喇叭或群組進行精確調整。

• 本工具使用 SSDP 進行網路探索；請確保您的區域網路允許 UDP 流量通過標準 SSDP 連接埠。

• 若探索失敗，可使用 --ip 旗標手動指定喇叭的 IP 位址，以避開網路路由問題。

• 在 Docker 或特定 IDE 終端機等沙盒環境中執行時，請確保網路堆疊已設定為允許存取區域網路，以避免權限錯誤。

• 支援選用的 Spotify Web API 整合；請提供 SPOTIFY_CLIENT_ID 與 SPOTIFY_CLIENT_SECRET 以啟用進階 SMAPI 搜尋功能。

• 針對常見的網路問題（如「找不到主機路由」或綁定權限錯誤）提供疑難排解指南，特別適用於需管理區域網路隱私設定的 macOS 使用者。