Servizi Aspirapolvere

L'integrazione espone vari servizi personalizzati per azioni avanzate e funzionalità che non sono direttamente controllabili tramite entità standard. Questi servizi personalizzati utilizzano il dominio vacuum e forniscono un controllo dettagliato sulle funzionalità specifiche del dispositivo.

Pulisci la stanza

dreame_vacuum.vacuum_clean_segment

Avvia la pulizia della stanza selezionata con parametri di pulizia personalizzati opzionali.

Nota

• Se stai utilizzando l'integrazione con la funzione mappa, puoi acquisire gli ID dei segmenti dagli attributi dell'entità del robot aspirapolvere.
• I parametri di pulizia e la sequenza di pulizia vengono ignorati dal dispositivo quando customized_cleaning o cleaning_sequence sono abilitati.

Impostare la modalità di pulizia

Questo servizio non accetta un parametro cleaning_mode. Per impostare la modalità dinamicamente prima di avviare la pulizia, consulta FAQ.

Esempi

• Pulisci la stanza 3

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

• Pulisci le stanze 3 e 5

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

• Pulisci le stanze 3 e 5 due volte

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

• Pulisci la stanza 2 due volte e la 5 una volta

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

• Pulisci le stanze 3 e 5 con alta velocità della ventola

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

• Pulisci la stanza 3 con alta velocità della ventola e la 5 con bassa velocità della ventola

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

Pulizia zona

dreame_vacuum.vacuum_clean_zone

Avvia la pulizia della zona selezionata con parametri di pulizia personalizzati opzionali.

Suggerimento

Puoi ottenere le coordinate della zona con Scheda Mappa Aspirapolvere Xiaomi.

Impostare la modalità di pulizia: Questo servizio non accetta un parametro cleaning_mode. Per impostare la modalità dinamicamente prima di avviare la pulizia, consulta il FAQ.

Esempi

• Pulisci la zona selezionata

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

• Pulisci più zone

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

• Pulisci la zona selezionata due volte

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

• Pulisci la prima zona due volte e la seconda zona tre volte

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

Pulizia punto singolo (Spot)

dreame_vacuum.vacuum_clean_spot

Avvia la pulizia del punto selezionato con parametri di pulizia personalizzati opzionali.

Nota

La funzione di pulizia mirata è disponibile solo per robot a marchio Xiaomi/Mijia, ma funziona anche con i dispositivi Dreame.

Suggerimento

Puoi ottenere le coordinate del punto con Scheda Mappa Aspirapolvere Xiaomi.

Impostare la modalità di pulizia: Questo servizio non accetta un parametro cleaning_mode. Per impostare la modalità dinamicamente prima di avviare la pulizia, consulta il FAQ.

Esempi

• Pulisci il punto selezionato

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

• Pulisci più punti

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

• Pulisci il punto selezionato due volte

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

• Pulisci il primo punto due volte e il secondo punto tre volte

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

Vai al Punto

dreame_vacuum.vacuum_goto

Invia il robot a una singola coordinata sulla mappa e fermalo lì.

Nota

• Sui dispositivi con la funzione di crociera (aspirapolvere con navigazione lidar e streaming della fotocamera) questo avvia un lavoro di crociere verso punto e il robot scatta foto intorno al punto di destinazione quando arriva. Il lavoro viene memorizzato nella cronologia della crociera. (Maggiori informazioni sulle mappe della cronologia di navigazione)
• Su altri dispositivi lo stesso comportamento viene emulato con un piccolo lavoro di pulizia a zona intorno al punto dato. Il livello di aspirazione è impostato su silenzioso e la funzione di lavaggio è disabilitata per quel lavoro, e il robot viene fermato e le impostazioni di pulizia precedenti vengono ripristinate dall'integrazione non appena raggiunge il punto.
• Il livello della batteria deve essere almeno del 15% e le coordinate devono essere all'interno della mappa corrente.
• Il dispositivo non risponde a questa azione quando il robot si trova già sulla coordinata selezionata, la stazione si sta svuotando o la stazione si sta auto-riparando/testando.

Suggerimento

Puoi ottenere le coordinate del punto con Scheda Mappa Aspirapolvere Xiaomi.

Esempio

• Vai a [819, -2235] e fermati

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

Segui percorso Sperimentale

dreame_vacuum.vacuum_follow_path

Avvia un lavoro di percorso di crociera che visita le coordinate indicate una per una e ritorna alla stazione di ricarica.

Avvertenza

Il dispositivo è limitato a eseguire solo compiti di seguire il percorso mentre lo streaming della telecamera è attivo. A differenza di Vai al Punto, questo servizio è legato alla telecamera e devi aprire la telecamera dall'App ufficiale prima di chiamarlo. Altrimenti il robot ignora completamente la richiesta e non fa nulla.

Nota

