Integración domótica Reolink, gratuita y de código abierto
Sus cámaras Reolink en Gladys: imágenes, detecciones instantáneas, foco, sirena y PTZ.
Publicado por William-De71
- Dispositivos
- Versión 1.4.2
- Requiere Gladys >=5.0.0
- ★ 0
Esta integración lleva sus cámaras Reolink a Gladys: la imagen en el panel, el vídeo en directo, detecciones instantáneas como desencadenantes de escenas y, según el modelo, el control del foco, la sirena, los LED infrarrojos y los cabezales motorizados.
Todo ocurre en su red local. No se necesita ninguna cuenta Reolink y ninguna imagen pasa nunca por una nube.
Lo que necesita
- Una o varias cámaras Reolink en la misma red que Gladys — independientes, o emparejadas con un Home Hub o un NVR.
- El usuario y la contraseña con los que accede a esas cámaras (los de la aplicación Reolink, normalmente
admin). - Gladys 5.0.0 o posterior.
Eso es todo. No hay que crear ninguna cuenta ni solicitar ninguna clave de API.
Cámaras con batería (Argus, Go…): normalmente se accede a ellas a través de su Home Hub o su NVR — por sí solas, la mayoría no ofrecen la API local que usa esta integración.
Puesta en marcha
- En Gladys, abra Integraciones → Instalar una integración e instale Reolink.
- En la pantalla de configuración, introduzca el usuario y la contraseña de sus cámaras.
- Pulse Probar la conexión: Gladys busca sus cámaras e indica lo que sabe hacer cada una, si notifica sus detecciones al instante y si su vídeo en directo está disponible.
- Vaya a Descubrir y lance una búsqueda: sus cámaras aparecen ahí, listas para añadirse. Detrás de un Home Hub o un NVR, cada cámara se convierte en un dispositivo propio.
Ajustes recomendados en las cámaras
Los firmwares recientes de Reolink se entregan con algunos servicios de red desactivados. En la aplicación Reolink, abra Ajustes → Red → Avanzado → Ajustes del servidor (el nombre varía ligeramente según la versión de la aplicación) y active:
- HTTP (o HTTPS) — imprescindible: es la vía por la que Gladys se comunica con la cámara. Sin él, la cámara nunca se encuentra, aunque su flujo RTSP funcione en otro sitio;
- RTSP — necesario para el vídeo en directo;
- ONVIF — necesario para las detecciones instantáneas (ver más abajo).
La prueba de conexión le indica, cámara por cámara, cuándo RTSP está desactivado.
Si no se encuentra una cámara
Gladys busca sus cámaras mediante un broadcast de red. Algunos routers lo filtran, y una cámara en otra VLAN nunca lo recibe. En ese caso, introduzca su dirección en Direcciones de las cámaras, en la sección Avanzado:
192.168.1.42, 192.168.1.43
Si una cámara no usa el puerto estándar, añádalo: 192.168.1.42:8000.
Si sus cámaras no comparten la misma contraseña
Indique las excepciones en Cuentas por cámara:
192.168.1.42|gladys|MiContraseña
Las cámaras que no estén en esa lista usan la cuenta global.
Lo que obtiene
Cada cámara recibe las funciones que realmente tiene. La integración pregunta a la cámara en lugar de fiarse de su nombre de modelo: dos cámaras de la misma gama pueden ser distintas.
| Función | En qué cámaras |
|---|---|
| Imagen | Todas |
| Vídeo en directo | Todas (RTSP activado) |
| Movimiento | Todas |
| Persona / Vehículo / Animal | Modelos con detección por IA |
| Timbre | Videotimbres |
| Batería | Modelos con batería y solares |
| Cargando | Modelos con batería y solares |
| Foco | Modelos con foco blanco |
| Sirena | Modelos con altavoz de alarma |
| Infrarrojos | La mayoría de los modelos |
| Mover (flechas) | Cámaras motorizadas (giro/inclinación, o solo zoom) |
| Posición | Cámaras motorizadas con posiciones guardadas |
Detecciones
Una cámara puede informar de lo que ve de dos maneras, y la integración elige sola la mejor para cada cámara:
- Al instante, mediante ONVIF — las cámaras con cable a las que se accede directamente envían sus eventos de movimiento, persona, vehículo, animal y timbre en el momento en que se producen, e indican también cuándo terminan. Es el funcionamiento por defecto, siempre que ONVIF esté activado en la cámara.
- Mediante comprobaciones periódicas — las cámaras con batería, las que están detrás de un Home Hub o un NVR y las que tienen ONVIF desactivado se consultan periódicamente. El intervalo de comprobación (15 segundos por defecto) es entonces el retraso de detección.
Si una cámara deja de responder por ONVIF, vuelve sola a las comprobaciones periódicas, y regresa a ONVIF en cuanto vuelve a responder. Puede desactivar ONVIF por completo con la opción Detecciones instantáneas (ONVIF) de la sección Avanzado.
Una detección también provoca una captura de imagen, para que el widget muestre lo ocurrido sin esperar.
Las detecciones de persona, vehículo y animal aparecen como detectores de movimiento llamados «Person», «Vehicle» y «Animal»: úselos en un desencadenante de escena como cualquier detector de movimiento, por ejemplo «cuando se detecte una persona en la verja, encender la luz de la entrada».
Timbre
El botón del timbre aparece como una función Timbre: el panel muestra «Sonando» durante una llamada y después la hora de la última, y el editor de escenas ofrece «Si suena el timbre».
Cámaras motorizadas (PTZ)
- Mover muestra flechas en el panel. Cada pulsación mueve la cámara un pequeño paso, que se detiene solo — una escena que envía un movimiento nunca deja la cámara girando. Una cámara que solo tiene zoom recibe únicamente los botones de zoom.
- Posición lista, por su nombre, las posiciones guardadas en la aplicación Reolink. Elija una para enviar la cámara allí, desde el panel o desde una escena.
La lista de posiciones se lee al descubrir la cámara: tras guardar una nueva posición en la aplicación Reolink, vuelva a lanzar una búsqueda. La acción Listar las posiciones PTZ muestra lo que cada cámara tiene guardado en este momento.
Cargando
Las cámaras con batería y solares reciben también una función Cargando: está activa mientras la cámara se recarga, en su cargador o gracias a su panel solar, e inactiva cuando la batería está llena o desenchufada. Úsela en una escena — «cuando la cámara del jardín deje de cargarse, avísame» — o simplemente para comprobar que un panel solar sigue haciendo su trabajo.
Protección de la batería
Capturar una imagen es lo que más agota una cámara con batería o solar. Por eso la integración reduce el ritmo antes de que la batería llegue a un nivel crítico:
- por debajo del 60 %: la actualización automática se detiene. Abrir el widget o una detección siguen capturando una imagen;
- por debajo del 40 %: no se captura ninguna imagen;
- vuelta a la normalidad en cuanto la cámara vuelve a su cargador, o cuando alcanza el 80 % con energía solar.
Ese 80 % está deliberadamente muy por encima del umbral de pausa: reanudar justo por encima reiniciaría la descarga de inmediato. Evite ponerlo al 100 % — una cámara solar se carga a tirones y rara vez marca exactamente lleno, lo que la dejaría en pausa indefinidamente, sin cargador en el que ponerla.
El nivel de batería y las detecciones se siguen leyendo en todos los casos: no cuesta casi nada, y es lo que permite saber cuándo se ha recargado la cámara.
Una cámara con batería que deja de responder — sueño profundo, sesión rechazada, red caída — también pasa a «solo bajo demanda»: su último nivel conocido ya no es fiable, y una cámara silenciosa tiene más probabilidades de estar vacía que llena.
Detrás de un Home Hub, el hub indica además qué cámaras están dormidas: la actualización automática nunca despierta a una cámara dormida, sea cual sea su nivel.
Un intervalo de captura propio
Las cámaras con batería tienen su propio intervalo de actualización, independiente del de las cámaras con cable. Espaciar las capturas de un modelo solar no le cuesta nada a la frescura de sus cámaras conectadas a la red eléctrica.
| Ajuste | Por defecto | Se aplica a |
|---|---|---|
| Intervalo de actualización de imágenes | 60 s | solo cámaras con cable |
| Intervalo de actualización de cámaras con batería | 900 s (15 min) | modelos con batería o solares |
Es el ajuste más eficaz de todos: lo que gasta batería es despertar la cámara, mucho más que la propia imagen. En invierno, o si su panel recibe poco sol, alargue ese intervalo y suba el umbral de pausa.
Todos los umbrales son configurables, y las cámaras con cable nunca se ven afectadas.
Preguntas frecuentes
La imagen del panel está congelada. Compruebe el intervalo de actualización en la sección Avanzado. Si la cámara funciona con batería, quizá esté en pausa: mire su nivel de batería.
El vídeo en directo no arranca. El directo pasa por el flujo RTSP de la cámara. Ejecute Probar la conexión: indica cuándo RTSP está desactivado en una cámara. Actívelo en la aplicación Reolink (Ajustes → Red → Avanzado → Ajustes del servidor) y vuelva a lanzar una búsqueda.
Mis detecciones llegan con retraso. La cámara se consulta periódicamente en lugar de enviar sus eventos. Ejecute Probar la conexión: una cámara marcada con «detecciones comprobadas periódicamente» funciona con batería, está detrás de un Home Hub o un NVR, o tiene ONVIF desactivado. En este último caso, active ONVIF en la aplicación Reolink y vuelva a lanzar una búsqueda.
Se encuentra una cámara pero Gladys indica que las credenciales son rechazadas. La cuenta utilizada debe poder leer los ajustes de la cámara. Un usuario restringido funciona, pero una cuenta de «invitado» no siempre tiene los permisos necesarios.
Mi foco se apaga solo. La cámara aplica su propia programación de iluminación. Cuando enciende el foco desde Gladys, la integración amplía esa programación a todo el día, y restablece sus propios ajustes cuando lo apaga desde Gladys. Un cambio hecho mientras tanto en la aplicación Reolink tiene prioridad.
Falta una posición en la lista. Las posiciones se leen al descubrir la cámara. Vuelva a lanzar una búsqueda después de guardar una nueva posición en la aplicación Reolink.
Una cámara de mi Home Hub no aparece. El hub solo lista las cámaras que puede alcanzar en ese momento. Compruebe que la cámara está alimentada y al alcance del hub, y vuelva a lanzar una búsqueda.
Una cámara con batería añadida antes de la versión 1.4.0 no tiene la función Cargando. La función es nueva: abra Descubrir, lance una búsqueda y actualice la cámara. La función se añade; las existentes, su historial y sus escenas se conservan.
Parámetros de configuración
Estos son los parámetros que Reolink te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Esta integración se comunica con sus cámaras directamente en su red — sin cuenta Reolink, nada pasa por la nube. Introduzca abajo la cuenta con la que accede a sus cámaras y luego vaya a la pantalla Descubrir y lance una búsqueda. Cada cámara recibe las funciones que realmente tiene: imagen y movimiento para todas, más detección de personas/vehículos/animales, batería, foco, sirena, timbre o PTZ según el modelo. Las cámaras con cable notifican sus detecciones al instante mediante ONVIF. |
| Usuario de las cámaras | string | Sí | El usuario con el que Gladys inicia sesión, el mismo que usa en la aplicación Reolink. admin en la mayoría de las instalaciones. Un usuario restringido también funciona, siempre que pueda leer los ajustes de la cámara. |
| Contraseña de las cámaras | secret | Sí | La contraseña de ese usuario. Si no todas sus cámaras tienen la misma, rellene más abajo el campo de cuentas por cámara. |
| Calidad de imagen | select | No | HD captura el flujo a resolución completa y lo reduce si es necesario; SD pide directamente el flujo ligero de la cámara — menos nítido, pero más rápido y más económico para una cámara con batería. |
| Avanzado | section | No | Rellene estos campos solo si una cámara no se encuentra automáticamente, o para ajustar cómo se vigilan las cámaras. |
| Direcciones de las cámaras | string | No | Direcciones separadas por comas, por ejemplo 192.168.1.42, 192.168.1.43. Gladys busca sus cámaras en la red por sí mismo; rellene este campo para una cámara que la búsqueda no encuentra (otra VLAN, broadcast filtrado por el router). Añada :puerto si una cámara no usa el puerto estándar, por ejemplo 192.168.1.42:8000. |
| Cuentas por cámara | secret | No | Solo es necesario cuando una cámara tiene credenciales distintas de las anteriores. Cámaras separadas por comas, cada una como dirección|usuario|contraseña — por ejemplo 192.168.1.42|gladys|MiContraseña. |
| Intervalo de comprobación de detecciones (s) | number | No | Frecuencia con la que la integración pregunta a las cámaras que no envían sus detecciones (modelos con batería, cámaras detrás de un Home Hub o un NVR, u ONVIF desactivado) si se está detectando algo. Esas cámaras informan de su estado actual y no de un historial: este intervalo ES su retraso de detección — más corto reacciona antes pero las consulta más a menudo. |
| Detecciones instantáneas (ONVIF) | boolean | No | Las cámaras con cable a las que se accede directamente envían sus eventos de movimiento, persona/vehículo/animal y timbre en el momento en que se producen, en lugar de ser consultadas cada pocos segundos. ONVIF debe estar activado en la cámara (aplicación Reolink → Ajustes → Red → Avanzado → Ajustes del servidor). Una cámara que no responde por ONVIF se consulta automáticamente. |
| Tiempo límite de captura (s) | number | No | Tiempo concedido a una cámara para responder. Los modelos con batería que salen del reposo necesitan más tiempo que una cámara con cable. Por encima de 14 s, la vista en directo del panel puede expirar antes, pero la actualización programada se completa igualmente. |
| Intervalo de actualización de imágenes (s) | number | No | Frecuencia con la que se captura una nueva imagen para el panel, SOLO en cámaras CONECTADAS A LA RED ELÉCTRICA. Las cámaras con batería o solares tienen su propio ajuste más abajo: mantener frescas las imágenes de las cámaras con cable no cuesta nada a las demás. |
| Protección de la batería | section | No | Capturar imágenes es lo que agota una cámara con batería o solar. Estos ajustes se aplican SOLO a los modelos con batería o solares — las cámaras con cable mantienen su propio intervalo y nunca se ralentizan. Cuando una cámara baja del límite de pausa, la captura se reanuda en cuanto vuelve a estar en su cargador, o cuando alcanza el nivel de reanudación: una recarga parcial reiniciaría la descarga, y los ciclos cortos repetidos desgastan la batería más rápido. |
| Intervalo de actualización de cámaras con batería (s) | number | No | Frecuencia con la que se captura una cámara con batería o solar, independientemente de sus cámaras con cable. Despertar la cámara es lo que gasta la batería, así que este es el ajuste más eficaz: 900 s (15 min) dan tiempo a un panel solar para recargar entre dos capturas. Bájelo solo si sus cámaras se cargan más rápido de lo que se descargan. |
| Pausar la captura automática por debajo de (%) | number | No | Por debajo de este nivel se detiene la actualización automática. Abrir el widget de la cámara o una detección sigue capturando una imagen. |
| Detener toda captura por debajo de (%) | number | No | Por debajo de este nivel no se captura ninguna imagen, ni siquiera a petición. El nivel de batería y las detecciones se siguen leyendo: no cuesta casi nada y permite saber cuándo se ha recargado la cámara. |
| Reanudar la captura automática al (%) | number | No | Una vez en pausa, una cámara permanece así hasta alcanzar este nivel — deliberadamente muy por encima del límite de pausa, para que no vuelva enseguida a la descarga de la que acaba de salir. Una cámara conectada a su cargador se reanuda de inmediato, así que este ajuste solo afecta a la recarga solar. Evite el 100 %: una cámara solar se carga a tirones y rara vez marca exactamente lleno, lo que la dejaría en pausa indefinidamente. |
Cómo instalar Reolink en Gladys
- En Gladys, abre Integraciones: Reolink 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/william-de71/gladys-reolink:1.4.2), 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/William-De71/gladys-reolink.
Reolink requiere Gladys >=5.0.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.
Guías relacionadas
- URL RTSP de Reolink: activa RTSP y encuentra la URL del flujo de tu cámara.
Sobre las integraciones externas
Reolink 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 William-De71, 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