Publicación RTMP¶

media.publish.rtmp

La fuente se conecta a Sapsan y envía el stream. Es publicación; la captura cliente desde un servidor remoto pertenece a media.ingest.

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.

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.

Autenticación¶

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.

Transporte¶

RTMP sobre TCP. El emisor se conecta al listener RTMP compartido del servidor.

Códecs admitidos¶

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

RTMP transporta mensajes FLV; Enhanced RTMP identifica los códecs de vídeo mediante FourCC. La lista describe la recepción de frames comprimidos y su envío al procesamiento. AV1 requiere Enhanced RTMP con av01; seleccionar AV1 en el emisor sin este empaquetado no basta. MP3 se acepta como audio FLV, por separado de AAC.

Comportamiento ante errores¶

Un stream acepta una publicación activa a la vez. Al terminar la conexión, la fuente deja de estar disponible y se aplican las reglas de reserva. El emisor inicia la reconexión.