音频输出 Cluster（AudioOutput）

Cluster ID: 0x050B  |  所在 Endpoint: 媒体端点（电视、AV 接收器、Soundbar 等）

AudioOutput 负责管理设备的音频输出目的地 —— HDMI ARC、蓝牙、光纤、耳机、内置扬声器等。 用户可以通过它查询设备有哪些音频输出、当前正在使用哪个、切换到指定输出，以及为输出源自定义名称。 它是智能电视、AV 接收器、Soundbar 等媒体设备的常见 Cluster 之一，与 MediaInput 互为输入/输出的对应关系。

命令（Commands）

AudioOutput Cluster 共有 2 个命令。SelectOutput 用于切换音频输出目的地， RenameOutput 允许用户为输出源自定义名称（需要 NU 特性）。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

SelectOutput —— 切换音频输出（0x00）

将设备的音频输出切换到指定目的地。Index 必须是 OutputList 中某个 OutputInfoStruct 的 Index 值，否则设备会返回错误。 执行成功后，CurrentOutput 属性会更新为指定的 Index 值。

↑ 返回命令列表

RenameOutput —— 重命名输出源（0x01）

为指定的输出源设置一个自定义名称。修改后，OutputList 中对应条目的 Name 字段会更新。 此命令需要设备启用 NU（NameUpdates） 特性。

// RenameOutput 命令示例
// 将 Index=2 的输出源重命名为 "HomePod"
{
  "Index": 2,
  "Name": "HomePod"
}
// 执行后 OutputList 中 Index=2 的 Name 变为 "HomePod"

↑ 返回命令列表

属性详解

AudioOutput Cluster 共有 2 个属性。点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

音频输出状态（0x0000, 0x0001）

描述设备当前可用的音频输出列表和当前选中的输出源。

↑ 返回属性列表

结构体定义

AudioOutput Cluster 使用一个结构体来描述输出源信息。

OutputInfoStruct

描述一个音频输出源的完整信息，包括索引、类型和名称。

OutputTypeEnum

定义音频输出源的接口类型。共 6 个枚举值，涵盖常见的音频输出方式。 控制端可据此在 UI 上展示对应的图标或分类。

Feature 位图

AudioOutput Cluster 通过 FeatureMap（0xFFFC）声明设备支持的可选能力：

示例数据

一台智能电视的 AudioOutput Cluster 读取结果 —— 当前音频输出到 HDMI ARC，共有 4 个输出源：

{
  // --- 当前输出源 ---
  "0x0001": 1,                   // CurrentOutput = 1（当前选中 HDMI ARC）

  // --- 输出源列表 ---
  "0x0000": [                    // OutputList
    {
      "Index": 0,
      "OutputType": 4,            // Internal（内置扬声器）
      "Name": "TV Speaker"
    },
    {
      "Index": 1,
      "OutputType": 0,            // HDMI（HDMI ARC/eARC 回传）
      "Name": "HDMI ARC"
    },
    {
      "Index": 2,
      "OutputType": 1,            // BT（蓝牙音箱）
      "Name": "Bluetooth"
    },
    {
      "Index": 3,
      "OutputType": 2,            // Optical（光纤输出）
      "Name": "Optical Out"
    }
  ]
}

常见场景