Serviços de Mapas

Serviços de edição de mapa também usam o domínio do aspirador porque todos os serviços estão disponíveis mesmo sem conexão com a nuvem.

Solicitar mapa

dreame_vacuum.vacuum_request_map

Solicitar ao dispositivo para enviar um novo mapa para a nuvem. (Este serviço é útil quando a conexão com a nuvem não é usada e outra integração é utilizada para renderização do mapa)

Importante

O dispositivo não responde a esta ação quando:

• Limpeza localizada
• Mapeamento rápido
• Realizando relocação
• Após uma edição de mapa até que ele se mova

Selecionar mapa

dreame_vacuum.vacuum_select_map

Alterar o mapa atualmente selecionado. (Somente possível se o mapa de vários andares estiver habilitado)

Nota

• Você pode obter o ID do mapa a partir dos atributos da entidade da câmera do mapa salvo.
• O robô encerrará o trabalho ativo quando o mapa selecionado for alterado.

Exemplo

• Definir o mapa atual como o mapa com ID 27

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

Eliminar mapa

dreame_vacuum.vacuum_delete_map

Eliminar um mapa.

Nota

• Você pode obter o ID do mapa a partir dos atributos da entidade da câmera do mapa salvo.
• Quando o recurso de mapa de vários andares estiver habilitado, os índices dos mapas podem mudar após a exclusão. (Mais sobre suporte a mapas de vários andares)

Exemplo

• Definir exclusão do mapa com ID 48

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

Renomear mapa

dreame_vacuum.vacuum_rename_map

Renomear um mapa.

Nota

• Você pode obter o ID do mapa a partir dos atributos da entidade da câmera do mapa salvo.
• O App Oficial não permite que você insira caracteres especiais no nome do mapa, mas esta integração permite, então use este serviço com cuidado.

Exemplo

• Renomear o mapa com id 14 para "Segundo Andar"

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

Restaurar mapa Suporte a Mapas

dreame_vacuum.vacuum_restore_map

Restaurar um mapa a partir do estado anterior que foi criado e enviado pelo dispositivo.

Nota

• Não é garantido que a recuperação do mapa seja bem-sucedida. A nuvem não armazena os arquivos para sempre e os arquivos de recuperação geralmente são excluídos da nuvem após 365 dias do último acesso.

Exemplos

• Restaurar o mapa selecionado para o segundo mapa de recuperação salvo na lista de mapas de recuperação

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

• Restaurar o mapa salvo com id 14 para o estado original

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

Restaurar mapa a partir de ficheiro

dreame_vacuum.vacuum_restore_map_from_file

Restaurar um mapa a partir de um arquivo de mapa de recuperação previamente salvo.

Nota

• Este serviço pode ser usado para recuperação offline se você baixar e colocar o arquivo do mapa de recuperação na pasta /www/ do Home Assistant (o robô e o servidor devem estar na mesma rede).
• O Id do mapa é necessário se a conexão com a nuvem não estiver habilitada.

Exemplos

• Restaurar o mapa selecionado a partir de arquivo de mapa de recuperação salvo

  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

• Restaurar mapa salvo com id 14 a partir de arquivo de mapa de recuperação salvo

  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

Cópia de segurança do mapa

dreame_vacuum.vacuum_backup_map

Disparar o envio de um mapa salvo como mapa de recuperação para a nuvem.

Nota

• A nuvem pode armazenar apenas um mapa de backup para cada mapa salvo. Este serviço substituirá o mapa de backup anterior, caso você tenha um.
• Aspiradores sem câmera ou sensor lidar não possuem este recurso; o acionamento do backup do mapa funciona apenas em dispositivos suportados.

Exemplos

• Acionar backup do mapa selecionado

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

• Acionar backup do mapa com id 15

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

Guardar mapa temporário

dreame_vacuum.vacuum_save_temporary_map

Salvar mapa recém-criado. (O dispositivo pedirá que você faça isso quando o primeiro mapa for criado após o reset de fábrica)

Descartar mapa temporário

dreame_vacuum.vacuum_discard_temporary_map

Descartar mapa recém-criado.

Substituir mapa temporário

dreame_vacuum.vacuum_replace_temporary_map

Substituir mapa novo por um antigo.

Nota

