Entidades de Mapa Suporte a Mapas

A integração expõe automaticamente uma variedade de entidades dedicadas à visualização e gerenciamento de mapas. Isso inclui entidades de câmera dinâmica para renderização de mapas ao vivo e salvos, entidades de seleção para gerenciar layouts de vários andares e rotação de mapas, entidades de botão para acionar novas tarefas de mapeamento e entidades de sensor que fornecem dados históricos e rastreamento atual de quartos.

A disponibilidade dessas entidades depende das capacidades de suporte a mapas do dispositivo e do método de conexão ativo.

Suporte a mapas de vários andares

Até três mapas salvos com entidades de câmera geradas automaticamente e entidades de seleção para gerenciamento de mapas de vários andares.

Nota

Mapas salvos usam [original map id][version] como seu formato map_id (por exemplo, 46). Por causa disso, os IDs de mapas estão constantemente mudando e não podem ser usados em IDs de entidades. Em vez disso, entidades de câmera de mapa usam um sistema de indexação. Os índices de mapa são criados a partir da lista de mapas salvos ordenada pelo ID do mapa e usados para nomear mapas sem nomes personalizados. Portanto, quando map_2 é removido da lista, map_3 será excluído em vez disso e map_3 se tornará map_2 (exatamente como é feito no aplicativo oficial). Se o mapa de múltiplos andares estiver desativado quando existir mais de um mapa salvo, map_1 sempre se tornará o mapa selecionado em vez de outros mapas serem deletados.

Câmera

Nome	Descrição	Notas
map	Mapa ao vivo	Imagem do mapa ao vivo
map_data	Dados do mapa ao vivo para o valetudo-card	Desativado por padrão
map_1	Primeiro mapa salvo	Mapa salvo no índice 1
map_2	Segundo mapa salvo	Mapa salvo no índice 2, disponível se o mapa de múltiplos andares estiver habilitado e houver pelo menos dois mapas salvos na lista de mapas
map_3	Terceiro mapa salvo	Mapa salvo no índice 3, disponível se o mapa de múltiplos andares estiver habilitado e houver pelo menos três mapas salvos na lista de mapas
map_4	Quarto mapa salvo	Mapa salvo no índice 4, disponível se o mapa de vários andares estiver ativado e houver pelo menos quatro mapas salvos na lista de mapas (disponível apenas em aspiradores com mapa WiFi)
wifi_map_1	Mapa WiFi do primeiro mapa salvo	Disponível em aspiradores com mapa WiFi
wifi_map_2	Mapa WiFi do segundo mapa salvo	Disponível em aspiradores com mapa WiFi
wifi_map_3	Mapa WiFi do terceiro mapa salvo	Disponível em aspiradores com mapa WiFi
wifi_map_4	Mapa WiFi do quarto mapa salvo	Disponível em aspiradores com mapa WiFi

Entidades da câmera estão disponíveis apenas ao usar uma conexão com a nuvem. Todas as entidades de câmera operam com uma taxa de atualização dinâmica determinada pelo tempo da última solicitação e pelo estado atual do dispositivo. Um mapa é renderizado apenas quando uma solicitação de imagem é feita, e apenas as áreas modificadas da imagem são atualizadas.

Os nomes das câmeras dos mapas salvos são gerados dinamicamente com base no índice ou nome personalizado. Para configurações de vários andares, as entidades de mapas salvos utilizam um sistema de indexação em vez de um ID de mapa. Mais informações

O mapa ao vivo não pode ser editado diretamente; após a edição, o mapa salvo é renderizado até que o robô inicie uma nova tarefa de limpeza.

Nota

A entidade map_1 sempre renderiza o mapa salvo do mapa atualmente selecionado quando o recurso de mapa de múltiplos andares está desativado.

Para mais informações sobre o recurso de mapas

Botão

Nome	Descrição	Notas
start_fast_mapping	Iniciar mapeamento rápido	Indisponível quando o número máximo de mapas é atingido
start_mapping	Criar novo mapa limpando todo o andar	Indisponível quando o número máximo de mapas é atingido
backup_saved_map	Criar um backup do mapa atualmente salvo	Disponível em dispositivos com recurso de backup de mapa

Selecionar

Nome	Descrição	Notas
map_rotation	Define a rotação do mapa selecionado	Disponível com o recurso de mapas. Indisponível quando o mapa atual não é um dos mapas selecionados (Diferentes rotações de mapas podem ser configuradas para mapas salvos, mas apenas o mapa selecionado pode ser editado por meio desta entidade)
selected_map	Mapa atualmente selecionado	Disponível com o recurso de mapas. Indisponível quando o mapa de múltiplos andares está desativado ou indisponível (O robô encerrará o trabalho ativo quando o mapa selecionado for alterado)

Selecionar Entidades para Salas

As entidades de seleção de sala são geradas dinamicamente a partir dos mapas salvos e são usadas para editar as configurações de limpeza personalizadas por sala.

Para mais informações sobre o recurso de limpeza personalizada

Sensor

Nome	Descrição	Notas
cleaning_history	Detalhes do trabalho de limpeza anterior como atributos	Disponível com recurso de mapa
cruising_history	Detalhes do trabalho de patrulha anterior como atributos	Disponível com recurso de mapa
current_room	Sala atual em que o aspirador está	Disponível com recurso de mapa