地图支持
完全逆向工程的地图数据处理、解码和渲染,支持实时和多个已保存地图,并提供官方应用的所有功能。


- 高分辨率图像渲染,带有图层缓存以提高性能。
- 所有图标位置和颜色索引查找算法均独立逆向工程,以匹配官方应用的外观和感觉。
- 所有地图操作在发送到设备之前均在内存中处理,以实现低延迟更新。
- 功能齐全、高度优化的集成地图管理器,用于地图编辑和处理部分地图。
- 动态刷新率由地图类型、设备状态和最后访问时间决定。
高刷新率、低延迟
该集成具有先进的地图解码功能,可提供高刷新率和低延迟,其性能与官方应用程序紧密匹配。它能够无缝处理传入的数据流,以支持大多数设备上常见的三秒刷新率,以及2026年及更新型号引入的更快的一秒刷新率。


地图解码复杂性
现代设备传输部分地图更新(P帧),这些帧仅包含相对于前一帧的增量差异。解码这些差异帧是一个高度复杂的过程,但这是实现实时更新所必需的。通过独立处理该逻辑,该集成避免了持续请求完整地图时的巨大开销和任意时间限制。
颜色方案
该集成提供多种内置配色方案,允许用户自定义实时地图和已保存地图的视觉风格,以最适合他们的仪表板设计。


Dreame 浅色


Dreame 深色


米家浅色


米家深色


灰度模式
可以随时通过 色彩方案 配置选项更改特定设备的当前配色方案。
房间和自定义清洁图标
地图渲染器动态生成并叠加一套完整的房间特定图标、标签和徽章,以实时反映设备当前的自定义清洁设置。这些动态渲染的元素包括:
- 房间颜色
- 房间图标
- 房间名称
- 房间名称背景
- 房间顺序
- 房间吸力等级
- 房间水量
- 房间清洁次数
- 房间清洁模式
- 房间拖地模式
任何这些特定房间的元素都可以通过 隐藏的地图对象 配置选项在生成的地图中随时选择性隐藏。
作业类型的动态对象渲染
地图上显示的视觉元素,包括房间颜色、活动图标和其他对象,会根据机器人的当前作业类型(例如房间清洁与区域清洁)动态变化,以准确反映当前任务。




快速建图和局部清洁
集成系统可以实时解析和渲染未保存的临时地图。这包括在 快速建图 操作或 局部清洁 任务中动态绘制的地图,这些任务是通过机器人上的物理按钮直接启动的。
临时地图处理
当机器人进行快速建图或局部清扫时,它会在内存中创建一个新的临时地图,并且不会响应本地 map_request API 操作。由于这些新创建的地图尚未命名对象,因此只能通过云端 map_data 属性访问。新地图数据需要完全不同的解码和渲染规则,使该集成能够独特地处理此类地图数据。




当一次建图任务完成,但设备已达到可保存地图的最大限制时,机器人会暂停并等待您决定是覆盖现有地图还是丢弃新生成的地图。该集成提供了一个专门的 通知 来提醒您发现了临时地图并等待操作。
机器人状态
清扫图标覆盖以显示设备状态,与官方 App 的惯例相匹配。
休眠中 | 待机中 | 运作中 | 充电中 | 错误 |
|---|---|---|---|---|
![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() |
提示
警告可以通过通知或 clear_warning 服务清除,以在地图上恢复机器人状态。
房间实体


该集成公开了用于管理房间所有可自定义属性的动态房间实体,例如房间名称、地板材料以及自定义清洁设置。这些实体是从已保存的地图动态生成的,并在所选地图更改时自动更新。




