How Tos

Aplicar un logo a un Live stream en emisión

Pon o quita el logo de un Live stream mientras está al aire, sin detener la emisión.

Available in: UI · API

Pon o quita la mosca / logo de un Live stream en emisión sin detener el broadcast. La operación de runtime es runtimeApplyLogo; persiste el cambio en el broadcast y el encoder lo aplica en el siguiente keyframe.

Cuándo usar esto

Cuando un logo debe añadirse, sustituirse o quitarse mientras el broadcast emite — por ejemplo una mosca de patrocinador para un bloque de programa, o un evento de derechos que obliga a retirarla temporalmente.

Prerrequisitos

Un Live stream actualmente en emisión (LiveStream.status = 2).
Un usuario con rol Operator o System Administrator.
Un Asset de imagen en el bucket logos — lista los disponibles con listAssets({ fileType: "logos" }) o abre Assets en la UI.

Via UI

Navegación: On air → <fila> → pestaña Logo 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 Logo

Pulsa el icono Logo (logo.svg) en el cluster de runtime. El panel Logo se renderiza inline.

Elige un logo y la posición

Logo — elige un Asset del bucket logos.
Position — elige una de las nueve posiciones: Center, Left, Right, Top, Bottom, Top-Left, Top-Right, Bottom-Left, Bottom-Right.

Envía. El logo aparece en la salida en el siguiente keyframe.

Quita el logo

Envía el mismo panel con el campo Logo vacío (filename vacío). La posición se conserva para que una llamada posterior vuelva a aplicar un logo sin tener que reespecificarla.

Via API

Acción	Método + ruta	operationId
Aplicar o quitar el logo	`POST /c21apiv2/livestreams/{id}/runtimeOptions/logo`	`runtimeApplyLogo`

curl -X POST "https://<tu-host>/c21apiv2/livestreams/<livestreamId>/runtimeOptions/logo" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "logo": {
      "filename": "station.png",
      "position": "Top-Right"
    }
  }'

Cuerpo:

Campo	Notas
`logo.filename`	Filename de Asset del bucket `logos`. Un string vacío limpia el logo conservando la posición.
`logo.position`	Uno de los valores canónicos del enum `LogoPosition` listados arriba. El entero bitmask legacy se sigue aceptando en entrada por compatibilidad.

La respuesta es el envelope estándar con data: null — las operaciones de runtime no devuelven el nuevo estado. Para confirmar, llama a GET /c21apiv2/livestreams/{livestreamId} e inspecciona la propiedad Logo.

Verificar

La salida del broadcast muestra el nuevo logo en el siguiente keyframe.
GET /c21apiv2/livestreams/{livestreamId} devuelve la propiedad Logo actualizada con el nuevo filename y la posición.

FAQ

Las operaciones de runtime van dirigidas a un broadcast en emisión. Con LiveStream.status = 0, la llamada sigue persistiendo el nuevo estado del logo pero solo aplica en el siguiente arranque.

Cualquier Asset cuyo fileType sea logos. Lístalos con listAssets({ fileType: "logos" }). Consulta Logos para el catálogo.

Cortar un clip en el Editor y enviarlo a MediaCopilot

Abre una grabación en el Editor de grabaciones, corta un clip y entrégalo a MediaCopilot para transcripción, subtitulado y generación de clips.

Hacer blackout o sustituir el programa de un Live stream

Pasa a un frame negro, sustituye la salida con un fichero de medios o vuelve a la entrada en directo — sin detener la emisión.