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


- 高解析度影像渲染,配合圖層快取以提升效能。
- 所有圖示位置和顏色索引尋找演算法均獨立逆向工程,以匹配官方應用程序的外觀和操作感。
- 所有地圖操作皆在記憶體中處理,然後才傳送至設備,以實現低延遲更新。
- 完全功能且高度優化的整合地圖管理器,用於地圖編輯和部分地圖處理。
- 依據地圖類型、設備狀態和最後存取時間動態決定刷新率。
高刷新率與低延遲
該整合功能具備先進的地圖解碼能力,能以低延遲提供高刷新率,性能與官方應用程序非常接近。它可無縫處理傳入的數據流,以支援大多數設備上的標準三秒刷新率,以及從 2026 年及更新型號引入的更快一秒刷新率。


地圖解碼複雜度
現代設備傳輸部分地圖更新(P 幀),這些幀僅包含相較於前一幀的增量差異。解碼這些差異幀是一個高度複雜的過程,但對於實現實時更新是必要的。透過獨立處理這個邏輯,該整合避免了持續請求完整地圖所帶來的高額開銷和任意時間限制。
配色方案
該整合提供多種內建的配色方案,允許用戶自訂即時和已儲存地圖的視覺風格,以最適合其儀表板設計。


Dreame 淺色


Dreame 深色


米家淺色


米家深色


灰度模式
特定設備的啟用配色方案可隨時從 色彩方案 設定選項中更改。
房間及自訂清掃圖示
地圖渲染器會動態生成並疊加完整的房間專屬圖示、標籤和徽章,以即時反映設備當前的自訂清掃設定。這些動態渲染的元素包括:
- 房間顏色
- 房間圖示
- 房間名稱
- 房間名稱背景
- 房間順序
- 房間吸力等級
- 房間水量
- 房間清掃次數
- 房間清掃模式
- 房間拖地模式
任何這些針對特定房間的元素都可以通過 隱藏的地圖物件 配置選項隨時選擇性地從生成的地圖中隱藏。
作業類型的動態物件呈現
地圖上顯示的視覺元素,包括房間顏色、活動圖標及其他物件,會根據機器人的當前作業類型(例如房間清潔與區域清潔)動態變化,以準確反映正在執行的任務。




快速地圖繪製與定點清潔
該整合功能可以即時解析並呈現未儲存的臨時地圖。這包括在 快速地圖繪製 操作或 定點清潔 任務中,透過機器人實體按鈕直接啟動時動態繪製的地圖。
臨時地圖處理
當機器人在快速建圖或區域清掃時,它會在記憶體中建立一個新的臨時地圖,並且不會回應本地 map_request API 操作。由於這些新建立的地圖尚未有物件名稱,因此只能透過雲端 map_data 屬性存取。新的地圖資料需要完全不同的解碼和渲染規則,使得此整合能夠獨特地處理這種類型的地圖資料。




當建圖任務完成,但設備已達到最大保存地圖限制時,機器人將暫停,等待您決定是否覆蓋現有地圖或捨棄新生成的地圖。此整合提供專用的 通知 來提醒您當發現臨時地圖並等待操作時。
機器人狀態
吸塵器圖示覆蓋用於顯示設備狀態,符合官方 App 的慣例。
休眠中 | 待機 | 運行中 | 充電中 | 錯誤 |
|---|---|---|---|---|
![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() |
提示
警告可以透過通知或 clear_warning 服務清除,以恢復地圖上的機器人狀態。
房間實體


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




