未读消息与消息通知
 更新: 2025/10/10
 阅读时间: 5 分钟
使用 $cloud 模块向云控后台实时推送设备未读消息、任务进度及运行状态,实现群控投屏端动态展示。
功能概述
$cloud.notifyUnreadMessages() 用于通知云控后台更新当前设备的 未读消息数 或其他关键状态。
脚本可从本地 SQLite 数据库读取统计数据(如消息数量、待办任务等),并实时同步至云控后台,实现投屏界面动态展示。
适用场景
- 显示设备端的 未读消息数量;
 - 同步脚本执行状态或任务进度;
 - 向后台推送自定义日志、提示或告警信息。
 
实现逻辑
- 设备端 SQLite 数据更新
- 未读消息数据存储在设备本地 SQLite;
 - 脚本可通过 SQLite API 实时更新或查询相关表。
 
 - 调用通知接口
- 调用 
$cloud.notifyUnreadMessages()后,云控后台会自动刷新显示; - 支持批量设备同步,适合群控与多任务监控场景。
 
 - 调用 
 
相关 API
$cloud.message(message)
发送一条普通文本消息到云控后台。
$cloud.message(message, type)
发送带类型的消息到云控后台,用于区分消息等级与日志类型。
参数说明:
| 参数 | 类型 | 说明 | 
|---|---|---|
message | string | 要发送的消息内容 | 
type | string | 消息类型(可选) | 
可选类型:
"verbose"— 普通消息;"info"— 一般消息;"warn"— 警告消息;"error"— 错误消息;"log"— 普通消息
示例:
说明
💡
$cloud.message()与$cloud.notifyUnreadMessages()均为云控通信接口,封装了设备端消息上报逻辑。 它们会自动将消息内容通过 WebSocket / P2P 通道转发至云控后台,实现群控投屏端的实时消息同步展示。