Skip to content

Descubrimiento de cámaras

device.onvif.discovery

Sapsan puede descubrir cámaras ONVIF en la red, recibir sus eventos (movimiento, detección de personas y vehículos) y comprobar la compatibilidad de una cámara.

Descubrimiento de cámaras

Sapsan descubre las cámaras mediante WS-Discovery (solicitudes Probe multicast y respuestas ProbeMatch) y, además, entiende el protocolo de descubrimiento propietario de Hikvision. De cada cámara recopila las direcciones (XAddrs), el nombre y el modelo; las observaciones repetidas de una misma cámara se fusionan.

Al trabajar a través de NAT, las direcciones que una cámara comunica sobre sí misma (URL de snapshot, URL de RTSP) se reescriben automáticamente a la dirección del dispositivo realmente alcanzable.

Configuración de la cámara mediante ONVIF

Tras descubrir una cámara, Sapsan puede obtener su URL RTSP y configurar la propia cámara mediante ONVIF. Los parámetros disponibles dependen del modelo y de los permisos de su cuenta.

  1. Obtenga los perfiles con media/GetProfiles e identifique el token de la configuración del codificador.
  2. Lea media/GetVideoEncoderConfigurations y los valores permitidos mediante media/GetVideoEncoderConfigurationOptions.
  3. Modifique los campos necesarios de la configuración completa y envíela con media/SetVideoEncoderConfiguration. Permite ajustar resolución y frecuencia de fotogramas, bitrate y GOP, y un códec admitido por la cámara.
  4. Vuelva a leer la configuración y compruebe la entrada RTSP. La cámara puede reiniciar el codificador al aplicar los cambios.

Utilice POST /flussonic/api/onvif_call/{camera}/{service}/{method} en la interfaz HTTP de Sapsan. {camera} es el nombre del stream configurado cuya entrada proporciona la dirección de la cámara; para MBR se utiliza la primera fuente anidada. Ejemplo de consulta de perfiles:

curl --user admin -X POST \
  'http://sapsan.example.com:5080/flussonic/api/onvif_call/camera1/media/GetProfiles' \
  -H 'Content-Type: application/json' --data '{}'

La autorización en Sapsan y la cuenta de la cámara son independientes. Por defecto, las credenciales de la cámara se toman de la URL de entrada y ONVIF utiliza el puerto 80. x-onvif-auth: user:password sustituye las credenciales de la cámara; x-onvif-port, su puerto ONVIF. El cuerpo JSON contiene los argumentos del método ONVIF; las claves con $ representan atributos XML, como $token.

La configuración del stream mediante central controla la captura en Sapsan. SetVideoEncoderConfiguration modifica la propia cámara. Para PTZ y otras operaciones, consulte control ONVIF.

Siguientes pasos