Usługi odkurzacza

Integracja udostępnia różne niestandardowe usługi do zaawansowanych działań i funkcji, które nie są bezpośrednio sterowalne za pomocą standardowych encji. Te niestandardowe usługi wykorzystują domenę vacuum i zapewniają szczegółową kontrolę nad funkcjami specyficznymi dla urządzenia.

Czyszczenie pokoju

dreame_vacuum.vacuum_clean_segment

Rozpocznij sprzątanie wybranego pokoju z opcjonalnie dostosowanymi parametrami czyszczenia.

Uwaga

• Jeśli używasz integracji z funkcją mapy, możesz pobrać identyfikatory segmentów z atrybutów encji odkurzacza.
• Parametry czyszczenia i sekwencja czyszczenia są ignorowane przez urządzenie, gdy customized_cleaning lub cleaning_sequence są włączone.

Ustawienie trybu czyszczenia

Ta usługa nie akceptuje parametru cleaning_mode. Aby ustawić tryb dynamicznie przed rozpoczęciem sprzątania, zobacz FAQ.

Przykłady

• Czyść pokój 3

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

• Czyść pokój 3 i 5

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

• Czyść pokój 3 i 5 dwa razy

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

• Czyść pokój 2 dwa razy i pokój 5 jeden raz

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

• Czyść pokój 3 i 5 z wysoką prędkością wentylatora

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

• Czyść pokój 3 z wysoką prędkością wentylatora i pokój 5 z cichą prędkością wentylatora

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

Strefa Czysta

dreame_vacuum.vacuum_clean_zone

Rozpocznij czyszczenie wybranej strefy z opcjonalnymi, dostosowanymi parametrami czyszczenia.

Wskazówka

Współrzędne stref można uzyskać za pomocą Karty Mapy Odkurzacza Xiaomi.

Ustawianie trybu czyszczenia: Ta usługa nie przyjmuje parametru cleaning_mode. Aby dynamicznie ustawić tryb przed rozpoczęciem czyszczenia, zobacz FAQ.

Przykłady

• Czyść wybraną strefę

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

• Czyść kilka stref

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

• Czyść wybraną strefę dwa razy

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

• Czyść pierwszą strefę dwa razy, drugą strefę trzy razy

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

Czyste miejsce

dreame_vacuum.vacuum_clean_spot

Rozpocznij czyszczenie wybranego punktu z opcjonalnymi, dostosowanymi parametrami czyszczenia.

Uwaga

Funkcja czyszczenia punktowego jest dostępna tylko dla robotów marki Xiaomi/Mijia, ale działa również z urządzeniami Dreame.

Wskazówka

Współrzędne punktu można uzyskać za pomocą Karty Mapy Odkurzacza Xiaomi.

Ustawianie trybu czyszczenia: Ta usługa nie przyjmuje parametru cleaning_mode. Aby dynamicznie ustawić tryb przed rozpoczęciem czyszczenia, zobacz FAQ.

Przykłady

• Czyść wybrany punkt

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

• Czyść kilka punktów

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

• Czyść wybrany punkt dwa razy

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

• Czyść pierwszy punkt dwa razy, drugi punkt trzy razy

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

Idź do Punktu

dreame_vacuum.vacuum_goto

Wyślij robota do pojedynczych współrzędnych na mapie i zatrzymaj go tam.

Uwaga

• Na urządzeniach z funkcją rejsu (odkurzacze z nawigacją lidar i strumieniowaniem obrazu z kamery) uruchamia to zadanie rejs do punktu, a robot robi zdjęcia wokół wybranego punktu po przybyciu. Zadanie jest zapisywane w historii rejsów. (Więcej o mapach historii kursów)
• W przypadku innych urządzeń to samo zachowanie jest emulowane za pomocą małego zadania czyszczenia strefy wokół podanego punktu. Poziom ssania jest ustawiony na cichy, a mopowanie wyłączone dla tego zadania, a robot jest zatrzymywany i poprzednie ustawienia czyszczenia są przywracane przez integrację, gdy tylko dotrze do punktu.
• Poziom baterii musi wynosić co najmniej 15%, a współrzędna musi znajdować się wewnątrz aktualnej mapy.
• Urządzenie nie reaguje na tę akcję, gdy robot już stoi na wybranej współrzędnej, stacja jest w trakcie opróżniania lub stacja prowadzi samonaprawę/testy.

Wskazówka

Współrzędne punktu można uzyskać za pomocą Karty Mapy Odkurzacza Xiaomi.

Przykład

• Przejdź do [819, -2235] i zatrzymaj się

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

Podążaj ścieżką Eksperymentalne

dreame_vacuum.vacuum_follow_path

Rozpocznij zadanie rejsu po ścieżce, które odwiedza podane współrzędne jedna po drugiej i wraca do stacji dokującej.

Ostrzeżenie

Urządzenie jest ograniczone do wykonywania zadań podążania ścieżką tylko wtedy, gdy aktywne jest strumieniowanie na żywo z kamery. W przeciwieństwie do Idź do Punktu, ta usługa jest powiązana z kamerą i należy otworzyć kamerę w oficjalnej aplikacji przed jej wywołaniem. W przeciwnym razie robot całkowicie ignoruje żądanie i nie wykonuje żadnej akcji.

Uwaga

