Integración domótica Viseron, gratuita y de código abierto
Cámaras de Viseron: imágenes, movimiento, objetos detectados (persona, coche…), grabación, en local.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Lleva a Gladys las cámaras de un servidor Viseron (el grabador de vídeo en red autoalojado con detección de objetos): su imagen, el movimiento detectado, los objetos que Viseron sigue (persona, coche, perro…), la grabación en curso y si están en línea. Los eventos en directo de Viseron inician escenas, con la imagen del momento, que una escena puede enviarle. Las escenas también pueden iniciar o detener una grabación.
Probada contra un servidor Viseron real en Docker (3.7.0, CPU, detección de objetos darknet) con cámaras de red simuladas, aún no en una instalación en servicio con cámaras reales: sus comentarios son bienvenidos en GitHub o en el foro de Gladys.
Lo que necesita
- Gladys 5.1 o posterior.
- Viseron 3.7 o posterior, accesible desde Gladys en su puerto web (8888 por defecto).
- Las cámaras ya configuradas en Viseron (componente
ffmpegogstreamer), con un detector de movimiento y un detector de objetos si quiere esas funciones. - Si la autenticación está activa en Viseron (
webserver: auth:), un usuario de Viseron para Gladys. El rol read basta para seguir las cámaras; el rol write también permite a Gladys iniciar grabaciones.
Instalación
- En Gladys, abra Integraciones, busque Viseron e instálela.
- En su pestaña Configuración, rellene:
- Dirección de Viseron: la dirección del equipo que ejecuta Viseron, p. ej.
192.168.1.20. Sin puerto, se usa el 8888; añada:puertosi se cambió, ohttps://detrás de un proxy inverso. - Usuario y Contraseña: solo si la autenticación está activa en Viseron. Si no, déjelos vacíos.
- Actualización de imágenes: con qué frecuencia se envía la imagen de cada cámara a Gladys (de 10 segundos a 15 minutos, 1 minuto por defecto). Un movimiento o un objeto detectado también envía una al instante.
- Idioma de los nombres: el idioma de los nombres de funciones dados al añadir una cámara.
- Dirección de Viseron: la dirección del equipo que ejecuta Viseron, p. ej.
- Guarde y abra la pestaña Descubrir: un dispositivo por cámara. Añada los que quiera.
- Comprobar la conexión muestra lo que lee la integración: la versión de Viseron, si llegan los eventos en directo, cada cámara, si está en línea, graba y los objetos que sigue.
Los dispositivos de Gladys
Cada cámara de Viseron se convierte en una cámara de Gladys, con el nombre de Viseron, con:
| Función | Qué es |
|---|---|
| Imagen | La imagen de la cámara, enviada al ritmo elegido y al instante con movimiento u objeto. |
| Movimiento | 1 mientras el detector de movimiento de Viseron ve movimiento, si no 0. |
| Objeto detectado | 1 mientras un objeto que Viseron sigue está en la imagen, si no 0. |
| Detección de persona, … | Una por etiqueta que Viseron sigue en la cámara (persona, coche, perro…). |
| Grabación | 1 durante una grabación. Un interruptor: inicia o detiene una grabación manual. |
Las funciones siguen la configuración de Viseron: una cámara sin detector de movimiento no tiene Movimiento. Una etiqueta añadida más tarde en Viseron aparece tras Actualizar en la pestaña Descubrir. Una cámara cuyo flujo se ha perdido, o detenida en Viseron, aparece como inaccesible en Gladys.
Cámaras añadidas con la versión 1.0.x: tenían una función En línea del tipo Gladys «cámara activada», que Gladys 5.2 usa como modo de privacidad de la cámara (a 0, Gladys rechaza sus imágenes). Abra la pestaña Descubrir de la integración y haga clic en Actualizar en cada cámara: la función desaparece. Mientras tanto, la integración la pone a 1 una vez al arrancar, para que las imágenes sigan llegando.
Widget del panel
Cámara Viseron muestra la imagen de una cámara, el movimiento, los objetos a la vista (p. ej. «Perro, Persona»), la grabación y el estado en línea, y dos botones: Grabar (o Detener la grabación) y Nueva imagen.
Escenas
Disparadores
- Viseron: objeto detectado: Viseron empieza a ver un objeto que sigue. Filtros: la cámara (vacía
= todas), el objeto (etiqueta, p. ej.
person) y la zona (vacía = todas), escritos como en la configuración de Viseron. Variables: el nombre de la cámara, el objeto, la zona (vacía para toda la imagen) y la confianza en %. La imagen del momento se envía primero a Gladys. Un objeto seguido a la vez en toda la imagen y en una zona dispara una vez por cada una: filtre por la zona para quedarse con una. - Viseron: movimiento detectado: el detector de movimiento de una cámara empieza a ver movimiento. Filtro: la cámara. Variable: el nombre de la cámara. La imagen del momento se envía primero.
- Viseron: cámara sin conexión: una cámara activa en Viseron pierde su flujo durante 30 segundos, o el propio Viseron deja de responder. No se dispara para una cámara detenida en Viseron.
Acciones
- Viseron: grabar: Iniciar inicia una grabación manual en una cámara, Detener la detiene. Viseron la rechaza para una cámara sin conexión y, con autenticación, para un usuario sin el rol write.
La acción Enviar una imagen de cámara del núcleo envía la última imagen de una cámara: justo después de Viseron: objeto detectado o Viseron: movimiento detectado, es la imagen de ese momento.
Ideas de escenas
- Alguien en la puerta: Viseron: objeto detectado, cámara «Entrada», objeto
person→ Enviar una imagen de cámara de esa cámara a su teléfono, con{{triggerEvent.data.score}}% en el texto. - Coche en la entrada de noche: Viseron: objeto detectado, objeto
car, zonadriveway→ encender la luz exterior cinco minutos. - Puerta abierta en su ausencia: un sensor de apertura se abre y no hay nadie en casa → Viseron: grabar, Iniciar, en la cámara del pasillo; Detener dos minutos después.
- Cámara perdida: Viseron: cámara sin conexión → enviar un mensaje con el nombre de la cámara.
Solución de problemas
- «Viseron no responde en esta dirección»: abra
http://<dirección>:8888en un navegador. Compruebe el puerto y que ningún cortafuegos bloquee a Gladys. - «Algo responde, pero no como Viseron»: la dirección o el puerto llevan a otro servicio. Introduzca la dirección de Viseron, sin ruta de página.
- «Viseron pide iniciar sesión, o rechaza el usuario o la contraseña»: la autenticación está activa en Viseron. Introduzca un usuario de Viseron (no un token de acceso personal), o compruebe la contraseña.
- Ninguna función de objeto o movimiento: la cámara no tiene detector de objetos o de movimiento en la configuración de Viseron, o Viseron no lo ha iniciado (vea sus registros).
- «Sin eventos en directo» en Comprobar la conexión: el WebSocket de Viseron no se abre (un proxy
inverso debe dejar pasar los WebSockets en
/websocket). Los estados solo se leen entonces una vez por minuto, y no se dispara ningún disparador salvo cámara sin conexión. - Más detalles: los registros de la integración (Integraciones → Viseron → Registros); ponga
LOG_LEVELendebugpara ver cada petición.
Límites
- Sin vídeo en directo: Gladys muestra imágenes, enviadas al ritmo elegido (Gladys guarda 12 imágenes por minuto y cámara como máximo). El directo y las grabaciones se ven en Viseron.
- Etiquetas y zonas se filtran tal como se escriben en Viseron: los filtros de escena solo comparan texto.
- Como máximo 12 etiquetas por cámara se convierten en funciones.
- Las grabaciones pasadas, el reconocimiento facial y de matrículas, el PTZ e iniciar o detener cámaras no están cubiertos.
- Un servidor Viseron por integración.
- Probada con Viseron 3.7.0 en Docker y cámaras simuladas, sin instalación real: sus comentarios son bienvenidos.
Esta integración no está afiliada a Viseron ni a sus autores.
Parámetros de configuración
Estos son los parámetros que Viseron te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su servidor Viseron | section | No | Viseron, el grabador de vídeo autoalojado con detección de objetos. Introduzca su dirección (puerto 8888 por defecto) y abra la pestaña Descubrir: un dispositivo por cámara. |
| Dirección de Viseron | string | Sí | Sin puerto, se usa el 8888. Añada https:// detrás de un proxy inverso. |
| Usuario | string | No | Solo si la autenticación está activa en Viseron (webserver: auth). Un usuario con rol de escritura también puede iniciar grabaciones. |
| Contraseña | secret | No | |
| Actualización de imágenes | select | No | Con qué frecuencia se envía la imagen de cada cámara a Gladys. Un movimiento o un objeto detectado también envía una al instante. |
| Idioma de los nombres | select | No | Nombres dados a las funciones al añadir una cámara (Movimiento, Detección de persona…). |
Cómo instalar Viseron en Gladys
- En Gladys, abre Integraciones: Viseron 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-viseron: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-viseron.
Viseron 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
Viseron 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