| 一、什么是消息？ 消息是设备向萤石云平台传输的带有特定内容的信息，大部分消息由设备端主动产生，并且上报到平台。举个例子，设备开启画面变化检测，当设备画面产生变化，设备就会产生报警（画面变化报警），产生这条报警消息之后，设备会主动向平台上传该消息。 常见的消息分类有：告警消息、上下线消息、呼叫消息、ISAPI消息等。不同消息触发方式不同，例如告警消息需要设备处于布防状态才会触发上报；ISAPI消息需要设备订阅ISAPI事件（EventScribe为YES），设备才会上报ISAPI消息。 告警消息由设备端触发并上报，触发上报的消息内容中带有告警相关信息，可能是图片，可能是视频，可能是文字，以设备实际触发上报信息为准 上下线消息与设备在萤石云平台的在离线状态相关，由平台和设备的关联状态而定。当设备上线时，会主动上报在线消息给平台；下线时，平台会定时去查设备的状态，最长三个心跳（3*30S）周期之后，平台判断设备离线，发送离线消息 呼叫消息通常是由门铃类设备产生的，按下门铃的呼叫按钮之后，设备会向平台发送呼叫消息 ISAPI消息是海康某些设备特有的消息类型，是toB类型的消息，不同设备有不同的能力，具体由设备端提供ISAPI消息相关解释 二、如何接收消息？
三、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）。 设备上报到萤石云平台需简单三步：
打开本地消息开关需要在设备端的配置界面操作
打开平台的布防开关可以用接口操作布防，接口文档：https://open.ys7.com/help/56#device_switch-api1
开启设备的ISAPI订阅（EventScribe为YES 这一步需要用户自行联系设备端配合），用接口操作，接口文档 https://open.ys7.com/help/75，接口路径和报文内容需要找设备销售签署保密协议拿到 操作这三步之后，设备端产生ISAPI消息就会上报到平台了，后续就可以通过消息通道获取ISAPI消息。 |
