Skip to content

FAQ ​

Questa pagina raccoglie le domande che si presentano ripetutamente sul Tracker di problemi di GitHub. Controllare qui prima di aprire un nuovo problema fa risparmiare tempo, poiché la maggior parte di questi non sono bug ma comportamenti previsti con una causa documentata.

Cerca Problemi Esistenti

Nessuno di questi? Assicurati di cercare nel problemi chiusi su GitHub prima di aprirne uno nuovo. Se il problema persiste, la pagina Segnalazione Problemi spiega come raccogliere i log di debug e aprire un rapporto di bug o una richiesta di funzionalità adeguata.

Le notifiche possono essere inviate a un telefono? ​

Mostra Risposta

Non direttamente. Per impostazione predefinita, l'integrazione crea solo notifiche persistenti all'interno della dashboard di Home Assistant; esse non vengono automaticamente inoltrate all'App Companion di Home Assistant su un dispositivo mobile, poiché ciò richiede un target di notifica specifico per dispositivo che l'integrazione non possiede.

Per riceverle su un telefono, deve essere creato un automazione personalizzata che ascolti il eventi dell'integrazione (o le notifiche persistenti generate) e le inoltri al target notify per il dispositivo mobile.

Ulteriori informazioni su come configurare quali notifiche vengono generate

Foto di ostacoli / rilevamento AI non vengono visualizzate Supporto Mappa ​

Mostra Risposta

Se le immagini degli ostacoli rimangono vuote anche con Caricamento immagine ostacolo AI abilitato nell'app, e l'account collegato a Home Assistant è un account condiviso/familiare invece dell'account che ha originariamente aggiunto e possiede il dispositivo, l'API cloud del produttore può bloccare silenziosamente l'accesso alle immagini degli ostacoli per quell'account condiviso. Utilizzare l'account effettivamente proprietario, o verificare che l'accesso alla fotocamera sia stato esplicitamente concesso all'account condiviso all'interno dell'app, risolve il problema nella maggior parte dei casi.

La fotocamera della mappa può essere trasmessa in streaming su HomeKit / Apple Home? Supporto Mappa ​

Mostra Risposta

Non in modo affidabile come visualizzazione in diretta. La videocamera della mappa trasmette come vero MJPEG, lo stesso metodo utilizzato dalla piattaforma delle videocamere di Home Assistant, quindi l'immagine statica di anteprima in Apple Home viene visualizzata correttamente. Un nuovo fotogramma viene generato solo quando la mappa effettivamente cambia, e lo stream non produce nulla mentre l'aspirapolvere è fermo. La visualizzazione in diretta di HomeKit necessita di una sorgente che si aggiorni continuamente per rimanere connessa, e Home Assistant deve convertire lo stream MJPEG attraverso un ulteriore livello prima che HomeKit possa visualizzarlo, poiché HomeKit non accetta direttamente MJPEG. Quando lo stream della mappa tace, quel livello di conversione considera la connessione come persa, e Home Assistant segnala che la videocamera non ha sorgente di stream oppure mostra un feed vuoto invece di un'immagine in diretta.

Ciò è stato segnalato più volte. I tentativi utilizzando la piattaforma della fotocamera ffmpeg, go2rtc, e l'integrazione Generic Camera producono tutti lo stesso risultato: l'anteprima statica funziona, ma un flusso video live continuamente aggiornato all'interno di HomeKit non funziona. Non è stata confermata nessuna configurazione completamente funzionante per questa integrazione o per flussi simili di mappe dei robot aspirapolvere altrove.

Home Assistant si blocca, si riavvia o utilizza molta memoria Supporto Mappa ​

Mostra Risposta

L'integrazione restituisce immagini della mappa a risoluzione completa e zoomabili simili all'app ufficiale, il che può usare una quantità significativa di memoria. Su sistemi con RAM limitata, come un Raspberry Pi, una piccola VM o un container con limite di circa 2-3GB, ciò può esaurire la memoria disponibile e causare il blocco, il riavvio o l'impossibilità di avviare completamente Home Assistant, di solito subito dopo l'aggiunta di un dispositivo con supporto alla mappa o quando si apre la pagina del dispositivo o la fotocamera della mappa.

Soluzione

Abilitare Immagine della Mappa a Bassa Risoluzione dalle opzioni di configurazione del dispositivo. Questo risolve la stragrande maggioranza di questi casi.

Se continua a bloccarsi dopo aver abilitato quell'opzione, i dati della mappa stessi potrebbero essersi corrotti o essere diventati insolitamente grandi nel tempo, il che può anche aumentare l'uso della memoria durante il rendering. Ripristinare una mappa più vecchia e integra da Backup e Ripristino può risolvere il problema. Se nessuno dei due metodi funziona, raccogli i log di debug e apri un segnalazione di bug, poiché ciò indica una causa sottostante diversa.

L'integrazione non si carica dopo un aggiornamento di Home Assistant, menzionando py_mini_racer Supporto Mappa ​

Mostra Risposta

L'integrazione dipende da py-mini-racer, un motore JavaScript utilizzato per ottimizzare e rendere le mappe in modo che corrispondano all'app ufficiale. Questa dipendenza è installata dallo stesso Home Assistant, non dall'integrazione, e occasionalmente non riesce a installarsi o non riesce a caricare il suo binario nativo dopo un aggiornamento di Home Assistant Core, in particolare sui sistemi basati su musl (come HAOS su alcune piattaforme) o subito dopo un aggiornamento.

Problema dell'ambiente

Questo è un problema di installazione dell'ambiente/dipendenze, non qualcosa che il codice dell'integrazione può rilevare o aggirare. Si manifesta ripetutamente attraverso versioni non correlate di Home Assistant e tipi di installazione.

Riavviare Home Assistant (per permettere di riprovare a installare le dipendenze) lo risolve in alcuni casi. Se persiste, controlla il registro di Home Assistant all'avvio per l'effettivo errore di installazione di pip/dipendenza; quell'errore è ciò che deve essere risolto (anche come problema di Home Assistant Core, se sembra un fallimento a livello di piattaforma).

È possibile utilizzare un dispositivo con Valetudo con questa integrazione? ​

Mostra Risposta

Sì e no. Tecnicamente, non esiste una restrizione che impedisca all'integrazione di funzionare insieme a Valetudo. Valetudo non disabilita l'API locale miIO, quindi il dispositivo può essere controllato tramite Connessione Locale finché il token può essere acquisito. Tuttavia, i dati della mappa non possono essere recuperati tramite l'API locale, e Valetudo non espone dati grezzi della mappa tramite un servizio. Pertanto, l'integrazione può funzionare solo senza il supporto della mappa.

Senza il supporto della mappa, le funzionalità fornite da questa integrazione diventano in gran parte ridondanti, poiché tutte le rimanenti funzionalità possono già essere utilizzate attraverso il nativo Integrazione Valetudo Home Assistant MQTT.