Editor

Qué hace el editor

El Editor de grabaciones es la vista en navegador enlazada a una grabación existente en la plataforma orquestada por C21 Live Control. Es el camino desde un broadcast capturado a un clip que puede descargarse, entregarse a MediaCopilot o enviarse a un destino de almacenamiento externo. El editor nunca modifica la grabación fuente; cada exportación es un artefacto derivado nuevo.

El editor puede abrirse sobre una grabación en cualquier estado, incluido mientras la grabación sigue escribiéndose (la API expone ended_at: null en ese caso).

La pestaña Editor y el endpoint de ejecución subyacente requieren la licencia C21LiveEditor en la instancia de Live Control. Sin ella, la pestaña queda oculta en la sección Recordings y las llamadas directas al endpoint se rechazan.

UI Interface

La vista Editor expone:

Los clips sobreviven recargas — el Editor los persiste en una clave por-grabación del session storage del navegador y los restaura al volver a montar.

Cómo se define un corte

Un corte es el cuerpo de una única petición executeEditor. Los campos obligatorios son:

Formatos de salida

El diálogo Send-to expone los siguientes formatos de salida:

Destinos de entrega

El diálogo Send-to expone un destino a la vez. El valor de command elegido activa el sub-objeto correspondiente en el cuerpo de la petición.

Cada sub-objeto FTP, SFTP y S3 acepta los campos de conexión inline o — preferido — una referencia id única a un Target Folder guardado (cross-link abajo).

Sub-objetos FTP y SFTP

{
  "ftp": {
    "id": <target folder id>,
    "host": "<host>",
    "username": "<usuario>",
    "password": "<contraseña>",
    "path": "<dir remoto>",
    "filename": "<override de filename>"
  }
}

sftp acepta el mismo shape más un identificador account opcional. Cuando id referencia un Target Folder guardado, host, credenciales y path se toman del registro y los valores inline pueden omitirse.

Sub-objeto S3

{
  "s3": {
    "id": <target folder id>,
    "aki": "<AWS access key id>",
    "sak": "<AWS secret access key>",
    "bucket": "<nombre del bucket>"
  }
}

Cuando id referencia un Target Folder guardado, las credenciales y el bucket se toman del registro. Consulta Target Folders para el catálogo y el modelo de credenciales.

Selección de audio

El bloque audio opcional selecciona qué pistas de audio lleva el corte — útil para grabaciones multilingües:

{
  "audio": {
    "pids": [<pid>, …],
    "languages": ["<idioma>", …],
    "codecs": ["<codec>", …]
  }
}

Cada miembro es independiente; el editor empareja pistas por cualquier combinación de pid, idioma o codec.

DRM en exportación

Cuando el deploy sirve clips protegidos en reposo, el bloque drm opcional asocia un DRM provider registrado al corte:

{
  "drm": {
    "provider": <id del proveedor>,
    "content_id": "<content id en hex>"
  }
}

content_id debe ser un valor hexadecimal. Consulta DRM workflow para el registro del proveedor y el alcance multi-sistema (Widevine, PlayReady, FairPlay).

Sidecar XML de metadatos

Cuando xml_enabled = true, el editor genera un sidecar XML desde el template configurado y lo entrega junto al fichero de vídeo. Los campos de metadatos viven en el sub-objeto FTP / SFTP / S3 elegido (o se envían desde el formulario de metadatos del diálogo Send-to):

El template XML lo personaliza el System Administrator al instalar — los operators solo rellenan los campos de arriba.

Exportación a MediaCopilot

command: "exportMediaCopilot" activa los campos específicos de MediaCopilot. Los dos prerrequisitos heredados de la página de integración MediaCopilot aplican: cuenta MediaCopilot contratada vía Cires21 más la licencia C21LiveEditor.

Cuando sync = false, sondea el job mediante GET /c21apiv2/system/mediacopilot/jobs/{jobId} hasta que termine. El destino MediaCopilot aparece en el diálogo Send-to solo cuando la integración está configurada en Integrations → MediaCopilot.

Superficie API

El cuerpo completo de la petición está documentado arriba. El handler aplica Idempotency-Key; repetir la misma clave devuelve la respuesta original sin volver a cortar.

Ejemplo mínimo — descarga un clip MP4:

curl -X POST "https://<tu-host>/c21apiv2/editor/<broadcastName>/<broadcastDetailName>/execute" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "quality": 4000,
    "allbitrates": false,
    "kfstart": true,
    "concat": false,
    "encoding": "mp4",
    "command": "download",
    "filename": "highlight",
    "intervals": [{ "start": 1747585200, "end": 1747588800, "name": "Goal 1" }]
  }'

Cross-links

• Recordings — catálogo de capturas y política de retención.
• Opciones del Live stream — abrir el editor sobre la grabación activa de un Live stream.
• Target Folders — registra Target Folders para entrega FTP / SFTP / S3.
• Integración MediaCopilot — modelo de cuenta y prerrequisitos para el destino MediaCopilot.
• DRM workflow — registro de proveedor para el bloque drm opcional en exportación.
• Cortar un clip en el Editor y enviarlo a MediaCopilot — how-to paso a paso.

FAQ