• Você pode obter o ID do mapa a partir dos atributos da entidade da câmera do mapa salvo.
• Quando o recurso de mapa multiandar estiver habilitado, os índices do mapa podem mudar após a substituição do mapa. O mapa novo substituído sempre estará no último índice disponível, mesmo sendo substituído por um mapa com índice menor. (Mais sobre suporte a mapas de vários andares)

Exemplo

• Substituir mapa novo pelo mapa com id 39

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

Renomear Sala

dreame_vacuum.vacuum_rename_segment

Definir nome personalizado para uma sala no mapa atual.

Nota

• Você pode obter os ids do mapa e do segmento a partir dos atributos da entidade de câmera do mapa salvo.
• O aplicativo oficial não permite que você insira caracteres especiais no nome da sala, mas esta integração permite, então use este serviço com cuidado.

Exemplo

• Renomeie a sala 3 para "Sala de Jantar"

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

Definir ignorar obstáculo Suporte a Mapas

dreame_vacuum.vacuum_set_obstacle_ignore

Defina o status de ignorar de um obstáculo detectado no mapa atual para que o robô não o evite nos trabalhos seguintes.

Nota

• Este serviço está disponível apenas em aspiradores com recurso de detecção de obstáculos por IA e requer conexão com a nuvem.
• Você pode obter as coordenadas dos obstáculos e seu status atual de ignorar a partir do atributo obstacles da entidade da câmera do mapa atual. (Mais sobre obstáculos)
• As coordenadas devem corresponder exatamente a um obstáculo existente no mapa atual, caso contrário, a ação será rejeitada.
• Obstáculos que são automaticamente ignorados pelo dispositivo não podem ser alterados com este serviço.
• O status de ignorar obstáculo não pode ser alterado enquanto o robô estiver em operação.

Exemplos

• Ignorar o obstáculo em [819, -263]

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

• Parar de ignorar o obstáculo em [819, -263]

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

Outros Serviços Suporte a Mapas

Serviços adicionais de gerenciamento de mapas são expostos pela integração. Vários desses parâmetros (como material do piso, visibilidade do cômodo e tipo de esfregão) já estão expostos e podem ser configurados diretamente através do Entidades de Sala, tornando o uso direto desses serviços desnecessário.

Não destinado a Usuários Finais

Esses serviços são estritamente expostos para uso do Cartão de Aspirador Dreame. Eles não possuem parâmetros facilmente acessíveis pelos usuários finais. Se parâmetros inválidos forem enviados, eles podem ser passados diretamente para o dispositivo, o que pode resultar em problemas graves, como mapas corrompidos ou o dispositivo entrando em loop de inicialização. Portanto, esses serviços não devem ser usados a menos que a funcionalidade exata e a estrutura de parâmetros sejam totalmente compreendidas. Por razões de segurança, esses serviços são explicitamente excluídos do services.yaml e não incluem strings de tradução.

• Definir Área de Tapete: dreame_vacuum.vacuum_set_carpet_area
• Definir Tipo de Tapete: dreame_vacuum.vacuum_set_carpet_type
• Definir Cortina: dreame_vacuum.vacuum_set_curtain
• Definir Limpeza Personalizada de Tapete: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• Definir Material do Piso: dreame_vacuum.vacuum_set_floor_material
• Definir Móveis: dreame_vacuum.vacuum_set_furniture
• Definir Segmentos Ocultos: dreame_vacuum.vacuum_set_hidden_segments
• Definir Área Baixa: dreame_vacuum.vacuum_set_low_lying_area
• Definir Tipo de Esfregão: dreame_vacuum.vacuum_set_mop_type
• Definir Pontos Predefinidos: dreame_vacuum.vacuum_set_predefined_points
• Definir Zonas Restritas: dreame_vacuum.vacuum_set_restricted_zone
• Definir Posição do Roteador: dreame_vacuum.vacuum_set_router_position
• Definir Tipo de Segmento: dreame_vacuum.vacuum_set_segment_type
• Definir Limite: dreame_vacuum.vacuum_set_threshold
• Definir Limite Virtual: dreame_vacuum.vacuum_set_virtual_threshold
• Definir Paredes: dreame_vacuum.vacuum_set_walls
• Mesclar quartos: dreame_vacuum.vacuum_merge_segments
• Dividir Sala: dreame_vacuum.vacuum_split_segments