名称： devialet
描述： "通过 HTTP API 控制 Devialet Phantom 系列音箱。支持功能：播放/暂停、音量调节、静音/取消静音、音源选择、音箱状态查询。需要 DOS 2.14+ 或 SDOS 1.3+ 固件。兼容 Phantom I、Phantom II、Phantom Reactor 及 Dialog 型号。"

Devialet 音箱控制

通过本地网络控制 Devialet 音箱（Phantom、Mania 系列），并支持 Spotify 集成播放。

自然语言指令示例

用户可通过以下指令控制音箱：
- “播放 Nines - Lick Shots” → 通过 Spotify 搜索并播放
- “将音箱音量设为 40” → 调节音量
- “暂停音乐” → 暂停播放
- “现在播放什么？” → 查看当前曲目与状态

设置步骤

1. 获取音箱 IP 地址：通过路由器管理界面或 Devialet 应用查找
2. 配置 IP 地址：设置 DEVIALET_IP 环境变量，或在 TOOLS.md 中添加：
   ## Devialet 音箱 - IP: 192.168.x.x
3. Spotify 集成准备（如需使用）：
   - 安装并登录 Spotify 桌面客户端
   - 安装 playerctl 与 xdotool 工具（Ubuntu/Debian 示例：sudo apt install playerctl xdotool）

快速使用

# 设置音箱 IP
export DEVIALET_IP="192.168.x.x"

# 播放歌曲（自动搜索）
./scripts/play-on-devialet.sh "Drake - God's Plan"

# 通过 Spotify URI 播放
./scripts/play-on-devialet.sh spotify:track:4YZNJOA9d8wiO5ELNY5WxC

# 暂停 / 恢复
./scripts/play-on-devialet.sh pause
./scripts/play-on-devialet.sh resume

# 音量调节（0-100）
./scripts/play-on-devialet.sh volume 50

# 查看状态
./scripts/play-on-devialet.sh status

环境要求

• Devialet 音箱：需升级至 DOS 2.14+ 或 SDOS 1.3+ 固件
• Spotify 集成（可选）：
• 运行已登录的 Spotify 桌面客户端
• 安装 playerctl 与 xdotool
• 在 Spotify 应用中手动选择一次音箱作为 Spotify Connect 设备

工作原理

1. 通过 Spotify 桌面客户端（D-Bus/MPRIS）搜索曲目
2. 在 Spotify 中打开曲目 URI
3. Spotify Connect 将音频流推送至 Devialet 音箱
4. 通过 Devialet API 控制播放与音量

直接调用 Devialet API

若不使用 Spotify 集成，可直接调用音箱 API（请将 $DEVIALET_IP 替换为实际 IP）：

# 音量设置（0-100）
curl -X POST -H "Content-Type: application/json" \
  -d '{"volume": 50}' \
  "http://$DEVIALET_IP/ipcontrol/v1/systems/current/sources/current/soundControl/volume"

# 播放 / 暂停
curl -X POST "http://$DEVIALET_IP/ipcontrol/v1/groups/current/sources/current/playback/play"
curl -X POST "http://$DEVIALET_IP/ipcontrol/v1/groups/current/sources/current/playback/pause"

# 静音 / 取消静音
curl -X POST "http://$DEVIALET_IP/ipcontrol/v1/groups/current/sources/current/playback/mute"
curl -X POST "http://$DEVIALET_IP/ipcontrol/v1/groups/current/sources/current/playback/unmute"

# 获取设备状态
curl -s "http://$DEVIALET_IP/ipcontrol/v1/devices/current" | jq .

支持型号

• Phantom I、Phantom II、Phantom Reactor（需 DOS 2.14+ 固件）
• Dialog
• Mania（需 SDOS 1.3+ 固件）

API 参考

完整接口文档请参阅 references/api.md。