Xiaomi Vacuum Map Card 多楼层支持功能解析

项目背景

Xiaomi Vacuum Map Card 是 Home Assistant 平台上一款功能强大的扫地机器人地图卡片插件，它能够直观展示扫地机器人的工作状态和清扫路径。随着用户家庭环境的复杂化，多楼层支持成为了该插件的重要功能需求。

多楼层功能实现原理

该插件通过集成 Xiaomi Cloud Map Extractor 组件，实现了对扫地机器人多楼层地图的支持。核心机制包括：

1. 楼层切换控制：插件通过调用 select.select_option 服务来切换当前活动楼层
2. 动态图标菜单：利用 append_icons 配置项添加楼层选择菜单
3. 地图数据同步：实时获取不同楼层的地图数据并渲染显示

配置方法详解

要实现多楼层支持功能，用户需要在卡片配置中添加以下关键配置项：

append_icons: true
icons:
  - type: "menu"
    menu_id: "selected_map"
    icon_id: "selected_map"
    entity: "select.rosie_selected_map"  # 替换为实际的楼层选择实体
    available_values_attribute: "options"
    icon: "mdi:map"
    tap_action:
        action: "call-service"
        service: "select.select_option"
        service_data:
            option: "[[value]]"
            entity_id: "[[entity_id]]"

技术要点说明

1. 实体集成：配置中需要指定正确的楼层选择实体，该实体通常由扫地机器人集成提供
2. 动态菜单：available_values_attribute 参数会自动获取可用的楼层选项
3. 服务调用：点击菜单项时会调用 select.select_option 服务切换楼层
4. 图标自定义：用户可以根据喜好更改 mdi:map 为其他 Material Design 图标

常见问题解决方案

1. 楼层切换不响应：检查机器人是否处于待机状态，部分型号需要唤醒后才能切换
2. 地图不更新：确认 Xiaomi Cloud Map Extractor 组件版本是否为最新
3. 选项不显示：验证 available_values_attribute 是否正确指向包含选项列表的属性

最佳实践建议

1. 为每个楼层创建独立的清扫预设，便于快速调用
2. 定期备份地图数据，防止意外丢失
3. 考虑使用自动化脚本实现基于位置或时间的自动楼层切换

总结

Xiaomi Vacuum Map Card 的多楼层支持功能通过灵活的配置和清晰的界面设计，大大简化了多楼层家庭环境下的扫地机器人管理。合理利用这一功能可以显著提升智能家居的使用体验。