跳到主要内容

HMS 管理

功能概述

上云API 开放HMS功能是为了将设备的告警显示在指挥中心,提升用户对于风险的感知和处理能力,以保障作业安全。

说明: HMS 上报的是全量的告警信息。若上一次 HMS 上报中的告警,在本次 HMS 上报中消失了,则说明该告警解除了。

告警文案查询

用户需要通过上报的协议中的字段信息拼接文案Key。凭借文案Key告警文案查询json文件中查询对应的告警文案。根据告警的设备的不同,拼接规则也有区别。

  • 告警文案查询json文件:hms.json
  • 拼接规则及示例:
    • {code}为告警码,可通过协议中的字段获得。HMS功能的协议中的字段及其解释可参见API介绍 > HMS 管理
    • 如果是机巣设备的告警,需要将dock_tip_拼接在{code}前,机场拼接逻辑:dock_tip_{code}
      以错误码为0x1001为例,文案Key为:dock_tip_0x1001
    • 如果是飞行器的告警,需要将fpv_tip_拼接在{code}前,飞机拼接逻辑:fpv_tip_{code}
      以错误码为0x0108为例,文案Key为:fpv_tip_0x0108
    • 如果是遥控器的告警,需要将rc_tip_拼接在{code}前,遥控器拼接逻辑:rc_tip_{code}
      以错误码为0x00010001为例,文案Key为:rc_tip_0x00010001

交互时序

设备通过健康告警协议(Topic: thing/product/{gateway_sn}/events Method: hms)上传机巣设备与飞行器的告警信息到云端,云端通过拼接Key、查询json文件、渲染文案等行为后获得正确且完整的告警文案并呈现在Web界面。

接口详细实现

HMS功能

  • 健康告警