未读消息与消息通知
未读消息
未读消息数量用于展示设备端的当前未读消息数量,以及同步脚本执行状态或任务进度。
$cloud.notifyUnreadMessages() 是用来通知云控后台更新当前设备的 未读消息数 或其他关键状态。
- 设备端 SQLite 数据更新:
- 未读消息数据存储在设备本地的 SQLite 数据库中。
- 脚本可以通过 SQLite API 实时更新或查询相关数据表。
- 调用通知接口:
- 使用
$cloud.notifyUnreadMessages()后,云控后台会自动刷新显示。 - 支持批量设备同步,适用于群控和多任务监控场景。
- 使用
示例:
// 示例:更新未读消息数量
$cloud.notifyUnreadMessages(5);
消息通知
消息通知用于将自定义的日志、提示或告警信息推送到云控后台,实现设备与后台的实时消息同步。
- 普通消息:
使用$cloud.message(message)发送普通文本消息到云控后台。$cloud.message("任务执行完成"); - 带类型消息:
使用$cloud.message(message, type)发送带有类型的消息,用于区分不同的消息等级。
参数说明:参数 类型 说明 messagestring要发送的消息内容 typestring消息类型(可选)
可选类型:"verbose"— 普通消息;"info"— 一般消息;"warn"— 警告消息;"error"— 错误消息;"log"— 详细日志消息。
示例:
// 示例:发送带类型的消息
$cloud.message("同步完成", "info");
$cloud.message("任务超时,请检查网络连接", "warn");
$cloud.message("数据库更新失败", "error");