如何获取设备消息？

news2024/12/22 11:52:34

一、什么是消息？

消息是设备向萤石云平台传输的带有特定内容的信息，大部分消息由设备端主动产生，并且上报到平台。举个例子，设备开启画面变化检测，当设备画面产生变化，设备就会产生报警（画面变化报警），产生这条报警消息之后，设备会主动向平台上传该消息。

常见的消息分类有：告警消息、上下线消息、呼叫消息、ISAPI消息等。不同消息触发方式不同，例如告警消息需要设备处于布防状态才会触发上报；ISAPI消息需要设备订阅ISAPI事件（EventScribe为YES），设备才会上报ISAPI消息。

告警消息由设备端触发并上报，触发上报的消息内容中带有告警相关信息，可能是图片，可能是视频，可能是文字，以设备实际触发上报信息为准

上下线消息与设备在萤石云平台的在离线状态相关，由平台和设备的关联状态而定。当设备上线时，会主动上报在线消息给平台；下线时，平台会定时去查设备的状态，最长三个心跳（3*30S）周期之后，平台判断设备离线，发送离线消息

呼叫消息通常是由门铃类设备产生的，按下门铃的呼叫按钮之后，设备会向平台发送呼叫消息

ISAPI消息是海康某些设备特有的消息类型，是toB类型的消息，不同设备有不同的能力，具体由设备端提供ISAPI消息相关解释

二、如何接收消息？

通过萤石云客户端/萤石云视频APP接收消息，这种方式用户不需要进行额外的操作，只要设备端触发了告警消息就可以通过萤石客户端收到

通过开放平台的告警消息消息接口（只能获取告警消息）获取，接口文档，注意：使用该接口时，需将参数status设置为2

通过消息推送获取消息。自定义一个回调地址，当设备上报消息后，开放平台会自动将消息推送到该回调地址，开通指南。目前可支持推送设备上下线消息、呼叫消息、托管设备变更消息、ISAPI 上行消息、告警消息等。

注意事项：

免费版套餐只推送10台设备消息，不会推送账号下所有设备的消息。
消息推送用户可以自行在控制台开通，填入回调地址等关键信息即可
用户必需提供https url作为回调地址
当用户服务出现问题，超时2S以上没有及时处理消息，平台会判断这次推送失败，进入推送失败后续操作
当用户webhook推送错误率在1分钟内失败率达到一半时，平台会对客户进行预降级操作，在预降级状态下长时间（一天）未恢复至正常状态则对客户推送进行降级处理，在降级时仅有十分之一的消息量会尝试推送至客户系统。

三、ISPAI消息相关信息汇总

一般海康设备有自己特有的功能，例如温度实时监控、GPS实时定位等，萤石开放平台只开放了设备的基础能力，这些特有的功能需要通过ISAPI协议与设备交互实现。目前平台无法直接使用，若想使用这部分能力，需先自行联系到海康设备销售，签署保密协议之后拿到ISAPI协议相关接口和报文后使用。

如何判断设备支持上报ISAPI消息到萤石云平台？

设备上传消息到公网需要走萤石云协议（接入DevSDK 1.5.13、1.5.53及之后版本）与设备确认以下信息：设备触发ezDevSDK_thirdparty_send_isapi_msg命令（需要接入DevSDK 1.5.13、1.5.53及之后版本）后才会上报消息。设备上报的消息中，文字消息是必选的，图片消息可以根据设备功能选择是否上报。如果设备端产生的消息中包含图片时，则需购买萤石开放平台的云录制服务才能获取到图片（注：ISAPI消息中的文字和图片是通过两种方式传到平台的，文字可以直接上传，图片则需要存在云端的存储空间内，需要使用时从云端获取图片相关信息，操作指南：https://open.ys7.com/bbs/article/80）。

设备上报到萤石云平台需简单三步：