Come collegare le telecamere Imou a Home Assistant con Imou Life Official

Imou Home Assistant - Le telecamere Imou possono essere integrate in Home Assistant attraverso Imou Life Official, un'integrazione pubblicata dal team Imou Open Platform e installabile tramite HACS. La soluzione permette di visualizzare i flussi video, utilizzare i controlli disponibili sul dispositivo e ricevere eventi di allarme per creare automazioni domestiche. Il funzionamento si basa sulle API cloud di Imou e richiede credenziali applicative dedicate, differenti dalla password utilizzata nell'app Imou Life. La disponibilità delle singole funzioni dipende dalle caratteristiche effettivamente comunicate da ciascun modello. Fonte: Share your Projects.

Imou Home Assistant: requisiti e funzionamento

Per utilizzare l'integrazione è necessario disporre di Home Assistant 2025.4 o successivo, di HACS e di una telecamera già associata a un account Imou Life. Prima di procedere, occorre verificare che il dispositivo risulti online nell'applicazione del produttore.

Imou Life Official accede ai dispositivi attraverso un'applicazione registrata sulla piattaforma cloud Imou Open Platform. Le entità vengono generate in base alle informazioni restituite dalle API per l'account configurato.

Questo comportamento evita di mostrare controlli che la telecamera non possiede. Un modello fisso, per esempio, non presenta pulsanti per la rotazione dell'obiettivo, mentre una telecamera che non comunica informazioni sulla batteria non genera il relativo sensore.

Ogni obiettivo e ogni canale di un registratore NVR dispone di una propria visualizzazione live. Lo streaming utilizza il cloud e può quindi essere accessibile anche quando ci si trova fuori dalla rete domestica.

Preparare Imou Open Platform e le credenziali API

Il primo passaggio consiste nel creare un'applicazione sul portale internazionale open.imoulife.com, utilizzando l'account associato alle telecamere.

Le credenziali necessarie si trovano nella sezione Control Board → My App → App Information. Qui sono disponibili App ID e App secret, entrambi richiesti durante la configurazione dell'integrazione.

L'App secret deve essere trattato come una password. È importante copiarlo senza spazi aggiuntivi, soprattutto alla fine del valore. Se il segreto viene rigenerato, Home Assistant richiederà una nuova autenticazione, mantenendo comunque la voce dell'integrazione già configurata.

Un altro parametro fondamentale è la regione del server, individuabile nel portale attraverso Control Board → Basic Information → My Information. La corrispondenza documentata è la seguente: East Asia utilizza Singapore, Central Europe utilizza Europe e Western America utilizza North America.

Una regione errata può consentire l'accettazione dell'App ID ma restituire un elenco vuoto dei dispositivi. Un App secret non valido, invece, avvia la procedura di riautenticazione.

Ogni App ID comprende 30.000 richieste API gratuite al mese. Le richieste eccedenti vengono fatturate secondo le tariffe pubblicate sulla piattaforma. Gli aggiornamenti periodici dello stato consumano questa disponibilità e anche la riproduzione live utilizza risorse associate all'applicazione.

Il consumo residuo è consultabile nella sezione My Resources del portale. Quando la disponibilità viene esaurita, Home Assistant può segnalarlo attraverso Impostazioni → Sistema → Riparazioni.

Installare Imou Life Official tramite HACS

Una volta preparate le credenziali, l'installazione avviene direttamente da HACS. È sufficiente cercare Imou Life Official, scaricare l'integrazione e riavviare Home Assistant quando richiesto.

Successivamente bisogna aprire Impostazioni → Dispositivi e servizi → Aggiungi integrazione, selezionare Imou Life Official e inserire App ID e App secret. La procedura richiede anche la scelta della regione corrispondente al data center dell'account.

Durante la configurazione è possibile selezionare le telecamere da interrogare periodicamente. I dispositivi non selezionati rimangono nell'elenco, ma vengono esclusi dagli aggiornamenti regolari. La procedura può essere completata anche senza selezionare alcuna telecamera.

È possibile terminare la configurazione persino quando l'account non contiene ancora dispositivi. In seguito, attraverso Configure → Bind a new device, si può associare una telecamera utilizzando il numero seriale e il codice di associazione recuperabili dall'etichetta del dispositivo o dall'app Imou Life.

Streaming, sensori e controlli delle telecamere

Dopo il collegamento, Home Assistant crea le entità corrispondenti alle capacità dichiarate dal dispositivo. La visualizzazione live viene esposta come entità camera e può essere utilizzata nelle schede della dashboard.

