Preguntes Freqüents

Aquesta pàgina recull les preguntes que surten repetidament al Rastrejador d'incidències de GitHub. Comprovar aquí abans d'obrir una nova incidència estalvia temps, ja que la majoria no són errors sinó comportaments esperats amb una causa documentada.

Cerca incidències existents

Cap d'aquestes? Assegura't de cercar al incidències tancades a GitHub abans d'obrir-ne una de nova. Si el problema persisteix, la pàgina Reportar Problemes explica com recopilar registres de depuració i obrir un informe d'error o una sol·licitud de funció adequada.

Es poden enviar notificacions a un telèfon?

Mostra la resposta

No directament. Per defecte, la integració només crea notificacions persistents dins el tauler de Home Assistant; aquestes no es transmeten automàticament a l'App Home Assistant Companion en un dispositiu mòbil, ja que això requereix un objectiu de notificació específic per a cada dispositiu que la integració no té.

Per rebre-les en un telèfon, s'ha de crear un automació personalitzada que escolti els esdeveniments de la integració (o les notificacions persistents generades) i els reenviï a l'objectiu notify per al dispositiu mòbil.

Més informació sobre com configurar quines notificacions es generen

No es mostren Fotos d'Obstacles / Detecció d'IA Suport de Mapes

Mostra la resposta

Si les imatges d'obstacles continuen buides fins i tot amb Carregar Imatges d'Obstacles d'IA habilitat a l'aplicació, i el compte connectat a Home Assistant és un compte compartit/familiar en lloc del compte que originalment va afegir i posseeix el dispositiu, l'API del núvol del fabricant pot bloquejar silenciosament l'accés a les imatges d'obstacles per a aquest compte compartit. Fer servir el compte real propietari, o comprovar que l'accés a la càmera s'ha concedit explícitament al compte compartit dins l'aplicació, resol la situació en la majoria de casos.

Es pot retransmetre la càmera del mapa a HomeKit / Apple Home? Suport de Mapes

Mostra la resposta

No de manera fiable com a visualització en directe. La càmera del mapa transmet en MJPEG genuí, el mateix mètode que utilitza la plataforma de càmeres de Home Assistant, de manera que la imatge de vista prèvia estàtica a Apple Home es mostra correctament. Només es genera un nou fotograma quan el mapa realment canvia, i la transmissió no produeix res mentre l’aspirador està inactiu. La visualització en directe de HomeKit necessita una font que es refresqui contínuament per mantenir la connexió, i Home Assistant ha de convertir el flux MJPEG a través d’una capa addicional abans que HomeKit el pugui mostrar, ja que HomeKit no accepta MJPEG directament. Quan la transmissió del mapa queda en silenci, aquesta capa de conversió tracta la connexió com a perduda, i Home Assistant informa que la càmera no té cap font de transmissió o mostra una alimentació en blanc en lloc d’una imatge en directe.

Això s'ha informat diverses vegades. Els intents utilitzant la plataforma de càmera ffmpeg, go2rtc, i la integració de Càmera Genèrica produeixen tots el mateix resultat: la vista prèvias estàtica funciona, però un flux en directe que s’actualitza contínuament dins de HomeKit no. No s’ha confirmat cap configuració completament funcional per a aquesta integració ni per a fluxos de mapa de robots similars en altres llocs.

Home Assistant es bloqueja, es reinicia o utilitza molta memòria Suport de Mapes

Mostra la resposta

La integració renderitza imatges de mapa a tot color i amb zoom similars a l’aplicació oficial, cosa que pot utilitzar una quantitat significativa de memòria. En sistemes amb RAM limitada, com un Raspberry Pi, una petita VM o un contenidor limitat a uns 2-3GB, això pot esgotar la memòria disponible i fer que Home Assistant es bloquegi, es reiniciï o no es pugui iniciar del tot, normalment just després d’afegir un dispositiu amb suport de mapa o quan s’obre la seva pàgina de dispositiu o la càmera de mapa.

Solució

Activa Imatge de Mapa de Baixa Resolució a les opcions de configuració del dispositiu. Això resol la gran majoria d’aquests casos.

Si encara falla després d'habilitar aquesta opció, les dades del mapa poden haver-se corromput o esdevenir inhabitualment grans amb el temps, cosa que també pot augmentar l'ús de memòria durant el renderitzat. Restaurar un mapa antic i en bon estat des de Còpia de seguretat i recuperació pot resoldre-ho. Si cap de les dues opcions ajuda, recopilar registres de depuració i obrir un informe d'error, ja que això indica una causa subjacent diferent.

La integració no es carrega després d'una actualització de Home Assistant, mencionant py_mini_racer Suport de Mapes

Mostra la resposta

La integració depèn de py-mini-racer, un motor de JavaScript utilitzat per optimitzar i renderitzar mapes perquè coincideixin amb l'aplicació oficial. Aquesta dependència és instal·lada per Home Assistant mateix, no per la integració, i ocasionalment falla a instal·lar-se o no es carrega el seu binari nadiu després d'una actualització de Home Assistant Core, particularment en sistemes basats en musl (com HAOS en algunes plataformes) o just després d'una actualització.

Problema d'entorn

Aquest és un problema d’instal·lació d’entorn/dependències, no pas alguna cosa que el codi de la integració pugui detectar o evitar. Apareix repetidament en versions i tipus d’instal·lació de Home Assistant que no estan relacionats.

Reiniciar Home Assistant (per permetre que torni a intentar instal·lar les dependències) el resol en alguns casos. Si persisteix, consulteu el registre de Home Assistant durant l’inici per l’error real d’instal·lació de pip/dependències; aquest és l’error que cal resoldre (inclosos els casos com a problema de Home Assistant Core, si sembla un error d’instal·lació a nivell de plataforma).

Es pot fer servir un dispositiu amb Valetudo amb aquesta integració?

Mostra la resposta

Sí i no. Tècnicament, no hi ha cap restricció que impedeixi que la integració funcioni al costat de Valetudo. Valetudo no desactiva l'API local miIO, així que el dispositiu es pot controlar a través de Connexió local sempre que es pugui obtenir el token. No obstant això, les dades del mapa no es poden recuperar mitjançant l'API local, i Valetudo no exposa dades de mapa en brut a través d'un servei. Per tant, la integració només pot funcionar sense suport de mapa.

Sense suport de mapa, la funcionalitat proporcionada per aquesta integració esdevé en gran part redundant, ja que totes les funcions restants ja es poden utilitzar a través de la nativa Integració de Valetudo Home Assistant MQTT.