API Watcher: acceso móvil y agentes¶

En una instalación Optic en funcionamiento puede activar la compatibilidad con la aplicación móvil Flussonic Watcher y conectar cámaras mediante agentes. Optic necesita un origen HTTPS público accesible desde el teléfono, los agentes y Peeklio. La API y el vídeo deben estar disponibles en el mismo origen, por ejemplo https://optic.example.com.

Active la API Watcher¶

En una instalación mediante paquetes, cree /etc/optic/optic.yaml.d/90-mobile.conf:

optic:
  mobile_compat:
    enabled: true

Este directorio carga archivos con extensión .conf o .json. Un archivo posterior sustituye toda la sección optic: si ya contiene ajustes propios, consérvelos en el mismo bloque junto con mobile_compat.

Reinicie Optic:

systemctl restart optic

La opción activa la API de cliente Watcher para iniciar sesión y reproducir cámaras bajo /watcher/client-api/v3/. Está desactivada por defecto. Los cambios requieren reiniciar; la página Acceso móvil muestra el estado y genera códigos QR de inicio de sesión, pero todavía no modifica esta opción.

Conecte la aplicación móvil¶

Cree una cuenta personal de central. Complete cualquier cambio obligatorio de contraseña temporal antes de conectar la aplicación.
Entre en la consola desde el origen público de Optic y abra Acceso móvil.
Genere un QR para su cuenta y escanéelo en Watcher. El código caduca a los cinco minutos; un superadministrador puede generarlo para otra cuenta admitida.

Permisos de visualización de cámaras:

superadmin y admin — todas las cámaras de la instalación.
viewer — cámaras según content_labels: campo ausente permite todas; lista vacía, ninguna; lista no vacía, cámaras con al menos una etiqueta coincidente.
security y player — acceso móvil denegado.

La aplicación ofrece vídeo en directo y el archivo existente. Activar la API no activa por sí solo la grabación de la cámara.

Activar notificaciones de episodios¶

Configure la conexión con Peeklio en Conectar Optic e inicie sesión en la aplicación Watcher con su cuenta. Permita las notificaciones en el teléfono y active la campana de la cámara. Solo reciben notificaciones los destinatarios que conservan permiso para ver esa cámara.

Suscripciones admitidas:

Movimiento — nuevos episodios de movimiento.
Rostros — nuevos episodios de reconocimiento facial con la analítica configurada.
Vehículos — nuevos episodios de reconocimiento de vehículos con la analítica configurada.

El límite de notificaciones automáticas es común para el destinatario: como máximo una notificación cada diez minutos entre todas sus cámaras y dispositivos. Los eventos del intervalo no generan una notificación diferida adicional. Reiniciar Optic o desactivar y volver a activar la campana no restablece el límite. Los fallos temporales se reintentan después del mismo intervalo.

Para comprobar la entrega, seleccione Send test notification en los ajustes de la aplicación móvil. La prueba se envía a todos los dispositivos registrados en su cuenta y no requiere un evento de cámara ni la campana activada. Puede solicitarla sin esperar el intervalo de las notificaciones automáticas. La siguiente notificación automática no se permite hasta al menos diez minutos después del envío de la prueba.

Al pulsar una notificación de episodio se abre la cámara en el momento del episodio. Configure previamente la grabación y los eventos de cámara. La suscripción no envía el historial acumulado. Tras migrar desde Watcher sin importar los dispositivos, vuelva a iniciar sesión y active las notificaciones. Bloquear nuevas conexiones de agentes no desactiva los push existentes.

Permita añadir cámaras mediante agentes¶

Entre como admin o superadmin y abra Conexión de Optic en el menú de la consola.

