Layanan Penyedot Debu

Integrasi ini menampilkan berbagai layanan kustom untuk tindakan dan fitur lanjutan yang tidak dapat dikontrol secara langsung melalui entitas standar. Layanan kustom ini memanfaatkan domain vacuum dan menyediakan kontrol rinci atas fungsionalitas spesifik perangkat.

Bersihkan Ruangan

dreame_vacuum.vacuum_clean_segment

Mulai pembersihan ruangan yang dipilih dengan parameter pembersihan kustom opsional.

Catatan

• Jika Anda menggunakan integrasi dengan fitur peta, Anda dapat memperoleh ID segmen dari atribut entitas vacuum.
• Parameter pembersihan dan urutan pembersihan diabaikan oleh perangkat ketika customized_cleaning atau cleaning_sequence diaktifkan.

Mengatur Mode Pembersihan

Layanan ini tidak menerima parameter cleaning_mode. Untuk mengatur mode secara dinamis sebelum memulai pembersihan, lihat FAQ.

Contoh

• Bersihkan ruangan 3

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

• Bersihkan ruangan 3 dan 5

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

• Bersihkan ruangan 3 dan 5 dua kali

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

• Bersihkan ruangan 2 dua kali dan 5 satu kali

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

• Bersihkan ruangan 3 dan 5 dengan kecepatan kipas tinggi

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

• Bersihkan ruangan 3 dengan kecepatan kipas tinggi dan 5 dengan kecepatan kipas senyap

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

Bersihkan Zona

dreame_vacuum.vacuum_clean_zone

Mulai pembersihan zona yang dipilih dengan parameter pembersihan kustom opsional.

Tip

Anda dapat memperoleh koordinat zona dengan Kartu Peta Vakum Xiaomi.

Mengatur Mode Pembersihan: Layanan ini tidak menerima parameter cleaning_mode. Untuk mengatur mode secara dinamis sebelum memulai pembersihan, lihat FAQ.

Contoh

• Bersihkan zona yang dipilih

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

• Bersihkan beberapa zona

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

• Bersihkan zona yang dipilih dua kali

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

• Bersihkan zona pertama dua kali, zona kedua tiga kali

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

Bersihkan Titik

dreame_vacuum.vacuum_clean_spot

Mulai pembersihan titik yang dipilih dengan parameter pembersihan kustom opsional.

Catatan

Fitur pembersihan titik hanya tersedia untuk robot bermerek Xiaomi/Mijia tetapi juga berfungsi dengan perangkat Dreame.

Tip

Anda dapat memperoleh koordinat titik dengan Kartu Peta Vakum Xiaomi.

Mengatur Mode Pembersihan: Layanan ini tidak menerima parameter cleaning_mode. Untuk mengatur mode secara dinamis sebelum memulai pembersihan, lihat FAQ.

Contoh

• Bersihkan titik yang dipilih

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

• Bersihkan beberapa titik

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

• Bersihkan titik yang dipilih dua kali

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

• Bersihkan titik pertama dua kali, titik kedua tiga kali

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

Pergi ke Titik

dreame_vacuum.vacuum_goto

Kirim robot ke satu koordinat di peta dan hentikan di sana.

Catatan

• Pada perangkat dengan fitur jelajah (robot penyedot debu dengan navigasi lidar dan streaming kamera) ini memulai pekerjaan cruise to point dan robot mengambil foto di sekitar titik target saat sampai. Pekerjaan ini disimpan dalam riwayat jelajah. (Lebih lanjut tentang peta riwayat perjalanan)
• Pada perangkat lain, perilaku yang sama disimulasikan dengan pekerjaan pembersihan zona kecil di sekitar titik yang diberikan. Tingkat hisap diatur ke mode tenang dan fitur mengepel dinonaktifkan untuk pekerjaan itu, dan robot dihentikan serta pengaturan pembersihan sebelumnya dipulihkan oleh integrasi segera setelah mencapai titik.
• Tingkat baterai harus minimal 15% dan koordinat harus berada di dalam peta saat ini.
• Perangkat tidak merespons tindakan ini jika robot sudah berada di koordinat yang dipilih, stasiun sedang menguras daya, atau stasiun sedang memperbaiki/menguji diri.

Tip

Anda dapat memperoleh koordinat titik dengan Kartu Peta Vakum Xiaomi.

Contoh

• Pergi ke [819, -2235] dan berhenti

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

Ikuti Jalur Eksperimental

dreame_vacuum.vacuum_follow_path

Mulai pekerjaan jalur jelajah yang mengunjungi koordinat yang diberikan satu per satu dan kembali ke dok.

Peringatan

Perangkat dibatasi untuk menjalankan tugas mengikuti jalur hanya saat pemrosesan streaming kamera langsung aktif. Tidak seperti Pergi ke Titik, layanan ini terikat pada kamera dan Anda harus membuka kamera dari Aplikasi resmi sebelum memanggilnya. Jika tidak, robot sepenuhnya mengabaikan permintaan dan tidak melakukan apa pun.

Catatan

