Integración domótica Imou Life, gratuita y de código abierto
Cámaras Imou con la API abierta oficial de Imou: imágenes, movimiento, personas, timbre, privacidad.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Las cámaras y timbres Imou (Ranger, Cruiser, Bullet, Cell, Versa, timbres…) en Gladys, con la API abierta oficial de Imou (open.imoulife.com): imágenes de las cámaras, detección de movimiento y de personas, timbre, modo privado, detección de movimiento, foco, sirena, orientación, batería y tarjeta SD.
Desarrollada sin el hardware (Developed without the hardware): sus comentarios son bienvenidos. Esta integración se escribió a partir de la documentación de Imou y de las bibliotecas Imou de código abierto, sin cámara Imou ni cuenta de desarrollador Imou. Si algo no funciona con su modelo, abra una incidencia: https://github.com/guim31/gladys-imou/issues
Esta integración no está afiliada a Imou ni a Dahua.
Requisitos
- Gladys Assistant 5.1 o posterior (las flechas de orientación del panel requieren Gladys 5.2).
- Sus cámaras añadidas en la app Imou Life.
- Una cuenta de desarrollador Imou gratuita, para obtener un AppId y un AppSecret:
- Vaya a open.imoulife.com y regístrese con el mismo usuario que la app Imou Life (Gladys ve las cámaras de esa cuenta).
- Abra la consola, My App → App Information, pulse Edit, rellene los campos y guarde.
- Copie el AppId y el AppSecret de esa página.
- Gladys necesita Internet: todo pasa por la nube Imou.
Configuración
En Gladys, Integraciones → Imou Life → Configuración:
| Ajuste | Lo que hace |
|---|---|
| AppId | El AppId de su aplicación de desarrollador. |
| AppSecret | Su AppSecret. Solo firma las peticiones: nunca se envía ni se escribe en los registros. |
| Centro de datos | Dónde está su cuenta Imou: Europa (por defecto), Asia-Pacífico, América o China. |
| Consulta de alarmas | Frecuencia de lectura de las alarmas de cada cámara (de 30 segundos a 10 minutos, 1 minuto por defecto). |
| Imágenes de las cámaras | Frecuencia de una captura nueva de las cámaras con corriente (15 minutos por defecto). |
| Permitir desactivar la vigilancia | Permite a escenas y widget desactivar la detección o activar el modo privado. Desactivado por defecto. |
| Permitir la sirena | Añade un interruptor de sirena a las cámaras que la tienen. Desactivado por defecto. |
| Idioma de los nombres | Idioma de los nombres de funciones y de los textos enviados a las escenas (francés por defecto). |
Después, Probar la conexión: el resultado indica cuántas cámaras devolvió Imou y cuántas llamadas al día cuestan sus ajustes. Las cámaras aparecen en la pestaña Descubrimiento: añada las que quiera. Solo se leen las cámaras añadidas a Gladys.
Dispositivos
Un dispositivo Gladys por cámara (uno por objetivo de una cámara de doble objetivo o por canal de un grabador), identificado por su número de serie Imou. Cada cámara solo tiene las funciones que posee:
| Función | Lo que muestra |
|---|---|
| Imagen | La última captura o imagen de alarma, que muestra la caja de cámara del panel. |
| Orientación | Flechas (y zoom) de las cámaras motorizadas: cada pulsación es un paso corto, la cámara se detiene sola. |
| Movimiento | 1 durante un minuto tras una detección (personas incluidas). |
| Persona | 1 durante un minuto tras detectar la cámara a una persona. |
| Timbre | Timbres: 1 y luego 0 cuando alguien llama. |
| Último evento | «Persona · 18:32». |
| En línea | La cámara responde a la nube Imou. Una cámara de batería en reposo está en línea. |
| Detección de movimiento | Si la detección de movimiento está activa. Solo lectura: vea Acciones de escena. |
| Modo privado | Si el objetivo está tapado. Solo lectura: vea Acciones de escena. |
| Foco | El foco de las cámaras que lo tienen: encendido/apagado desde Gladys. |
| Sirena | Solo si Permitir la sirena está marcado. |
| Batería | Cámaras de batería, en %. |
| Tarjeta SD | Normal, sin tarjeta, formateando, error. |
| Tamaño de la tarjeta SD | En GB. |
| Espacio libre de la tarjeta SD | En GB (0 sin tarjeta). |
La Detección de movimiento y el Modo privado se muestran, pero nunca se ofrecen como interruptores: desactivarlos por error (un asistente de voz, una escena «apagar todo») dejaría la casa sin vigilancia. Se cambian con las acciones de escena y el widget.
Actualización y cuota
Gladys no consulta estas cámaras: la integración lee la nube Imou con sus propios temporizadores.
- La lista de dispositivos (una llamada para todas las cámaras) cada 10 minutos: nombres, estado en línea.
- Las alarmas de cada cámara añadida a Gladys al intervalo de Consulta de alarmas: una llamada por cámara.
- Detección de movimiento, modo privado y foco cada 30 minutos, batería y tarjeta SD cada hora, y justo después de una orden.
- Una captura de cada cámara con corriente al intervalo de Imágenes de las cámaras. Este temporizador nunca despierta las cámaras de batería.
Cada llamada cuenta en la cuota de su cuenta de desarrollador Imou. Con los ajustes por defecto, una cámara con corriente cuesta unas 1 700 llamadas al día (1 440 de ellas para las alarmas): espacie la Consulta de alarmas para ahorrar. Imou cambia los límites de su plan gratuito con el tiempo: consúltelos en My Resources de la consola. Cuando Imou responde que la cuota está agotada, todas las lecturas se detienen una hora y la página de configuración lo indica.
Widget
Cámaras Imou muestra la imagen más reciente de las cámaras elegidas (todas por defecto), una línea por cámara (modo privado, último evento, en línea, en reposo o sin conexión) y, cuando muestra una sola cámara, un botón Nueva imagen y el modo privado: Reanudar siempre, Modo privado solo si Permitir desactivar la vigilancia está marcado, tras una confirmación.
Disparadores de escena
- Movimiento detectado por una cámara Imou: toda detección, personas incluidas. Filtros: cámara, lo detectado (movimiento, persona). Variables: nombre de la cámara, lo detectado.
- Persona detectada por una cámara Imou: la detección humana de la cámara vio a alguien. Variable: nombre de la cámara.
- Alguien llama a un timbre Imou: filtro: timbre. Variable: nombre del timbre.
La imagen de la cámara se actualiza antes del disparo: «enviar la imagen de la cámara» envía la imagen del evento. Los eventos se leen al intervalo de Consulta de alarmas: cuente hasta ese retraso.
Acciones de escena
- Actualizar la imagen de una cámara Imou: una captura ya.
- Girar una cámara Imou: un paso a la izquierda, a la derecha, arriba, abajo, acercar o alejar.
- Modo privado de una cámara Imou: activado (objetivo tapado) o desactivado (cámara vigilando). Activado requiere Permitir desactivar la vigilancia.
- Detección de movimiento de una cámara Imou: activada o desactivada. Desactivada requiere Permitir desactivar la vigilancia.
Ejemplos de escenas
- Cuando una Persona detectada por una cámara Imou viene de la cámara de la entrada de coches de noche: encender la luz exterior y enviar su imagen por mensaje.
- Cuando Alguien llama a un timbre Imou: enviar la imagen del timbre a la familia y anunciarlo en los altavoces.
- Cuando la última persona sale de casa: Modo privado de una cámara Imou desactivado para las cámaras interiores; al volver (si se permite desactivar la vigilancia): activado.
Solución de problemas
- «Imou ha rechazado el AppId o el AppSecret»: cópielos de nuevo desde My App y compruebe el Centro de datos de su cuenta.
- Ninguna cámara encontrada: la cuenta de desarrollador debe usar el mismo usuario que la app Imou Life. Una cámara compartida solo aparece con permiso de control.
- «Por encima del límite de dispositivos del plan gratuito»: el plan gratuito de desarrollador de Imou controla un número limitado de dispositivos. Deje en esa cuenta las cámaras útiles o comparta las demás con una segunda cuenta con su propio AppId.
- Cuota agotada: espacie la Consulta de alarmas y las Imágenes de las cámaras, o añada menos cámaras.
- Sin imagen: la cámara está sin conexión, en reposo o en modo privado. Algunos modelos cifran sus imágenes de alarma: la integración toma entonces una captura de las cámaras con corriente.
- Registros: Integraciones → Imou Life → Registros.
LOG_LEVEL=debugmuestra cada lectura. El AppSecret, el AppId, los tokens y las direcciones de imágenes nunca se escriben.
Límites
- Solo nube: se necesitan la nube Imou y el acceso a Internet. Imou no puede enviar eventos a Gladys (su push requiere una dirección pública): las alarmas se leen en cada Consulta de alarmas, así que una escena arranca hasta ese retraso después del evento.
- Sin vídeo en directo: el panel muestra la última imagen.
- Las cámaras de la nueva plataforma Imou (indicadas por Probar la conexión) solo tienen imagen, alarmas y estado en línea.
- Las cámaras de batería no se capturan con el temporizador (cada captura las despertaría) y su tarjeta SD no se lee.
- La detección de personas, el timbre y las capacidades vienen de la documentación de Imou, no de pruebas con cámaras reales: sus comentarios son bienvenidos.
- Desarrollada sin el hardware ni cuenta Imou; no está afiliada a Imou ni a Dahua.
Parámetros de configuración
Estos son los parámetros que Imou Life te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su aplicación de desarrollador Imou | section | No | Gladys lee sus cámaras con la API abierta oficial de Imou. Cree una cuenta de desarrollador gratuita en open.imoulife.com con el usuario de la app Imou Life y copie el AppId y el AppSecret de «My App». |
| AppId | string | Sí | Página «My App» de la consola de desarrollador Imou. |
| AppSecret | secret | Sí | Firma las peticiones: nunca se envía ni se escribe en los registros. |
| Centro de datos | select | No | Dónde está su cuenta Imou. Europa para una cuenta creada en Europa. |
| Consulta de alarmas | select | No | Frecuencia de lectura de las alarmas de cada cámara: una llamada a Imou por cámara cada vez, contada en la cuota de su cuenta de desarrollador. |
| Imágenes de las cámaras | select | No | Frecuencia de una captura nueva de las cámaras con corriente: es la que muestra la caja de cámara del panel. Con batería: solo al alarmar. |
| Permitir desactivar la vigilancia | boolean | No | Permite a las escenas y al widget desactivar la detección de movimiento o activar el modo privado. Desactivado por defecto: un error dejaría la casa sin vigilancia. |
| Permitir la sirena | boolean | No | Añade un interruptor de sirena a las cámaras que la tienen. Desactivado por defecto: un error de escena despertaría a los vecinos. |
| Idioma de los nombres | select | No | Idioma de los nombres de funciones y de los textos enviados a las escenas. Se fijan al añadir un dispositivo. |
Cómo instalar Imou Life en Gladys
- En Gladys, abre Integraciones: Imou Life aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-imou:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-imou.
Imou Life requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Imou Life es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación