AudioOutput Cluster

Cluster ID: 0x050B  |  Endpoint: Media endpoint (TV, AV receiver, Soundbar, etc.)

AudioOutput manages the audio output destinations of a device — HDMI ARC, Bluetooth, optical, headphones, built-in speakers, etc. Users can query available audio outputs, check which one is currently in use, switch to a specified output, and customize output source names. It is a common Cluster for media devices such as smart TVs, AV receivers, and Soundbars, serving as the output counterpart to MediaInput.

Commands

The AudioOutput Cluster has 2 commands. SelectOutput switches the audio output destination, and RenameOutput allows users to customize output source names (requires the NU feature). Click a command ID in the table below to jump to its detailed description.

SelectOutput — Switch Audio Output (0x00)

Switches the device's audio output to the specified destination. Index must match the Index value of an OutputInfoStruct in OutputList; otherwise the device returns an error. On success, the CurrentOutput attribute updates to the specified Index value.

↑ Back to Commands

RenameOutput — Rename Output Source (0x01)

Sets a custom name for the specified output source. After modification, the Name field of the corresponding entry in OutputList updates. This command requires the device to have the NU (NameUpdates) feature enabled.

// RenameOutput command example
// Rename the output source at Index=2 to "HomePod"
{
  "Index": 2,
  "Name": "HomePod"
}
// After execution, the Name of Index=2 in OutputList becomes "HomePod"

↑ Back to Commands

Attributes

The AudioOutput Cluster has 2 attributes. Click an attribute ID in the summary table below to jump to its detailed description.

Audio Output State (0x0000, 0x0001)

Describes the device's currently available audio output list and the currently selected output source.

↑ Back to Attributes

Struct Definitions

The AudioOutput Cluster uses one structure to describe output source information.

OutputInfoStruct

Describes the complete information for an audio output source, including index, type, and name.

OutputTypeEnum

Defines the interface type of audio output sources. Contains 6 enum values covering common audio output methods. Controllers can use this to display corresponding icons or categories in the UI.

Feature Bitmap

The AudioOutput Cluster declares optional capabilities the device supports via FeatureMap (0xFFFC):

Example Data

Read results of the AudioOutput Cluster from a smart TV — currently outputting audio to HDMI ARC, with 4 output sources:

{
  // --- Current Output Source ---
  "0x0001": 1,                   // CurrentOutput = 1 (currently selected HDMI ARC)

  // --- Output Source List ---
  "0x0000": [                    // OutputList
    {
      "Index": 0,
      "OutputType": 4,            // Internal (built-in speakers)
      "Name": "TV Speaker"
    },
    {
      "Index": 1,
      "OutputType": 0,            // HDMI (HDMI ARC/eARC passthrough)
      "Name": "HDMI ARC"
    },
    {
      "Index": 2,
      "OutputType": 1,            // BT (Bluetooth speaker)
      "Name": "Bluetooth"
    },
    {
      "Index": 3,
      "OutputType": 2,            // Optical (optical output)
      "Name": "Optical Out"
    }
  ]
}

Common Scenarios