应用信息 Cluster（ApplicationBasic）

Cluster ID: 0x050D  |  所在 Endpoint: 应用端点（每个内容应用占用一个独立的 Endpoint）

ApplicationBasic 提供内容应用（Content App）的基本信息 —— 包括应用名称、开发商、版本号、运行状态和唯一标识。 它是 Matter 媒体/电视设备生态中的核心 Cluster，每个安装在电视或机顶盒上的内容应用都通过一个独立的 Endpoint 暴露这个 Cluster。

属性总览

ApplicationBasic 共有 8 个属性，按功能分为四组。点击属性 ID 可跳转到对应的详细说明。

厂商信息（0x0000 – 0x0002）

描述应用的开发商和名称。这些属性在应用安装后就已确定，运行时不可更改。

↑ 返回属性列表

产品标识（0x0003 – 0x0004）

应用的产品编号和全局唯一标识。Application 属性是最重要的标识 —— 它通过目录体系唯一定位一个应用。

↑ 返回属性列表

运行状态（0x0005 – 0x0006）

描述应用的当前运行状态和版本信息。

↑ 返回属性列表

访问控制（0x0007）

控制哪些厂商的 Controller 可以访问此应用的 Cluster。

↑ 返回属性列表

结构体与枚举

ApplicationStruct（应用标识结构体）

通过目录体系唯一标识一个内容应用。不同的应用目录（如 CSA、Google Play、Apple App Store） 各自有独立的编号体系，CatalogVendorID 指明使用哪个目录，ApplicationID 是该目录内的应用标识。

ApplicationStatusEnum（应用运行状态枚举）

描述内容应用当前的运行和可见状态。

命令（Commands）

ApplicationBasic 没有定义任何命令。应用的启动和控制由其他 Cluster 负责：

• ApplicationLauncher（0x050C）—— 负责启动、停止和隐藏应用
• MediaPlayback（0x0506）—— 负责播放控制（播放、暂停、快进等）
• ContentLauncher（0x050A）—— 负责启动特定内容（如打开某个视频）

ApplicationBasic 的定位是只读的信息查询 —— 它告诉 Controller「这个应用是什么」， 而不负责「对这个应用做什么」。

示例数据

一台智能电视上某个流媒体应用（Endpoint 3）的 ApplicationBasic Cluster 读取结果：

{
  // --- 厂商信息 ---
  "0x0000": "StreamCo",            // VendorName = 应用开发商名称
  "0x0001": 4996,                  // VendorID = 0x1384（CSA 分配）
  "0x0002": "StreamCo Player",     // ApplicationName = 应用名称

  // --- 产品标识 ---
  "0x0003": 101,                   // ProductID = 应用产品 ID
  "0x0004": {                      // Application（应用标识结构体）
    "CatalogVendorID": 24742,      //   CatalogVendorID = CSA 目录
    "ApplicationID": "com.streamco.player"  //   ApplicationID = 应用 ID
  },

  // --- 运行状态 ---
  "0x0005": 1,                     // Status = ActiveVisibleFocus（前台可见且有焦点）
  "0x0006": "2.1.0",               // ApplicationVersion = 应用版本号

  // --- 访问控制 ---
  "0x0007": [4996, 65521]          // AllowedVendorList = 允许访问此应用的厂商 ID 列表
}

常见场景