目标导航 Cluster（TargetNavigator）

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

TargetNavigator 负责在设备的内容目标之间进行导航 —— 这些目标可以是应用、屏幕页面、菜单项等。 用户可以通过它查询设备有哪些可导航的目标、当前处于哪个目标，并跳转到指定目标。 它是智能电视和机顶盒等媒体设备中用于应用切换和界面导航的核心 Cluster。

命令（Commands）

TargetNavigator Cluster 只有 1 个命令和 1 个响应。 NavigateTarget 用于跳转到指定目标，设备返回 NavigateTargetResponse 告知导航结果。

NavigateTarget —— 导航到目标（0x00）

请求设备跳转到指定的目标。Target 必须是 TargetList 中某个 TargetInfoStruct 的 Identifier 值。 可选的 Data 字段可以传递额外的导航参数（如深度链接路径）。 设备收到命令后会返回 NavigateTargetResponse 告知结果。

// NavigateTarget 命令示例
// 导航到 Identifier=1 的目标（Netflix），附带启动参数
{
  "Target": 1,
  "Data": "movie/12345"
}

// NavigateTargetResponse 响应
{
  "Status": 0,                   // Success
  "Data": "launched"
}

↑ 返回命令列表

NavigateTargetResponse —— 导航结果响应（0x01）

设备对 NavigateTarget 命令的响应。通过 Status 字段告知导航是否成功， 可选的 Data 字段可以携带设备返回的额外信息。

↑ 返回命令列表

属性详解

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

目标状态（0x0000, 0x0001）

描述设备当前可导航的目标列表和当前所在的目标。

↑ 返回属性列表

结构体定义

TargetNavigator Cluster 使用一个结构体来描述导航目标信息。

TargetInfoStruct

描述一个导航目标的基本信息，包括唯一标识和显示名称。

枚举定义

StatusEnum

NavigateTargetResponse 中 Status 字段的枚举值，表示导航操作的结果。

示例数据

一台智能电视的 TargetNavigator Cluster 读取结果 —— 当前在设置页面，共有 4 个可导航目标：

{
  // --- 当前目标 ---
  "0x0001": 2,                   // CurrentTarget = 2（当前在"设置"页面）

  // --- 目标列表 ---
  "0x0000": [                    // TargetList
    {
      "Identifier": 0,
      "Name": "Home"              // 主屏幕
    },
    {
      "Identifier": 1,
      "Name": "Netflix"           // Netflix 应用
    },
    {
      "Identifier": 2,
      "Name": "Settings"          // 系统设置
    },
    {
      "Identifier": 3,
      "Name": "YouTube"           // YouTube 应用
    }
  ]
}

常见场景