RTMP¶

media.ingest.rtmp

Descripción¶

Sapsan puede tomar un stream RTMP de otro servidor en modo cliente (pull). Para aceptar publicaciones RTMP entrantes (push hacia Sapsan), vea publicación.

Configuración¶

Configure el stream mediante la API de central. Fragmento de configuración:

streams:
  - name: relay
    inputs:
    - rtmp:
        url: rtmp://origin.example.com/live/streamkey
        peer_timeout_ms: 5000

Parámetros¶

Parámetro	Descripción
`url`	dirección del stream RTMP remoto.
`peer_timeout_ms`	espera sin datos.

Autenticación¶

Indique las credenciales en la URL: rtmp://user:password@origin.example.com/live/streamkey. Se admite autenticación Adobe/FMS authmod=adobe.

Opciones de transporte¶

RTMP sobre TCP. Se admiten streams solo de audio.

Códecs admitidos¶

H.264
HEVC (Enhanced RTMP, hvc1)
AV1 (Enhanced RTMP, av01)
AAC
MP3

RTMP transporta mensajes FLV; Enhanced RTMP identifica los códecs de vídeo mediante FourCC. La lista describe la recepción de frames comprimidos y su envío al procesamiento. AV1 requiere Enhanced RTMP con av01; seleccionar AV1 en el emisor sin este empaquetado no basta. MP3 se acepta como audio FLV, por separado de AAC.

Comportamiento ante errores¶

Los códigos de rechazo del servidor se distinguen y son visibles en el estado de la entrada: stream no encontrado, acceso denegado, stream detenido, error de protocolo. También se distinguen una conexión rota y un servidor silencioso (peer_timeout_ms). Ante cualquiera de estas causas, el LSI conmuta a una entrada de reserva.

Aplicación de cambios¶

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

Contadores¶

Las tablas indican los nombres exactos de los campos de estadísticas del protocolo, incluidos contadores de eventos e indicadores del valor actual. Los campos nulos pueden omitirse. API y Prometheus exponen proyecciones distintas; un único resultado de Admin API no incluye necesariamente toda la lista. El detalle depende de la licencia de contadores.

Totales comunes de entrada: bytes, frames, errors, warnings. Agregan datos del protocolo; no deben sumarse otra vez a los contadores del protocolo.

Rtmp¶

Campo	Tipo
`bytes`	`counter`
`outgoing_bytes`	`counter`
`frames`	`counter`
`rtmp_script_data`	`counter`
`memory_bytes`	`gauge`

Otros detalles¶

Los metadatos onMetaData acompañan al stream. Los metadatos opcionales dañados no detienen la captura de vídeo y audio.