FAQ

Esta página reúne as perguntas que surgem repetidamente no Rastreador de issues do GitHub. Verificar aqui antes de abrir um novo issue economiza tempo, pois a maioria não são bugs, mas comportamentos esperados com uma causa documentada.

Pesquisar Issues Existentes

Nenhuma delas? Certifique-se de pesquisar no issues fechadas no GitHub antes de abrir uma nova. Se o problema persistir, a página Relatório de Problemas explica como coletar logs de depuração e abrir um relatório de bug ou solicitação de recurso adequado.

As notificações podem ser enviadas para um telefone?

Mostrar Resposta

Não diretamente. Por padrão, a integração apenas cria notificações persistentes dentro do painel do Home Assistant; eles são não encaminhados automaticamente para o App Home Assistant Companion em um dispositivo móvel, já que isso exige um destino de notificação específico por dispositivo que a integração não possui.

Para recebê-los em um telefone, um automação personalizada deve ser criado que escute os eventos da integração (ou as notificações persistentes geradas) e os encaminhe para o alvo notify do dispositivo móvel.

Mais sobre como configurar quais notificações são geradas

Fotos de Obstáculos / Detecção de IA Não Estão Aparecendo Suporte a Mapas

Mostrar Resposta

Se as imagens de obstáculos permanecerem vazias mesmo com Envio de Imagem de Obstáculo de IA habilitado no aplicativo, e a conta conectada ao Home Assistant for uma conta compartilhada/familiar em vez da conta que originalmente adicionou e possui o dispositivo, a API de nuvem do fabricante pode bloquear silenciosamente o acesso às imagens de obstáculos para essa conta compartilhada. Usar a conta proprietária real, ou verificar se o acesso à câmera foi explicitamente concedido à conta compartilhada dentro do aplicativo, resolve isso na maioria dos casos.

A Câmera do Mapa Pode Ser Transmitida para o HomeKit / Apple Home? Suporte a Mapas

Mostrar Resposta

Não de forma confiável como uma visualização ao vivo. A câmera do mapa transmite em MJPEG genuíno, o mesmo método usado pela própria plataforma de câmeras do Home Assistant, então a imagem de pré-visualização estática no Apple Home exibe corretamente. Um novo quadro só é gerado quando o mapa realmente muda, e a transmissão não produz nada enquanto o aspirador está parado. A visualização ao vivo do HomeKit precisa de uma fonte que se atualize continuamente para permanecer conectada, e o Home Assistant precisa converter o fluxo MJPEG por meio de uma camada adicional antes que o HomeKit possa exibi-lo, já que o HomeKit não aceita MJPEG diretamente. Quando o fluxo do mapa fica silencioso, essa camada de conversão trata a conexão como perdida, e o Home Assistant indica que a câmera não tem fonte de transmissão ou mostra um feed em branco em vez de uma imagem ao vivo.

Isso foi relatado várias vezes. Tentativas usando a plataforma de câmera ffmpeg, go2rtc, e a integração Generic Camera resultam no mesmo: a pré-visualização estática funciona, mas um feed ao vivo continuamente atualizado dentro do HomeKit não funciona. Nenhuma configuração totalmente funcional foi confirmada para esta integração ou para fluxos de mapa de aspiradores similares em outros lugares.

Home Assistant trava, reinicia ou consome muita memória Suporte a Mapas

Mostrar Resposta

A integração renderiza imagens de mapa com resolução total e zoom semelhante ao aplicativo oficial, o que pode usar uma quantidade significativa de memória. Em sistemas com RAM limitada, como um Raspberry Pi, uma pequena VM ou um container limitado a cerca de 2-3GB, isso pode esgotar a memória disponível e fazer com que o Home Assistant congele, reinicie ou não consiga iniciar totalmente, normalmente logo após adicionar um dispositivo com suporte a mapa ou ao abrir a página do dispositivo ou a câmera do mapa.

Solução

Habilite Imagem do Mapa em Baixa Resolução nas opções de configuração do dispositivo. Isso resolve a grande maioria desses casos.

Se ainda assim travar após habilitar essa opção, os próprios dados do mapa podem ter se corrompido ou se tornado anormalmente grandes ao longo do tempo, o que também pode aumentar o uso de memória durante a renderização. Restaurar um mapa mais antigo e saudável de Backup e Recuperação pode resolver isso. Se nenhuma das opções ajudar, reunir logs de depuração e abra um relatório de bug, pois isso aponta para uma causa subjacente diferente.

Integração Não Carrega Após uma Atualização do Home Assistant, Mencionando py_mini_racer Suporte a Mapas

Mostrar Resposta

A integração depende de py-mini-racer, um motor JavaScript usado para otimizar e renderizar mapas para que correspondam ao aplicativo oficial. Essa dependência é instalada pelo próprio Home Assistant, não pela integração, e ocasionalmente falha ao instalar ou falha ao carregar seu binário nativo após uma atualização do Home Assistant Core, particularmente em sistemas baseados em musl (como HAOS em algumas plataformas) ou logo após uma atualização.

Problema de Ambiente

Este é um problema de instalação de ambiente/dependência, não algo que o código da integração possa detectar ou contornar. Ele aparece repetidamente em versões e tipos de instalação do Home Assistant não relacionados.

Reiniciar o Home Assistant (para permitir que ele tente reinstalar as dependências) resolve em alguns casos. Se o problema persistir, verifique o log do Home Assistant na inicialização para o erro real de instalação da dependência pip; esse erro é o que precisa ser resolvido (incluindo como um problema do Home Assistant Core, se parecer uma falha de instalação em nível de plataforma).

Um dispositivo executando Valetudo pode ser usado com esta integração?

Mostrar Resposta

Sim e não. Tecnicamente, não há restrição que impeça a integração de operar junto com Valetudo. O Valetudo não desativa a API local miIO, portanto, o dispositivo pode ser controlado via Conexão Local desde que o token possa ser adquirido. No entanto, os dados do mapa não podem ser recuperados pela API local, e o Valetudo não expõe os dados brutos do mapa via um serviço. Portanto, a integração só pode funcionar sem suporte a mapas.

Sem suporte a mapas, a funcionalidade fornecida por esta integração se torna em grande parte redundante, já que todos os recursos restantes já podem ser utilizados através do nativo Integração Valetudo Home Assistant MQTT.