BluOS播放器控制

技能简介

blucli（简称 blu）是一款面向 Bluesound/NAD 播放器的命令行控制工具，支持设备发现、播放控制、多房间分组及音量管理。

业务背景

BluOS播放器控制工具让IT运维与智能家居集成商通过命令行批量管理多房间音频系统。企业会议室、酒店客房、连锁门店可统一执行播放切换、音量调节与设备分组，摆脱逐台手动操作的繁琐，提升部署效率与现场响应速度。

落地案例：某酒店集团需在50间套房同时播放定制化欢迎音乐。技术人员通过脚本调用blucli扫描局域网内所有BluOS播放器，一键创建全屋同步分组并设定初始音量，后续每日自动切换时段歌单，无需工程人员逐房调试。

能做什么

• 扫描局域网内的 BluOS 设备并列出可用目标
• 控制播放状态：播放、暂停、停止
• 调节设备音量或设置指定数值
• 创建和管理播放器分组，实现多房间同步
• 搜索并播放 TuneIn 网络电台内容
• 输出 JSON 格式结果，便于脚本集成

使用说明

安装步骤

1. 确保系统已安装 Go 环境
2. 执行安装命令：go install github.com/steipete/blucli/cmd/blu@latest
3. 确认 blu 二进制文件已在 PATH 中可用

基础用法

1. 运行 blu devices 查看可用设备并选择目标
2. 查看设备状态：blu --device <id> status
3. 控制播放：blu play / blu pause / blu stop
4. 设置音量：blu volume set 15

目标选择优先级：命令行 --device 参数 → 环境变量 BLU_DEVICE → 配置文件默认值

常用任务

• 分组管理：blu group status / blu group add / blu group remove
• TuneIn 电台：blu tunein search "关键词" 后 blu tunein play "关键词"

脚本场景建议加 --json 参数；执行播放变更前请确认目标设备。

输入与输出

见下方输入与输出表格。

风险提示

• 操作前务必确认目标设备，避免误控其他房间播放器
• 网络环境变化可能导致设备发现失败，需重新扫描
• 分组操作会影响多个设备同步状态，建议先查看当前分组
• 依赖局域网通信，跨网段或防火墙限制可能阻断控制

来源信息

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