吸塵器服務

該整合提供多種自訂服務，用於執行進階操作和功能，這些操作和功能無法透過標準實體直接控制。這些自訂服務使用 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。
• 已刪除快捷方式的按鈕實體會自動移除。
• 當快捷方式自身任務正在執行時，無法刪除該快捷方式。
• 已刪除的快捷方式無法還原，只能從官方 App 重新創建。

範例

• 刪除 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