blucli¶

Skill 简介¶

blucli（简称 blu）是一个开源命令行工具，专为控制 Bluesound 和 NAD 品牌的网络音频播放器而设计。该工具的核心目标是让开发者能够通过简单的命令，轻松实现设备发现、媒体播放、分组控制以及音量调节等操作。使用 blucli，开发者无需深入了解底层协议或复杂的 API 文档，只需通过直观易懂的命令即可与 Bluesound/NAD 设备进行交互。这不仅提升了开发效率，也使得家庭自动化系统、媒体服务器集成等应用场景的开发变得更加便捷。

在现代智能家居和多媒体应用中，音频设备的集中控制是一个常见需求。blucli 通过提供统一的命令行接口，填补了这一领域的空白。它不仅支持单个设备的控制，还能方便地管理多个设备组成的群组，为开发者提供了极大的灵活性。

主要功能¶

blucli 提供了丰富的功能，以下是几个核心功能的详细介绍：

• 设备发现与管理
  blucli 可以自动扫描局域网内的 Bluesound/NAD 设备，并列出所有可用的设备信息。开发者可以通过 blu devices 命令查看设备列表，并根据设备 ID、名称或别名进行选择和控制。例如：
  bash blu devices
  该命令将显示所有在线的音频设备，方便用户选择目标设备进行后续操作。

• 媒体播放控制
  blucli 支持对音频播放进行全面的控制，包括播放、暂停、停止等常用操作。例如：
  bash blu play blu pause blu stop
  这些命令允许用户在不离开命令行环境的情况下，轻松管理音频播放状态。

• 音量调节
  通过 blucli，用户可以精确地控制设备的音量。例如，将音量设置为 15：
  bash blu volume set 15
  该命令支持多种参数设置，使用户能够根据需求灵活调整音量。

• 设备分组管理
  blucli 允许用户将多个设备组合成一个群组，并对其进行统一控制。例如，查看群组状态、添加设备到群组或从群组中移除设备：
  bash blu group status blu group add <device_id> blu group remove <device_id>
  这些命令为多房间音频系统的管理提供了便利。

• TuneIn 电台搜索与播放
  blucli 集成了 TuneIn 电台的支持，用户可以通过命令行搜索并播放电台。例如：
  bash blu tunein search "jazz" blu tunein play "jazz"
  这为用户提供了丰富的在线音频资源。

使用场景¶

1. 家庭自动化系统集成
   在智能家居环境中，blucli 可以作为音频控制模块，轻松集成到现有的自动化平台中。例如，通过脚本控制音频设备的开关、播放列表切换等。

2. 媒体服务器管理
   对于运行媒体服务器（如 Plex、Emby）的用户，blucli 可以作为控制音频输出的工具，实现远程播放、暂停等操作。

3. 多房间音频系统
   blucli 的分组功能使其成为管理多房间音频系统的理想选择。用户可以通过命令行将多个设备组合成一个群组，实现同步播放或独立控制。

4. 开发与测试
   在开发与 Bluesound/NAD 设备交互的应用时，blucli 提供了一个便捷的测试工具。开发者可以通过命令行快速验证功能，而无需编写额外的测试代码。

5. 远程控制与管理
   通过 SSH 或其他远程访问方式，blucli 可以实现对音频设备的远程控制。这对于需要在不同地点管理音频系统的用户尤为有用。

如何使用¶

安装¶

blucli 使用 Go 语言编写，安装前需要确保系统中已安装 Go 环境。安装命令如下：

go install github.com/steipete/blucli/cmd/blu@latest

安装完成后，blu 命令将添加到系统的 PATH 中，用户可以在终端中直接使用。

配置¶

blucli 支持通过命令行参数、环境变量或配置文件进行配置。优先级顺序为：
1. 命令行参数（如 --device）
2. 环境变量（如 BLU_DEVICE）
3. 配置文件（如果设置）

例如，设置默认设备可以通过以下命令：

export BLU_DEVICE=<device_id>

前置条件¶

• 局域网内至少有一个 Bluesound 或 NAD 设备处于在线状态。
• 设备与运行 blucli 的机器在同一网络中。

示例¶

示例 1：基本操作¶

# 列出所有设备
blu devices

# 选择目标设备并查看状态
blu --device <device_id> status

# 播放音乐
blu play

# 暂停播放
blu pause

# 设置音量
blu volume set 20

示例 2：设备分组¶

# 查看群组状态
blu group status

# 将设备添加到群组
blu group add <device_id>

# 从群组中移除设备
blu group remove <device_id>

总结¶

blucli 是一个功能强大且易于使用的命令行工具，专为控制 Bluesound 和 NAD 设备而设计。它为开发者提供了一种简洁高效的途径来管理音频设备，适用于家庭自动化、媒体服务器管理、多房间音频系统等多种场景。通过 blucli，用户可以轻松实现设备的发现、播放控制、音量调节以及分组管理等操作，极大地提升了开发效率和使用体验。无论你是智能家居开发者，还是音频设备爱好者，blucli 都是一个值得尝试的工具。