Layanan Peta

Layanan pengeditan peta juga menggunakan domain vacuum karena semua layanan tersedia bahkan tanpa koneksi cloud.

Minta Peta

dreame_vacuum.vacuum_request_map

Meminta perangkat untuk mengunggah peta baru ke cloud. (Layanan ini berguna ketika koneksi cloud tidak digunakan dan integrasi lain digunakan untuk menangani rendering peta)

Penting

Perangkat tidak merespons tindakan ini ketika:

• Pembersihan area
• Pemetaan Cepat
• Memindahkan lokasi
• Setelah pengeditan peta sampai bergerak

Pilih Peta

dreame_vacuum.vacuum_select_map

Mengubah peta yang dipilih saat ini. (Hanya mungkin jika peta multi-lantai diaktifkan)

Catatan

• Anda dapat memperoleh id peta dari atribut entitas kamera peta yang tersimpan.
• Robot akan menghentikan pekerjaan aktif ketika peta yang dipilih diubah.

Contoh

• Mengatur peta saat ini sebagai peta dengan id 27

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

Hapus Peta

dreame_vacuum.vacuum_delete_map

Menghapus peta yang dipilih.

Catatan

• Anda dapat memperoleh id peta dari atribut entitas kamera peta yang tersimpan.
• Ketika fitur peta multi-lantai diaktifkan, indeks peta dapat berubah setelah penghapusan. (Lebih lanjut tentang dukungan peta multi-lantai)

Contoh

• Menghapus peta dengan id 48

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

Ganti Nama Peta

dreame_vacuum.vacuum_rename_map

Mengganti nama peta pilihan.

Catatan

• Anda dapat memperoleh id peta dari atribut entitas kamera peta yang tersimpan.
• Aplikasi Resmi tidak mengizinkan Anda memasukkan karakter khusus dalam nama peta tetapi integrasi ini mengizinkannya, jadi gunakan layanan ini dengan hati-hati.

Contoh

• Ganti nama peta dengan id 14 menjadi "Lantai Dua"

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

Pulihkan Peta Dukungan Peta

dreame_vacuum.vacuum_restore_map

Pulihkan peta dari keadaan sebelumnya yang dibuat dan diunggah oleh perangkat.

Catatan

• Tidak dijamin bahwa pemulihan peta akan berhasil. Cloud tidak menyimpan file selamanya dan file pemulihan biasanya akan dihapus dari cloud setelah 365 hari sejak akses terakhir.

Contoh

• Pulihkan peta yang dipilih ke peta pemulihan kedua yang disimpan dalam daftar peta pemulihan

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

• Pulihkan peta yang disimpan dengan id 14 ke keadaan asli

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

Pulihkan Peta dari Berkas

dreame_vacuum.vacuum_restore_map_from_file

Pulihkan peta dari file peta pemulihan yang disimpan sebelumnya.

Catatan

• Layanan ini dapat digunakan untuk pemulihan offline jika Anda mengunduh dan menempatkan file peta pemulihan ke folder /www/ di Home Assistant (Vacuum dan server harus berada di jaringan yang sama).
• Id Peta diperlukan jika koneksi cloud tidak diaktifkan.

Contoh

• Pulihkan peta yang dipilih dari file peta pemulihan yang disimpan

  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

• Pulihkan peta yang disimpan dengan id 14 dari file peta pemulihan yang disimpan

  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

Cadangkan Peta

dreame_vacuum.vacuum_backup_map

Memicu unggahan peta yang disimpan sebagai peta pemulihan ke cloud.

Catatan

• Cloud hanya dapat menyimpan satu peta cadangan untuk setiap peta yang disimpan. Layanan ini akan menimpa peta cadangan sebelumnya jika Anda memilikinya.
• Vakum tanpa kamera atau sensor lidar tidak memiliki fitur ini, pemicu cadangan peta hanya berfungsi pada perangkat yang didukung.

Contoh

• Memicu cadangan peta yang dipilih

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

• Memicu cadangan peta dengan id 15

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

Simpan Peta Sementara

dreame_vacuum.vacuum_save_temporary_map

Simpan peta yang baru dibuat. (Perangkat akan meminta Anda untuk melakukannya ketika peta pertama dibuat setelah pengaturan pabrik)

Buang Peta Sementara

dreame_vacuum.vacuum_discard_temporary_map

Buang peta yang baru dibuat.

Ganti Peta Sementara

dreame_vacuum.vacuum_replace_temporary_map

Ganti peta baru dengan yang lama.

Catatan

