Perkhidmatan Penyedut

Integrasi ini mendedahkan pelbagai perkhidmatan tersuai untuk tindakan dan ciri lanjutan yang tidak boleh dikawal secara langsung melalui entiti standard. Perkhidmatan tersuai ini menggunakan domain vacuum dan menyediakan kawalan terperinci ke atas fungsi khusus peranti.

Bersihkan Bilik

dreame_vacuum.vacuum_clean_segment

Mulakan pembersihan bilik yang dipilih dengan parameter pembersihan tersuai pilihan.

Nota

• Jika anda menggunakan integrasi dengan ciri peta, anda boleh mendapatkan ID segmen daripada atribut entiti vakum.
• Parameter pembersihan dan urutan pembersihan diabaikan oleh peranti apabila customized_cleaning atau cleaning_sequence diaktifkan.

Menetapkan Mod Pembersihan

Perkhidmatan ini tidak menerima parameter cleaning_mode. Untuk menetapkan mod secara dinamik sebelum memulakan pembersihan, lihat Soalan Lazim.

Contoh

• Bersihkan bilik 3

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

• Bersihkan bilik 3 dan 5

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

• Bersihkan bilik 3 dan 5 dua kali

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

• Bersihkan bilik 2 dua kali dan 5 sekali

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

• Bersihkan bilik 3 dan 5 dengan kelajuan kipas tinggi

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

• Bersihkan bilik 3 dengan kelajuan kipas tinggi dan 5 dengan kelajuan kipas perlahan

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

Cuci Zon

dreame_vacuum.vacuum_clean_zone

Mulakan pembersihan zon yang dipilih dengan parameter pembersihan tersuai pilihan.

Petua

Anda boleh mendapatkan koordinat zon dengan Kad Peta Vakum Xiaomi.

Menetapkan Mod Pembersihan: Perkhidmatan ini tidak menerima parameter cleaning_mode. Untuk menetapkan mod secara dinamik sebelum memulakan pembersihan, lihat Soalan Lazim.

Contoh

• Bersihkan zon yang dipilih

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

• Bersihkan beberapa zon

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

• Bersihkan zon yang dipilih dua kali

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

• Bersihkan zon pertama dua kali, zon 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

Cuci Titik

dreame_vacuum.vacuum_clean_spot

Mulakan pembersihan titik yang dipilih dengan parameter pembersihan tersuai pilihan.

Nota

Ciri pembersihan titik hanya tersedia untuk robot berjenama Xiaomi/Mijia tetapi ia juga berfungsi dengan peranti Dreame.

Petua

Anda boleh mendapatkan koordinat titik dengan Kad Peta Vakum Xiaomi.

Menetapkan Mod Pembersihan: Perkhidmatan ini tidak menerima parameter cleaning_mode. Untuk menetapkan mod secara dinamik sebelum memulakan pembersihan, lihat Soalan Lazim.

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

Hantar robot ke satu koordinat pada peta dan hentikannya di situ.

Nota

• Pada peranti yang mempunyai ciri pelayaran (vakum dengan navigasi lidar dan penstriman kamera), ini akan memulakan tugasan cruise to point dan robot akan mengambil gambar di sekitar titik sasaran apabila ia tiba. Tugasan ini disimpan dalam sejarah pelayaran. (Lebih lanjut tentang peta sejarah pelayaran)
• Pada peranti lain, tingkah laku yang sama ditiru dengan tugasan pembersihan zon kecil di sekitar titik yang diberikan. Tahap sedutan ditetapkan kepada senyap dan mengepel dinyahaktifkan untuk tugasan itu, dan robot dihentikan serta tetapan pembersihan sebelumnya dipulihkan oleh integrasi sebaik sahaja ia sampai ke titik tersebut.
• Tahap bateri mestilah sekurang-kurangnya 15% dan koordinat mestilah berada di dalam peta semasa.
• Peranti tidak bertindak balas terhadap tindakan ini apabila robot sudah berada di koordinat yang dipilih, stesen sedang mengalirkan kuasa atau stesen sedang membaiki/dalam ujian sendiri.

Petua

Anda boleh mendapatkan koordinat titik dengan Kad 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

Ikut Laluan Eksperimen

dreame_vacuum.vacuum_follow_path

Mulakan tugasan laluan pelayaran yang mengunjungi koordinat yang diberikan satu persatu dan kembali ke dok.

Amaran

Peranti hanya dibenarkan melaksanakan tugas mengikuti laluan apabila penstriman kamera langsung aktif. Berbeza dengan Pergi ke Titik, perkhidmatan ini berkait dengan kamera dan anda mesti membuka kamera dari Aplikasi rasmi sebelum memanggilnya. Jika tidak, robot sepenuhnya mengabaikan permintaan dan tidak melakukan apa-apa.

Nota

