RTMP¶

media.ingest.rtmp

Descrição¶

Sapsan pode puxar um stream RTMP de outro servidor em modo cliente (pull). Para aceitar publicações RTMP de entrada (push para o Sapsan), veja publicação.

Configuração¶

Configure o stream pela API do central. Trecho de configuração:

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

Parâmetros¶

Parâmetro	Descrição
`url`	endereço do stream RTMP remoto.
`peer_timeout_ms`	espera sem dados.

Autenticação¶

Informe as credenciais na URL: rtmp://user:password@origin.example.com/live/streamkey. A autenticação Adobe/FMS authmod=adobe é compatível.

Opções de transporte¶

RTMP sobre TCP. Streams somente de áudio são compatíveis.

Codecs compatíveis¶

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

RTMP transporta mensagens FLV; Enhanced RTMP identifica os codecs de vídeo por FourCC. A lista descreve a recepção de frames comprimidos e seu envio ao processamento. AV1 requer Enhanced RTMP com av01; selecionar AV1 no emissor sem esse empacotamento não basta. MP3 é aceito como áudio FLV, separadamente de AAC.

Comportamento em caso de erro¶

Os códigos de recusa do servidor são distinguidos e aparecem no status da entrada: stream não encontrado, acesso negado, stream parado, erro de protocolo. Uma conexão rompida e um servidor silencioso (peer_timeout_ms) também são distinguidos. O LSI comuta para uma entrada reserva em qualquer desses casos.

Aplicação de alterações¶

A troca de url reinicia a fonte; a troca apenas de peer_timeout_ms é aplicada em tempo real.

Contadores¶

As tabelas mostram os nomes exatos dos campos de estatísticas do protocolo, incluindo contadores de eventos e indicadores do valor atual. Campos zerados podem ser omitidos. API e Prometheus expõem projeções diferentes; uma única resposta da Admin API não contém necessariamente toda a lista. O detalhe depende da licença de contadores.

Totais comuns da entrada: bytes, frames, errors, warnings. Eles agregam dados do protocolo; não devem ser somados novamente aos contadores do protocolo.

Rtmp¶

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

Outros detalhes¶

Metadados onMetaData acompanham o stream. Metadados opcionais danificados não interrompem a captura de vídeo e áudio.