吸尘器服务

该集成暴露了各种自定义服务，用于执行高级操作和功能，这些操作和功能无法通过标准实体直接控制。这些自定义服务使用 vacuum 域，并提供对特定设备功能的精细控制。

清洁房间

dreame_vacuum.vacuum_clean_segment

使用可选的自定义清洁参数开始清洁所选房间。

注意

• 如果您使用带有地图功能的集成，可以从吸尘器实体属性中获取分段ID。
• 当启用 customized_cleaning 或 cleaning_sequence 时，设备会忽略清洁参数和清洁顺序。

设置清洁模式

该服务不接受 cleaning_mode 参数。要在开始清洁前动态设置模式，请参见 常见问题。

示例

• 清洁房间3

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments: 3
  target:
    entity_id: vacuum.vacuum

• 清洁房间3和5

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
  target:
    entity_id: vacuum.vacuum

• 清洁房间3和5两次

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• 清洁房间2两次，房间5一次

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 
      - 2
      - 1
  target:
    entity_id: vacuum.vacuum

• 清洁房间3和5，风速设置为高

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: "high"
  target:
    entity_id: vacuum.vacuum

• 清洁房间3风速为高，房间5风速为安静

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: 
      - "high"
      - "quiet"
  target:
    entity_id: vacuum.vacuum

区域清洁

dreame_vacuum.vacuum_clean_zone

开始选定区域清扫，可选自定义清扫参数。

提示

您可以使用小米扫地机器人地图卡获取区域坐标。

设置清扫模式: 本服务不接受 cleaning_mode 参数。要在开始清扫前动态设置模式，请参见常见问题。

示例

• 清扫选定区域

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
  target:
    entity_id: vacuum.vacuum

• 清扫多个区域

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• 选定区域清扫两次

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• 第一区域清扫两次，第二区域清扫三次

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

定点清洁

dreame_vacuum.vacuum_clean_spot

开始选定点清扫，可选自定义清扫参数。

注意

点清扫功能仅适用于小米/米家品牌机器人，但也适用于追觅设备。

提示

您可以使用小米扫地机器人地图卡获取点坐标。

设置清扫模式: 本服务不接受 cleaning_mode 参数。要在开始清扫前动态设置模式，请参见常见问题。

示例

• 清扫选定点

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
  target:
    entity_id: vacuum.vacuum

• 清扫多个点

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
  target:
    entity_id: vacuum.vacuum

• 选定点清扫两次

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• 第一点清扫两次，第二点清扫三次

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

指哪到哪

dreame_vacuum.vacuum_goto

将机器人发送到地图上的单个坐标并在那里停止。

注意

• 在具有巡航功能的设备（带有激光雷达导航和摄像头流功能的吸尘器）上，这会启动一个巡航到点的任务，当机器人到达目标点时会在周围拍照。该任务会保存在巡航历史中。 （更多关于巡航历史地图的信息）
• 在其他设备上，相同行为通过在指定点周围的小区域清洁任务来模拟。该任务的吸力设置为静音且扫地功能被禁用，当机器人到达该点时，集成系统会停止机器人并恢复之前的清洁设置。
• 电池电量必须至少为15%，且坐标必须位于当前地图内。
• 当机器人已停在所选坐标、充电座正在排放或充电座在自我修复/测试时，设备不会响应此操作。

提示

您可以使用小米扫地机器人地图卡获取点坐标。

示例

• 前往 [819, -2235] 并停止

  service: dreame_vacuum.vacuum_goto
  data:
    x: 819
    y: -2235
  target:
    entity_id: vacuum.vacuum

跟随路径 实验性

dreame_vacuum.vacuum_follow_path

启动一个巡航路径任务，依次访问给定坐标并返回到充电座。

警告

该设备仅在实时摄像头流活动时，才能执行跟随路径任务。与 指哪到哪 不同，此服务与摄像头绑定，必须在调用前从官方 App 打开摄像头。否则，机器人会完全忽略请求，什么也不做。

注意

• 此服务仅适用于具有巡航功能的设备（带激光雷达导航和摄像头流的吸尘器）。
• 仅前 20 个点会发送到设备，且每个坐标必须在当前地图内。
• 当省略 points 时，将使用当前地图中保存的巡航点。启动任务至少需要一个有效或已保存的坐标。
• 电池电量必须至少为 15%，且当设备基座正在放电或自我修复/测试时，设备不会响应此操作。
• 您可以使用小米扫地机器人地图卡获取点坐标。

示例

• 跟随三点路径

  service: dreame_vacuum.vacuum_follow_path
  data:
    points:
      - - 819
        - -263
      - - 2001
        - -3050
      - - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• 跟随当前地图的已保存巡航点

  service: dreame_vacuum.vacuum_follow_path
  target:
    entity_id: vacuum.vacuum

