地圖服務

地圖編輯服務也使用吸塵器域，因為即使沒有雲端連線，所有服務仍可使用。

請求地圖資料

dreame_vacuum.vacuum_request_map

請求裝置上傳新地圖到雲端。（當不使用雲端連線且使用其他整合進行地圖渲染時，此服務非常有用）

重要

當裝置處於以下狀態時不會回應此操作：

• 定點清潔中
• 快速建圖
• 重新定位
• 地圖編輯後直到裝置移動

選擇地圖

dreame_vacuum.vacuum_select_map

更改當前選擇的地圖。（僅在啟用多樓層地圖時可行）

注意

• 你可以從已保存的地圖攝影機實體屬性中獲取地圖ID。
• 當選擇的地圖更改時，機器人將結束正在進行的工作。

範例

• 設定當前地圖為 ID 為 27 的地圖

  service: dreame_vacuum.vacuum_select_map
  data:
      map_id: 27
  target:
      entity_id: vacuum.vacuum

刪除地圖

dreame_vacuum.vacuum_delete_map

永久刪除指定地圖資料

注意

• 你可以從已保存的地圖攝影機實體屬性中獲取地圖ID。
• 當啟用多樓層地圖功能時，刪除後地圖索引可能會改變。 （更多關於多樓層地圖支援）

範例

• 刪除 ID 為 48 的地圖

  service: dreame_vacuum.vacuum_delete_map
  data:
      map_id: 48
  target:
      entity_id: vacuum.vacuum

地圖重新命名

dreame_vacuum.vacuum_rename_map

修改指定地圖的名稱

注意

• 你可以從已保存的地圖攝影機實體屬性中獲取地圖ID。
• 官方App不允許在地圖名稱中輸入特殊字符，但此整合可以，因此請謹慎使用此服務。

範例

• 將 ID 為 14 的地圖重新命名為「二樓」

  service: dreame_vacuum.vacuum_rename_map
  data:
      map_id: 14
      map_name: "Second Floor"
  target:
      entity_id: vacuum.vacuum

還原地圖 地圖支援

dreame_vacuum.vacuum_restore_map

從裝置建立並上傳的先前狀態中恢復地圖。

注意

• 地圖恢復不能保證成功。雲端不會永久儲存檔案，且恢復檔案通常會在最後一次存取後 365 天從雲端刪除。

範例

• 將選定的地圖恢復到恢復地圖列表中的第二個已保存恢復地圖

  service: dreame_vacuum.vacuum_restore_map
  data:
      recovery_map_index: 2
  target:
      entity_id: vacuum.vacuum

• 將已保存的 ID 為 14 的地圖恢復到原始狀態

  service: dreame_vacuum.vacuum_restore_map
  data:
      map_id: 14
      recovery_map_index: 1
  target:
      entity_id: vacuum.vacuum

從檔案還原地圖

dreame_vacuum.vacuum_restore_map_from_file

從先前保存的恢復地圖檔案恢復地圖。

注意

• 如果下載並將恢復地圖檔案放置到 Home Assistant 的 /www/ 資料夾中，此服務可用於離線恢復（掃地機器人和伺服器必須在同一網路）。
• 如果未啟用雲端連線，則需要地圖 ID。

範例

• 從已保存的恢復地圖檔案恢復選定的地圖

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      file_url: http://192.168.1.10/local/2023-11-04-1724223415-423528451_284320462.1156.mb.tbz2
  target:
      entity_id: vacuum.vacuum

• 從已保存的ID 為 14 的地圖恢復檔案

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      map_id: 14
      file_url: https://dreame-cn.oss-cn-shanghai.aliyuncs.com/iot/tmp/000000/ali_dreame/YR649291/648921668/101?Expires=1699189998&OSSAccessKeyId=LTAI5t96WkBXXNzQrX4HtQti&Signature=ttRrjg8p7aC650H3DwI3%2F2ngOOE%3D
  target:
      entity_id: vacuum.vacuum

備份地圖至雲端

dreame_vacuum.vacuum_backup_map

觸發將已保存的地圖作為恢復地圖上傳到雲端。

注意

• 雲端只能為每個已保存的地圖存儲一個備份地圖。如果您已有備份，這項服務將會覆蓋之前的備份地圖。
• 沒有相機或雷射測距儀的掃地機器人沒有此功能，地圖備份觸發僅在支持的設備上有效。

範例

• 觸發所選地圖的備份

  service: dreame_vacuum.vacuum_backup_map
  target:
      entity_id: vacuum.vacuum

