FAQ

Deze pagina verzamelt de vragen die herhaaldelijk op de GitHub issue-tracker voorkomen. Hier controleren voordat je een nieuw issue opent, bespaart tijd, omdat de meeste hiervan geen bugs zijn maar verwachte gedragingen met een gedocumenteerde oorzaak.

Bestaande issues zoeken

Geen van deze? Zorg ervoor dat je de gesloten issues op GitHub doorzoekt voordat je een nieuwe opent. Als het probleem aanhoudt, legt de Probleem Rapportage-pagina uit hoe je debuglogs kunt verzamelen en een correct bugrapport of functieverzoek kunt indienen.

Kunnen Meldingen naar een Telefoon Worden Geplaatst?

Antwoord tonen

Niet direct. Standaard maakt de integratie alleen permanente meldingen binnen het Home Assistant-dashboard; deze worden niet automatisch doorgestuurd naar de Home Assistant Companion App op een mobiel apparaat, aangezien dat een specifiek per-apparaat meldingsdoel vereist dat de integratie niet heeft.

Om ze op een telefoon te ontvangen, moet een aangepaste automatisering worden aangemaakt die luistert naar de evenementen van de integratie (of de gegenereerde persistente meldingen) en deze doorstuurt naar het notify-doel voor het mobiele apparaat.

Meer over het configureren welke meldingen worden gegenereerd

Obstakel- / AI-detectiefoto's worden niet weergegeven Kaart Ondersteuning

Antwoord tonen

Als obstakelfoto's leeg blijven, zelfs met AI Obstakelbeeld Upload ingeschakeld in de app, en het account dat is verbonden met Home Assistant een gedeeld/familieaccount is in plaats van het account dat het apparaat oorspronkelijk heeft toegevoegd en bezit, kan de cloud-API van de fabrikant stilletjes de toegang tot obstakelfoto's voor dat gedeelde account blokkeren. Het gebruik van het daadwerkelijk bezitende account, of controleren dat cameratoegang expliciet is verleend aan het gedeelde account binnen de app, lost dit in de meeste gevallen op.

Kan de Map Camera naar HomeKit / Apple Home worden gestreamd? Kaart Ondersteuning

Antwoord tonen

Niet betrouwbaar als een liveweergave. De beeldstroom van de kaartcamera is echt MJPEG, dezelfde methode die het eigen cameraplatform van Home Assistant gebruikt, dus de statische voorbeeldafbeelding in Apple Home wordt correct weergegeven. Er wordt alleen een nieuw frame gegenereerd wanneer de kaart daadwerkelijk verandert, en de stream levert niets terwijl de robotstofzuiger stilzit. De liveweergave van HomeKit heeft een continu verfrissende bron nodig om verbonden te blijven, en Home Assistant moet de MJPEG-stream via een extra laag converteren voordat HomeKit deze überhaupt kan weergeven, aangezien HomeKit MJPEG niet direct accepteert. Wanneer de kaartstream stilvalt, behandelt die conversielaag de verbinding als verloren, en rapporteert Home Assistant dat de camera geen streambron heeft of toont een leeg beeld in plaats van een live afbeelding.

Hier is dit meerdere keren gemeld. Pogingen met het ffmpeg cameraplatform, go2rtc, en de Generic Camera-integratie leveren allemaal hetzelfde resultaat op: de statische preview werkt, maar een continu bijgewerkte live-feed binnen HomeKit werkt niet. Er is geen volledig werkende setup bevestigd voor deze integratie of voor vergelijkbare vacuum map-streams elders.

Home Assistant Crasht, Start Opnieuw of Gebruikt Veel Geheugen Kaart Ondersteuning

Antwoord tonen

De integratie genereert zoombare, full-resolution kaartafbeeldingen vergelijkbaar met de officiële app, wat een aanzienlijke hoeveelheid geheugen kan gebruiken. Op systemen met beperkte RAM, zoals een Raspberry Pi, een kleine VM, of een container die rond 2-3GB is beperkt, kan dit het beschikbare geheugen uitputten en ervoor zorgen dat Home Assistant vastloopt, opnieuw start, of helemaal niet opstart, meestal direct na het toevoegen van een apparaat met kaartenondersteuning of bij het openen van de apparaatpagina of de kaartcamera.

Oplossing

Schakel Lage Resolutie Kaartafbeelding in via de configuratieopties van het apparaat. Dit lost het overgrote deel van deze gevallen op.

Als het nog steeds vastloopt na het inschakelen van die optie, kan het zijn dat de kaartgegevens zelf beschadigd zijn geraakt of in de loop van de tijd ongewoon groot zijn geworden, wat ook het geheugenverbruik tijdens het renderen kan verhogen. Het herstellen van een oudere, gezonde kaart van Back-up en herstel kan dit oplossen. Als geen van beide helpt, verzamel debuglogs en open een foutmelding, aangezien dat op een andere onderliggende oorzaak wijst.

Integratie laadt niet na een Home Assistant-update, met vermelding van py_mini_racer Kaart Ondersteuning

Antwoord tonen

De integratie is afhankelijk van py-mini-racer, een JavaScript-engine die wordt gebruikt om kaarten te optimaliseren en weer te geven, zodat ze overeenkomen met de officiële app. Deze afhankelijkheid wordt door Home Assistant zelf geïnstalleerd, niet door de integratie, en het kan soms mislukken om te installeren of kan zijn native binaire bestand niet laden na een Home Assistant Core-update, vooral op musl-gebaseerde systemen (zoals HAOS op sommige platforms) of direct na een upgrade.

Omgevingsprobleem

Dit is een probleem met de installatie van de omgeving/afhankelijkheden, niet iets dat de code van de integratie kan detecteren of omzeilen. Het komt herhaaldelijk voor bij verschillende, niet-verwante versies van Home Assistant en installatietypen.

Het herstarten van Home Assistant (om het opnieuw te laten proberen de afhankelijkheden te installeren) lost het in sommige gevallen op. Als het aanhoudt, controleer dan het Home Assistant-logboek rondom de opstart voor de werkelijke pip/afhankelijkheidsinstallatiefout; die fout is wat opgelost moet worden (ook als een Home Assistant Core-kwestie, als het lijkt op een fout bij de installatie op platformniveau).

Kan een apparaat dat Valetudo draait met deze integratie worden gebruikt?

Antwoord tonen

Ja en nee. Technisch gezien is er geen beperking die voorkomt dat de integratie naast Valetudo functioneert. Valetudo schakelt de lokale miIO API niet uit, dus het apparaat kan via Lokale verbinding worden bediend zolang het token kan worden verkregen. Kaartgegevens kunnen echter niet via de lokale API worden opgehaald, en Valetudo maakt geen ruwe kaartgegevens beschikbaar via een service. Daarom kan de integratie alleen functioneren zonder kaartsupport.

Zonder kaartsupport wordt de functionaliteit die door deze integratie wordt geboden grotendeels overbodig, omdat alle resterende functies al via de native interface kunnen worden gebruikt. Valetudo Home Assistant MQTT-integratie.