Xiaomi Vacuum Map Card 中 Dreame 吸尘器按房间清洁功能失效问题分析

问题现象

在使用 Xiaomi Vacuum Map Card 项目时，部分 Dreame 型号吸尘器（如 dreame.vacuum.r2228o）出现了按房间清洁功能失效的情况。具体表现为：当用户通过地图界面选择特定房间进行清洁时，吸尘器会错误地执行全屋清洁，而不是仅清洁选定的房间。

技术背景

Xiaomi Vacuum Map Card 是一个用于 Home Assistant 的 Lovelace 卡片，它提供了可视化地图界面来控制小米/石头/追觅等品牌的扫地机器人。该卡片支持多种清洁模式，包括区域清洁、点清洁和房间清洁。

问题排查

1. 服务调用验证：通过开发者工具直接调用 dreame_vacuum.vacuum_clean_segment 服务，确认底层API功能正常，能够正确清洁单个房间。

2. 配置检查：用户配置中已正确定义了房间ID和轮廓信息，且房间ID已从字符串类型改为整数类型。

3. 服务调用对比：卡片生成的服务调用与手动调用的服务数据结构完全一致，排除了数据格式问题。

问题原因

经过深入分析，发现该问题并非真正的功能失效，而是用户界面操作上的误解。卡片界面提供了两个不同的"播放"按钮：

1. 全局播放按钮：位于卡片顶部，用于启动全屋清洁
2. 房间播放按钮：位于每个房间选择区域，用于启动特定房间清洁

用户错误地点击了顶部的全局播放按钮，而非房间特定的播放按钮，导致系统执行了全屋清洁而非房间清洁。

解决方案

1. 正确操作方式：在需要清洁特定房间时，应点击房间区域内的播放按钮，而非卡片顶部的全局播放按钮。

2. 界面优化建议：可以考虑以下改进措施帮助用户区分：

   • 为不同类型的播放按钮使用不同的颜色或图标
   • 添加操作提示文字说明
   • 在用户点击全局播放按钮时增加确认对话框

技术总结

该案例展示了智能家居系统中用户界面设计的重要性。即使底层API功能完全正常，不直观的UI设计也可能导致用户操作错误。对于开发者而言，在设计类似功能时应当考虑：

1. 操作元素的视觉区分度
2. 关键操作的确认机制
3. 用户引导提示的充分性

对于终端用户，建议在使用新功能时仔细阅读文档，并注意界面上的细节差异，以避免类似的操作误解。