• 觸發ID為15的地圖備份

  service: dreame_vacuum.vacuum_backup_map
  data:
      map_id: 15
  target:
      entity_id: vacuum.vacuum

儲存暫時地圖

dreame_vacuum.vacuum_save_temporary_map

保存新創建的地圖。（設備會在出廠重置後首次創建地圖時要求您操作）

捨棄暫時地圖

dreame_vacuum.vacuum_discard_temporary_map

放棄新創建的地圖

取代暫時地圖

dreame_vacuum.vacuum_replace_temporary_map

用舊地圖替換新地圖

注意

• 你可以從已保存的地圖攝影機實體屬性中獲取地圖ID。
• 當啟用多樓層地圖功能時，替換地圖後地圖索引可能會發生變化。被替換的新地圖將始終位於最後可用索引，即使被替換成索引較低的地圖。 （更多關於多樓層地圖支援）

範例

• 用ID為39的地圖替換新地圖

  service: dreame_vacuum.vacuum_replace_temporary_map
  data:
      map_id: 39
  target:
      entity_id: vacuum.vacuum

重命名房間

dreame_vacuum.vacuum_rename_segment

為當前地圖中的房間設置自訂名稱

注意

• 您可以從已保存地圖的相機實體屬性中獲取地圖和區域ID。
• 官方應用程式不允許您在房間名稱中輸入特殊字符，但此整合允許，因此請謹慎使用此服務。

範例

• 將房間 3 重新命名為「餐廳」

  service: dreame_vacuum.vacuum_rename_segment
  data:
      segment_id: 3
      segment_name: "Dining Room"
  target:
      entity_id: vacuum.vacuum

設定障礙物忽略 地圖支援

dreame_vacuum.vacuum_set_obstacle_ignore

設定當前地圖上檢測到的障礙物忽略狀態，使機器人在後續任務中不會避開它。

注意

• 此服務僅適用於具備 AI 障礙物檢測功能的吸塵器，且需要雲端連線。
• 您可以從當前地圖相機實體的 obstacles 屬性取得障礙物的座標及其目前的忽略狀態。（更多關於障礙物的資訊）
• 座標必須與當前地圖上的現有障礙物完全匹配，否則操作會被拒絕。
• 裝置自動忽略的障礙物無法使用此服務更改。
• 在機器人運行中無法更改障礙物忽略狀態。

範例

• 忽略位於 [819, -263] 的障礙物

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: true
  target:
      entity_id: vacuum.vacuum

• 停止忽略位於 [819, -263] 的障礙物

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: false
  target:
      entity_id: vacuum.vacuum

其他服務 地圖支援

整合中公開了額外的地圖管理服務。其中幾個參數（例如地板材質、房間可見性和拖把類型）已經公開，並可直接通過 房間實體 配置，因此不需要直接使用這些服務。

不提供給最終使用者

這些服務僅供 Dreame 吸塵器卡片 使用。它們沒有最終使用者容易訪問的參數。如果傳遞無效參數，可能會直接傳送到設備，導致嚴重問題，例如地圖損毀或設備進入啟動循環。因此，除非完全理解其功能和參數結構，否則不得使用這些服務。出於安全原因，這些服務明確不包括在 services.yaml 中，也不包含翻譯字串。

• 設定地毯區域: dreame_vacuum.vacuum_set_carpet_area
• 設定地毯類型: dreame_vacuum.vacuum_set_carpet_type
• 設定窗簾: dreame_vacuum.vacuum_set_curtain
• 設定自訂地毯清潔: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• 設定地板材質: dreame_vacuum.vacuum_set_floor_material
• 設定家具: dreame_vacuum.vacuum_set_furniture
• 設定隱藏區段: dreame_vacuum.vacuum_set_hidden_segments
• 設定低窪區域: dreame_vacuum.vacuum_set_low_lying_area
• 設定拖把類型: dreame_vacuum.vacuum_set_mop_type
• 設定預設點: dreame_vacuum.vacuum_set_predefined_points
• 設定限制區域: dreame_vacuum.vacuum_set_restricted_zone
• 設定路由器位置: dreame_vacuum.vacuum_set_router_position
• 設定區段類型: dreame_vacuum.vacuum_set_segment_type
• 設定閾值: dreame_vacuum.vacuum_set_threshold
• 設定虛擬閾值: dreame_vacuum.vacuum_set_virtual_threshold
• 設定牆壁: dreame_vacuum.vacuum_set_walls
• 合併房間: dreame_vacuum.vacuum_merge_segments
• 分割房間: dreame_vacuum.vacuum_split_segments