Integración externa - UniFi Protect (cámaras, videoporteros, detecciones)

¡Hola a todos! :waving_hand:

Ya he hecho la integración de UniFi Network, pero faltaba su hermana para quienes tienen cámaras Ubiquiti: UniFi Protect. Es la segunda integración de cámara más utilizada en Home Assistant, y no existía en la tienda. Funciona a través de la API oficial de la consola, de forma local, sin cuenta en la nube de Ubiquiti.

¿Qué hace?

  • Cámaras: la imagen (actualizada regularmente, en cada detección y bajo demanda), en línea o no, el movimiento y las detecciones inteligentes persona/vehículo/animal/paquete (solo las que su cámara pueda hacer).
  • Timbres: la pulsación del timbre.
  • Proyectores (Floodlight): encender, volver a su modo, detección de movimiento.
  • Sensores UP-Sense: apertura, temperatura, humedad, luminosidad, movimiento, fuga de agua, batería, según cómo estén colocados.
  • Dos disparadores de escena: « objeto detectado » (filtrable por cámara y por tipo: persona, vehículo…) y « se toca el timbre ». Se activan una vez que la imagen fresca llega a Gladys, para que la notificación tenga la foto correcta.
  • Dos acciones de escena: actualizar la imagen de una cámara y cambiar el mensaje mostrado en el timbre.
  • Un widget « Protect »: cámaras en línea, detecciones de las últimas 24 horas y las últimas detecciones con su imagen.
  • Una acción que te da la dirección RTSP de una cámara, para pegarla en la integración « Cámara RTSP » de Gladys para el flujo de video.
  • En francés, inglés, alemán y español.

La parte divertida

Persona detectada frente al garaje de noche → notificación con la foto y el proyector se enciende
Se toca el timbre → la foto del visitante en el teléfono, y el timbre muestra « ¡Voy! »

Instalación

:warning: Gladys 5.1 mínimo, y una consola con una versión reciente de Protect (Protect 6 o más reciente, que tiene la API « Integration »).

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub

  1. En la consola UniFi: Settings → Control Plane → Integrations, crea una clave de API.
  2. En Gladys: la dirección de la consola y la clave. La consola tiene un certificado auto-firmado: marca la opción prevista para aceptarlo (está desactivada por defecto, a propósito).
  3. Probar la conexión, luego pestaña Descubrimiento para agregar tus cámaras y sensores.

Pequeñas reservas honestas

  • Desarrollado sin consola Protect (no tengo cámaras UniFi): todo se ha probado con respuestas reales de Protect, tomadas de las pruebas de la biblioteca uiprotect de Home Assistant. Tus comentarios son bienvenidos, especialmente sobre las detecciones y el timbre.
  • La API oficial no permite ni activar la grabación ni cortar las notificaciones: estas acciones no existen.
  • El flujo de video pasa por la integración RTSP de Gladys, no por esta.

Como las anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a Ubiquiti.

Repositorio: GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub