Publicação RTMP por chave¶
media.publish.rtmp_streamkey
A chave seleciona um stream e autoriza a publicação RTMP recebida. Sem rtmp_streamkey, a publicação é rejeitada, mesmo que o stream declare uma entrada publish.
Finalidade¶
O codificador precisa do endereço do servidor e da chave; não envia o nome do stream no comando de publicação. Conecte-se ao servidor configurado para receber este stream. O roteamento automático de publicações entre servidores não está implementado.
Diferença em relação à publicação básica¶
A chave autoriza e seleciona o stream para a publicação RTMP. Não altera o transporte nem os codecs.
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.
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.
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.
Próximos passos¶
Transporte¶
RTMP sobre TCP. A chave é enviada como nome de publicação; não cifra o transporte.
Codecs compatíveis¶
Os mesmos da publicação RTMP.