Glosario
Las definiciones están alfabetizadas por término. Donde una entrada nombra un esquema, campo o valor enum de OpenAPI se cita para que el lector pueda localizarlo en openapi.yaml.
A
ABR ladder. Adaptive-bitrate ladder. Lista ordenada de renditions entre las que un reproductor puede alternar al cambiar la red; producida por un Encoding group.
API base path. Cada endpoint REST vive bajo /c21apiv2. La URL completa es https://<host>/c21apiv2/….
API token. Cadena bearer opaca emitida por POST /c21apiv2/security/tokens y devuelta exactamente una vez al crearla. Se pasa en la cabecera estándar Authorization: Bearer <token>. Los tokens son propiedad de un usuario y heredan su rol.
Asset. Fichero de medios gestionado por C21 Live Control y reutilizable entre Live streams. El endpoint listAssets expone tres buckets: logos, files, clips.
Audit log. Historial de mutaciones autenticadas que el servidor mantiene a nivel de plataforma. La superficie de auditoría varía por deploy; no hay una pestaña UI unificada de Audit log en esta versión.
B
Bitrate. Tasa de datos de un stream, en kilobits o megabits por segundo.
Broadcast. Acto de distribuir un Live stream a uno o varios Destinations.
C
CBCS. Esquema Common Encryption — AES-128 en modo CBC con subsample skipping (cbcs). Uno de los dos valores de Publishing.drm.encryption_mode; esquema por defecto para salidas FairPlay.
CENC. Esquema Common Encryption — AES-128 en modo CTR (cenc). Uno de los dos valores de Publishing.drm.encryption_mode; usado por Widevine y PlayReady.
CKC. Content Key Context. El payload de licencia que un servidor de licencias FairPlay devuelve en respuesta a una petición SPC del reproductor.
Channel. Entidad detrás de la sección UI Sources. El enum Channel.type expone 10 valores: File, SDI, Stream, AES/EBU, RTMP-Push, UDP-R Cloud, SRT, SRT Cloud, NDI, Youtube Live. La UI cara al cliente agrupa RTMP-Push, SRT Cloud y UDP-R Cloud bajo la etiqueta única "Stream – C21 Live Cloud".
Channel type. Valor del enum Channel.type (ver arriba).
C21 Live Cloud. Plataforma cloud gestionada que provee capacidad de encoding cloud a la que Live Control puede despachar junto con los encoders on-prem. Gestionado en Integrations → C21LiveCloud (addC21LiveCloudAccount, validateC21LiveCloudAccount).
C21 Live Cloud account. Cuenta persistida que enlaza Live Control con la plataforma C21 Live Cloud; respaldada por el esquema C21LiveCloudAccount (client, client_id, password solo-escritura, enabled).
Codec. Estándar de compresión de vídeo o audio aplicado por un Encoding. Valores de vídeo expuestos por Encoding.settings_video.codec: h264, hevc, av1, mp4v, vp9, mpgv, copy. Valores de audio expuestos por Encoding.settings_audio.codec: mp4a, aacp, opus, mp3, mpga, copy. La página de Encodings documenta el subconjunto soportado para nuevos perfiles; los valores legacy aparecen aquí porque siguen en el esquema.
D
DASH. Dynamic Adaptive Streaming over HTTP. Uno de los valores de Publishing.type.
Destination. Entidad detrás de la sección UI Destinations. El enum Publishing.type expone: HLS / TS, DASH, CMAF, RTMP, Enhanced RTMP, SRT, STREAM, SDIOUT, Record.
Destination group. Ramillete con nombre de Destinations activados juntos. Campos: id, name, description, elements[] (IDs de Destination).
Device. Entidad detrás de la sección UI Devices. Una instancia de C21 Live Encoder emparejada con el plano de control; campos incluyen alias, location, ip_address, type, enabled, mountstatus, licensed.
Device group. Conjunto de Devices que actúan como un único pool de asignación. Campos: id, name, description, devices[]. Todos los miembros deben compartir el mismo type.
DRM. Digital Rights Management. Live Control asocia DRM a un Destination mediante su bloque drm; la plataforma soporta los esquemas Widevine, PlayReady y FairPlay (DrmProvider.supported_systems lista los esquemas que el proveedor sirve; Publishing.drm.systems selecciona cuáles se anuncian en el manifest) bajo uno de dos modos de cifrado (cenc, cbcs). El spec OpenAPI emite supported_systems en mayúsculas y Publishing.drm.systems en TitleCase — la UI y este glosario usan TitleCase por legibilidad.
DRM provider. Entrada de catálogo que guarda las credenciales de un servicio DRM upstream. Respaldado por el esquema DrmProvider; provider_type lo dirige el servidor (hoy: AXINOM, EZDRM).
E
Encoder. Término genérico para el proceso encoder que corre en un Device.
Encoding. Entidad detrás de la sección UI Encodings. Agrupa ajustes de vídeo y audio. El esquema expone settings_video.codec, settings_audio.codec, bitrate, resolución, fps, modo HDR y knobs específicos del codec.
Encoding group. Conjunto ordenado de Encodings enlazados a un Live stream como una escala multi-rate. Campos: id, name, pipeline (solo lectura, derivada del primer miembro), description, quality_order (asc / desc, dirige el orden de la escalera ABR), elements (IDs de los Encodings miembros).
Entrypoint. Punto en el que una etapa de un Live stream en marcha (el Channel, el Encoding o un Destination) entra o sale del broadcast. Aparece en la fila on-air como una flecha coloreada cuyo color refleja el estado en runtime.
F
Failover. Sustitución automática de una fuente degradada por el siguiente miembro de su grupo. Logueado en los events del Live stream.
FairPlay. El esquema DRM de Apple; en Live Control viaja sobre CMAF (CBCS). Uno de los tres valores de DrmProvider.supported_systems.
FairPlay Streaming (FPS). Perfil DRM de Apple para HTTP streaming. Distinto de frames per second, que también se abrevia fps.
FQDN. Fully Qualified Domain Name.
G
GOP. Group of Pictures — el segmento de frames acotado por keyframes en un stream de vídeo.
Group. Término genérico usado por Encoding groups, Destination groups, Device groups y User groups. El significado exacto lo desambigua el prefijo.
H
HLS. HTTP Live Streaming. Disponible tanto como pull de Channel (bajo el tipo Stream) como origen Destination (HLS / TS).
HEVC. High Efficiency Video Coding (H.265). Uno de los valores de Encoding.settings_video.codec (hevc).
I
I-frame. Frame intra-codificado; un keyframe autocontenido.
Ingest. Acto de recibir un feed de entrada.
Idempotency key. Cabecera (Idempotency-Key) que los clientes pueden adjuntar a peticiones mutantes; si el deploy lo soporta, los reintentos no duplican efectos. Verifica con tu equipo de plataforma antes de basar un cliente en este comportamiento.
K
Keyframe interval. Distancia, en segundos o frames, entre I-frames consecutivos. Equivalente a la longitud de GOP en la mayoría de casos prácticos; expuesto por codec en el Encoding (por ejemplo Encoding.settings_video.h264.keyframe_interval).
L
License. Allowance instalado en la instancia. Gestionado vía installLicense, getSystemLicenses, downloadSystemInfo.
License server. Servicio remoto que emite content keys a un reproductor bajo demanda. Live Control integra con los servidores de licencia de los DRM providers registrados.
Live Control. El producto documentado en este sitio.
Live stream. Broadcast configurado y con nombre que enlaza un Channel, un Encoding (o Encoding group) y un Destination (o Destination group) a un Device. LiveStream.status es un entero con 4 valores: 0 parado / inactivo, 1 arrancando (transitorio), 2 running, 3 error / fallo; la UI condensa status > 0 a "Live" y status = 0 a "Off".
M
Manifest. Fichero HLS .m3u8 o DASH .mpd que describe las renditions y segmentos de una salida empaquetada.
MCP. Model Context Protocol. El protocolo abierto que habla el servidor MCP de C21 Live Control para exponer las operaciones de streaming a cualquier agente o automatización compatible con MCP.
MCP profile. Perfil del servidor que acota el toolset que un cliente MCP puede llamar. Hoy: voice, readonly, operator, full. Activable vía la variable de entorno TOOL_PROFILE del servidor MCP en el deploy; el default cuando la variable no se establece es full. Deploys NOC deberían fijar TOOL_PROFILE=voice para una superficie curada.
MediaCopilot. Servicio de Cires21 de transcripción, subtitulado e inteligencia de contenido. Live Control se integra con él como exportación post-stream desde una grabación.
Multicast. Entrega IP uno-a-muchos sobre UDP. Live Control soporta multicast como entrada (bajo el tipo Stream) y como salida (tipo STREAM, MPEG-TS sobre UDP/RTP).
MPEG-TS. Contenedor MPEG-2 Transport Stream.
N
NDI. Network Device Interface. Uno de los valores de Channel.type; el editor puede descubrir fuentes automáticamente o aceptar un nombre de stream tecleado.
NVENC. Encoder de vídeo por hardware de NVIDIA, cuando el Device expone una GPU NVIDIA soportada.
Now-line. Barra vertical en el Scheduler que marca el momento actual.
O
On air. Live stream actualmente en status = 2. La vista On air muestra cada uno de ellos como una fila.
Operator. Uno de los dos perfiles de usuario (user_role = 2). Los Operators operan el broadcast del día a día: vista On air, Live streams, Scheduler, Recordings.
Overlay. Logo o gráfico compuesto sobre una rendition codificada. Aplicado en runtime mediante runtimeApplyLogo.
P
PlayReady. El esquema DRM de Microsoft. Uno de los tres valores de DrmProvider.supported_systems.
R
Recording. Captura de un Live stream almacenada para VOD, producida al adjuntar un Destination de tipo Record a uno de los Destination groups enlazados al Live stream. Respaldada por el esquema Recording; campos clave: name, livestreamId, duration_seconds, size_bytes, started_at, ended_at (null mientras todavía se escribe), qualities, remotefolder.
Remote Folder. Share de red (NFS o WebDAV) al que Live Control hace backup de una grabación antes de que la retención la elimine. Respaldado por el esquema RemoteFolder (name, host, folder, protocol, user, validation_status). Solo gestionable por System Administrator. Consulta Remote Folders.
Restart. Parar y volver a arrancar un Live stream. No hay endpoint público de restart; el Operator detiene el Live stream y lo arranca de nuevo.
Retry / backoff. Bucle de entrega del lado destino. Cada Destination tiene su propio presupuesto de reintentos y envelope de backoff exponencial.
S
SCTE-35. Standard 35 de la Society of Cable Telecommunications Engineers. Formato de señalización para inserción de programación digital. El Live stream expone un toggle SCTE markers que indica si los cue points SCTE-35 se preservan.
Scheduler. Sección UI que aloja Schedules. La vista de calendario.
Schedule. Entidad programada en el Scheduler. Enlaza un Live stream a una hora de inicio, fin, encoder y recurrencia opcional. El enum recurrence.type expone 5 valores: none, daily, weekly, workdays, weekend.
Segment. Un fichero HLS o DASH en una salida empaquetada. La duración por defecto del segmento es 6 segundos; configurable por Destination.
Signed URL. URL cuya query string lleva una firma con vencimiento; usada en las descargas de grabaciones.
Source. La sección UI Sources cataloga Channels. Ver Channel.
SRT. Secure Reliable Transport. Aparece en Channel.type (SRT, SRT Cloud) y en Publishing.type (SRT).
Stream (channel type). Tipo de Channel que hace pull sobre HLS, RTMP, HTTP, RTP o UDP multicast (por ejemplo udp://@239.0.0.1:1234 o una URL de playlist HLS).
Stream – C21 Live Cloud. Etiqueta de UI cara al cliente que agrupa las tres variantes cloud de contribución del enum Channel.type (RTMP-Push, UDP-R Cloud, SRT Cloud). No es un valor del enum por sí misma.
System Administrator. Uno de los dos perfiles de usuario (user_role = 1). Acceso completo — gestiona usuarios, licencias, integraciones, DRM providers y la superficie del sistema.
T
Target Folder. Registro de credenciales (FTP, SFTP o S3) que el Editor de grabaciones usa como destino de exportación de clips. Respaldado por el esquema TargetFolder; las passwords y las S3 secret keys son solo escritura. Solo gestionable por System Administrator. Consulta Target Folders.
Transport stream. Sinónimo de MPEG-TS en la mayoría de contextos.
U
UDP. User Datagram Protocol. Transporte bajo SRT, MPEG-TS UDP y RTP.
UDP-R. Variante cloud de contribución del enum Channel.type (UDP-R Cloud). Junto con RTMP-Push y SRT Cloud constituye la familia de Channels que terminan en la plataforma C21 Live Cloud.
Uptime. Tiempo transcurrido desde que el Live stream salió al aire.
User group. Colección de pertenencias. Campos: id, name, elements (IDs de los miembros). El esquema no expone description en esta versión; los permisos no se asocian aquí.
User profile. Plantilla de permisos asociada a un usuario. Lleva role, api (si el usuario puede emitir API tokens), admin, language, password_version.
V
VAAPI. Video Acceleration API.
Viewer. Cliente concurrente de un endpoint de salida.
VOD. Video on Demand. La salida empaquetada producida desde una grabación terminada.
W
Widevine. El esquema DRM de Google. Uno de los tres valores de DrmProvider.supported_systems.
Y
Youtube Live. Uno de los valores de Channel.type. Pull desde un canal de Youtube Live; requiere una licencia C21LiveYouTube activa en el deploy.