Video and Audio Loader

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El Video and Audio Loader permite a los usuarios cargar archivos de audio y video directamente desde el dashboard de Nappai. Una vez cargado, el componente devuelve los datos en forma de bytes, listos para ser procesados por otros componentes del flujo de trabajo.

¿Cómo funciona?

El componente acepta un archivo cuyo tipo debe ser uno de los soportados: wav, mp3, flac, mp4, avi, mov, entre otros. Cuando el usuario selecciona un archivo, el componente determina su extensión y abre el archivo en modo binario. Si el archivo es un wav, se extraen los frames de audio usando la librería wave; para los demás formatos se lee el contenido completo. El resultado se devuelve como un objeto Data que contiene los bytes del archivo. Si ocurre un error y la opción Silent Errors está desactivada, se lanza una excepción; si está activada, el error se ignora y se devuelve None.

Entradas

Campos de Entrada

• Path: Ruta del archivo que se desea cargar. El usuario puede arrastrar y soltar el archivo o navegar por el sistema de archivos. El componente solo acepta los tipos de archivo listados en la descripción del input.
• Silent Errors: Si se marca, los errores que ocurran durante la carga del archivo no generarán una excepción. En su lugar, el componente devolverá None, lo que permite que el flujo continúe sin interrupciones.

Salidas

• Output: Devuelve los bytes del archivo cargado como un objeto Data. Este valor puede ser conectado a componentes que requieran datos binarios, como analizadores de audio, transcriptores o convertidores de formato.

Ejemplo de Uso

1. Seleccionar archivo: Arrastra un archivo mp3 o mp4 al campo Path.
2. Configurar errores: Desmarca Silent Errors si quieres que el flujo se detenga en caso de fallo.
3. Conectar salida: Conecta la salida Output a un componente de transcripción de audio o a un visualizador de video.
4. Ejecutar flujo: Al ejecutar, el componente leerá el archivo y pasará los bytes al siguiente paso del flujo.

Componentes Relacionados

• Audio Transcriber – Convierte audio en texto.
• Video Thumbnail Generator – Extrae miniaturas de videos.
• File Validator – Comprueba la integridad y el tipo de archivos antes de cargarlos.

Consejos y Mejores Prácticas

• Verifica el tamaño del archivo antes de cargarlo para evitar sobrecargar la memoria del servidor.
• Usa Silent Errors solo cuando el flujo pueda continuar sin el archivo; de lo contrario, deja la opción desactivada para detectar fallos tempranamente.
• Conecta la salida a un componente de validación para asegurarte de que el archivo cumple con los requisitos de formato y calidad antes de procesarlo.

Consideraciones de Seguridad

• Control de acceso: Asegúrate de que solo usuarios autorizados puedan cargar archivos, especialmente si el sistema procesa datos sensibles.
• Validación de ruta: El componente resuelve la ruta del archivo; evita que los usuarios especifiquen rutas que puedan acceder a directorios fuera del ámbito permitido.
• Tamaño máximo: Configura un límite de tamaño de archivo para prevenir ataques de denegación de servicio (DoS) por archivos muy grandes.