Publicación RTMP con clave del stream¶

Prepare una transmisión en Agora, asígnele una clave de publicación y entregue la clave al operador del codificador. El codificador envía vídeo a esa transmisión existente; la dirección del servidor y la clave se introducen por separado.

Puerto de recepción¶

Abra Clúster → Streamers, seleccione el streamer receptor y abra Servidor. En la sección de puertos, rtmp debe contener un puerto de recepción, por ejemplo 1935. Si está vacío, añada el puerto y guarde. Permita que el codificador se conecte a ese puerto TCP.

En una instalación de un solo proceso, use la dirección del equipo Agora. En un clúster, conecte el codificador al streamer asignado para recibir la transmisión; la asignación aparece en la pestaña Layout del stream.

Transmisión y clave¶

1. En Streams, cree townhall-rtmp o abra una transmisión existente.
2. Abra Fuentes y seleccione Publish como protocolo de la fuente. Para añadir la publicación junto a fuentes existentes, pulse + Añadir fuente.
3. En Publicación RTMP, pulse Regenerar clave. También puede introducir una clave: al menos 5 letras latinas, dígitos o caracteres ._-. No hay límite superior de longitud. La regeneración crea una clave aleatoria de 10 caracteres.
4. Pulse Guardar y después el botón de copia a la derecha de Clave del stream.

La clave está oculta de forma predeterminada. A la derecha del campo están los botones:

• Ojo — mostrar u ocultar la clave; al salir del campo vuelve a ocultarse.
• Regenerar clave — crear una clave aleatoria nueva. Guarde los ajustes para aplicarla.
• Copiar valor — copiar la clave real sin mostrarla en pantalla.
• Eliminar clave — borrar la clave conservando la entrada Publish. Guarde los ajustes para desactivar la publicación RTMP.

La clave debe ser única en toda la instalación, incluidos los streams desactivados. Una clave duplicada impide guardar y muestra un error en el campo. Cada transmisión admite una sola entrada Publish; Publish dentro de MBR no está permitido. townhall-rtmp identifica la transmisión en el panel; el codificador recibe la clave.

Configuración del codificador¶

OBS¶

En OBS, seleccione un servidor RTMP personalizado. Introduzca por separado la dirección del servidor y la clave:

Sustituya agora.example.org por la dirección del streamer receptor y 1935 por el puerto configurado. La dirección del servidor no requiere una ruta de aplicación. El codificador no usa las credenciales del administrador de Agora: la clave autoriza la publicación.

Para este procedimiento, seleccione vídeo H.264 y audio AAC; después inicie la transmisión en el codificador.

FFmpeg¶

Con FFmpeg puede publicar un patrón de prueba y un tono sin un archivo de entrada. El ejemplo requiere una compilación con libx264. Sustituya Abc012._-Z por la clave guardada en Agora y use la dirección del streamer receptor:

RTMP_STREAM_KEY='Abc012._-Z'
ffmpeg -hide_banner \
  -re -f lavfi -i 'testsrc2=size=1280x720:rate=25' \
  -f lavfi -i 'sine=frequency=440:sample_rate=48000' \
  -c:v libx264 -preset ultrafast -pix_fmt yuv420p -b:v 1800k -g 50 \
  -c:a aac -b:a 128k \
  -f flv -rtmp_app '' -rtmp_playpath "$RTMP_STREAM_KEY" \
  'rtmp://agora.example.org:1935'

La clave se pasa por separado con -rtmp_playpath; -rtmp_app '' establece un nombre de aplicación vacío. No se necesita la ruta /live. Pulse Ctrl+C para detener la publicación.

Comprobar la recepción¶

Vuelva a Fuentes. La entrada Publish muestra un estado operativo y los parámetros de las pistas recibidas. Esta configuración recibe vídeo H.264 y audio AAC.

Si una fuente principal operativa precede a Publish, el codificador permanece conectado como reserva. Cuando desaparece la fuente principal, el vídeo empieza en el siguiente fotograma clave. El retorno de la fuente principal tras la ventana limpia mantiene abierta la conexión de reserva.

Cambiar o desactivar la clave¶

Para cambiar de codificador, detenga la publicación anterior y conecte el nuevo con la misma clave. El servidor rechaza un segundo publicador simultáneo, incluso si el primero está en reserva.

Para revocar la clave anterior, genere otra o borre el campo y guarde. Cuando el streamer receptor aplique el cambio, la publicación RTMP actual se desconectará. La entrada Publish permanece; cambiar la clave RTMP no desconecta una publicación SRT. Otros ajustes mantienen abierta la conexión RTMP si la clave no cambia.