Emitir radio como vídeo

Available in: UI · API

Usa este how-to para emitir una fuente de radio (un Channel cuyo contenido principal es el audio) como un Live stream estilo TV. La pista de vídeo es una imagen o clip corto programable que el encoder transcodea; la pista de audio es siempre el directo de entrada. La pista visual se puede ir cambiando a lo largo del día — un fondo distinto por programa — sin interrumpir el audio nunca.

La feature combina dos piezas:

• El codec de vídeo logo del Encoding, que transcodea una imagen estática o un clip corto como vídeo H.264. Consulta la referencia de Encoding profiles para el listado de codecs.
• El flag Keep input audio during blackout en la operación de runtime Blackout, que genera el slate vídeo-only y reenvía el audio en directo del Channel sin tocar. Consulta Hacer blackout o sustituir el programa de un Live stream para la superficie completa de Blackout.

Cuándo usar esto

Cuando el contenido del Live stream es fundamentalmente audio — un programa de radio, un feed musical — pero el entregable es una señal estilo TV que espera una pista de vídeo. Patrón típico: una emisora de radio difunde un feed de audio continuo; el operador quiere una pista visual distinta por cada segmento del programa, sustituida sin cortar el audio nunca.

Prerrequisitos

• Un Channel cuyo audio en directo es fiable (SRT, Stream u otro Channel que transporte audio).
• Un usuario con rol Operator o System Administrator.
• Uno o más ficheros de medios (imágenes estáticas o clips cortos) subidos como Assets con fileType: "files" — son las pistas visuales entre las que el encoder alternará.

Via UI

Via API

El flujo por API es el mismo que por UI: configura el Encoding con video_codec = logo, y luego dispara las sustituciones visuales con runtimeApplyBlackout y keep_input_audio = true.

Sustituir la imagen; conservar el audio en directo:

curl -X POST "https://<tu-host>/c21apiv2/livestreams/<livestreamId>/runtimeOptions/blackout" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "File", "file": "afternoon_show.mp4", "keep_input_audio": true }'

Volver al logo configurado (imagen base):

curl -X POST "https://<tu-host>/c21apiv2/livestreams/<livestreamId>/runtimeOptions/blackout" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "Live" }'

Para la superficie API completa (body, respuesta, códigos de error, idempotencia sobre el flag keep_input_audio), consulta Hacer blackout o sustituir el programa de un Live stream y la subsección Blackout de la referencia de On air.

Verificar

• La fila del Live stream en On air refleja el modo Blackout actual y el fichero visual activo.
• Un reproductor consumiendo los Destinations publicados muestra la nueva imagen en unos segundos tras el swap y no reporta corte de audio.
• Un GET /c21apiv2/livestreams/{livestreamId}/status posterior devuelve keep_input_audio: true en el bloque de blackout mientras el swap está activo.

FAQ