VOD¶

media.play.vod

Transporte¶

HTTP o HTTPS; las listas y los fragmentos se entregan mediante solicitudes separadas por TCP.

Códecs compatibles¶

Dependen del protocolo de entrega: HLS y DASH. Sapsan empaqueta las pistas existentes; compruebe la compatibilidad de decodificación en el reproductor de destino.

Sapsan guarda archivos como assets VOD, mantiene su catálogo en central y los entrega bajo demanda. Los assets no necesitan una fuente en vivo. Gestione cargas, almacenamientos, plantillas y tareas en la consola de central.

Almacenamiento y carga¶

Mediante central, defina una raíz VOD con nombre en la config del streamer, que corresponde a un directorio del disco:

vod:
  roots:
    - name: movies
      path: /srv/vod

Los nombres contienen letras latinas minúsculas, dígitos, _ y - y deben ser únicos en la config. El proceso necesita acceso de lectura y escritura al directorio. Central recibe disponibilidad y espacio libre en los informes del streamer.

En VOD, abra Cargas, seleccione los archivos y una clave del asset. Central elige un almacenamiento disponible con espacio libre y emite un permiso de carga; los bytes van directamente al streamer. Almacenamientos muestra disponibilidad y capacidad. Tokens de carga da acceso restringido de carga a una aplicación externa; la revocación impide seguir utilizándolo.

Catálogo y archivos¶

• Clave: nombre modificable como movies/2026/film.mp4; sus prefijos forman el árbol del catálogo.
• Asset id: identificador permanente que se conserva al renombrar la clave.
• Revisión: versión de la composición de archivos; cambia al añadir o eliminar archivos.
• Archivos: vídeo y otros archivos del asset, con tamaño, hash e información multimedia.

Archivos del asset¶

Abra un asset en Catálogo para inspeccionar archivos y ubicaciones. Un asset disponible tiene una ubicación lista en un almacenamiento disponible. Un archivo que no puede analizarse como multimedia solo permite descarga RAW. Renombrar clave cambia los metadatos y conserva archivos y enlaces por Asset id; una clave ocupada se rechaza.

Reproducción¶

En la ficha del archivo, Play abre un reproductor; HLS, DASH y RAW copian un enlace. Use enlaces de central para reproducir mediante el clúster:

Central selecciona una ubicación lista y redirige al cliente al streamer. La URL nativa del streamer es /streaming/vod/<root>/<asset-id>/<file>/index.m3u8 (para DASH, Manifest.mpd; para descargar, sin sufijo). No sustituya Asset id por la clave del catálogo. La reproducción protegida requiere un token que permita acceder al asset; acceso denegado devuelve 403 y un asset o archivo inexistente, 404. Sin ubicaciones disponibles, central devuelve 503 con Retry-After.

Copias y balanceo¶

Configure Copias en otros servidores en la plantilla de asset. El valor 1 significa el original y una copia en otro streamer. Una plantilla sin calidades copia archivos preparados sin transcodificar. Ejecute una tarea desde la ficha del asset o asigne una plantilla al cargar.

Central selecciona streamers conectados con una raíz VOD disponible, un diario de archivos legible, el rol Copia activado y espacio suficiente. Solo se permite una ubicación del asset por streamer. Se requiere el tamaño de los archivos más la reserva vod_min_free_bytes (1 GiB por defecto); se elige el almacenamiento elegible con más espacio libre. Sin candidatos, la tarea espera en la cola.

La copia es una tarea separada en el streamer de destino: descarga los archivos por la dirección interna, verifica tamaño y hash y publica la copia. Las copias no ocupan puestos de transcodificación. Desactivar el rol impide nuevas tareas; las que ya están en curso continúan. Los archivos añadidos después llegan a las copias existentes con la siguiente tarea.

La tabla de ubicaciones muestra original y copias con revisión y espectadores. Central dirige nuevas reproducciones a la ubicación lista con menos sesiones; excluye un streamer desconectado cuando vence su liveness. El enlace por Asset id no cambia. Una redirección no transfiere una conexión abierta: el reproductor debe reconectarse tras un fallo.

Eliminación¶

• Archivo: elimina un archivo e incrementa la revisión; al eliminar el último se elimina el asset.
• Asset: elimina el asset y sus archivos del catálogo.
• Carpeta: elimina los assets bajo el prefijo de clave seleccionado.

El catálogo cambia inmediatamente. Si el almacenamiento no está disponible, la eliminación física espera a que se restablezca la conexión. Compruebe el estado de tareas y ubicaciones en central; una entrada del catálogo no garantiza una copia lista.

Siguientes pasos¶

• HLS
• DASH
• Autorización de reproducción