• Ta usługa jest dostępna tylko na urządzeniach z funkcją trybu rejsowego (odkurzacze z nawigacją lidar i strumieniowaniem z kamery).
• Do urządzenia wysyłane są tylko pierwsze 20 punktów, a każda współrzędna musi znajdować się w ramach obecnej mapy.
• Gdy points jest pominięte, używane są zapisane punkty trybu rejsowego z obecnej mapy. Do rozpoczęcia zadania wymagana jest przynajmniej jedna prawidłowa lub zapisana współrzędna.
• Poziom baterii musi wynosić co najmniej 15%, a urządzenie nie reaguje na tę czynność, gdy stacja jest w trybie rozładowywania lub samonaprawy/testu.
• Współrzędne punktu można uzyskać za pomocą Karty Mapy Odkurzacza Xiaomi.

Przykłady

• Podążaj ścieżką składającą się z trzech punktów

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

• Podążaj zapisanymi punktami trybu rejsowego obecnej mapy

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

Uruchom skrót

dreame_vacuum.vacuum_start_shortcut

Rozpocznij zadanie skrótu utworzone w oficjalnej aplikacji.

Uwaga

• Skróty są dostępne tylko na obsługiwanych urządzeniach i można uzyskać identyfikatory skrótów z atrybutu shortcuts encji odkurzacza.
• Ważne identyfikatory skrótów mieszczą się w zakresie od 25 do 128.
• Integracja tworzy również encję przycisku dla każdego skrótu urządzenia jako button.{vacuum_name}_shortcut_{shortcut_id}, dlatego korzystanie z tej usługi zazwyczaj nie jest konieczne.
• Urządzenie nie reaguje na tę akcję, gdy stacja opróżnia lub wykonuje samonaprawę/testy.

Przykład

• Uruchom skrót o identyfikatorze 32

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

Zmień nazwę skrótu

dreame_vacuum.vacuum_rename_shortcut

Ustaw niestandardową nazwę dla skrótu.

Uwaga

• Można uzyskać identyfikatory skrótów z atrybutu shortcuts encji odkurzacza.
• Nazwy skrótów muszą być unikalne. Gdy nowa nazwa jest już używana przez inny skrót, do nazwy dodawany jest licznik, tak jak w oficjalnej aplikacji. (Na przykład: Mopping after sweeping staje się Mopping after sweeping2)
• Nazwa wygenerowanej encji przycisku skrótu odpowiada nazwie skrótu.
• Skróty nie mogą być zmieniane, gdy robot pracuje.

Przykład

• Zmień nazwę skrótu o identyfikatorze 32 na "Mopowanie po zamiataniu"

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

Usuń skrót

dreame_vacuum.vacuum_delete_shortcut

Usuń skrót.

Uwaga

• Można uzyskać identyfikatory skrótów z atrybutu shortcuts encji odkurzacza.
• Jednostka przycisku usuniętego skrótu jest usuwana automatycznie.
• Skrót nie może być usunięty, gdy jego własne zadanie jest w toku.
• Usuniętych skrótów nie można przywrócić i można je tylko ponownie utworzyć w oficjalnej aplikacji.

Przykład

• Usuń skrót o identyfikatorze 34

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

Zainstaluj pakiet głosowy

dreame_vacuum.vacuum_install_voice_pack

Zainstaluj oficjalny pakiet głosowy.

Ustaw sekwencję czyszczenia Wsparcie mapy

dreame_vacuum.vacuum_set_cleaning_sequence

Ustaw sekwencję sprzątania pokoi na aktualnej mapie.

Uwaga

Dokładna liczba identyfikatorów pokoi musi być przekazana jako lista sekwencji

Przykład

• Ustaw sekwencję sprzątania pokoi na aktualnej mapie na 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

• Wyłącz niestandardową sekwencję sprzątania na aktualnej mapie

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

Ustaw czyszczenie niestandardowe Wsparcie mapy

dreame_vacuum.vacuum_set_custom_cleaning

Ustaw niestandardowe parametry sprzątania pokoi na aktualnej mapie.

Uwaga

Ustawienia dla wszystkich pokoi muszą być przekazane jako lista

Przykłady

• Ustaw prędkość wentylatora pokoju 1 na cichą, poziom wody na niski, liczbę cykli sprzątania na 2 oraz prędkość wentylatora pokoju 5 na turbo, poziom wody na średni, liczbę powtórzeń na 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

• Ustaw poziom wilgotności pokoju 3 na 16

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

Zresetuj materiały eksploatacyjne

dreame_vacuum.vacuum_reset_consumable

Zresetuj żywotność materiału eksploatacyjnego według typu.

Możliwe wartości dla materiału eksploatacyjnego

• 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

Przykłady

• Zresetuj żywotność głównej szczotki

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

• Zresetuj żywotność nakładki mopującej

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

Pilot Niezalecane

dreame_vacuum.vacuum_remote_control_move_step

Wyślij polecenie pilota do odkurzacza.

Wyślij polecenie Niezalecane

vacuum.send_command

Usługa wysyłania poleceń może być używana do wysyłania surowych żądań API, które nie są dostępne w tej integracji.

Tylko do użytku eksperymentalnego

Nie zaleca się, aby użytkownicy końcowi korzystali z tej usługi bezpośrednio. Jeśli istnieje akcja wymagająca użycia tej usługi, ponieważ nie została jeszcze zaimplementowana w integracji, prosimy zamiast tego zgłoś żądanie funkcji.

Wskazówka

Więcej informacji o poleceniach i parametrach.

Przykłady

• Rozpocznij automatyczne opróżnianie

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

• Włącz ścisły wzór mopowania i wyłącz wzmocnienie dywanów

  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