设备能力与事件参考
设备能力与事件参考
本域说明
本区给出设备能力、事件和告警字段。任务步骤在 开发指南：绑定设备、读写配置、接收消息分别见接入摄像机、Web/SaaS 集成、接收设备消息 与 推送配置。
旧版物模型 OpenAPI（getProductModel、iotDeviceControl 等）未对海外集成发布，请走 设备能力使用说明 与 device.property.* / device.service.invoke。海外不提供设备托管。
读者必读
新接入请先读 能力使用。调用前用 device.capability.list 确认设备是否支持本页能力；权限见 权限码；错误码见 能力错误码。
本区还包括
- 按设备类型浏览（不含国标）
- 权限码、能力错误码
- 事件总览与 事件总表
- 告警与能力消息（
device.message.*） - 设备列表与绑定状态 HTTP（
device.detail.*）：设备接口（第 5 章，不在能力树下）
现行能力集与历史推送类型见 能力集、能力开关、事件消息类型（历史 msgType 对照）、事件消息格式（历史报文对照）。常见问题见 能力 FAQ。
设备能力
设备能力正文在侧栏 设备能力 下，按编号域浏览：00 通用方法 → 01 侦测与告警（含各侦测能力组）→ 02 图像 … → 16 控制。每个能力组内是平铺的编号文档；对外 URL 由每页 permalink 决定（如 /book/zh/04-capabilities/detection/arming/enabled/get.html），不要按 URL 路径再建子文件夹。
先读 设备能力使用说明，再按域浏览。四个通用 OpenAPI 方法：
| 做什么 | 方法名 |
|---|---|
| 查这台设备支持哪些能力 | device.capability.list |
| 批量读属性 | device.property.get |
| 批量写属性 | device.property.set |
| 调用一次服务 | device.service.invoke |
重启、Wi-Fi、校时、升级等见 设备维护 域；详情与绑定见 API 参考中的设备管理接口（尚未全部迁入本区）。
事件
能力事件：在 setMessageCallback 的 callbackFlag 中加入 capabilityEvent。msgType 为 eventId，报文含 deviceId 与 outputData。
历史告警与上下线仍用 alarm、deviceStatus（did、cid、字符串 msgType）。类型见 事件消息类型（历史对照），报文见 事件消息格式定义（历史对照）。标准 eventId 见 事件总表；接收见 接收告警 与 设备消息。