Inicio y parada
Arrancar y detener un Live stream son las dos acciones más usadas por el Operator. Ambas pasan por un diálogo de confirmación, ambas están expuestas desde la fila de On air y desde la lista de Live streams, y ambas pueden invocarse contra la API pública.
Ciclo de vida
El estado de runtime sigue el enum LiveStream.status:
status | Significado | UI |
|---|---|---|
0 | Off | El panel de estado muestra "Off". El editor queda desbloqueado. |
1 | Live | El panel de estado muestra "Live". El editor queda bloqueado. |
LiveStream.status es binario. La salud de runtime del encoder se reporta aparte sobre LiveStream.errorstatus — consulta Live streams overview para el mapping.
Arranque manual
Abre el Live stream
Selecciona el Live stream desde la lista de Live streams o desde la vista On air.
Confirma
El diálogo de confirmación muestra "Do you want to start this Live stream?" con la acción primaria "Start Live stream" y la secundaria "Cancel".
Levanta el encoder
C21 Live Control resuelve el encoder group, aplica el startConfig[] guardado y levanta el pipeline. La UI muestra un toast "Live stream started" una vez aceptado el arranque. El estado de runtime transita por starting (1) y aterriza en running (2); las flechas de la fila on-air reflejan cada entrypoint subiendo.
Equivalente API
El mismo flujo se ejecuta con la operación startLivestream. Los clientes deben llamar primero a getLivestreamStartConfig para obtener un idEncoderGroup válido y el último startConfig[] guardado; la respuesta también expone un boolean startAllowed que controla si el arranque puede proceder. Envía una cabecera Idempotency-Key en el POST para que los reintentos no dupliquen efectos.
Parada manual
El flujo de parada espeja al de arranque. El diálogo muestra "Do you want to stop this Live stream?" con la acción primaria "Stop Live stream". Al confirmar, C21 Live Control apaga la preview de runtime y luego detiene el broadcast; el estado vuelve a 0 y la fila on-air sale del listado.
En la API pública la operación equivalente es stopLivestream.
Parada de Live stream programado
Cuando el Live stream lo arrancó un Schedule (automatic = true), el diálogo de parada lleva una segunda línea:
Do you want to stop this Scheduled Live stream?The associated Schedule will be deleted.
Confirmar detiene el Live stream y borra el Schedule que lo dirigía. Para detener el Live stream sin perder el Schedule, edita el Schedule desde el Scheduler.
Lo que está y lo que no está expuesto
- No hay operación pública de Restart. Para reiniciar, detén y arranca de nuevo.
- No hay dry-run público en el arranque. La validación contra el Channel, Encoding y Destination enlazados — incluida la compatibilidad de entrada y target — se hace en servidor al arrancar; los fallos quedan en los logs del encoder.
- No hay operación pública de force-stop. Un
stopLivestreamnormal emite la parada; si un destino aguas abajo retiene el teardown, eso se refleja en el indicador del entrypoint en la fila on-air.
Compatibilidad de entrada y target
Al arrancar, C21 Live Control comprueba que el tipo de entrada del Live stream encaja con el grupo de encoders al que apunta y, si no, rechaza el arranque con un error específico:
- Entradas on-prem — SDI/ASI, AES-EBU, NDI, fichero local y YouTube Live — corren solo en un grupo de encoders on-prem, nunca en un target C21 Live Cloud.
- Entradas cloud — RTMP push, UDP-R Cloud y SRT Cloud — corren solo en un target C21 Live Cloud, nunca en un grupo on-prem.
- Entradas de captura física (SDI/ASI, AES-EBU) están cableadas a un Device concreto. Si el grupo on-prem elegido no contiene ese Device, el arranque se rechaza y el error nombra el Device a usar; el diálogo Start with options fija el selector de encoder a ese Device.
- Las entradas
StreamySRTno tienen esta restricción y arrancan donde su grupo lo permita.
Estas comprobaciones se ejecutan en servidor, así que las mismas reglas aplican tanto si arrancas desde la UI, la API o el servidor MCP.
Cross-links
- Live streams para el catálogo y el editor.
- Opciones del Live stream para las operaciones de runtime disponibles mientras el broadcast está al aire.
- Scheduler para arranque y parada en una ventana temporal.
FAQ
Record.