• Perkhidmatan ini hanya tersedia pada peranti dengan ciri pelayaran (vakum dengan navigasi lidar dan penstriman kamera).
• Hanya 20 titik pertama dihantar ke peranti dan setiap koordinat mestilah dalam peta semasa.
• Apabila points diabaikan, titik pelayaran yang disimpan pada peta semasa digunakan sebaliknya. Sekurang-kurangnya satu koordinat sah atau tersimpan diperlukan untuk memulakan tugas.
• Tahap bateri mesti sekurang-kurangnya 15% dan peranti tidak bertindak balas terhadap tindakan ini semasa stesen sedang mengecas atau melakukan pembaikan/ujian sendiri.
• Anda boleh mendapatkan koordinat titik dengan Kad Peta Vakum Xiaomi.

Contoh

• Ikuti laluan tiga titik

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

• Ikuti titik pelayaran yang disimpan pada peta semasa

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

Mula Pintasan

dreame_vacuum.vacuum_start_shortcut

Mulakan tugas pintasan yang dibuat pada Aplikasi rasmi.

Nota

• Pintasan hanya tersedia pada peranti yang disokong dan anda boleh mendapatkan id pintasan dari atribut shortcuts entiti vakum.
• Id pintasan yang sah adalah antara 25 dan 128.
• Integrasi juga mencipta entiti butang untuk setiap pintasan peranti sebagai button.{vacuum_name}_shortcut_{shortcut_id} oleh itu menggunakan perkhidmatan ini biasanya tidak diperlukan.
• Peranti tidak bertindak balas terhadap tindakan ini semasa stesen sedang mengalirkan atau membaiki/menguji diri sendiri.

Contoh

• Mulakan pintasan dengan id 32

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

Namakan Semula Pintasan

dreame_vacuum.vacuum_rename_shortcut

Tetapkan nama tersuai untuk pintasan.

Nota

• Anda boleh mendapatkan id pintasan dari atribut shortcuts entiti vakum.
• Nama pintasan mesti unik. Apabila nama baru sudah digunakan oleh pintasan lain, pemasa akan ditambahkan kepadanya seperti yang dilakukan oleh App rasmi. (Sebagai contoh: Mopping after sweeping menjadi Mopping after sweeping2)
• Nama entiti butang pintasan yang dihasilkan mengikuti nama pintasan.
• Pintasan tidak boleh dinamakan semula semasa robot sedang berjalan.

Contoh

• Namakan semula pintasan dengan id 32 kepada "Mopping after sweeping"

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

Padam Pintasan

dreame_vacuum.vacuum_delete_shortcut

Padamkan pintasan.

Nota

• Anda boleh mendapatkan id pintasan dari atribut shortcuts entiti vakum.
• Entiti butang bagi pintasan yang dipadam akan dialihkan secara automatik.
• Pintasan tidak boleh dipadamkan semasa tugasan sendiri sedang berjalan.
• Pintasan yang dipadam tidak boleh dipulihkan dan hanya boleh dicipta semula dari Aplikasi rasmi.

Contoh

• Padam pintasan dengan id 34

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

Pasang Pek Suara

dreame_vacuum.vacuum_install_voice_pack

Pasang pek suara rasmi.

Tetapkan Urutan Pembersihan Sokongan Peta

dreame_vacuum.vacuum_set_cleaning_sequence

Tetapkan urutan pembersihan bilik pada peta semasa.

Nota

Bilangan tepat ID bilik mesti dihantar sebagai senarai urutan

Contoh

• Tetapkan urutan pembersihan bilik pada peta semasa kepada 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

• Lumpuhkan urutan pembersihan tersuai pada peta semasa

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

Tetapkan Pembersihan Tersuai Sokongan Peta

dreame_vacuum.vacuum_set_custom_cleaning

Tetapkan parameter pembersihan bilik tersuai pada peta semasa.

Nota

Tetapan bagi semua bilik mesti dihantar sebagai senarai

Contoh

• Tetapkan kelajuan kipas bilik 1 kepada senyap, tahap air kepada rendah, masa pembersihan kepada 2 dan bilik 5 kelajuan kipas kepada turbo, tahap air kepada sederhana, ulangan kepada 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

• Tetapkan tahap kekalutan bilik 3 kepada 16

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

Tetapkan Semula Boleh Habis

dreame_vacuum.vacuum_reset_consumable

Tetapkan semula hayat bahan pakai mengikut jenis.

Nilai yang mungkin bagi bahan pakai

• 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

• Tetapkan semula Hayat Berus Utama

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

• Tetapkan semula Hayat Pad Mop

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

Kawalan Jauh Tidak Disyorkan

dreame_vacuum.vacuum_remote_control_move_step

Hantar arahan kawalan jauh ke vakum.

Hantar Arahan Tidak Disyorkan

vacuum.send_command

Perkhidmatan hantar arahan boleh digunakan untuk menghantar permintaan API mentah yang tidak tersedia dengan integrasi ini.

Untuk Penggunaan Eksperimen Sahaja

Tidak disyorkan bagi pengguna akhir untuk menggunakan perkhidmatan ini secara langsung. Sekiranya terdapat tindakan yang memerlukan penggunaan perkhidmatan ini kerana ia belum dilaksanakan dalam integrasi, sila buka permintaan ciri sebaliknya.

Petua

Maklumat lanjut tentang arahan dan parameter.

Contoh

• Mula mengosongkan automatik

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

• Aktifkan corak mengepel rapat dan matikan 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