RTMP¶

media.push.rtmp

O Sapsan inicia uma publicação de saída por RTMP. Um stream pode ter vários pushes com nome.

Configuração¶

Aplique a configuração do stream pelo central.

Os pushes de um stream formam um mapa de «nome do push — configuração», não uma lista. O nome é único dentro do stream e serve de chave: é por ele que o push é encontrado na configuração, nas estatísticas e nas métricas. Um push tem exatamente um 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

O nome é a identidade do push. Renomeá-lo não leva nem a configuração nem os contadores acumulados: o push antigo desaparece e o novo começa do zero.

Capacidades e comportamento¶

• O push RTMP suporta H.264, AAC/MP3, HEVC e AV1 (enhanced RTMP), além de streams só de áudio; as marcas de tempo no push começam de zero, como as CDNs esperam.
• Os erros do push são distinguidos e ficam visíveis no status: conexão recusada, tempo limite de conexão, recusa de publicação (NetStream.Publish.BadName — chave ocupada ou errada), servidor travado (tempo limite de escrita de quadros).

Reconexão¶

O pusher não tem política de novas tentativas própria — quem o levanta de novo é o stream. A cada cinco segundos o stream coteja os pushes em execução com a configuração e substitui um pusher morto por um novo; o contador reconnects conta exatamente essas substituições. Por isso o envio para um destino inalcançável nunca «desiste» nem precisa de reinício manual: ele continuará sendo levantado enquanto o push estiver ativado.

O que não conta como reconexão:

• editar a configuração de um push — o pusher também é reiniciado, mas é uma decisão do operador, não uma falha do canal;
• desligar e ligar (enabled: false) — desligar não é excluir: a configuração e os contadores acumulados permanecem, só o envio cessa.

Desativação e exclusão¶

Um push desativado permanece na configuração com o seu nome: as estatísticas o mostram como desativado, seus contadores ficam congelados nos últimos valores, e ao ligá-lo a contagem continua dali. Excluir a chave exclui também as estatísticas: os contadores pertencem ao nome.

Monitoramento¶

Cada push tem estatísticas próprias — destino, status, causa da falha, taxa, bytes, erros, reconexões. A referência de campos, as séries do Prometheus e as receitas de alerta estão na página Estatísticas.

Transporte¶

RTMP sobre TCP; o Sapsan abre uma conexão de saída para url.

Codecs compatíveis¶

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

O push empacota faixas codificadas em FLV sem transcodificá-las. Para HEVC e AV1, o receptor deve aceitar Enhanced RTMP; o suporte a H.264/AAC, por si só, não garante isso.