未讀訊息與訊息通知
 更新: 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 通道轉發至雲控後台,實現群控投屏端的即時訊息同步展示。