Proporcionar acceso RTSP a un sistema externo¶

Un sistema externo necesita acceso al vídeo de la cámara y un token de visualización independiente. Un token de acceso compartido de Watcher está vinculado a una cámara y define las acciones permitidas. Estos tokens se gestionan mediante API v3.

La conexión RTSP se establece con el streamer que sirve el vídeo, por lo que el sistema externo necesita acceso de red a su puerto RTSP. La dirección de la interfaz web de Watcher detrás de un proxy HTTPS no proporciona por sí sola ese acceso. Compruebe la compatibilidad con RTSP y el formato de la dirección del watcher-streamer instalado.

Procedimiento¶

Primero añada la cámara a Watcher y compruebe el vídeo en vivo. Obtenga el nombre de la cámara del campo name de la respuesta de la API. Inicie sesión como administrador de Watcher y obtenga un token de Admin API siguiendo las instrucciones de autenticación. Para crear un token de visualización, envíe:

POST /watcher/admin-api/v3/shares
Authorization: Bearer <admin_token>
Content-Type: application/json

{
  "name": "external-system-live",
  "media": "entrance-example",
  "permissions": [{"live":true,"dvr":false,"ptz":false,"export":false}]
}

Guarde key de la respuesta. Proporciona acceso a la cámara indicada. Establezca los permisos explícitamente: los permisos de visualización omitidos pueden interpretarse como permitidos. Cree un token independiente para cada sistema externo para poder revocarlo por separado.

Los tokens también están disponibles en la sección de acceso compartido de la cámara; consulte insertar una cámara en un sitio web.

Transmita el token en el parámetro token de la dirección de reproducción. Para una salida RTSP direccionada por el nombre del stream, la dirección tiene este formato:

rtsp://streamer.example.com:554/entrance-example?token=<key>

Utilice la dirección y el puerto reales de su salida RTSP. El destinatario del token puede utilizar el acceso concedido sin una cuenta de usuario; proteja la dirección como un secreto.

Acceso uniforme en un clúster¶

No sustituya la dirección comprobada por un streamer arbitrario. El acceso a través de distintos streamers depende de la configuración de entrega de vídeo y del enrutamiento de su instalación. Compruebe la dirección del sistema externo después de cambiar la ubicación de la cámara y tras un fallo del streamer que la sirve.

Guarde el identificador de la cámara por separado de la dirección del streamer en la integración. Así podrá actualizar la dirección de conexión manteniendo la asociación con la misma cámara.

Reproducción del archivo¶

Para leer el archivo, la cámara debe tener grabaciones y el token debe tener el permiso dvr: true. El permiso export se aplica a la exportación del archivo a un fichero y se establece por separado.

El permiso dvr por sí solo no determina el protocolo de reproducción. Compruebe el formato de la solicitud del archivo y su compatibilidad con RTSP en el watcher-streamer instalado. Después de la configuración, verifique que el sistema externo puede abrir un intervalo grabado y que se le deniega el acceso fuera de los permisos concedidos.

Multiplexación del acceso¶

Conecte los consumidores externos a la entrega de vídeo del servidor Watcher para que cada uno no abra su propia conexión directamente con la cámara. El número de conexiones de watcher-streamer con la cámara depende de las fuentes configuradas, incluidos el stream principal y el substream.

Revocar el acceso¶

Utilice una cuenta con permisos para gestionar cámaras en la Organización a la que pertenece el token. Para revocarlo, envíe:

DELETE /watcher/admin-api/v3/shares/<key>
Authorization: Bearer <admin_token>

La respuesta correcta es 204. Después, compruebe una nueva conexión del sistema externo: debe ser rechazada. Compruebe las conexiones ya abiertas por separado; eliminar un token no demuestra el cierre inmediato de todas las conexiones multimedia.