บริการแผนที่

บริการแก้ไขแผนที่ยังใช้โดเมนเครื่องดูดฝุ่นเนื่องจากบริการทั้งหมดสามารถใช้งานได้แม้ไม่มีการเชื่อมต่อคลาวด์

ร้องขอแผนที่

dreame_vacuum.vacuum_request_map

ขอให้อุปกรณ์อัปโหลดแผนที่ใหม่ไปยังคลาวด์ (บริการนี้มีประโยชน์เมื่อไม่ใช้การเชื่อมต่อคลาวด์และมีการใช้งานแบบอินทิเกรชันอื่นสำหรับการเรนเดอร์แผนที่)

สำคัญ

อุปกรณ์จะไม่ตอบสนองต่อการกระทำนี้เมื่อ:

• ทำความสะอาดเฉพาะจุด
• สร้างแผนที่อย่างรวดเร็ว
• กำลังย้าย
• หลังจากแก้ไขแผนที่จนกว่าจะมีการเคลื่อนที่

เลือกแผนที่

dreame_vacuum.vacuum_select_map

เปลี่ยนแผนที่ที่เลือกปัจจุบัน (ทำได้เฉพาะเมื่อเปิดใช้งานแผนที่หลายชั้น)

หมายเหตุ

• คุณสามารถรับรหัสแผนที่จากคุณลักษณะของกล้องแผนที่ที่บันทึกไว้
• หุ่นยนต์จะยุติงานที่ใช้งานอยู่เมื่อแผนที่ที่เลือกถูกเปลี่ยน

ตัวอย่าง

• ตั้งค่าแผนที่ปัจจุบันเป็นแผนที่ที่มีรหัส 27

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

ลบแผนที่

dreame_vacuum.vacuum_delete_map

ลบแผนที่

หมายเหตุ

• คุณสามารถรับรหัสแผนที่จากคุณลักษณะของกล้องแผนที่ที่บันทึกไว้
• เมื่อเปิดใช้งานคุณสมบัติเครื่องแผนที่หลายชั้น ดัชนีแผนที่อาจเปลี่ยนหลังจากการลบ (ข้อมูลเพิ่มเติมเกี่ยวกับการรองรับแผนที่หลายชั้น)

ตัวอย่าง

• ตั้งค่าลบแผนที่ที่มีรหัส 48

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

เปลี่ยนชื่อแผนที่

dreame_vacuum.vacuum_rename_map

เปลี่ยนชื่อแผนที่

หมายเหตุ

• คุณสามารถรับรหัสแผนที่จากคุณลักษณะของกล้องแผนที่ที่บันทึกไว้
• แอปอย่างเป็นทางการไม่อนุญาตให้ใส่อักขระพิเศษในชื่อแผนที่ แต่การอินทิเกรชันนี้ทำได้ ดังนั้นใช้บริการนี้ด้วยความระมัดระวัง

ตัวอย่าง

• เปลี่ยนชื่อแผนที่ที่มีรหัส 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

• กู้คืนแผนที่ที่บันทึกไว้ที่มีรหัส 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

กู้คืนแผนที่จากไฟล์แผนที่กู้คืนที่บันทึกไว้ก่อนหน้านี้

หมายเหตุ

• บริการนี้สามารถใช้สำหรับการกู้คืนแบบออฟไลน์ได้ หากคุณดาวน์โหลดและวางไฟล์แผนที่กู้คืนในโฟลเดอร์ /www/ ของ Home Assistant (เครื่องดูดฝุ่นและเซิร์ฟเวอร์ต้องอยู่ในเครือข่ายเดียวกัน)
• จำเป็นต้องระบุรหัสแผนที่หากไม่ได้เปิดการเชื่อมต่อคลาวด์

ตัวอย่าง

• กู้คืนแผนที่ที่เลือกจากไฟล์แผนที่กู้คืนที่บันทึกไว้

  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

• กู้คืนแผนที่ที่บันทึกไว้ที่มีรหัส 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

• ทริกเกอร์สำรองแผนที่ที่มีรหัส 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

แทนที่แผนที่ใหม่ด้วยแผนที่เก่า

หมายเหตุ

• คุณสามารถรับรหัสแผนที่จากคุณลักษณะของกล้องแผนที่ที่บันทึกไว้
• เมื่อเปิดใช้งานฟีเจอร์แผนที่หลายชั้น ดัชนีแผนที่อาจเปลี่ยนหลังจากแทนที่แผนที่ แผนที่ใหม่ที่ถูกแทนที่จะอยู่ที่ดัชนีสุดท้ายเสมอ แม้ว่าจะถูกแทนที่ด้วยแผนที่ที่มีดัชนีต่ำกว่า (ข้อมูลเพิ่มเติมเกี่ยวกับการรองรับแผนที่หลายชั้น)

ตัวอย่าง

• แทนที่แผนที่ใหม่ด้วยแผนที่ที่มีรหัส 39

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

เปลี่ยนชื่อห้อง

dreame_vacuum.vacuum_rename_segment

ตั้งชื่อเองสำหรับห้องในแผนที่ปัจจุบัน

หมายเหตุ

• คุณสามารถรับรหัสแผนที่และรหัสส่วนย่อยจากแอตทริบิวต์ของกล้องในแผนที่ที่บันทึกไว้
• แอปอย่างเป็นทางการไม่อนุญาตให้คุณกรอกอักขระพิเศษในชื่อห้อง แต่การรวมระบบนี้อนุญาต ดังนั้นโปรดใช้บริการนี้อย่างระมัดระวัง

ตัวอย่าง

• เปลี่ยนชื่อห้อง 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 Vacuum พวกมันไม่มีพารามิเตอร์ที่ผู้ใช้ปลายทางสามารถเข้าถึงได้ง่าย หากมีการส่งพารามิเตอร์ที่ไม่ถูกต้อง อาจถูกส่งตรงไปยังอุปกรณ์ ซึ่งอาจทำให้เกิดปัญหารุนแรงเช่น แผนที่เสียหายหรืออุปกรณ์เข้าสู่การบูตซ้ำ ดังนั้นห้ามใช้บริการเหล่านี้ เว้นแต่ว่าฟังก์ชันและโครงสร้างของพารามิเตอร์จะเข้าใจอย่างชัดเจน เพื่อความปลอดภัย บริการเหล่านี้ถูกยกเว้นอย่างชัดเจนจาก 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