启动快捷方式

dreame_vacuum.vacuum_start_shortcut

启动在官方 App 上创建的快捷任务。

注意

• 快捷方式仅在支持的设备上可用，您可以从吸尘器实体的 shortcuts 属性获取快捷方式 ID。
• 有效的快捷方式 ID 范围是 25 到 128。
• 集成还为设备的每个快捷方式创建一个按钮实体作为 button.{vacuum_name}_shortcut_{shortcut_id}，因此通常不需要使用此服务。
• 当设备在排水或自我修复/测试时，不会响应此操作。

示例

• 启动 ID 为 32 的快捷方式

  service: dreame_vacuum.vacuum_start_shortcut
  data:
    shortcut_id: 32
  target:
    entity_id: vacuum.vacuum

重新命名快捷方式

dreame_vacuum.vacuum_rename_shortcut

为快捷方式设置自定义名称。

注意

• 您可以从吸尘器实体的 shortcuts 属性获取快捷方式 ID。
• 快捷方式名称必须唯一。当新名称已被其他快捷方式使用时，会像官方应用一样在后面添加计数器。（例如：Mopping after sweeping 变为 Mopping after sweeping2）
• 生成的快捷方式按钮实体的名称遵循快捷方式名称。
• 机器人运行时，无法重命名快捷方式。

示例

• 将 ID 为 32 的快捷方式重命名为“扫后拖地”

  service: dreame_vacuum.vacuum_rename_shortcut
  data:
    shortcut_id: 32
    shortcut_name: "Mopping after sweeping"
  target:
    entity_id: vacuum.vacuum

删除捷径

dreame_vacuum.vacuum_delete_shortcut

删除快捷方式。

注意

• 您可以从吸尘器实体的 shortcuts 属性获取快捷方式 ID。
• 已删除快捷方式的按钮实体会自动移除。
• 当快捷方式自身的任务正在运行时，无法删除该快捷方式。
• 已删除的快捷方式无法恢复，只能从官方应用重新创建。

示例

• 删除ID为34的快捷方式

  service: dreame_vacuum.vacuum_delete_shortcut
  data:
    shortcut_id: 34
  target:
    entity_id: vacuum.vacuum

安装语音包

dreame_vacuum.vacuum_install_voice_pack

安装官方语音包。

设置清洁顺序 地图支持

dreame_vacuum.vacuum_set_cleaning_sequence

在当前地图上设置房间清扫顺序。

注意

必须以序列列表形式传入房间ID的确切数量

示例

• 将当前地图上的房间清扫顺序设置为3、5、4、2、1

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: 
        - 3
        - 5
        - 4
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• 禁用当前地图上的自定义清扫顺序

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: []
  target:
      entity_id: vacuum.vacuum

设置自定义清洁 地图支持

dreame_vacuum.vacuum_set_custom_cleaning

在当前地图上设置自定义房间清扫参数。

注意

所有房间的设置必须以列表形式传入

示例

• 将房间1的风速设置为静音，水量设置为低，清扫次数设置为2；房间5的风速设置为强力，水量设置为中，重复次数设置为1

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 1
        - 5
      suction_level: 
        - 0
        - 3
      water_volume: 
        - 1
        - 2
      repeats: 
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• 将房间3的湿度等级设置为16

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 3
      wetness_level: 
        - 16
  target:
      entity_id: vacuum.vacuum

重设耗材

dreame_vacuum.vacuum_reset_consumable

按类型重置消耗品寿命。

消耗品的可能值

• main_brush
• side_brush
• filter
• tank_filter
• sensor
• mop_pad
• silver_ion
• detergent
• squeege
• dirty_water_channel
• onboard_dirty_water_tank
• deodorizer
• wheel
• scale_inhibitor
• fluffing_roller
• rollermop_filter
• water_outlet_filter

示例

• 重置主刷寿命

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "main_brush"
  target:
      entity_id: vacuum.vacuum

• 重置拖布寿命

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "mop_pad"
  target:
      entity_id: vacuum.vacuum

遥控模式 不推荐

dreame_vacuum.vacuum_remote_control_move_step

向吸尘器发送遥控命令。

发送命令 不推荐

vacuum.send_command

发送命令服务可用于发送此集成中不可用的原始 API 请求。

仅供实验性使用

不建议终端用户直接使用此服务。如果有操作需要使用该服务，因为它尚未在集成中实现，请改为 提交功能请求。

提示

有关命令和参数的更多信息。

示例

• 开始自动清空

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: action
      params: 
          did: "15.1"
          siid: 15
          aiid: 1
          in: []

• 启用紧密拖地模式并禁用地毯增强

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: set_properties
      params: 
        - did: "4.29"
          siid: 4
          piid: 29
          value: 1
        - did: "4.12"
          siid: 4
          piid: 12
          value: 0