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 poupa tempo, uma vez que a maioria destes não são erros, mas comportamentos esperados com uma causa documentada.

Pesquisar Issues Existentes

Nenhum destes? Certifique-se de pesquisar no issues fechados no GitHub antes de abrir um novo. Se o problema persistir, a página Reportar Problema explica como reunir logs de depuração e abrir um relatório de bug ou pedido de funcionalidade adequado.

É Possível Enviar Notificações para um Telemóvel?

Mostrar Resposta

Não diretamente. Por defeito, a integração apenas cria notificações persistentes dentro do painel do Home Assistant; elas não são automaticamente enviadas para a App Home Assistant no dispositivo móvel, dado que isso requer um alvo de notificação específico por dispositivo que a integração não possui.

Para os receber num telemóvel, deve ser criado um automação personalizada 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 a Aparecer Suporte de Mapa

Mostrar Resposta

Se as imagens de obstáculos permanecerem vazias mesmo com Carregamento de Imagem de Obstáculo de IA ativado na app, e a conta ligada ao Home Assistant for uma conta partilhada/familiar em vez da conta que originalmente adicionou e possui o dispositivo, a API da nuvem do fabricante pode bloquear silenciosamente o acesso às imagens de obstáculos para essa conta partilhada. Usar a conta que realmente possui o dispositivo, ou verificar se o acesso da câmera foi explicitamente concedido à conta partilhada dentro da app, resolve isto na maioria dos casos.

É possível transmitir a Câmara do Mapa para o HomeKit / Apple Home? Suporte de Mapa

Mostrar Resposta

Não de forma fiável como uma visualização em direto. A câmara do mapa transmite como MJPEG genuíno, o mesmo método que a própria plataforma de câmaras do Home Assistant usa, pelo que a imagem de pré-visualização estática na Apple Home é exibida corretamente. Um novo frame só é gerado quando o mapa realmente muda, e a transmissão não produz nada enquanto o aspirador está inativo. A visualização em direto do HomeKit precisa de uma fonte que se atualize continuamente para se manter ligada, e o Home Assistant tem de converter o fluxo MJPEG através de uma camada adicional antes de o HomeKit poder exibí-lo de todo, uma vez que o HomeKit não aceita MJPEG diretamente. Quando a transmissão do mapa fica em silêncio, essa camada de conversão trata a ligação como perdida, e o Home Assistant reporta que a câmara não tem fonte de transmissão ou mostra um feed em branco em vez de uma imagem em direto.

Isto foi reportado múltiplas vezes. Tentativas com a plataforma de câmeras ffmpeg, go2rtc, e a integração Generic Camera produzem todas o mesmo resultado: a pré-visualização estática funciona, mas um feed contínuo em tempo real dentro do HomeKit não funciona. Nenhuma configuração totalmente funcional foi confirmada para esta integração ou para fluxos de mapas de aspiradores semelhantes noutros locais.

O Home Assistant Bloqueia, Reinicia ou Usa Muito Memória Suporte de Mapa

Mostrar Resposta

A integração gera imagens de mapas ampliáveis e em resolução total semelhantes à aplicação oficial, o que pode utilizar uma quantidade significativa de memória. Em sistemas com RAM limitada, como um Raspberry Pi, uma pequena VM ou um container com cerca de 2-3GB, isto pode esgotar a memória disponível e causar bloqueios, reinícios ou falha total de arranque do Home Assistant, normalmente logo após adicionar um dispositivo com suporte a mapas ou ao abrir a página do dispositivo ou a câmera do mapa.

Solução

Ative Imagem de Mapa de Baixa Resolução nas opções de configuração do dispositivo. Isto resolve a grande maioria destes casos.

Se continuar a falhar após ativar essa opção, os próprios dados do mapa podem ter ficado corrompidos ou 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 nenhum dos métodos ajudar, reunir logs de depuração e abra um relatório de bug, pois isso indica uma causa subjacente diferente.

A Integração Não Carrega Após uma Atualização do Home Assistant, Mencionando py_mini_racer Suporte de Mapa

Mostrar Resposta

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

Problema de Ambiente

Isto é um problema de instalação de ambiente/dependências, não algo que o código da integração possa detetar ou contornar. Aparece repetidamente em diversas versões não relacionadas do Home Assistant e tipos de instalação.

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

É Possível Usar um Dispositivo a Executar Valetudo com esta Integração?

Mostrar Resposta

Sim e não. Tecnicamente, não há qualquer restrição que impeça a integração de funcionar em conjunto com Valetudo. O Valetudo não desativa a API miIO local, pelo que o dispositivo pode ser controlado via Ligação Local desde que o token possa ser obtido. No entanto, os dados do mapa não podem ser recuperados através da API local, e o Valetudo não expõe dados brutos do mapa através de 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 torna-se largamente redundante, uma vez que todas as características restantes já podem ser utilizadas através da nativa Integração Valetudo com Home Assistant via MQTT.