频道 Cluster（Channel）

Cluster ID: 0x0504  |  所在 Endpoint: 媒体端点（电视、机顶盒等）

Channel 负责频道的导航和频道线路（Lineup）管理 —— 切台、跳台、按名称搜台、查询频道列表和电子节目单（EPG）。 它是智能电视和机顶盒等媒体设备的核心 Cluster 之一，与 MediaInput 分工不同： MediaInput 管理物理输入源（HDMI、USB），Channel 管理逻辑频道（CCTV-1、HBO）。

命令（Commands）

Channel Cluster 共有 6 个客户端命令和 2 个响应命令。 基础切台（ChangeChannelByNumber / SkipChannel）所有设备都支持， ChangeChannel 需要频道列表或线路信息支撑（CL 或 LI），GetProgramGuide 和录制相关命令需要更高级的特性。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

响应命令

ChangeChannel —— 模糊匹配切台（0x00）

通过一个字符串在频道列表中模糊匹配并切换频道。设备会依次匹配频道的 Name、CallSign、AffiliateCallSign、 编号（MajorNumber-MinorNumber）等字段。如果唯一匹配到一个频道，自动切换并更新 CurrentChannel； 如果匹配到多个或零个，通过 ChangeChannelResponse 告知控制端。

ChangeChannelResponse

ChangeChannel 的响应，告知匹配结果：

// ChangeChannel 命令响应（ChangeChannelResponse）
// 匹配成功
{
  "Status": 0,         // Success
  "Data": null
}

// 匹配到多个结果
{
  "Status": 1,         // MultipleMatches
  "Data": "CCTV-5 体育, CCTV-5+ 赛事"
}

// 未匹配到任何频道
{
  "Status": 2,         // NoMatches
  "Data": null
}

↑ 返回命令列表

ChangeChannelByNumber —— 精确切台（0x02）

通过主号（MajorNumber）和副号（MinorNumber）精确切换到指定频道。 这是最基础的切台命令，不需要设备提供频道列表，所有实现 Channel Cluster 的设备都必须支持。 不返回响应命令 —— 切台成功后 CurrentChannel 属性会更新。

↑ 返回命令列表

SkipChannel —— 相对跳台（0x03）

相对当前频道向前或向后跳转指定数量的频道。正数向前（频道号增大方向），负数向后。 跳转依据的是设备内部的频道排列顺序，到达列表末尾或开头时会循环（wrap around）。

↑ 返回命令列表

GetProgramGuide —— 查询节目单（0x04）

查询电子节目单（EPG）数据，返回指定时间范围和频道范围内的节目列表。 此命令需要设备启用 EG（ElectronicGuide） 特性。 响应通过 ProgramGuideResponse 返回，支持分页。

↑ 返回命令列表

RecordProgram —— 预约录制（0x06）

预约录制指定节目。通过节目的唯一标识符（ProgramIdentifier）或外部 ID 定位要录制的节目。 此命令需要设备启用 RP（RecordProgram） 特性。 该命令只支持具备存储能力的设备（如带硬盘的机顶盒、DVR）。

↑ 返回命令列表

CancelRecordProgram —— 取消录制（0x07）

取消之前通过 RecordProgram 预约的录制任务。参数结构与 RecordProgram 相同， 通过 ProgramIdentifier 定位要取消的录制。需要 RP 特性。

↑ 返回命令列表

属性详解

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

频道信息（0x0000 ~ 0x0002）

描述设备可用的频道列表、运营商线路信息以及当前选中的频道。

↑ 返回属性列表

结构体定义

Channel Cluster 使用两个核心结构体来描述频道和线路信息。

ChannelInfoStruct

描述一个频道的完整信息。MajorNumber 和 MinorNumber 是必选字段，其余为可选。

LineupInfoStruct

描述设备当前接入的运营商线路信息。OperatorName 和 LineupInfoType 是必选字段。

枚举值

StatusEnum

ChangeChannelResponse 中的匹配结果状态：

ChannelTypeEnum

描述频道的传输方式 / 来源类型：

LineupInfoTypeEnum

描述线路运营商的类型：

Feature 位图

Channel Cluster 通过 FeatureMap（0xFFFC）声明设备支持哪些可选能力：

示例数据

一台启用了 CL + LI 特性的机顶盒，当前正在收看 CCTV-6 的 Channel Cluster 读取结果：

{
  // --- 当前频道 ---
  "0x0002": {                       // CurrentChannel
    "MajorNumber": 6,
    "MinorNumber": 1,
    "Name": "CCTV-6 电影",
    "CallSign": "CCTV6",
    "AffiliateCallSign": null,
    "Identifier": "cctv6-hd",
    "Type": 2                        // Terrestrial（地面广播）
  },

  // --- 频道列表（需要 CL 特性）---
  "0x0000": [                        // ChannelList
    {
      "MajorNumber": 1,
      "MinorNumber": 1,
      "Name": "CCTV-1 综合",
      "CallSign": "CCTV1",
      "AffiliateCallSign": null,
      "Identifier": "cctv1-hd",
      "Type": 2                      // Terrestrial
    },
    {
      "MajorNumber": 5,
      "MinorNumber": 1,
      "Name": "CCTV-5 体育",
      "CallSign": "CCTV5",
      "AffiliateCallSign": null,
      "Identifier": "cctv5-hd",
      "Type": 2
    },
    {
      "MajorNumber": 6,
      "MinorNumber": 1,
      "Name": "CCTV-6 电影",
      "CallSign": "CCTV6",
      "AffiliateCallSign": null,
      "Identifier": "cctv6-hd",
      "Type": 2
    },
    {
      "MajorNumber": 100,
      "MinorNumber": 1,
      "Name": "HBO",
      "CallSign": "HBO",
      "AffiliateCallSign": "HBO East",
      "Identifier": "hbo-east",
      "Type": 1                      // Cable（有线电视）
    }
  ],

  // --- 线路信息（需要 LI 特性）---
  "0x0001": {                        // Lineup
    "OperatorName": "中国广电",
    "LineupName": "标清数字套餐",
    "PostalCode": "100000",
    "LineupInfoType": 0              // MSO
  }
}

常见场景