Última actualización: 12 de septiembre

Transmite medios remotos a FFmpeg con cURL

Tim Koschützki

Cofundador · Berlín, Alemania ·

En esta publicación, obtenemos datos de video remotos con cURL y los procesamos con FFmpeg sin guardar el video de entrada localmente. Al canalizar los datos directamente hacia FFmpeg, puedes extraer fotogramas, analizar cambios de escena o generar miniaturas dinámicas mientras se transmite el video.

Descripción general

Cuando trabajas con medios, la eficiencia es clave. Combinar cURL y FFmpeg en un pipeline fluido te permite obtener datos de medios remotos y procesarlos sobre la marcha. Esta guía asume que usas FFmpeg 6.0+ y cURL 7.81.0+ para lograr una compatibilidad y unas funcionalidades óptimas.

Los ejemplos usan Bash y archivos MP4 preparados para lectura secuencial, con sus metadatos moov antes de los datos de medios («faststart»). Una tubería no puede retroceder en la lectura: los archivos MP4 comunes con los metadatos al final pueden fallar incluso después de la descarga completa. Cuando no se conoce la disposición, entrega la URL HTTP directamente a FFmpeg para que pueda saltar de posición con solicitudes de rango, o descarga primero a un archivo local.

Configuración del pipeline

Así se configura un pipeline que extrae fotogramas de un flujo de video remoto. Este comando obtiene el video con cURL y lo canaliza hacia FFmpeg para procesarlo:

set -euo pipefail
mkdir thumbnails
curl -fsSL "https://example.com/path/to/video.mp4" | \
ffmpeg -nostdin -n -f mp4 -i pipe:0 \
  -vf "fps=1" \
  -frame_pts 1 \
  -v error \
  -stats \
  thumbnails/thumbnail_%03d.jpg

Explicación

-f mp4 especifica explícitamente el formato de entrada
pipe:0 le indica a FFmpeg que lea desde la entrada estándar
-frame_pts 1 usa el PTS de cada fotograma de salida como número del nombre de archivo, en la base de tiempo de salida
-v error muestra solo los mensajes de error
-stats muestra información de progreso
set -o pipefail provoca que una descarga fallida haga fallar el pipeline
mkdir thumbnails exige un directorio nuevo, lo que protege las imágenes de ejecuciones anteriores

Usos avanzados

El pipeline básico se puede ampliar para tareas más complejas:

Detección de cambios de escena: usa las capacidades de detección de escenas de FFmpeg con umbrales adecuados:

set -euo pipefail
mkdir scenes
curl -fsSL "https://example.com/path/to/video.mp4" | \
ffmpeg -nostdin -n -f mp4 -i pipe:0 \
  -filter_complex "select='gt(scene,0.3)',metadata=print:file=scenes/time.txt" \
  -fps_mode vfr \
  -frame_pts 1 \
  scenes/scene_%03d.jpg

Este comando detecta cambios de escena con un umbral de 0,3 y escribe las marcas de tiempo de los fotogramas en scenes/time.txt para un análisis posterior.

Análisis en tiempo real: procesa flujos de video con ajustes optimizados:

set -euo pipefail
mkdir analysis-frames
curl -fsSL "https://example.com/path/to/video.mp4" | \
ffmpeg -nostdin -n -f mp4 -i pipe:0 \
  -vf "scale=640:-1,fps=5" \
  -v warning \
  -vcodec ppm \
  analysis-frames/frame_%05d.ppm

Este ejemplo escala el video, reduce la tasa de fotogramas y guarda fotogramas PPM para que un programa de análisis los consuma.

Solución de problemas

Problemas comunes y sus soluciones:

Problemas de red: reintenta las descargas hacia un archivo antes de procesarlas. Reintentar una transferencia que ya está canalizada hacia un decodificador puede mezclar datos de varios intentos:
```
set -euo pipefail
mkdir download
curl --retry 3 --retry-delay 2 -fsSL \
  "https://example.com/path/to/video.mp4" -o download/input.mp4
```
Procesamiento lento: reduce la resolución o la tasa de fotogramas. Las colas de muxing y de paquetes de entrada de FFmpeg no corrigen un contenedor de entrada que necesita saltos de posición.
Detección de formato: usa -f mp4 antes de -i pipe:0 solo para entradas MP4. Forzar un demuxer no recupera los metadatos faltantes ni permite saltar de posición en una tubería.

Consideraciones de rendimiento

Para un rendimiento óptimo:

Reduce la resolución del video para el análisis cuando no se necesite la resolución completa
Usa tasas de fotogramas adecuadas para tu caso de uso
Considera la aceleración por hardware cuando esté disponible
Monitorea los recursos del sistema y ajusta los parámetros según corresponda

Ten en cuenta que las capacidades de análisis en tiempo real dependen del formato de entrada, la potencia de procesamiento y el ancho de banda de la red. Para flujos de alta resolución, considera reducir la carga de procesamiento bajando la tasa de fotogramas del análisis o usando una versión reducida de la entrada.

Conclusión

La combinación de cURL y FFmpeg ofrece un conjunto de herramientas potente para el procesamiento de medios en tiempo real. Este enfoque brinda flexibilidad y eficiencia para diversas tareas de análisis de video. En Transloadit, usamos técnicas similares en nuestro pipeline de procesamiento de medios para entregar resultados rápidos y confiables.