How Tos

Activar / desactivar un Publishing en mitad de la emisión

Activa o desactiva un Publishing en un Live stream en emisión sin reiniciar el broadcast.

Available in: UI · API

Usa este how-to para incorporar o sacar un Destination de un broadcast en emisión — por ejemplo para cortar una distribución SRT mientras la ruta HLS principal sigue emitiendo, o para activar un Destination Record a mitad de un programa. La operación de runtime es runtimeTogglePublishings; actualiza el estado por entrypoint del broadcast y el encoder reconcilia en unos segundos.

Cuándo usar esto

Cuando un Destination debe activarse o desactivarse en mitad de la emisión — sin cambiar su escala de bitrates, sus pistas de audio ni ninguna otra configuración. Esos cambios requieren un stop + edit + start completo.

Prerrequisitos

Un Live stream actualmente en emisión (LiveStream.status = 2).
Un usuario con rol Operator o System Administrator.
El Destination debe estar ya enlazado al Destination group del Live stream. Esta operación solo activa / desactiva enlaces existentes; no añade ni elimina Destinations.

Via UI

Navegación: On air → <fila> → pestaña Destinations del panel de runtime.

Abre el panel de runtime

Pulsa la fila del Live stream en emisión en On air para desplegar su panel de runtime.

Cambia a la pestaña Destinations

Pulsa el icono Destinations (publishing.svg) en el cluster de runtime. El panel lista cada Destination del Destination group enlazado con dos toggles por fila: Primary y Backup.

Conmuta

Tipo de destino	Toggle Primary	Toggle Backup
Con backup URL configurada (RTMP, SRT, FMS, HLS, IPTV, STREAM con backup)	On/off independiente para la URL primary	On/off independiente para la URL backup
Destino de un solo canal (Record, SDIOUT, STREAM sin backup)	On/off	No-op (aceptado por simetría)

Envía. El encoder recoge el nuevo estado en unos segundos; la fila del destino refleja el cambio en el siguiente tick de polling.

Via API

Acción	Método + ruta	operationId
Alternar Destinations	`POST /c21apiv2/livestreams/{id}/runtimeOptions/publishings`	`runtimeTogglePublishings`

curl -X POST "https://<tu-host>/c21apiv2/livestreams/<livestreamId>/runtimeOptions/publishings" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "toggles": [
      { "entry_point_id": 19, "primary": true,  "backup": false },
      { "entry_point_id": 21, "primary": false, "backup": false }
    ]
  }'

Cuerpo (PublishingToggleItem):

Campo	Notas
`toggles[]`	Una entrada por entrypoint de Destination a actualizar. Los entrypoints no listados conservan su estado actual. Mínimo un elemento.
`toggles[].entry_point_id`	Id numérico del entrypoint del Destination.
`toggles[].primary`	Si la ruta primary queda activa. Omitir para no cambiarla.
`toggles[].backup`	Si la ruta backup queda activa. Omitir para no cambiarla. Al menos uno de `primary` / `backup` debe suministrarse.

Restricción. Solo el estado on/off es mutable mientras el broadcast emite. Para cambiar las renditions que emite un Destination (el bitmask qualities) o las pistas de audio que lleva (el bitmask audios), detén el Live stream con POST /c21apiv2/livestreams/{id}/stop, edítalo con PUT /c21apiv2/livestreams/{id} y arráncalo de nuevo. Enviar qualities o audios en este cuerpo devuelve APIf001.

Respuesta. El envelope devuelve { livestream_id, detail_id, entry_points_updated[] } — la lista de entry points cuyo estado se actualizó realmente.

Verificar

GET /c21apiv2/livestreams/{livestreamId} devuelve los flags primary / backup por entrypoint actualizados en cada Destination.
La fila del Live stream en On air refleja los Destinations activos.
Un Destination recién activado empieza a emitir en unos segundos; un Destination desactivado deja de emitir.

FAQ

No. runtimeTogglePublishings solo activa o desactiva Destinations ya enlazados al Live stream a través de su Destination group. Para añadir un nuevo Destination, detén el Live stream, actualiza el enlazado y arráncalo de nuevo.

Cambiar la fuente de un Live stream en emisión

Apunta un Live stream en emisión a un Channel distinto sin detener el broadcast.

Contribuir una señal en directo a MediaCopilot Live

Empuja la salida HLS de un Live stream a MediaCopilot en tiempo real para que aparezca como live asset en el lado de MediaCopilot.