Xiaomi Vacuum Map Card与Roborock S7的重复清洁功能配置指南

问题背景

在使用Xiaomi Vacuum Map Card控制Roborock S7扫地机器人时，用户发现通过send_command平台调用清洁房间功能时，重复清洁次数设置无效。虽然选择了2-3次重复清洁，但机器人始终只执行一次清洁。

技术分析

Roborock S7通过官方集成接入Home Assistant后，其清洁指令需要特定的参数格式才能正常工作。默认的send_command平台配置无法正确处理重复清洁参数，导致功能失效。

解决方案

要实现房间重复清洁功能，需要在Xiaomi Vacuum Map Card配置中手动指定服务调用模式。以下是关键配置要点：

1. 在map_modes部分使用vacuum_clean_segment模板
2. 设置repeats_type为EXTERNAL以启用外部重复控制
3. 定义max_repeats参数限制最大重复次数
4. 最重要的是配置service_call_schema，明确指定服务调用参数

完整配置示例

map_modes:
  - template: vacuum_clean_segment
    repeats_type: EXTERNAL
    max_repeats: 3
    service_call_schema:
      service: vacuum.send_command
      service_data:
        command: app_segment_clean
        params:
          - segments: '[[selection]]'
            repeat: '[[repeats]]'
      target:
        entity_id: '[[entity_id]]'
    predefined_selections:
      - id: 16

配置说明

1. service_call_schema：定义了实际调用的服务及其参数格式
2. app_segment_clean：Roborock特定的清洁命令
3. segments参数：使用[[selection]]模板变量动态插入选择的房间ID
4. repeat参数：使用[[repeats]]模板变量动态插入用户选择的重复次数

注意事项

1. 此配置方案专为Roborock S7设计，其他型号可能需要调整参数
2. 确保predefined_selections中的房间ID与机器人地图中的实际ID一致
3. 未来版本可能会原生支持Roborock集成，届时可能不再需要此手动配置

通过以上配置，用户可以完美实现Roborock S7的房间重复清洁功能，提升清洁效果和使用体验。