La risoluzione richiesta per lo streaming è inizialmente impostata su HD e può essere gestita attraverso Configure → Polling and cameras.

Una scheda picture-entity con visualizzazione automatica avvia lo streaming cloud mentre rimane visibile. Sulle telecamere alimentate a batteria è quindi opportuno evitare di mantenerla permanentemente aperta in una dashboard, perché il flusso può risvegliare il dispositivo e utilizzare risorse come durante la visione nell'app Imou Life.

Tra le entità che possono essere esposte figurano la modalità privacy, il rilevamento delle persone, la luce bianca, i punti di orientamento predefiniti e il sensore di movimento. La loro presenza non è garantita su tutti i modelli.

La modalità privacy utilizza uno switch che chiude l'obiettivo, analogamente al controllo presente nell'app Imou Life. Il rilevamento delle persone dispone invece di uno switch dedicato all'abilitazione della funzione: il suo stato non cambia automaticamente quando qualcuno attraversa l'inquadratura.

Per gli allarmi di movimento viene utilizzata un'entità binary_sensor, che può attivarsi dopo la ricezione di una notifica push. Il sensore rimane non disponibile finché non vengono abilitati gli eventi push e inclusi i tipi di messaggio pertinenti. Gli allarmi relativi ad animali e veicoli non attivano questo specifico sensore.

Le telecamere motorizzate possono esporre pulsanti direzionali per controllare l'orientamento dell'obiettivo. Ogni pressione produce uno spostamento di breve durata, configurabile nelle impostazioni predefinite della telecamera.

I punti di orientamento salvati nell'app Imou Life vengono presentati attraverso un'entità select. L'integrazione consente di richiamare un preset mediante il suo nome, ma non legge la posizione corrente dell'obiettivo: dopo uno spostamento riuscito, il selettore può quindi continuare a mostrare il messaggio di scelta del punto.

Nei modelli dotati di illuminazione, la luce bianca viene esposta come entità light. L'eventuale sirena può essere comandata anche senza attivare le notifiche push e, secondo la guida, il suo stato torna normalmente disattivato dopo circa 15 secondi, in linea con la durata abituale dell'allarme sonoro gestito dal firmware.

Gli identificativi delle entità dipendono dal nome assegnato al dispositivo nel sistema. Gli esempi della documentazione utilizzano una telecamera chiamata Porch, ma i nomi effettivi devono essere recuperati da Strumenti per sviluppatori → Stati. Non bisogna creare manualmente entità mancanti quando il modello non dichiara una determinata capacità.

Eventi di allarme e automazioni in Home Assistant

Una delle possibilità offerte da Imou Life Official riguarda l'utilizzo degli allarmi nelle automazioni domestiche. Per ricevere questi eventi è necessario abilitare Configure → Alarm push and notifications e rendere raggiungibile da Internet l'URL di callback utilizzato dall'integrazione.

Un indirizzo esclusivamente locale, come un URL appartenente alla rete 192.168.1.x, non è sufficiente a ricevere le chiamate provenienti dal servizio cloud.

Gli eventi vengono pubblicati in Home Assistant con il tipo imou_life_alarm. Il campo msg_type identifica la categoria della segnalazione: human indica il rilevamento di una persona, mentre videoMotion corrisponde a un cambiamento dell'immagine.

Prima di utilizzare questi valori nei filtri di un'automazione, la guida consiglia di verificarli attraverso Strumenti per sviluppatori → Eventi, osservando un evento realmente ricevuto dalla propria telecamera.

Un esempio documentato consiste nell'accendere la luce bianca di una telecamera quando viene rilevata una persona. L'automazione ascolta l'evento imou_life_alarm con msg_type impostato su human e richiama l'azione light.turn_on sull'entità della luce.

Dopo la ricezione di una notifica push pertinente, il sensore di movimento può inoltre rimanere attivo per circa 15 secondi. Questo comportamento è distinto dall'abilitazione del rilevamento delle persone, che rimane un'impostazione della telecamera.

Se le notifiche push non vengono configurate, alcune funzioni continuano comunque a operare: la visualizzazione della telecamera, i controlli della luce, la sirena e la selezione dei punti predefiniti non dipendono dall'attivazione degli eventi di allarme.

La documentazione del progetto è disponibile nel repository Imou-OpenPlatform/Imou-Home-Assistant su GitHub, dove sono descritte anche le schermate di configurazione. Per utilizzare correttamente l'integrazione è importante verificare le funzioni effettivamente esposte dal proprio modello, scegliere la regione cloud appropriata e tenere sotto controllo il consumo delle richieste API.