Vista previa MP4 del archivo con la API

Cuando Save Preview está habilitado en la configuración de Almacenamiento, Alta guarda clips cortos de vista previa en formato MP4 para el archivo grabado. Este artículo describe cómo obtener la lista de archivos de vista previa de un canal y descargarlos con curl.

Requisitos

• El canal tiene un Almacenamiento asignado y el almacenamiento tiene Save Preview habilitado.
• El canal usa video H.264 o H.265.
• Las solicitudes se envían al API Server (puerto predeterminado 8100), no al OTT Server. Más información en Servidor HTTP.
• La API requiere autenticación HTTP Basic con un usuario de la interfaz web de Alta. Más información en Usuarios.

Ruta del canal

Ambas solicitudes usan el parámetro id con la ruta del canal en el formato <channel_name>/<variant>, por ejemplo discovery/hd.

Nota

Envíe / en el id tal cual o codificado en URL como %2F.

Listar archivos de vista previa

URL:

GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>

o con el parámetro opcional:

GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>&start=<time>

• id: ruta del canal.
• start (opcional): marca de tiempo Unix. Devuelve los archivos a partir de ese momento.

Alta no admite el parámetro end. Para limitar el resultado por la hora de finalización, filtre la lista en el lado del cliente.

Ejemplo:

curl -sS -u 'USER:PASSWORD' \
  'http://alta.example.com:8100/api/ott/channel/storage/preview?id=discovery/hd&start=1747485787'

Respuesta:

["1747485787.mp4", "1747485797.mp4", "1747485807.mp4"]

La respuesta es un arreglo JSON con los nombres de archivo. El nombre de cada archivo es la marca de tiempo Unix del inicio del segmento.

Descargar un archivo de vista previa

URL:

GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>&name=<file>

• id: ruta del canal.
• name: nombre de archivo de la lista, por ejemplo 1747485787.mp4.

Ejemplo:

curl -sS -f -u 'USER:PASSWORD' \
  -o preview.mp4 \
  'http://alta.example.com:8100/api/ott/channel/storage/preview?id=discovery/hd&name=1747485787.mp4'

El cuerpo de la respuesta es el archivo MP4. La opción -f hace que curl falle ante errores HTTP en lugar de guardar la página de error en el archivo.

Códigos de respuesta

Código	Descripción
200	Correcto
404	No se encontraron archivos de vista previa para el canal o el intervalo de tiempo, o el archivo no existe

Nota

Un intervalo de tiempo vacío se informa con 404, no con un arreglo vacío. Trate 404 en la solicitud de la lista como “sin archivos”.

Solución de problemas

Lista vacía o 404

• Compruebe que Save Preview esté habilitado en el almacenamiento y que el canal esté grabando.
• Compruebe la ruta del canal. Debe incluir la variante, por ejemplo discovery/hd.
• Elimine el parámetro start o disminuya su valor. Los archivos de vista previa están disponibles solo durante la duración del archivo del almacenamiento.

Connection refused

Compruebe que usa el puerto del API Server, no el del OTT Server. Pruebe la conexión:

curl -v http://alta.example.com:8100/