Configuración del playout¶
Use esta página para crear o configurar un playout concreto y su stream de salida. Para seguir todo el camino desde los archivos VOD hasta la reproducción del suscriptor, consulte Canal a partir de VOD.
Un playout reproduce bloques según la parrilla y envía la emisión a un stream llamado playout_<id>. La parrilla controla el contenido; los ajustes del stream controlan la codificación y la entrega.
Qué preparar¶
- Acceso de operador a Playout, VOD y Streams.
- Vídeo con sonido para la parrilla. Como relleno sirve un vídeo o una imagen JPEG.
- Para el relleno general, acceso a la management API y las utilidades
curlyjq.
Cree un playout¶
- Abra Playout.
- En Nombre del nuevo playout, escriba un nombre y pulse Crear playout. El editor se abrirá con una parrilla vacía.
Catena crea el stream playout_<id> y una fuente de guía de programación junto con el playout. No es necesario crear el stream ni vincular EPG por separado. El <id> completo aparece en la dirección del editor después de #/playouts/.
Un playout nuevo recibe este formato de origen predeterminado:
- 25 fps — frecuencia de fotogramas a la que se adapta el contenido.
- 1920×1080 — tamaño del cuadro de salida del playout.
- Mono, 48 kHz — distribución y frecuencia del audio.
- 8 bits — profundidad de color.
Elija la salida para los espectadores¶
El playout entrega vídeo YUV y audio PCM sin comprimir. Configure el transcodificador del stream automático para un reproductor HLS habitual:
- En el panel Emisión, pulse Abrir tarjeta del stream.
- Abra la pestaña Transcodificador y seleccione el preajuste Escalera estándar 1080/720/360 + AAC.
- En Vista previa: entrada → salida, compruebe que hay tres calidades de vídeo y audio AAC configurados; después pulse Guardar.
Este preajuste codifica la emisión en H.264 y AAC y crea tres calidades para HLS. Los demás ajustes de entrega y archivo también se encuentran en la página del stream, no en el editor del playout.
Cómo afectan los parámetros de origen a la emisión¶
El playout adapta todos los assets a un mismo formato de origen. Escala la imagen al tamaño configurado y convierte el audio a la frecuencia y distribución configuradas. Esto no sustituye al transcodificador: después de la adaptación, el playout sigue entregando fotogramas y audio sin comprimir.
Compruebe la frecuencia de fotogramas de los assets¶
Si la frecuencia de fotogramas de un asset difiere de la frecuencia de origen, el playout duplica o descarta fotogramas. La duración del bloque no cambia, pero el movimiento puede perder fluidez. El bloque recibe un aviso; el guardado de la parrilla no se bloquea. Para conseguir un movimiento uniforme, use assets con la frecuencia de fotogramas del playout.
Dónde se configura el formato de origen¶
Las propiedades del formato de origen se encuentran en la pestaña Fuentes de la tarjeta del stream. El editor del playout sirve para el nombre, el relleno y la parrilla. Para cambiar el formato, use Cambie el formato de origen: el procedimiento requiere deshabilitar y volver a habilitar el stream.
Configure los rellenos¶
Un relleno cubre los huecos de la parrilla y sustituye el contenido cuando falla un asset. El orden de sustitución es:
- Relleno del bloque — se aplica solo al bloque seleccionado.
- Relleno del canal — relleno general del playout; se reproduce si el bloque no tiene uno propio o si no hay ningún bloque en el momento actual.
- Síntesis de emergencia — barras de color con silencio cuando no hay un relleno adecuado configurado o disponible.
Los rellenos usan assets VOD: vídeo o una imagen JPEG estática. La imagen permanece en pantalla con silencio. Un stream en vivo no puede ser relleno.
Defina el relleno general mediante la API¶
En la versión comprobada, la consola no guarda Relleno del canal: el botón general Guardar devuelve HTTP 422 con «missing field fps» y el ajuste no se aplica. No use esta vía. El guardado de la parrilla y del relleno del bloque funciona por separado.
El relleno general se puede definir mediante la management API. El PATCH debe contener el config completo con solo filler modificado: si envía únicamente config.filler, el servidor rechazará la solicitud. Los comandos siguientes leen el documento actual y conservan todos sus parámetros, incluidos la parrilla y el formato de origen.
- Suba un vídeo o JPEG como asset VOD independiente y espere a que aparezca la información del archivo. Copie el identificador del playout de la dirección del editor.
-
Defina la dirección de la instalación, la cuenta del operador, el identificador del playout y la clave del asset. Envíe la contraseña solo mediante HTTPS:
set -euo pipefail BASE='https://catena.example.com' API_USER='operator' read -rsp 'Operator password: ' API_PASSWORD; echo PLAYOUT_ID='<playout id>' ASSET_KEY='slates/technical' -
Busque el identificador del asset por su clave:
ASSET_ID=$(curl -fsS -u "$API_USER:$API_PASSWORD" --get \ --data-urlencode "name_prefix=$ASSET_KEY" \ --data-urlencode 'limit=1000' \ "$BASE/central/api-v4/vod/assets" | jq -er --arg key "$ASSET_KEY" '.assets[] | select(.key == $key) | .id') -
Compruebe que el asset está ubicado en un almacenamiento disponible con un journal legible. El comando relaciona
storage_iddel placement del asset con el registro del almacenamiento y falla si no hay un almacenamiento adecuado. En ese caso, espere a que VOD esté listo y repita la comprobación en lugar de continuar con PATCH:curl -fsS -u "$API_USER:$API_PASSWORD" \ -o filler-asset.json "$BASE/central/api-v4/vod/assets/$ASSET_ID" curl -fsS -u "$API_USER:$API_PASSWORD" \ -o vod-storages.json "$BASE/central/api-v4/vod/storages" jq -e --slurpfile storages vod-storages.json \ '.placements[]? as $placement | $storages[0].storages[]? | select(.id == $placement.storage_id and .status == "available" and .journal == "readable")' \ filler-asset.json >/dev/null -
Lea el playout, guarde su ETag y prepare una solicitud con el
configcompleto:curl -fsS -u "$API_USER:$API_PASSWORD" \ -D playout.headers -o playout.json \ "$BASE/central/api-v4/playouts/$PLAYOUT_ID" ETAG=$(sed -n 's/^[Ee][Tt][Aa][Gg]:[[:space:]]*//p' playout.headers | tr -d '\r') if [[ -z "$ETAG" ]]; then echo 'ETag is missing; refusing to PATCH' >&2 exit 1 fi jq --arg filler "vod://$ASSET_ID" \ '{config: (.config + {filler: $filler})}' playout.json > playout-filler.json -
Envíe el cambio con el ETag del documento leído:
curl -fsS -u "$API_USER:$API_PASSWORD" \ -X PATCH "$BASE/central/api-v4/playouts/$PLAYOUT_ID" \ -H "If-Match: $ETAG" \ -H 'Content-Type: application/merge-patch+json' \ --data-binary @playout-filler.json | jq '.playout.config'
En la respuesta, filler debe contener vod://<asset id>, mientras que fps, size, sample_rate, audio y bit_depth deben conservar sus valores anteriores. Si el servidor devuelve HTTP 412, otra sesión modificó el documento: léalo de nuevo, revise la nueva configuración y solo entonces prepare otra vez la solicitud. No vuelva a enviar el ETag antiguo.
En un playout nuevo sin bloques, el relleno general ya debe estar en emisión; compruébelo por HLS como se indica más abajo. En un playout existente con un bloque actual, la respuesta guardada confirma el ajuste, y la imagen del relleno se podrá ver en el siguiente hueco de la parrilla. No elimine el bloque actual solo para comprobarlo.
Defina el relleno de un bloque en la consola¶
- Cree o abra un bloque en el editor.
- En Relleno del slot (opcional), seleccione un asset VOD. — igual que el canal — mantiene para este bloque el relleno general del playout.
- Pulse Crear slot o Guardar en la ventana del bloque y después el botón general Guardar situado sobre la retícula. No cambie Relleno del canal al mismo tiempo.
Vuelva a abrir el bloque y compruebe el asset seleccionado. El panel Emisión debe mostrar el título del bloque actual de la parrilla guardada.
Compruebe el stream¶
- En el panel Emisión, pulse Abrir tarjeta del stream y abra la pestaña Fuentes.
- Compruebe el protocolo playout y el identificador del playout. El enlace situado bajo el identificador vuelve al editor.