• Layanan ini hanya tersedia pada perangkat dengan fitur berlayar (robot vakum dengan navigasi lidar dan streaming kamera).
• Hanya 20 titik pertama yang dikirim ke perangkat dan setiap koordinat harus berada di dalam peta saat ini.
• Ketika points tidak disertakan, titik jalur yang tersimpan pada peta saat ini digunakan sebagai gantinya. Setidaknya satu koordinat yang valid atau tersimpan diperlukan untuk memulai pekerjaan.
• Tingkat baterai harus minimal 15% dan perangkat tidak merespons tindakan ini saat stasiun sedang mengisi daya atau melakukan perbaikan/pengujian sendiri.
• Anda dapat memperoleh koordinat titik dengan Kartu Peta Vakum Xiaomi.

Contoh

• Ikuti jalur dari tiga titik

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

• Ikuti titik jalur tersimpan dari peta saat ini

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

Mulai Pintasan

dreame_vacuum.vacuum_start_shortcut

Mulai tugas pintasan yang dibuat di Aplikasi resmi.

Catatan

• Pintasan hanya tersedia di perangkat yang didukung dan Anda dapat memperoleh ID pintasan dari atribut shortcuts dari entitas vacuum.
• ID pintasan yang valid berada antara 25 dan 128.
• Integrasi juga membuat entitas tombol untuk setiap pintasan perangkat sebagai button.{vacuum_name}_shortcut_{shortcut_id} sehingga biasanya menggunakan layanan ini tidak diperlukan.
• Perangkat tidak merespons tindakan ini saat stasiun sedang menguras atau memperbaiki/menguji diri sendiri.

Contoh

• Mulai pintasan dengan ID 32

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

Ganti Nama Pintasan

dreame_vacuum.vacuum_rename_shortcut

Tetapkan nama khusus untuk sebuah pintasan.

Catatan

• Anda dapat memperoleh ID pintasan dari atribut shortcuts dari entitas vacuum.
• Nama pintasan harus unik. Ketika nama baru sudah digunakan oleh pintasan lain, penghitung ditambahkan kepadanya seperti yang dilakukan aplikasi resmi. (Misalnya: Mopping after sweeping menjadi Mopping after sweeping2)
• Nama entitas tombol pintasan yang dibuat mengikuti nama pintasan.
• Pintasan tidak dapat diganti namanya saat robot sedang berjalan.

Contoh

• Ganti nama pintasan dengan ID 32 menjadi "Mopping after sweeping"

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

Hapus Pintasan

dreame_vacuum.vacuum_delete_shortcut

Hapus sebuah pintasan.

Catatan

• Anda dapat memperoleh ID pintasan dari atribut shortcuts dari entitas vacuum.
• Entitas tombol dari pintasan yang dihapus dihapus secara otomatis.
• Pintasan tidak dapat dihapus saat tugasnya sendiri sedang berjalan.
• Pintasan yang dihapus tidak dapat dikembalikan dan hanya dapat dibuat ulang dari Aplikasi resmi.

Contoh

• Hapus pintasan dengan id 34

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

Instal Paket Suara

dreame_vacuum.vacuum_install_voice_pack

Pasang paket suara resmi.

Atur Urutan Pembersihan Dukungan Peta

dreame_vacuum.vacuum_set_cleaning_sequence

Atur urutan pembersihan ruangan pada peta saat ini.

Catatan

Jumlah pasti id ruangan harus diberikan sebagai daftar urutan

Contoh

• Atur urutan pembersihan ruangan pada peta saat ini menjadi 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

• Nonaktifkan urutan pembersihan khusus pada peta saat ini

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

Atur Pembersihan Kustom Dukungan Peta

dreame_vacuum.vacuum_set_custom_cleaning

Atur parameter pembersihan ruangan yang disesuaikan pada peta saat ini.

Catatan

Pengaturan untuk semua ruangan harus diberikan sebagai daftar

Contoh

• Atur kecepatan kipas ruangan 1 menjadi hening, tingkat air ke rendah, jumlah pembersihan menjadi 2 dan kecepatan kipas ruangan 5 menjadi turbo, tingkat air ke sedang, pengulangan menjadi 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

• Atur tingkat kelembapan ruangan 3 menjadi 16

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

Reset Aksesori

dreame_vacuum.vacuum_reset_consumable

Reset masa pakai consumable berdasarkan jenis.

Nilai yang mungkin untuk 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

Contoh

• Reset Masa Pakai Sikat Utama

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

• Reset Masa Pakai Pel

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

Kontrol Jarak Jauh Tidak Direkomendasikan

dreame_vacuum.vacuum_remote_control_move_step

Kirim perintah remote control ke vacuum.

Kirim Perintah Tidak Direkomendasikan

vacuum.send_command

Layanan kirim perintah dapat digunakan untuk mengirim permintaan API mentah yang tidak tersedia dengan integrasi ini.

Hanya untuk Penggunaan Eksperimen

Tidak disarankan bagi pengguna akhir untuk menggunakan layanan ini secara langsung. Jika ada tindakan yang memerlukan penggunaan layanan ini karena belum diimplementasikan dalam integrasi, silakan buka permintaan fitur sebagai gantinya.

Tip

Informasi lebih lanjut tentang perintah dan parameter.

Contoh

• Mulai pengosongan otomatis

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

• Aktifkan pola pel ketat dan nonaktifkan peningkatan karpet

  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