Catálogo VOD¶

La sección VOD es un catálogo de assets del clúster: archivos que están en los streamers y se reproducen bajo demanda. A diferencia de un stream, un asset no tiene fuente ni colocación por el layouter; simplemente está donde se subió y se sirve desde allí.

Hay cuatro pestañas: Catálogo, Subidas, Almacenes y Tokens de subida. Esta página trata del catálogo; la subida y el almacenamiento están en Subidas de VOD.

Para que el catálogo tenga dónde vivir, el streamer necesita al menos un root VOD — se define en los ajustes del streamer.

Asset, clave y archivos¶

La unidad del catálogo es el asset. Un asset tiene:

• Clave — el nombre en forma de ruta por el que se encuentra: movies/2026/blade.mp4. Las claves forman carpetas, y el catálogo las muestra como un árbol.
• Asset id — un identificador inmutable. La clave se puede renombrar, el asset id no, así que los enlaces por asset id sobreviven a un renombrado.
• Revisión — se incrementa con cada cambio en el conjunto de archivos.
• Archivos — un asset puede constar de varios archivos: por ejemplo vídeo y pistas de audio separadas.

Las columnas de la lista son Nombre, Estado, Archivos, Tamaño, Asset id, Actualizado. El estado es reproducible o no reproducible: un asset cuya media info no se pudo leer solo se sirve como archivo raw.

El árbol muestra como mucho 1000 carpetas por nivel — en una lista más larga indica Se muestran las primeras 1000 carpetas: precise con el filtro. El campo Filtrar este nivel… filtra el nivel actual, y Cargar más trae más assets.

Dónde está un asset¶

El bloque Placement muestra qué almacenes tienen el asset y en qué revisión:

• origin — la ubicación primaria, donde se subió el asset.
• replica — una copia en otro almacén.

Junto a él puede aparecer almacén no disponible. Significa exactamente lo que dice la ayuda: Reproducción 503; la eliminación funciona, la limpieza queda diferida. Es decir, el catálogo sigue siendo manejable incluso mientras la máquina con los archivos está caída.

Archivos del asset¶

La tabla de archivos: Archivo, Tamaño, Media info, Hash, Acciones. Un archivo cuya media info no se pudo leer se marca como media error y queda disponible como archivo raw.

Copiar hash copia la suma de comprobación del archivo. El botón Reproducir y los botones HLS, DASH y RAW se explican más abajo.

Reproducir un archivo¶

El botón Reproducir de la columna Acciones abre un reproductor dentro de la propia consola — sobre la tarjeta, sin salir del catálogo. Se cierra con Esc o con la cruz de la esquina.

La dirección de la página cambia junto con el reproductor abierto, así que el enlace se le puede enviar a un compañero: le lleva directamente a ese archivo.

Los botones HLS, DASH y RAW copian el enlace de reproducción del tipo correspondiente — se pega en su propio reproductor, decodificador o analizador. El enlace copiado ya lleva un ticket de admisión temporal y se reproduce tal cual: la reproducción está cerrada por defecto, y ese ticket vive unas horas y está pensado para una sola visualización. Para su tienda emita sus propios tickets — véase Tickets de Catena.

Las direcciones se componen del asset id y del nombre del archivo:

En la dirección va el asset id, no la clave, así que renombrar no rompe esos enlaces.

La comprobación más rápida de que el archivo se entrega es su lista de reproducción:

curl -s 'http://<dirección>/playback/vod/<asset id>/<archivo>/index.m3u8?token=<ticket>' | head

• Una lista con calidades (#EXT-X-STREAM-INF) — el archivo está analizado y se reproduce.
• 403 — no hay ticket, o no cubre este asset.
• 404 — no existe ese asset, o ese archivo dentro de él.

Un archivo cuya media info no se pudo leer no se ofrece para reproducir: solo tiene RAW.

Renombrar la clave¶

Renombrar clave cambia solo los metadatos: los archivos se quedan donde están; los enlaces guardados por AssetId siguen funcionando. Renombrar una carpeta reescribe de golpe los prefijos de todas las claves que cuelgan de ella. Si la nueva clave está ocupada, la operación se rechaza — Esa clave ya está ocupada.

Eliminación¶

Se puede eliminar en tres niveles:

• Eliminar archivo — un archivo sale del asset y la revisión del asset se incrementará. Si era el último, el asset se elimina con él.
• Eliminar asset — con una confirmación que indica el número de archivos.
• Eliminar carpeta — todos los assets bajo ese prefijo. La consola primero reúne la lista (Reuniendo assets: N), luego los encola y muestra el avance: Eliminando assets: N/N, N con error, Eliminados N assets.

La eliminación siempre actúa sobre el catálogo, no sobre el disco: el mensaje Eliminado del catálogo — la limpieza en el nodo queda diferida significa que el registro desaparece de inmediato, mientras que los archivos los retira el streamer cuando puede. Por eso mismo la eliminación está disponible incluso con un almacén no disponible.

Qué sigue¶

• Subidas de VOD — cómo subir archivos, dónde mirar los almacenes y cómo emitir un token de subida para un portal.