未讀訊息與訊息通知

更新: 2025/10/10
閱讀時間: 5 分鐘
使用 $cloud 模組向雲控後台即時推送裝置未讀訊息、任務進度及執行狀態,實現群控投屏端動態展示。

功能概述

$cloud.notifyUnreadMessages() 用於通知雲控後台更新目前裝置的 未讀訊息數 或其他關鍵狀態。
腳本可從本地 SQLite 資料庫讀取統計數據(如訊息數量、待辦任務等),並即時同步至雲控後台,實現投屏介面動態展示。


適用場景

  • 顯示裝置端的 未讀訊息數量
  • 同步腳本執行狀態或任務進度;
  • 向後台推送自訂日誌、提示或警告資訊。

實現邏輯

  1. 裝置端 SQLite 資料更新
    • 未讀訊息資料儲存在裝置本地 SQLite;
    • 腳本可透過 SQLite API 即時更新或查詢相關表。
  2. 呼叫通知介面
    • 呼叫 $cloud.notifyUnreadMessages() 後,雲控後台會自動重新整理顯示;
    • 支援批量裝置同步,適合群控與多任務監控場景。

相關 API

$cloud.message(message)

發送一條普通文字訊息到雲控後台。

$cloud.message(message, type)

發送帶類型的訊息到雲控後台,用於區分訊息等級與日誌類型。

參數說明:

參數類型說明
messagestring要發送的訊息內容
typestring訊息類型(可選)

可選類型:

  • "verbose" — 普通訊息;
  • "info" — 一般訊息;
  • "warn" — 警告訊息;
  • "error" — 錯誤訊息;
  • "log" — 普通訊息

範例:


說明

💡 $cloud.message()$cloud.notifyUnreadMessages() 均為雲控通訊介面,封裝了裝置端訊息上報邏輯。 它們會自動將訊息內容透過 WebSocket / P2P 通道轉發至雲控後台,實現群控投屏端的即時訊息同步展示。