Servizi Mappa

I servizi di modifica della mappa utilizzano anche il dominio dell'aspirapolvere perché tutti i servizi sono disponibili anche senza connessione al cloud.

Richiedi mappa

dreame_vacuum.vacuum_request_map

Richiedi al dispositivo di caricare una nuova mappa sul cloud. (Questo servizio è utile quando la connessione al cloud non viene utilizzata e un'altra integrazione viene utilizzata per gestire il rendering della mappa)

Importante

Il dispositivo non risponde a questa azione quando:

• Pulizia mirata (Spot)
• Mappatura rapida
• Si sta spostando
• Dopo una modifica della mappa fino a quando non si muove

Seleziona mappa

dreame_vacuum.vacuum_select_map

Cambi la mappa attualmente selezionata. (Possibile solo se è abilitata la mappa a più piani)

Nota

• Puoi ottenere l'id della mappa dagli attributi dell'entità della telecamera della mappa salvata.
• Il robot terminerà il lavoro attivo quando la mappa selezionata viene cambiata.

Esempio

• Imposta la mappa corrente come mappa con id 27

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

Elimina mappa

dreame_vacuum.vacuum_delete_map

Rimuove definitivamente la mappa selezionata dal sistema.

Nota

• Puoi ottenere l'id della mappa dagli attributi dell'entità della telecamera della mappa salvata.
• Quando la funzione di mappa a più piani è abilitata, gli indici delle mappe possono cambiare dopo l'eliminazione. (Ulteriori informazioni sul supporto delle mappe a più piani)

Esempio

• Imposta elimina mappa con id 48

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

Rinomina mappa

dreame_vacuum.vacuum_rename_map

Modifica il nome di una mappa.

Nota

• Puoi ottenere l'id della mappa dagli attributi dell'entità della telecamera della mappa salvata.
• L'App ufficiale non permette di inserire caratteri speciali nel nome della mappa, ma questa integrazione lo permette, quindi usa questo servizio con attenzione.

Esempio

• Rinomina la mappa con id 14 in "Second Floor"

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

Ripristina mappa Supporto Mappa

dreame_vacuum.vacuum_restore_map

Ripristina una mappa dallo stato precedente che è stata creata e caricata dal dispositivo.

Nota

• Non è garantito che il recupero della mappa abbia successo. Il cloud non conserva i file per sempre e i file di recupero di solito vengono eliminati dal cloud dopo 365 giorni dall'ultimo accesso.

Esempi

• Ripristina la mappa selezionata alla seconda mappa di recupero salvata nell'elenco delle mappe di recupero

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

• Ripristina la mappa salvata con id 14 allo stato originale

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

Ripristina mappa da file

dreame_vacuum.vacuum_restore_map_from_file

Ripristina una mappa da un file di mappa di recupero precedentemente salvato.

Nota

• Questo servizio può essere utilizzato per il recupero offline se scarichi e posizioni il file della mappa di recupero nella cartella /www/ di Home Assistant (l'aspirapolvere e il server devono essere nella stessa rete).
• L'id della mappa è richiesto se la connessione al cloud non è abilitata.

Esempi

• Ripristina la mappa selezionata dal file di mappa di recupero salvato

  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

• Ripristina la mappa salvata con id 14 dal file di mappa di recupero salvato

  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

Backup della mappa

dreame_vacuum.vacuum_backup_map

Avvia il caricamento di una mappa salvata come mappa di recupero sul cloud.

Nota

• Il cloud può memorizzare solo una mappa di backup per ciascuna mappa salvata. Questo servizio sovrascriverà la mappa di backup precedente, se presente.
• Gli aspirapolvere senza fotocamera o sensore lidar non hanno questa funzione; il trigger di backup della mappa funziona solo sui dispositivi supportati.

Esempi

• Avvia il backup della mappa selezionata

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

• Avvia il backup della mappa con id 15

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

Salva mappa temporanea

dreame_vacuum.vacuum_save_temporary_map

Salva la mappa appena creata. (Il dispositivo ti chiederà di farlo quando viene creata la prima mappa dopo il reset di fabbrica)

Scarta mappa temporanea

dreame_vacuum.vacuum_discard_temporary_map

Scarta la mappa appena creata.

Sostituisci mappa temporanea

dreame_vacuum.vacuum_replace_temporary_map

Sostituisci la nuova mappa con una vecchia.

Nota

• Puoi ottenere l'id della mappa dagli attributi dell'entità della telecamera della mappa salvata.
• Quando la funzione di mappa multi-piano è abilitata, gli indici delle mappe possono cambiare dopo la sostituzione della mappa. La nuova mappa sostituita sarà sempre all'ultimo indice disponibile, anche se sostituita con una mappa con indice inferiore. (Ulteriori informazioni sul supporto delle mappe a più piani)

Esempio

• Sostituisci la nuova mappa con la mappa con id 39

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

Rinomina stanza

dreame_vacuum.vacuum_rename_segment

Imposta un nome personalizzato per una stanza nella mappa corrente.

Nota

• Puoi ottenere gli id della mappa e dei segmenti dagli attributi dell'entità fotocamera della mappa salvata.
• L'app ufficiale non permette di inserire caratteri speciali nel nome della stanza, ma questa integrazione lo consente, quindi usa questo servizio con attenzione.

Esempio

• Rinomina la stanza 3 in "Sala da pranzo"

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

Configura ostacoli da ignorare Supporto Mappa

dreame_vacuum.vacuum_set_obstacle_ignore

Imposta lo stato di ignoramento di un ostacolo rilevato sulla mappa corrente in modo che il robot non lo eviti nei lavori successivi.

Nota

• Questo servizio è disponibile solo sui robot aspirapolvere con funzione di rilevamento ostacoli AI e richiede una connessione cloud.
• Puoi ottenere le coordinate degli ostacoli e il loro stato di ignoramento corrente dall'attributo obstacles dell'entità della telecamera della mappa corrente. (Maggiori informazioni sugli ostacoli)
• Le coordinate devono corrispondere esattamente a un ostacolo esistente sulla mappa corrente, altrimenti l'azione viene rifiutata.
• Gli ostacoli ignorati automaticamente dal dispositivo non possono essere modificati con questo servizio.
• Lo stato di ignoramento dell'ostacolo non può essere cambiato mentre il robot è in funzione.

Esempi

• Ignora l'ostacolo in [819, -263]

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

• Smetti di ignorare l'ostacolo in [819, -263]

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

Altri servizi Supporto Mappa

Ulteriori servizi di gestione della mappa sono esposti dall'integrazione. Diversi di questi parametri (come il materiale del pavimento, la visibilità della stanza e il tipo di mocio) sono già esposti e possono essere configurati direttamente tramite Entità Stanze, rendendo non necessario l'uso diretto di questi servizi.

Non destinato agli utenti finali

Questi servizi sono strettamente esposti per l'uso di Scheda Aspirapolvere Dreame. Non hanno parametri facilmente accessibili dagli utenti finali. Se vengono inviati parametri non validi, essi possono essere trasferiti direttamente al dispositivo, il che può causare gravi problemi come mappe corrotte o l'ingresso del dispositivo in un loop di avvio. Pertanto, questi servizi non devono essere utilizzati a meno che la funzionalità esatta e la struttura dei parametri non siano pienamente comprese. Per motivi di sicurezza, questi servizi sono esplicitamente esclusi da services.yaml e non includono stringhe di traduzione.

• Imposta area tappeto: dreame_vacuum.vacuum_set_carpet_area
• Imposta tipo di tappeto: dreame_vacuum.vacuum_set_carpet_type
• Imposta tenda: dreame_vacuum.vacuum_set_curtain
• Imposta pulizia tappeto personalizzata: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• Imposta materiale del pavimento: dreame_vacuum.vacuum_set_floor_material
• Imposta mobili: dreame_vacuum.vacuum_set_furniture
• Imposta segmenti nascosti: dreame_vacuum.vacuum_set_hidden_segments
• Imposta Area Bassa: dreame_vacuum.vacuum_set_low_lying_area
• Imposta Tipo di Mop: dreame_vacuum.vacuum_set_mop_type
• Imposta Punti Predefiniti: dreame_vacuum.vacuum_set_predefined_points
• Imposta Zone Restritte: dreame_vacuum.vacuum_set_restricted_zone
• Imposta Posizione del Router: dreame_vacuum.vacuum_set_router_position
• Imposta Tipo di Segmento: dreame_vacuum.vacuum_set_segment_type
• Imposta Soglia: dreame_vacuum.vacuum_set_threshold
• Imposta Soglia Virtuale: dreame_vacuum.vacuum_set_virtual_threshold
• Imposta Muri: dreame_vacuum.vacuum_set_walls
• Unisci stanze: dreame_vacuum.vacuum_merge_segments
• Dividi Stanza: dreame_vacuum.vacuum_split_segments