Skip to content

地圖支援 ​

完全逆向工程地重新設計了地圖數據處理、解碼和渲染,以支持即時和多個已保存的地圖,並提供官方應用程序的所有功能。

即時地圖即時地圖
  • 高解析度影像渲染,配合圖層快取以提升效能。
  • 所有圖示位置和顏色索引尋找演算法均獨立逆向工程,以匹配官方應用程序的外觀和操作感。
  • 所有地圖操作皆在記憶體中處理,然後才傳送至設備,以實現低延遲更新。
  • 完全功能且高度優化的整合地圖管理器,用於地圖編輯和部分地圖處理。
  • 依據地圖類型、設備狀態和最後存取時間動態決定刷新率。

如何從儀表板查看地圖並控制設備

高刷新率與低延遲 ​

該整合功能具備先進的地圖解碼能力,能以低延遲提供高刷新率,性能與官方應用程序非常接近。它可無縫處理傳入的數據流,以支援大多數設備上的標準三秒刷新率,以及從 2026 年及更新型號引入的更快一秒刷新率。

刷新率清理刷新率清理刷新率清理

地圖解碼複雜度

現代設備傳輸部分地圖更新(P 幀),這些幀僅包含相較於前一幀的增量差異。解碼這些差異幀是一個高度複雜的過程,但對於實現實時更新是必要的。透過獨立處理這個邏輯,該整合避免了持續請求完整地圖所帶來的高額開銷和任意時間限制。

配色方案 ​

該整合提供多種內建的配色方案,允許用戶自訂即時和已儲存地圖的視覺風格,以最適合其儀表板設計。

Dreame 明亮配色方案Dreame 明亮配色方案
Dreame 淺色
Dreame 深色配色方案Dreame 深色配色方案
Dreame 深色
Mijia 明亮配色方案Mijia 明亮配色方案
米家淺色
Mijia 深色配色方案Mijia 深色配色方案
米家深色
灰階配色方案灰階配色方案
灰度模式

特定設備的啟用配色方案可隨時從 色彩方案 設定選項中更改。

房間及自訂清掃圖示 ​

地圖渲染器會動態生成並疊加完整的房間專屬圖示、標籤和徽章,以即時反映設備當前的自訂清掃設定。這些動態渲染的元素包括:

房間及自訂清掃圖示房間及自訂清掃圖示房間及自訂清掃圖示
  • 房間顏色
  • 房間圖示
  • 房間名稱
  • 房間名稱背景
  • 房間順序
  • 房間吸力等級
  • 房間水量
  • 房間清掃次數
  • 房間清掃模式
  • 房間拖地模式

任何這些針對特定房間的元素都可以通過 隱藏的地圖物件 配置選項隨時選擇性地從生成的地圖中隱藏。

作業類型的動態物件呈現 ​

地圖上顯示的視覺元素,包括房間顏色、活動圖標及其他物件,會根據機器人的當前作業類型(例如房間清潔與區域清潔)動態變化,以準確反映正在執行的任務。

房間清潔呈現房間清潔呈現房間清潔呈現
區域清潔呈現區域清潔呈現區域清潔呈現

快速地圖繪製與定點清潔 ​

該整合功能可以即時解析並呈現未儲存的臨時地圖。這包括在 快速地圖繪製 操作或 定點清潔 任務中,透過機器人實體按鈕直接啟動時動態繪製的地圖。

臨時地圖處理

當機器人在快速建圖或區域清掃時,它會在記憶體中建立一個新的臨時地圖,並且不會回應本地 map_request API 操作。由於這些新建立的地圖尚未有物件名稱,因此只能透過雲端 map_data 屬性存取。新的地圖資料需要完全不同的解碼和渲染規則,使得此整合能夠獨特地處理這種類型的地圖資料。

快速建圖快速建圖快速建圖
定點清潔中定點清潔中定點清潔中

當建圖任務完成,但設備已達到最大保存地圖限制時,機器人將暫停,等待您決定是否覆蓋現有地圖或捨棄新生成的地圖。此整合提供專用的 通知 來提醒您當發現臨時地圖並等待操作時。

機器人狀態 ​

吸塵器圖示覆蓋用於顯示設備狀態,符合官方 App 的慣例。

休眠中
待機
運行中
充電中
錯誤
休眠中休眠中
待機待機
運行中運行中
充電中充電中
錯誤錯誤

提示

警告可以透過通知或 clear_warning 服務清除,以恢復地圖上的機器人狀態。

房間實體 ​

動態房間實體動態房間實體動態房間實體

該整合會公開動態房間實體,用於管理房間的所有可自訂屬性,例如名稱、地板材質以及自訂清潔設定。這些實體是從已保存的地圖動態生成的,當所選地圖變更時會自動更新。

有關房間實體的更多資訊