应用启动器 Cluster（ApplicationLauncher）

Cluster ID: 0x050C  |  所在 Endpoint: 媒体端点（智能电视、机顶盒、流媒体设备等）

ApplicationLauncher 负责在媒体设备上启动、停止和隐藏内容应用 —— 是语音助手「打开 Netflix」「关闭当前应用」等指令的底层实现。 它管理的是应用的生命周期（启动/停止/隐藏），而不是应用内的内容播放。 通常部署在智能电视或机顶盒的媒体端点上，与 ApplicationBasic（应用信息查询）配合使用。

命令（Commands）

ApplicationLauncher Cluster 有 3 个请求命令和 1 个响应命令。 LaunchApp 启动应用，StopApp 停止应用，HideApp 隐藏应用（退到后台），三者都返回 LauncherResponse 告知操作结果。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

LaunchApp —— 启动应用（0x00）

启动设备上的指定应用。如果应用已在运行，则将其带到前台。 通过 ApplicationStruct 唯一标识目标应用， 可附带应用特定数据（如 DeepLink、启动参数）。

// LaunchApp 命令示例
// 启动 CSA 目录中的 StreamCo Player 应用
{
  "Application": {
    "CatalogVendorID": 24742,
    "ApplicationID": "com.streamco.player"
  },
  "Data": "source=voice&deeplink=/home"
}

↑ 返回命令列表

StopApp —— 停止应用（0x01）

停止设备上的指定应用。应用的运行状态会变为 Stopped。 如果该应用正在播放内容，播放也会一并终止。

// StopApp 命令示例
// 停止当前运行的 StreamCo Player 应用
{
  "Application": {
    "CatalogVendorID": 24742,
    "ApplicationID": "com.streamco.player"
  }
}

↑ 返回命令列表

HideApp —— 隐藏应用（0x02）

将应用退到后台，但不终止其进程。应用状态变为 ActiveHidden， 仍然可以执行后台任务（如继续播放音乐）。

// HideApp 命令示例
// 隐藏应用（退到后台，不终止进程）
{
  "Application": {
    "CatalogVendorID": 24742,
    "ApplicationID": "com.streamco.player"
  }
}

↑ 返回命令列表

LauncherResponse —— 操作结果（0x03）

LaunchApp、StopApp 和 HideApp 的统一响应。包含一个状态码和可选的附加数据。 控制端根据 Status 判断操作是否成功，失败时 Data 中可能包含错误详情。

// LauncherResponse 响应示例
// 启动成功
{
  "Status": 0,
  "Data": "session-id=xyz789"
}

// 应用不可用（未安装或不在目录中）
{
  "Status": 1,
  "Data": "Application not found in catalog"
}

// 等待用户确认（如首次启动需要同意条款）
{
  "Status": 3,
  "Data": "User approval required for first launch"
}

↑ 返回命令列表

属性详解

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

应用管理（0x0000, 0x0001）

描述设备支持的应用目录范围和当前前台应用的状态。

↑ 返回属性列表

结构体定义

ApplicationLauncher Cluster 使用两个结构体来标识应用。

ApplicationEPStruct（应用端点结构体）

描述一个应用及其在设备上对应的 Endpoint。用于 CurrentApp 属性， 让 Controller 既能知道当前前台应用是什么，也能直接定位到它的 Endpoint 进行进一步交互。

ApplicationStruct（应用标识结构体）

通过目录体系唯一标识一个内容应用。这个结构体在 LaunchApp / StopApp / HideApp 命令和 CurrentApp 属性中都会用到， 也与 ApplicationBasic Cluster 的 Application（0x0004）属性共用同一结构。

枚举

StatusEnum

LauncherResponse 中的状态码，表示应用操作的结果。相比 ContentLauncher 的 StatusEnum，ApplicationLauncher 的状态码涵盖了应用安装和权限审批等场景。

Feature 位图

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

示例数据

一台启用了 AP（ApplicationPlatform）特性的智能电视的 ApplicationLauncher Cluster 属性读取结果：

{
  // --- 支持的应用目录 ---
  "0x0000": [24742, 4996],           // CatalogList = 支持的目录厂商 ID 列表
                                      // 24742 = CSA 官方目录
                                      // 4996 = 某 OTT 平台目录

  // --- 当前前台应用 ---
  "0x0001": {                         // CurrentApp（当前应用，nullable）
    "Application": {                  //   ApplicationStruct
      "CatalogVendorID": 24742,       //     目录厂商 ID（CSA 官方）
      "ApplicationID": "com.streamco.player"  //  应用 ID
    },
    "Endpoint": 3                     //   应用所在 Endpoint 编号
  }
}

常见场景