Xiaomi Vacuum Map Card 自定义区域清洁问题分析与解决

问题描述

在使用 Xiaomi Vacuum Map Card 地图卡片时，用户遇到了自定义区域清洁功能失效的问题。具体表现为：

1. 无法通过卡片命令机器人清洁预定义的自定义区域
2. 即时绘制的自定义清洁区域也无法工作
3. 系统仅返回"SUCCESS"消息但机器人无实际动作
4. 全屋清洁功能正常可用

环境配置

• 设备型号：Viomi V6 Valetudo 机器人
• 集成方式：通过 MQTT 协议连接
• Home Assistant 版本：2024.10.4
• 卡片版本：2.2.4

根本原因分析

经过技术排查，发现问题的核心在于卡片配置中缺少必要的 MQTT 主题(topic)参数。Valetudo 集成需要通过 MQTT 主题来与机器人通信，而卡片配置中未指定这一关键参数，导致清洁指令无法正确传递。

解决方案

要解决此问题，需要在卡片配置中添加 MQTT 主题参数。具体修改如下：

1. 在 map_modes 部分的 vacuum_clean_segment 模板下添加 variables 配置
2. 指定机器人对应的 MQTT 主题路径

示例配置片段：

map_modes:
  - template: vacuum_clean_segment
    variables:
      topic: valetudo/机器人名称

配置建议

对于 Valetudo 集成的用户，建议注意以下几点：

1. 确保 MQTT 服务正常运行
2. 确认机器人名称与 MQTT 主题匹配
3. 检查 Valetudo 配置中的 MQTT 设置
4. 完整的配置应包含服务调用模式定义

常见问题排查

如果按照上述方法修改后问题仍然存在，可以检查：

1. MQTT 服务是否正常运行
2. 机器人是否在线并能接收其他指令
3. Home Assistant 日志中是否有相关错误信息
4. Valetudo 日志中是否收到清洁指令

总结

Xiaomi Vacuum Map Card 是一个功能强大的可视化控制工具，但在与 Valetudo 集成时需要特别注意 MQTT 通信参数的配置。正确设置主题路径后，自定义区域清洁功能将能正常工作，为用户提供更灵活的清洁控制体验。