Publicação RTMP¶

media.publish.rtmp

A fonte conecta-se ao Sapsan e envia o stream. Isso é publicação; a captura cliente de um servidor remoto pertence a media.ingest.

Configuração¶

Na consola, abra o stream, adicione uma entrada Publish explícita na posição desejada e configure a chave no cartão da entrada. Introduza a chave manualmente ou clique em Gerar nova chave: pelo menos 5 letras latinas, dígitos ou ._-. O campo é inputs[index].publish.rtmp_streamkey; configurar a chave não adiciona nem reordena entradas. Não há limite superior de comprimento. A geração cria uma chave aleatória de 10 caracteres.

O campo oculta a chave. Use o botão de cópia para configurar o codificador; o olho permite mostrar temporariamente o valor.

listeners:
  rtmp:
  - port: 1935
streams:
- name: studio
  inputs:
  - publish:
      rtmp_streamkey: Abc012._-Z

No OBS, use o servidor rtmp://server:1935 e a chave Abc012._-Z. Na API central, envie PATCH /central/api-v4/streams/configs/studio com {"inputs":[{"publish":{"rtmp_streamkey":"Abc012._-Z"}}]}. O array inputs é substituído por inteiro: inclua as outras entradas na ordem desejada, com todos os ajustes e segredos.

Quando uma fonte operacional precede publish, o codificador RTMP ou SRT é aceite como reserva. Após a recuperação da fonte principal e a janela limpa, mantém-se ligado como reserva. Um segundo codificador é recusado mesmo enquanto o primeiro está em reserva ou ainda não envia quadros utilizáveis. A mudança para vídeo espera o próximo quadro-chave; só áudio espera um quadro de áudio utilizável. Mantêm-se os tempos de espera da fonte e do transporte.

Autenticação¶

A chave autoriza a publicação RTMP na única entrada publish explícita. Sem chave, incluindo publish: {}, o RTMP é recusado; o nome do stream não substitui o segredo. O central valida atomicamente a unicidade na configuração atual de todo o cluster, incluindo streams desativados. Não é guardado histórico de chaves. A validação recusa uma segunda entrada publish e publish dentro de MBR.

Após aplicar a alteração ou limpeza da chave, o servidor desconecta a publicação RTMP atual e recusa a chave anterior. Limpar com rtmp_streamkey: null mantém a entrada publish. Alterar a chave RTMP preserva a publicação SRT; outras alterações mantêm a ligação RTMP quando a chave não muda.

Transporte¶

RTMP sobre TCP. O remetente se conecta ao listener RTMP compartilhado do servidor.

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¶

Um stream aceita uma publicação ativa por vez. Ao terminar a conexão, a fonte fica indisponível e aplicam-se as regras de reserva. O emissor inicia a reconexão.