Xiaomi Vacuum Map Card 在 Home Assistant 2024.7+ 版本中的房间配置问题解析

问题背景

Xiaomi Vacuum Map Card 是 Home Assistant 中一款广受欢迎的扫地机器人地图可视化插件。近期在 Home Assistant 2024.7.0 及以上版本中，用户报告了一个关键功能失效的问题：点击"Generate Rooms Config"(生成房间配置)按钮无响应，同时地图选择区域功能也无法正常工作。

问题表现

受影响用户主要观察到以下现象：

1. 点击生成房间配置按钮后无任何反应
2. 在地图上添加点后，选择区域值保持为空数组([])
3. 部分用户还报告了"Invalid calibration"(无效校准)的警告提示

影响范围

该问题主要影响以下设备：

• Dreame D10 Plus/D10s Pro/L20 Ultra 系列
• Roborock S5/S7/Q5 Max+ 系列
• 使用 Tasshack/dreame-vacuum 或 Hypfer/Valetudo 集成的设备

技术原因分析

经过开发者调查，确认问题源于 Home Assistant 2024.7.0 版本对前端架构的改动。这些改动并非bug，而是HA前端的正常演进，但导致了地图卡片的部分功能兼容性问题。

具体来说，新版本中：

1. 前端事件处理机制发生了变化
2. 组件间通信方式有所调整
3. 某些DOM操作API的行为发生了改变

解决方案

临时解决方案

对于Dreame设备用户，可以使用以下手动配置模板作为临时解决方案：

# 示例配置模板
type: custom:xiaomi-vacuum-map-card
entity: vacuum.your_vacuum
vacuum_platform: Tasshack/dreame-vacuum
map_source:
  camera: camera.your_map_camera
calibration_source:
  camera: true
# 添加手动配置的房间信息
rooms:
  - id: 1
    outline: [[650,-10450],[1750,-1650]]
    name: Corridor
    icon: mdi:foot-print
  - id: 2 
    outline: [[850,1450],[4350,3050]]
    name: Entrance
    icon: mdi:home-outline

永久修复

开发者已在 Xiaomi Vacuum Map Card v2.2.3 版本中修复了此问题，主要变更包括：

1. 更新了前端事件监听机制
2. 调整了与新版HA前端的兼容性处理
3. 优化了房间配置生成逻辑

对于使用实验性Sections Dashboard的用户，建议升级至v2.2.4或更高版本以获得完整支持。

最佳实践建议

1. 版本兼容性：保持插件与Home Assistant版本的同步更新
2. 配置备份：在升级前备份现有配置
3. 测试环境：建议在测试实例中验证新版本功能
4. 错误排查：如遇问题，检查浏览器控制台是否有错误日志

总结

Home Assistant生态系统的持续演进有时会导致第三方插件需要相应调整。Xiaomi Vacuum Map Card的开发团队已迅速响应并解决了2024.7+版本的兼容性问题。用户只需确保使用v2.2.3及以上版本即可恢复正常功能。对于需要立即使用的用户，手动配置模板提供了有效的临时解决方案。

建议用户定期关注插件更新，以获得最佳使用体验和最新功能支持。