Captura por RTSP¶

Sapsan toma el video de cámaras IP y de otras fuentes RTSP en modo cliente (pull).

Configuración¶

streams:
  - name: cam1
    inputs:
    - rtsp:
        url: rtsp://admin:password@10.0.0.5:554/stream0
        peer_timeout_ms: 5000

Parámetro	Descripción
`url`	dirección de la cámara; el usuario y la contraseña van en la URL
`peer_timeout_ms`	tiempo de espera de inactividad de la fuente, tras el cual la entrada se considera caída
`via_agent`	captura a través de un agente Peeklio (`agent://ID`) cuando la cámara está tras un NAT — vea la pasarela Peeklio

Autenticación¶

Se soportan Basic y Digest (con repliegue automático a Basic cuando la cámara rechaza Digest). Las credenciales se toman de la URL y no viajan en claro hacia la cámara cuando se usa Digest.

Códecs y transporte¶

El transporte es RTP/AVP/TCP (interleaved), robusto frente a NAT y firewalls. Se decodifican: video H264, HEVC, VP8, MJPEG; audio AAC, G.711 (PCMA/PCMU), Opus, MPEG-4; metadatos ONVIF (eventos de la cámara) directamente del stream RTP. Se manejan el desbordamiento y el retroceso de los timestamps RTP.

El analizador SDP está probado a fondo con cámaras reales: Axis, Hikvision, Dahua, Bosch, Panasonic, Uniview, Beward y otras — incluidas cámaras con un SDP defectuoso (PPS ausentes, SEI rotos).

Note

El audio G.711 no se reproduce por HLS — añada un transcodificador que recodifique el audio a AAC.

Aplicación de los cambios¶

El cambio de url o via_agent reinicia la fuente; el cambio de solo peer_timeout_ms se aplica en caliente.

Verificación¶

Abra http://server/streaming/v/cam1/index.m3u8 en un reproductor o solicite una captura de pantalla en http://server/streaming/live-preview-jpeg/cam1.