• Questo servizio è disponibile solo sui dispositivi con la funzione di navigazione (aspirapolvere con navigazione lidar e streaming della telecamera).
• Solo i primi 20 punti vengono inviati al dispositivo e ogni coordinata deve essere all'interno della mappa corrente.
• Quando points è omesso, vengono utilizzati i punti di crociera salvati della mappa corrente. È richiesta almeno una coordinata valida o salvata per avviare il lavoro.
• Il livello della batteria deve essere almeno del 15% e il dispositivo non risponde a questa azione mentre la stazione si sta scaricando o autoriaggiustando/testando.
• Puoi ottenere le coordinate del punto con Scheda Mappa Aspirapolvere Xiaomi.

Esempi

• Seguire un percorso di tre punti

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

• Seguire i punti di crociera salvati della mappa corrente

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

Avvia scorciatoia

dreame_vacuum.vacuum_start_shortcut

Avviare un compito rapido creato sull'App ufficiale.

Nota

• Le scorciatoie sono disponibili solo sui dispositivi supportati e puoi ottenere gli ID delle scorciatoie dall'attributo shortcuts dell'entità aspirapolvere.
• Gli ID delle scorciatoie validi sono compresi tra 25 e 128.
• L'integrazione crea anche un'entità pulsante per ogni scorciatoia del dispositivo come button.{vacuum_name}_shortcut_{shortcut_id}, quindi l'uso di questo servizio di solito non è necessario.
• Il dispositivo non risponde a questa azione mentre la stazione si sta scaricando o sta eseguendo autodiagnosi/test di auto-riparazione.

Esempio

• Avvia scorciatoia con ID 32

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

Rinomina scorciatoia

dreame_vacuum.vacuum_rename_shortcut

Imposta un nome personalizzato per una scorciatoia.

Nota

• Puoi ottenere gli ID delle scorciatoie dall'attributo shortcuts dell'entità aspirapolvere.
• I nomi delle scorciatoie devono essere unici. Quando il nuovo nome è già utilizzato da un'altra scorciatoia, gli viene aggiunto un contatore come fa l'app ufficiale. (Per esempio: Mopping after sweeping diventa Mopping after sweeping2)
• Il nome dell'entità pulsante della scorciatoia generata segue il nome della scorciatoia.
• Le scorciatoie non possono essere rinominate mentre il robot è in funzione.

Esempio

• Rinomina la scorciatoia con ID 32 in "Mop dopo spazzatura"

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

Elimina scorciatoia

dreame_vacuum.vacuum_delete_shortcut

Elimina una scorciatoia.

Nota

• Puoi ottenere gli ID delle scorciatoie dall'attributo shortcuts dell'entità aspirapolvere.
• L'entità del pulsante della scorciatoia eliminata viene rimossa automaticamente.
• Una scorciatoia non può essere eliminata mentre il suo compito è in esecuzione.
• Le scorciatoie eliminate non possono essere ripristinate e possono essere ricreate solo dall'App ufficiale.

Esempio

• Elimina la scorciatoia con id 34

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

Installa pacchetto vocale

dreame_vacuum.vacuum_install_voice_pack

Installa un pacchetto vocale ufficiale.

Imposta sequenza di pulizia Supporto Mappa

dreame_vacuum.vacuum_set_cleaning_sequence

Imposta la sequenza di pulizia delle stanze sulla mappa corrente.

Nota

Deve essere passato il numero esatto di ID delle stanze come lista di sequenza

Esempio

• Imposta la sequenza di pulizia delle stanze sulla mappa corrente su 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

• Disabilita la sequenza di pulizia personalizzata sulla mappa corrente

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

Imposta pulizia personalizzata Supporto Mappa

dreame_vacuum.vacuum_set_custom_cleaning

Imposta i parametri di pulizia personalizzati delle stanze sulla mappa corrente.

Nota

Le impostazioni per tutte le stanze devono essere passate come lista

Esempi

• Imposta la velocità della ventola della stanza 1 a silenzioso, il livello dell'acqua a basso, i tempi di pulizia a 2 e la velocità della ventola della stanza 5 a turbo, il livello dell'acqua a medio, i ripetizioni a 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

• Imposta il livello di umidità della stanza 3 su 16

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

Ripristina usura consumabili

dreame_vacuum.vacuum_reset_consumable

Reimposta la durata di un consumabile per tipo.

Valori possibili per il consumabile

• 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

Esempi

• Reimposta la durata della spazzola principale

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

• Reimposta la durata del panno mop

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

Telecomando Non Raccomandato

dreame_vacuum.vacuum_remote_control_move_step

Invia un comando del telecomando all'aspirapolvere.

Invia comando Non Raccomandato

vacuum.send_command

Il servizio di invio comandi può essere utilizzato per inviare richieste API grezze non disponibili con questa integrazione.

Solo per uso sperimentale

Non è consigliato agli utenti finali utilizzare direttamente questo servizio. Se c'è un'azione che richiede l'uso di questo servizio perché non ancora implementata nell'integrazione, si prega di apri una richiesta di funzionalità invece.

Suggerimento

Maggiori informazioni su comandi e parametri.

Esempi

• Avvia lo svuotamento automatico

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

• Abilita il modello di lavaggio stretto e disabilita l'incremento tappeto

  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