Xiaomi Vacuum Map Card 中 vacuum_clean_segment 服务调用问题解析

问题背景

在 Xiaomi Vacuum Map Card 项目中，用户在使用默认的 xiaomiMiio 平台模板时发现了一个服务调用不一致的问题。根据项目文档，清洁特定房间区域应该使用 xiaomi_miio.vacuum_clean_segment 服务，但实际生成的却是 vacuum.send_command 服务调用。

技术分析

预期行为与实际情况

按照项目文档描述，清洁特定房间区域的服务调用应该是这样的结构：

service: xiaomi_miio.vacuum_clean_segment
service_data:
  entity_id: vacuum.roborock_vacuum_m1s
  segments:
    - 17

但实际生成的却是：

service: vacuum.send_command
service_data:
  command: app_segment_clean
  entity_id: vacuum.roborock_vacuum_m1s
  params:
    - segments: [17]
      repeat: 1

问题根源

经过调查发现，这是项目开发者有意为之的变通方案，目的是为了解决 Home Assistant 中的一个已知问题。然而，这个变通方案并不适用于所有型号的扫地机器人，特别是 Roborock M1S 型号。

解决方案

临时解决方案

对于遇到此问题的用户，可以通过以下两种方式解决：

1. 完全自定义模式配置：

- name: Rooms
  icon: mdi:floor-plan
  run_immediately: false
  coordinates_rounding: true
  coordinates_to_meters_divider: 1000
  selection_type: ROOM
  id_type: number
  max_selections: 999
  repeats_type: REPEAT
  max_repeats: 3
  service_call_schema:
    service: xiaomi_miio.vacuum_clean_segment
    service_data:
      segments: "[[selection]]"
      entity_id: "[[entity_id]]"
  predefined_selections:
    - id: 17
      # 其他配置...

2. 模板覆盖方案（更简洁）：

- template: vacuum_clean_segment
  service_call_schema:
    service: xiaomi_miio.vacuum_clean_segment
    service_data:
      segments: "[[selection]]"
      entity_id: "[[entity_id]]"
  predefined_selections:
    - id: 17
    # 其他配置...

技术细节说明

1. [[selection]] 是模板变量，会自动替换为用户选择的房间ID
2. [[entity_id]] 会自动替换为扫地机器人的实体ID
3. 第二种方案利用了模板继承机制，只覆盖了服务调用部分，保留了模板的其他功能

注意事项

1. 重复清洁次数(repeat)参数在直接使用 xiaomi_miio.vacuum_clean_segment 服务时可能需要通过其他方式实现
2. 不同型号的扫地机器人可能对服务调用的响应不同，建议先测试
3. 如果未来 Home Assistant 修复了相关问题，建议回退到标准模板以获得更好的兼容性

总结

这个问题展示了在智能家居自动化中服务调用兼容性的重要性。通过理解底层服务调用机制，用户可以灵活地调整配置以适应不同设备和场景需求。对于开发者来说，这也提示了在文档中明确说明变通方案的必要性，以及提供灵活的配置覆盖机制的价值。