Skip to content

地图支持 ​

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

实时地图实时地图
  • 高分辨率图像渲染,带有图层缓存以提高性能。
  • 所有图标位置和颜色索引查找算法均独立逆向工程,以匹配官方应用的外观和感觉。
  • 所有地图操作在发送到设备之前均在内存中处理,以实现低延迟更新。
  • 功能齐全、高度优化的集成地图管理器,用于地图编辑和处理部分地图。
  • 动态刷新率由地图类型、设备状态和最后访问时间决定。

如何从仪表板查看地图并控制设备

高刷新率、低延迟 ​

该集成具有先进的地图解码功能,可提供高刷新率和低延迟,其性能与官方应用程序紧密匹配。它能够无缝处理传入的数据流,以支持大多数设备上常见的三秒刷新率,以及2026年及更新型号引入的更快的一秒刷新率。

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

地图解码复杂性

现代设备传输部分地图更新(P帧),这些帧仅包含相对于前一帧的增量差异。解码这些差异帧是一个高度复杂的过程,但这是实现实时更新所必需的。通过独立处理该逻辑,该集成避免了持续请求完整地图时的巨大开销和任意时间限制。

颜色方案 ​

该集成提供多种内置配色方案,允许用户自定义实时地图和已保存地图的视觉风格,以最适合他们的仪表板设计。

Dreame 亮色配色方案Dreame 亮色配色方案
Dreame 浅色
Dreame 暗色配色方案Dreame 暗色配色方案
Dreame 深色
Mijia 亮色配色方案Mijia 亮色配色方案
米家浅色
Mijia 暗色配色方案Mijia 暗色配色方案
米家深色
灰度配色方案灰度配色方案
灰度模式

可以随时通过 色彩方案 配置选项更改特定设备的当前配色方案。

房间和自定义清洁图标 ​

地图渲染器动态生成并叠加一套完整的房间特定图标、标签和徽章,以实时反映设备当前的自定义清洁设置。这些动态渲染的元素包括:

房间和自定义清洁图标房间和自定义清洁图标房间和自定义清洁图标
  • 房间颜色
  • 房间图标
  • 房间名称
  • 房间名称背景
  • 房间顺序
  • 房间吸力等级
  • 房间水量
  • 房间清洁次数
  • 房间清洁模式
  • 房间拖地模式

任何这些特定房间的元素都可以通过 隐藏的地图对象 配置选项在生成的地图中随时选择性隐藏。

作业类型的动态对象渲染 ​

地图上显示的视觉元素,包括房间颜色、活动图标和其他对象,会根据机器人的当前作业类型(例如房间清洁与区域清洁)动态变化,以准确反映当前任务。

房间清洁渲染房间清洁渲染房间清洁渲染
区域清洁渲染区域清洁渲染区域清洁渲染

快速建图和局部清洁 ​

集成系统可以实时解析和渲染未保存的临时地图。这包括在 快速建图 操作或 局部清洁 任务中动态绘制的地图,这些任务是通过机器人上的物理按钮直接启动的。

临时地图处理

当机器人进行快速建图或局部清扫时,它会在内存中创建一个新的临时地图,并且不会响应本地 map_request API 操作。由于这些新创建的地图尚未命名对象,因此只能通过云端 map_data 属性访问。新地图数据需要完全不同的解码和渲染规则,使该集成能够独特地处理此类地图数据。

快速建图快速建图快速建图
定点清洁中定点清洁中定点清洁中

当一次建图任务完成,但设备已达到可保存地图的最大限制时,机器人会暂停并等待您决定是覆盖现有地图还是丢弃新生成的地图。该集成提供了一个专门的 通知 来提醒您发现了临时地图并等待操作。

机器人状态 ​

清扫图标覆盖以显示设备状态,与官方 App 的惯例相匹配。

休眠中
待机中
运作中
充电中
错误
休眠中休眠中
待机中待机中
运作中运作中
充电中充电中
错误错误

提示

警告可以通过通知或 clear_warning 服务清除,以在地图上恢复机器人状态。

房间实体 ​

动态房间实体动态房间实体动态房间实体

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

有关房间实体的更多信息