Active Activar el registro de agentes.
Indique Origen del servicio Peeklio, por ejemplo https://api.peeklio.net, y Origen público de Optic, por ejemplo https://optic.example.com. Introduzca orígenes sin rutas adicionales.
Seleccione la Plantilla predeterminada de cámara entre las plantillas existentes de central. Si no hay ninguna, cree una con los ajustes de la cámara; una única plantilla disponible se selecciona automáticamente.
Pulse Guardar y después Registrar / actualizar instalación. Para una instalación nueva, deje vacíos Operator ID y la clave API de la instalación: Optic genera la clave y guarda el Operator ID recibido. Para una instalación existente, restaure primero sus Operator ID y clave API anteriores.
Pulse Comprobar conexión y verifique que la comprobación sea correcta.

Guardar los ajustes y registrar son acciones distintas. Tras el registro puede utilizar Operator ID para entrar en la aplicación. Reiniciar Optic no repite el registro.

Añadir una cámara desde el teléfono está disponible para admin y superadmin. Inicie en la aplicación la incorporación de una cámara con agente y siga el procedimiento elegido. El agente contacta con Peeklio, que envía sus datos a Optic. En Streams aparece una cámara ag-<agent_id> con la plantilla elegida. Su aparición no confirma la captura de vídeo: también debe configurar el streamer.

Configure la captura de vídeo mediante agentes¶

Abra Clúster → Streamers y los ajustes del streamer que capturará el vídeo. En una instalación de una máquina, seleccione el streamer local.
En Conexión, indique una Dirección pública de medios accesible para los agentes. Para una máquina, utilice la dirección pública de Optic: host optic.example.com, puerto 443, esquema https.
Guarde los cambios y espere a que el streamer aplique la configuración.

Al iniciar central o incorporar un nuevo nodo, central crea y guarda automáticamente la clave del túnel multimedia que falte para cada streamer, incluido el local. No es necesario introducir streampoint_key manualmente. Las claves existentes se conservan al reiniciar.

El agente establece su conexión de control con Optic mediante /endpoint/connect y el túnel multimedia con el streamer asignado mediante /streampoint/connect. Si Optic ya tiene un proxy inverso delante, ambas rutas deben permitir conexiones persistentes con HTTP Upgrade. Si el agente se conecta pero no hay vídeo, compruebe la dirección pública del streamer y la aplicación de su configuración.

Verifique el funcionamiento¶

Para comprobar el inicio de sesión, utilice una cuenta personal; curl solicitará la contraseña:

curl -sS --user operator1 --request POST --output /dev/null \
  --write-out '%{http_code}\n' \
  https://optic.example.com/watcher/client-api/v3/login

Se espera 200. Una contraseña incorrecta devuelve 401; una cuenta desactivada o un rol no admitido devuelve 403. Ante 404, compruebe 90-mobile.conf y el reinicio de Optic tras el cambio.

En Agentes, compruebe la conexión de control y la asociación del agente con un stream y un streamer. Abra la cámara y confirme el estado running y la reproducción de vídeo. Después compruebe la misma cámara en la aplicación móvil.

Desactive el acceso¶

Para desactivar el inicio de sesión y la reproducción móviles, configure enabled: false en 90-mobile.conf y reinicie Optic.

Para impedir que se añadan nuevos agentes, desactive Activar el registro de agentes en Conexión de Optic y guarde. Los agentes y streams existentes se conservan; estos ajustes no detienen por sí solos la grabación de las cámaras.

Teléfonos vinculados¶

Abra Teléfonos vinculados en el menú de Optic. Los administradores pueden ver el usuario propietario, modelo y plataforma, versión, fechas de registro y última confirmación push, y contadores de notificaciones enviadas y sin confirmar. La falta de confirmación no demuestra por sí sola que la notificación no apareciera en el teléfono.

Los dispositivos y las suscripciones se vinculan al nombre de usuario. Recrear una cuenta con el mismo nombre conserva los vínculos. Los tokens push no se muestran.

API del operador: GET /optic/api-v1/devices?offset=0. La respuesta contiene devices y next_offset. Si next_offset no es null, utilícelo como offset para la siguiente página. Cada página contiene hasta 100 registros.