核心用法
blucli 是 Bluesound/NAD 音频播放器的 CLI 控制工具,通过 blu 命令实现以下功能:
设备管理:blu devices 列出可用设备,支持通过 --device 参数、环境变量 BLU_DEVICE 或配置文件指定目标设备。
播放控制:blu play|pause|stop 控制播放状态,blu volume set 15 调节音量。
设备分组:blu group status|add|remove 管理多设备同步播放组。
TuneIn 电台:blu tunein search "关键词" 和 blu tunein play "电台名" 搜索播放网络电台。
脚本友好:所有命令支持 --json 输出格式,便于自动化集成。
显著优点
- 功能聚焦:专为 BluOS 生态设计,指令简洁直观
- 多目标支持:灵活的设备选择机制,适合多房间场景
- 自动化友好:JSON 输出和标准化退出码,易于集成 Home Assistant 等系统
- 维护者可信:由 PSPDFKit 创始人 Peter Steinberger 开发,代码质量有保障
- 零依赖风险:Skill 本身为纯文档,无嵌入可执行代码
潜在局限
- 硬件绑定:仅兼容 Bluesound/NAD 品牌的网络播放器,无法跨品牌使用
- 网络依赖:依赖局域网发现协议,跨 VLAN 或复杂网络环境可能失效
- 功能边界:专注播放控制,不支持音频格式转码或高级 DSP 设置
- 外部工具依赖:实际功能需安装独立的
blu二进制(Go 编译),Skill 本身仅为使用文档
适合人群
- 拥有 Bluesound/NAD 设备的智能家居用户
- 需要通过脚本自动化音频场景的技术爱好者
- 家庭多房间音频系统的管理员
常规风险
- 误操作风险:音量设置无确认步骤,高音量可能损坏设备或听力
- 设备误选:多设备环境下需确认目标设备,避免控制错误的房间
- 网络暴露:BluOS 协议基于局域网,建议确保 WiFi 安全,避免未授权访问