RTMP¶

media.push.rtmp

Sapsan inicia una publicación saliente por RTMP. Un stream puede tener varios pushes con nombre.

Configuración¶

Aplique la configuración del stream mediante central.

Los pushes de un stream son un mapa de «nombre del push — configuración», no una lista. El nombre es único dentro del stream y sirve de clave: por él se encuentra el push en la configuración, en las estadísticas y en las métricas. Un push tiene exactamente un protocolo.

streams:
  - name: tv1
    inputs:
    - udp: {host: 239.0.0.1, port: 5000}
    pushes:
      delivery:
        rtmp:
          url: rtmp://a.rtmp.youtube.com/live2/xxxx-xxxx

El nombre es la identidad del push. Renombrarlo no traslada ni la configuración ni los contadores acumulados: el push antiguo desaparece y el nuevo empieza de cero.

Capacidades y comportamiento¶

• El push RTMP soporta H.264, AAC/MP3, HEVC y AV1 (enhanced RTMP), así como streams de solo audio; las marcas de tiempo en el push empiezan de cero, como esperan las CDN.
• Los errores del push se distinguen y quedan visibles en el estado: conexión rechazada, tiempo de espera de conexión, rechazo de publicación (NetStream.Publish.BadName — clave ocupada o incorrecta), servidor colgado (tiempo de espera de escritura de fotogramas).

Reconexión¶

El pusher no tiene política de reintentos propia — lo vuelve a levantar el stream. Cada cinco segundos el stream coteja los pushes en marcha con la configuración y reemplaza un pusher muerto por uno nuevo; el contador reconnects cuenta exactamente esos reemplazos. Por eso el envío a un destino inalcanzable nunca «se rinde» ni necesita reinicio manual: se seguirá levantando mientras el push esté activado.

Lo que no cuenta como reconexión:

• editar la configuración de un push — el pusher también se reinicia, pero es una decisión del operador, no un fallo del canal;
• desactivar y activar (enabled: false) — desactivar no es eliminar: la configuración y los contadores acumulados se quedan, solo se detiene el envío.

Desactivación y eliminación¶

Un push desactivado permanece en la configuración con su nombre: las estadísticas lo muestran como desactivado, sus contadores quedan congelados en los últimos valores, y al activarlo el conteo continúa desde ellos. Eliminar la clave elimina también las estadísticas: los contadores pertenecen al nombre.

Monitorización¶

Cada push tiene estadísticas propias — destino, estado, causa del fallo, velocidad, bytes, errores, reconexiones. La referencia de campos, las series de Prometheus y las recetas de alertas están en la página Estadísticas.

Transporte¶

RTMP sobre TCP; Sapsan abre una conexión saliente a url.

Códecs compatibles¶

• H.264
• HEVC (Enhanced RTMP)
• AV1 (Enhanced RTMP)
• AAC
• MP3

El push empaqueta las pistas codificadas en FLV sin transcodificarlas. Para HEVC y AV1, el receptor debe admitir Enhanced RTMP; admitir H.264/AAC no lo garantiza.