• Anda dapat memperoleh id peta dari atribut entitas kamera peta yang tersimpan.
• Ketika fitur peta multi-lantai diaktifkan, indeks peta dapat berubah setelah mengganti peta. Peta baru yang diganti akan selalu berada di indeks terakhir yang tersedia, bahkan diganti dengan peta yang memiliki indeks lebih rendah. (Lebih lanjut tentang dukungan peta multi-lantai)

Contoh

• Ganti peta baru dengan peta dengan id 39

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

Ganti Nama Ruangan

dreame_vacuum.vacuum_rename_segment

Tetapkan nama khusus untuk sebuah ruangan di peta saat ini.

Catatan

• Anda dapat memperoleh id peta dan segmen dari atribut entitas kamera peta yang disimpan.
• Aplikasi Resmi tidak mengizinkan Anda memasukkan karakter khusus dalam nama ruangan tetapi integrasi ini memperbolehkannya, jadi gunakan layanan ini dengan hati-hati.

Contoh

• Ganti nama ruangan 3 menjadi "Ruang Makan"

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

Abaikan Rintangan Dukungan Peta

dreame_vacuum.vacuum_set_obstacle_ignore

Atur status abaikan dari sebuah halangan yang terdeteksi pada peta saat ini agar robot tidak menghindarinya pada pekerjaan berikutnya.

Catatan

• Layanan ini hanya tersedia pada vacuum dengan fitur deteksi halangan AI dan memerlukan koneksi cloud.
• Anda dapat memperoleh koordinat halangan dan status abaikan mereka saat ini dari atribut obstacles pada entitas kamera peta saat ini. (Selengkapnya tentang halangan)
• Koordinat harus sesuai persis dengan halangan yang ada pada peta saat ini, jika tidak aksi akan ditolak.
• Halangan yang secara otomatis diabaikan oleh perangkat tidak dapat diubah dengan layanan ini.
• Status abaikan halangan tidak dapat diubah saat robot sedang berjalan.

Contoh

• Abaikan halangan di [819, -263]

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

• Hentikan pengabaian halangan di [819, -263]

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

Layanan Lain Dukungan Peta

Layanan manajemen peta tambahan terekspos melalui integrasi. Beberapa parameter ini (seperti material lantai, visibilitas ruangan, dan tipe pel) sudah terekspos dan dapat dikonfigurasi langsung melalui Entitas Ruangan, sehingga penggunaan langsung layanan ini tidak diperlukan.

Tidak dimaksudkan untuk Pengguna Akhir

Layanan ini sepenuhnya terekspos untuk penggunaan Kartu Penyedot Debu Dreame. Mereka tidak memiliki parameter yang mudah diakses oleh pengguna akhir. Jika parameter yang tidak valid dikirim, mereka mungkin diteruskan langsung ke perangkat, yang dapat mengakibatkan masalah serius seperti peta yang rusak atau perangkat masuk ke loop boot. Oleh karena itu, layanan ini tidak boleh digunakan kecuali fungsi dan struktur parameter yang tepat sepenuhnya dipahami. Demi alasan keselamatan, layanan ini secara eksplisit dikecualikan dari services.yaml dan tidak mencakup string terjemahan.

• Atur Area Karpet: dreame_vacuum.vacuum_set_carpet_area
• Atur Tipe Karpet: dreame_vacuum.vacuum_set_carpet_type
• Atur Tirai: dreame_vacuum.vacuum_set_curtain
• Atur Pembersihan Karpet Kustom: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• Atur Material Lantai: dreame_vacuum.vacuum_set_floor_material
• Atur Perabotan: dreame_vacuum.vacuum_set_furniture
• Atur Segmen Tersembunyi: dreame_vacuum.vacuum_set_hidden_segments
• Atur Area Rendah: dreame_vacuum.vacuum_set_low_lying_area
• Atur Tipe Pel: dreame_vacuum.vacuum_set_mop_type
• Atur Titik yang Telah Ditentukan: dreame_vacuum.vacuum_set_predefined_points
• Atur Zona Terbatas: dreame_vacuum.vacuum_set_restricted_zone
• Atur Posisi Router: dreame_vacuum.vacuum_set_router_position
• Atur Tipe Segmen: dreame_vacuum.vacuum_set_segment_type
• Atur Ambang Batas: dreame_vacuum.vacuum_set_threshold
• Atur Ambang Virtual: dreame_vacuum.vacuum_set_virtual_threshold
• Atur Dinding: dreame_vacuum.vacuum_set_walls
• Gabungkan ruangan: dreame_vacuum.vacuum_merge_segments
• Pisahkan Ruangan: dreame_vacuum.vacuum_split_segments