Roon音乐控制

技能简介

该技能通过Roon官方API连接并控制Roon音乐播放器，支持自动发现Roon Core、区域切换、播放控制及曲目查询。兼容中文语音指令，适合集成到智能家居或自动化工作流中。

业务背景

为智能家居用户打造无缝音乐体验。通过语音即可操控全屋Roon音响系统，无需手动操作App或遥控器，解放双手的同时提升居家娱乐品质。特别适合多房间音乐场景，让不同区域随心切换播放内容。

落地案例：用户在客厅说"播放爵士乐"，系统自动连接Roon Core并在该区域开始播放；做饭时喊"切换到厨房"，音乐随人流动；好奇当前曲目时问"正在放什么"，即刻获取歌名和艺人信息。全程中文语音交互，老人小孩都能轻松使用。

能做什么

• 自动发现并连接局域网内的Roon Core
• 控制播放、暂停、上一曲、下一曲
• 查询当前播放曲目信息（歌名、艺人、专辑、进度）
• 列出所有可用播放区域并切换
• 响应中文指令如”播放音乐””下一曲””正在放什么”

使用说明

1. 安装依赖

pip install roonapi

2. 首次授权

运行代码后，需在Roon界面中授权该扩展。Token将自动保存至~/clawd/roon_config.json，后续无需重复授权。

3. 基础调用

from roon_controller import RoonController
controller = RoonController(verbose=True)

# 播放/暂停切换
controller.play_pause()

# 下一曲
controller.next()

# 获取当前曲目
track = controller.get_current_track()
print(f"正在播放: {track['track']} - {track['artist']}")

4. 命令行工具

python roon_controller.py play      # 播放
python roon_controller.py pause     # 暂停
python roon_controller.py next      # 下一曲
python roon_controller.py status    # 查看当前曲目
python roon_controller.py zones -v  # 列出所有区域

输入与输出

见下方输入与输出表格。

风险提示

• 首次运行必须在Roon界面完成扩展授权，否则无法连接
• 设备需与Roon Core处于同一局域网
• Token文件包含访问凭证，注意文件权限安全
• 区域名称以”muspi”结尾时会被优先识别
• Roon Core未运行或网络不通时将返回连接失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/puterjam/roon-controller/SKILL.md
来源类型：GitHub仓库