Xiaomi Vacuum Map Card 清洁模式与水位的深度解析

项目背景

Xiaomi Vacuum Map Card 是一款为 Home Assistant 设计的 Lovelace 卡片插件，主要用于可视化控制小米/石头等品牌的扫地机器人。该卡片提供了地图显示、区域清洁、定点清洁等丰富功能，是智能家居中管理扫地机器人的重要工具。

功能需求分析

在实际使用中，用户发现卡片缺少对清洁模式和水位控制的直接支持。现代扫地机器人（特别是带有拖地功能的型号）通常提供多种清洁模式选择和水位调节功能，这些功能对清洁效果有直接影响。

现有解决方案

目前用户主要通过两种方式实现这些功能：

1. 独立实体显示：在卡片外单独显示清洁模式和水位控制实体
2. 自定义Tile集成：利用卡片的自定义Tile功能添加控制选项

技术实现方案

自定义Tile实现

通过YAML配置可以添加清洁模式控制Tile：

tile_id: cleaning_mode
entity: vacuum.xiaomi_x20
label: 清洁模式
attribute: cleaning_mode
icon: mdi:broom
tap_action:
    action: call-service
    service: select.select_next
    service_data:
        entity_id: select.xiaomi_x20_cleaning_mode
translations:
    sweeping: 扫地
    mopping: 拖地
    sweeping and mopping: 扫拖同时
    mopping after sweeping: 先扫后拖

菜单图标实现

更优雅的解决方案是使用菜单图标，可以创建类似风扇速度控制的交互式菜单：

menu_id: cleaning_mode
icon: mdi:broom
label: 扫地模式
conditions:
  - entity: vacuum.xiaomi_robot_vacuum_x20
    attribute: cleaning_mode
    value: Sweeping
tooltip: 更改清洁模式
tap_action:
  action: call-service
  service: select.select_option
  service_data:
    entity_id: select.xiaomi_robot_vacuum_x20_cleaning_mode
    option: sweeping

水位控制实现

对于拖地水位控制，可以添加类似的菜单项，并设置条件只在拖地模式下显示：

menu_id: mop_pad_humidity
icon: mdi:water-minus
label: 微湿
conditions:
  - entity: vacuum.xiaomi_robot_vacuum_x20
    attribute: mop_pad_humidity
    value: Slightly dry
  - entity: vacuum.xiaomi_robot_vacuum_x20
    attribute: cleaning_mode
    value_not: Sweeping
tooltip: 更改湿度
tap_action:
  action: call-service
  service: select.select_option
  service_data:
    entity_id: select.xiaomi_robot_vacuum_x20_mop_pad_humidity
    option: slightly_dry

技术要点

1. 实体属性映射：需要正确映射机器人实体的属性和服务调用
2. 条件显示：水位控制应根据当前清洁模式动态显示/隐藏
3. 多语言支持：通过translations字段实现界面文本本地化
4. 服务调用：使用select.select_option或select.select_next服务改变模式

最佳实践建议

1. 对于多模式机器人，建议同时实现清洁模式和水位控制
2. 图标选择应符合功能语义（如mdi:broom代表扫地，mdi:water代表拖地）
3. 添加适当的tooltip提升用户体验
4. 考虑添加状态反馈，如当前模式的视觉指示

未来展望

虽然当前版本需要通过自定义配置实现这些功能，但考虑到带拖地功能的机器人越来越普及，未来版本可能会原生集成这些控制选项，提供更统一的使用体验。

通过以上方案，用户可以充分利用Xiaomi Vacuum Map Card的功能，实现对扫地机器人更精细化的控制，提升智能家居的自动化水平。