- Abra la pestaña Egreso. En Reproducción, busque Emitir un ticket de reproducción y pulse Emitir.
- Copie la dirección HLS / LL-HLS en un reproductor HLS. Para inspeccionar el manifiesto, abra la dirección en una pestaña nueva del navegador.
El manifiesto maestro debe contener variantes de calidad, y el manifiesto de una variante debe contener segmentos multimedia. El reproductor debe mostrar el bloque actual con sonido; con una parrilla vacía, debe mostrar el relleno general o las barras de color. Si la respuesta contiene solo la cabecera de la lista, revise el transcodificador. Si falla el acceso, emita un ticket nuevo.
No use la vista previa JPEG del editor como comprobación obligatoria: con la protección de reproducción activada, /playback/live-preview-jpeg/playout_<id> puede devolver HTTP 403 incluso cuando HLS funciona.
Guía de programación (EPG)¶
La fuente EPG se crea con el playout y ya está vinculada al stream. Los datos del bloque que pasan a la guía, su actualización después de editar y las comprobaciones del resultado se describen en Guía de programación del playout.
Eliminación¶
La eliminación es irreversible. Las consecuencias para el stream y el EPG, el procedimiento y las comprobaciones se describen en Elimine un playout.
Qué sigue¶
- Parrilla de emisión — añada bloques y cambie la parrilla actual.
- Canal a partir de VOD — publique el stream como canal y compruébelo como suscriptor.
- Transcodificación y MBR — elija otra escalera de calidades para el stream.