Serviços de Mapa

Os serviços de edição de mapas também utilizam o domínio do aspirador porque todos os serviços estão disponíveis mesmo sem ligação à nuvem.

Solicitar mapa

dreame_vacuum.vacuum_request_map

Solicitar ao dispositivo para carregar um novo mapa na nuvem. (Este serviço é útil quando a ligação à nuvem não é utilizada e outra integração é usada para gerir a renderização do mapa)

Importante

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

• Limpeza localizada
• Mapeamento rápido
• A mover-se
• Após uma edição de mapa até se mover

Selecionar mapa

dreame_vacuum.vacuum_select_map

Alterar o mapa selecionado atualmente. (Só é possível se o mapa multi-piso estiver ativado)

Nota

• Pode obter o ID do mapa a partir dos atributos da entidade da câmara do mapa guardado.
• O robô terminará 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

Excluir mapa

dreame_vacuum.vacuum_delete_map

Excluir um mapa.

Nota

• Pode obter o ID do mapa a partir dos atributos da entidade da câmara do mapa guardado.
• Quando a função de mapa multi-piso está ativada, os índices dos mapas podem mudar após a eliminação. (Mais sobre o suporte a mapas multi-piso)

Exemplo

• Definir eliminar 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

• Pode obter o ID do mapa a partir dos atributos da entidade da câmara do mapa guardado.
• A App oficial não permite introduzir caracteres especiais no nome do mapa, mas esta integração permite, por isso utilize 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 de Mapa

dreame_vacuum.vacuum_restore_map

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

Nota

• Não é garantido que a recuperação do mapa tenha êxito. A nuvem não armazena os ficheiros para sempre e os ficheiros de recuperação normalmente são eliminados da nuvem após 365 dias desde o último acesso.

Exemplos

• Restaurar o mapa selecionado para o segundo mapa de recuperação guardado 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 guardado 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 do arquivo

dreame_vacuum.vacuum_restore_map_from_file

Restaurar um mapa a partir de um ficheiro de mapa de recuperação guardado anteriormente.

Nota

• Este serviço pode ser utilizado para recuperação offline se descarregar e colocar o ficheiro do mapa de recuperação na pasta /www/ do Home Assistant (o aspirador e o servidor devem estar na mesma rede).
• O Id do Mapa é obrigatório se a ligação à nuvem não estiver ativada.

Exemplos

• Restaurar o mapa selecionado a partir de um ficheiro de mapa de recuperação guardado

  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 o mapa guardado com id 14 a partir do ficheiro de mapa de recuperação guardado

  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

Mapa de backup

dreame_vacuum.vacuum_backup_map

Iniciar o carregamento de um mapa guardado como mapa de recuperação para a nuvem.

Nota

• A nuvem pode armazenar apenas um mapa de backup para cada mapa guardado. Este serviço substitui o mapa de backup anterior, caso exista.
• Aspiradores sem câmara ou sensor lidar não possuem esta funcionalidade; o acionamento do backup do mapa funciona apenas em dispositivos compatíveis.

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

Salvar mapa temporário

dreame_vacuum.vacuum_save_temporary_map

Guardar mapa recém-criado. (O dispositivo pede que faça isso quando o primeiro mapa é criado após reinício 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

• Pode obter o ID do mapa a partir dos atributos da entidade da câmara do mapa guardado.
• Quando a funcionalidade de mapa multiandar está ativada, os índices do mapa podem mudar após a substituição do mapa. O mapa novo substituído ficará sempre no último índice disponível, mesmo sendo substituído por um mapa com índice inferior. (Mais sobre o suporte a mapas multi-piso)

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

• Pode obter os ids do mapa e do segmento a partir dos atributos da entidade da câmara do mapa guardado.
• A aplicação oficial não permite que introduza caracteres especiais no nome da divisão, mas esta integração permite, por isso utilize este serviço com cuidado.

Exemplo

• Renomeie a divisão 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 de Mapa

dreame_vacuum.vacuum_set_obstacle_ignore

Defina o estado 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á apenas disponível em aspiradores com a funcionalidade de deteção de obstáculos por IA e requer ligação à cloud.
• Pode obter as coordenadas dos obstáculos e o seu estado atual de ignorar a partir do atributo obstacles da entidade da câmara 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 é rejeitada.
• Obstáculos que são automaticamente ignorados pelo dispositivo não podem ser alterados com este serviço.
• O estado de ignorar o obstáculo não pode ser alterado enquanto o robô estiver a funcionar.

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

• Deixar 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 de Mapa

Serviços adicionais de gestão de mapas são disponibilizados pela integração. Vários desses parâmetros (como o tipo de pavimento, a visibilidade da divisão e o tipo de esfregona) já estão expostos e podem ser configurados diretamente através do Entidades de Sala, tornando o uso direto destes serviços desnecessário.

Não destinado a Utilizadores Finais

Estes serviços são estritamente disponibilizados para uso do Cartão Aspirador Dreame. Não possuem parâmetros facilmente acessíveis pelos utilizadores finais. Se forem enviados parâmetros inválidos, estes podem ser transmitidos diretamente para o dispositivo, o que pode resultar em problemas graves, como mapas corrompidos ou o dispositivo entrar num ciclo de arranque. Portanto, estes serviços não devem ser utilizados a menos que a funcionalidade exata e a estrutura dos parâmetros sejam completamente compreendidas. Por motivos de segurança, estes serviços são explicitamente excluídos do services.yaml e não incluem cadeias de tradução.

• Definir Área de Carpete: dreame_vacuum.vacuum_set_carpet_area
• Definir Tipo de Carpete: dreame_vacuum.vacuum_set_carpet_type
• Definir Cortina: dreame_vacuum.vacuum_set_curtain
• Definir Limpeza Personalizada de Carpete: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• Definir Material do Pavimento: dreame_vacuum.vacuum_set_floor_material
• Definir Mobiliário: 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 Mopa: 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 cômodos: dreame_vacuum.vacuum_merge_segments
• Dividir Sala: dreame_vacuum.vacuum_split_segments