Skip to content

Publicación RTMP mediante una clave

media.publish.rtmp_streamkey

La clave selecciona un stream y autoriza la publicación RTMP entrante. Sin rtmp_streamkey se rechaza la publicación, incluso si el stream declara una entrada publish.

Finalidad

El codificador necesita la dirección del servidor y la clave; no envía el nombre del stream en el comando de publicación. Conéctese al servidor configurado para recibir este stream. El enrutamiento automático de publicaciones entre servidores no está implementado.

Diferencia respecto a la publicación básica

La clave autoriza y selecciona el stream para la publicación RTMP. No cambia el transporte ni los códecs.

Configuración

En la consola, abra el stream, añada una entrada Publish explícita en la posición deseada y configure la clave en su tarjeta. Introduzca la clave manualmente o pulse Regenerar clave: al menos 5 letras latinas, dígitos o ._-. Se guarda en inputs[index].publish.rtmp_streamkey; configurar la clave no añade ni reordena entradas. No hay límite superior de longitud. La regeneración crea una clave aleatoria de 10 caracteres.

El campo oculta la clave. Use el botón de copia para configurar el codificador; el ojo permite mostrar temporalmente el valor.

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

En OBS, use el servidor rtmp://server:1935 y la clave Abc012._-Z. En la API central, envíe PATCH /central/api-v4/streams/configs/studio con {"inputs":[{"publish":{"rtmp_streamkey":"Abc012._-Z"}}]}. El array inputs se sustituye entero: incluya las demás entradas en orden, con todos sus ajustes y secretos.

La clave autoriza la publicación RTMP en la única entrada publish explícita. Sin clave, incluso con publish: {}, RTMP se rechaza; el nombre del stream no sustituye al secreto. Central comprueba atómicamente la unicidad en la configuración actual de todo el clúster, incluidos los streams desactivados. No se guarda historial de claves. La validación rechaza una segunda entrada publish y publish dentro de MBR.

Tras aplicar el cambio o borrado de la clave, el servidor desconecta la publicación RTMP actual y rechaza la clave anterior. Borrar con rtmp_streamkey: null conserva la entrada publish. Cambiar la clave RTMP conserva la publicación SRT; otros cambios conservan la conexión RTMP si la clave no cambia.

Si una fuente operativa precede a publish, el codificador RTMP o SRT se acepta como reserva. Tras la recuperación de la fuente principal y su ventana limpia, permanece conectado como reserva. Se rechaza un segundo codificador aunque el primero esté en reserva o aún no envíe cuadros utilizables. El cambio al vídeo espera el siguiente cuadro clave; solo audio espera un cuadro de audio utilizable. Se mantienen los tiempos de espera de fuente y transporte.

Qué sigue

Transporte

RTMP sobre TCP. La clave se envía como nombre de publicación; no cifra el transporte.

Códecs compatibles

Los mismos que en la publicación RTMP.