设备标识 Cluster（Identify）

Cluster ID: 0x0003  |  所在 Endpoint: 通常在 Endpoint 1（功能端点），也常见于 Endpoint 0（Root）

Identify 用于触发设备上的视觉或听觉指示器（闪灯、响铃、屏幕闪烁等），帮助用户在多个设备中定位某一台。 这个 Cluster 非常小 —— 只有 2 个属性和 2 个命令，但几乎所有 Matter 设备都必须支持它。

属性总览

Identify 只有两个属性，都是必须支持的。点击属性 ID 可跳转到详细说明。

IdentifyTime（标识剩余时间）

当前标识效果的剩余秒数。写入一个非零值会立即开始标识，设备以每秒递减的方式倒计时到 0 后停止。 写入 0 可以立即停止正在进行的标识。

↑ 返回属性列表

IdentifyType（标识方式）

只读属性，描述设备使用哪种方式进行标识。不同的设备硬件能力不同，灯泡会闪灯，门锁可能会响铃，带屏幕的设备会闪烁显示。

IdentifyTypeEnum 枚举值

↑ 返回属性列表

命令（Commands）

Identify Cluster 有两个命令，都是 Client 发给 Server（即 App 发给设备）。 不需要 Timed Interaction，也没有安全限制，直接发送即可。

Identify —— 开始标识（0x00）

让设备开始标识，持续指定的秒数。设备会根据自身 IdentifyType 的能力选择标识方式（闪灯、响铃等）。 发送后 IdentifyTime 属性会被设置为传入的值，然后逐秒递减到 0。

请求示例：

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0003",
      "commandId": "0x00"       // Identify
    },
    "commandFields": {
      "0": 10                   // IdentifyTime = 10 秒
    }
  }]
}

↑ 返回命令列表

TriggerEffect —— 触发效果（0x40）

触发一个预定义的标识效果。与 Identify 命令不同，TriggerEffect 指定的是效果类型而非持续时间 —— 每种效果有自己的固定时长和表现方式。

EffectIdentifierEnum 枚举值

EffectVariantEnum 枚举值

请求示例（触发呼吸灯效果）：

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0003",
      "commandId": "0x40"       // TriggerEffect
    },
    "commandFields": {
      "0": 1,                   // EffectIdentifier = Breathe（呼吸灯效果）
      "1": 0                    // EffectVariant = Default
    }
  }]
}

↑ 返回命令列表

示例数据

读取一个灯泡设备的 Identify Cluster 属性：

{
  // --- 属性 ---
  "0x0": 0,         // IdentifyTime = 0（当前未在标识中）
  "0x1": 2          // IdentifyType = VisibleIndicator（LED 指示灯）
}