Añadir Múltiples Segmentos desde un Único Archivo de Video en C¶

Introducción¶

Al desarrollar aplicaciones de edición de video, a menudo necesitas extraer porciones específicas de un archivo de video y combinarlas en una nueva composición. Esta técnica es esencial para crear resúmenes de momentos destacados, eliminar secciones no deseadas o ensamblar una compilación de momentos clave de un video más largo.

Esta guía demuestra cómo extraer y combinar programáticamente múltiples segmentos del mismo archivo de video usando C#. Aprenderás el proceso paso a paso con ejemplos de código funcionales que puedes implementar en tus propias aplicaciones.

¿Por qué Extraer Múltiples Segmentos?¶

Extraer segmentos específicos de videos sirve muchos propósitos prácticos:

Crear resúmenes de momentos destacados de grabaciones más largas
Eliminar secciones no deseadas (anuncios, errores, contenido irrelevante)
Ensamblar una compilación de momentos clave
Crear trailers o vistas previas de contenido de larga duración
Generar clips más cortos para redes sociales de videos más largos

Descripción General de la Implementación¶

La implementación involucra tres pasos clave:

Definir los segmentos de tiempo que quieres extraer
Crear una fuente de video que incluya estos segmentos especificados
Añadir el archivo segmentado a tu línea de tiempo de edición

Desglosemos cada paso con ejemplos de código detallados y explicaciones.

Implementación Detallada¶

Paso 1: Definir tus Segmentos¶

Primero, necesitas especificar los tiempos de inicio y fin de cada segmento. Cada segmento está definido por un punto de inicio y duración, medidos en milisegundos.

// Definir múltiples segmentos desde un único archivo de video
FileSegment[] segments = new[] { 
    new FileSegment(TimeSpan.FromMilliseconds(0), TimeSpan.FromMilliseconds(5000)),  // Primeros 5 segundos
    new FileSegment(TimeSpan.FromMilliseconds(3000), TimeSpan.FromMilliseconds(10000))  // Desde marca de 3s a 13s
};

En este ejemplo, hemos definido dos segmentos:

El primer segmento comienza al principio del video (0ms) y dura 5 segundos
El segundo segmento comienza en la marca de 3 segundos y continúa por 10 segundos

Nota que los segmentos pueden superponerse, como se muestra en este ejemplo donde el segundo segmento comienza antes de que el primero termine. Esto puede ser útil para crear transiciones suaves o cuando quieres que ciertas porciones aparezcan múltiples veces.

Paso 2: Crear una Fuente de Video con Segmentos¶

A continuación, crea un objeto VideoSource que incorpore tus segmentos definidos:

// Crear una fuente de video que incluya los segmentos especificados
VideoSource videoFile = new VideoSource(
    videoFileName,   // Ruta a tu archivo de video
    segments,        // Array de segmentos definidos arriba
    VideoEditStretchMode.Letterbox,  // Cómo manejar diferencias de relación de aspecto
    0,               // streamNumber — qué stream de video leer de un archivo multi-stream
    1.0);            // rate — tasa de reproducción (1.0 = normal; 2.0 = 2×; 0.5 = media velocidad)

El constructor de VideoSource toma varios parámetros:

videoFileName: La ruta a tu archivo de video fuente
segments: El array de objetos FileSegment que definiste en el Paso 1
VideoEditStretchMode: Cómo manejar diferencias de relación de aspecto (Letterbox, Stretch, Crop)
streamNumber: Índice base-cero del stream de video a usar en un archivo multi-stream (no rotación)
rate: Multiplicador de tasa de reproducción — 1.0 = normal, 0.5 = cámara lenta, 2.0 = avance rápido

Paso 3: Añadir a la Línea de Tiempo¶

Finalmente, añade la fuente de video segmentada a tu línea de tiempo de edición:

// Añadir el archivo segmentado a la línea de tiempo.
// Firma: Input_AddVideoFile(VideoSource fileSource, TimeSpan? timelineInsertTime = null,
//   int targetVideoStream = 0, int customWidth = 0, int customHeight = 0).
// Pasa solo la fuente para agregar al final de la línea de tiempo.
VideoEdit1.Input_AddVideoFile(videoFile);

// O insértalo en una posición específica de la línea de tiempo:
// VideoEdit1.Input_AddVideoFile(videoFile, TimeSpan.FromSeconds(5));

El método Input_AddVideoFile toma el VideoSource más una posición opcional de inserción en la línea de tiempo (TimeSpan?, no un int de número de pista). Parámetros opcionales adicionales eligen qué stream de video consumir de una fuente multi-stream y anulan el ancho/alto personalizado.

Trabajar con Segmentos de Audio¶

El mismo enfoque funciona para archivos de audio. Simplemente usa AudioSource en lugar de VideoSource:

// Definir tus segmentos de audio. FileSegment(startTime, stopTime) — stop debe ser mayor que start.
FileSegment[] audioSegments = new[] {
    new FileSegment(TimeSpan.FromMilliseconds(0),     TimeSpan.FromMilliseconds(8000)),   // 0 → 8s
    new FileSegment(TimeSpan.FromMilliseconds(15000), TimeSpan.FromMilliseconds(27000))   // 15s → 27s
};

// Crear fuente de audio con segmentos.
// Firma: AudioSource(string filename, FileSegment[] segments, string fileToSync = null,
//   int streamNumber = 0, double rate = 1.0).
// La posición 3 es fileToSync (un *string*), no un factor de velocidad — usa un arg nombrado para rate.
AudioSource audioFile = new AudioSource(
    audioFileName,
    audioSegments,
    rate: 1.0);

// Agregar al final de la línea de tiempo.
VideoEdit1.Input_AddAudioFile(audioFile);

Escenarios de Uso Avanzado¶

Segmentos de Velocidad Variable¶

Puedes crear efectos interesantes variando el factor de velocidad para diferentes segmentos:

// Crear segmentos con diferentes velocidades. FileSegment(start, stop) — stop debe ser > start.
VideoSource slowMotionSegment = new VideoSource(
    videoFileName,
    new[] { new FileSegment(TimeSpan.FromMilliseconds(5000), TimeSpan.FromMilliseconds(8000)) },  // 5s → 8s
    VideoEditStretchMode.Letterbox,
    0,      // streamNumber
    0.5);   // rate — media velocidad (cámara lenta)

VideoSource fastForwardSegment = new VideoSource(
    videoFileName,
    new[] { new FileSegment(TimeSpan.FromMilliseconds(10000), TimeSpan.FromMilliseconds(15000)) }, // 10s → 15s
    VideoEditStretchMode.Letterbox,
    0,      // streamNumber
    2.0);   // rate — doble velocidad

// Añadir segmentos a la línea de tiempo. El arg de posición es TimeSpan? (punto de inserción), no un int.
VideoEdit1.Input_AddVideoFile(slowMotionSegment);
VideoEdit1.Input_AddVideoFile(fastForwardSegment, TimeSpan.FromMilliseconds(3000));

Combinar Múltiples Archivos con Segmentos¶

Puedes combinar segmentos de diferentes archivos creando múltiples objetos VideoSource:

// Crear segmentos de diferentes archivos. FileSegment(start, stop) — stop debe ser > start.
VideoSource file1Segments = new VideoSource(
    videoFileName1,
    new[] { new FileSegment(TimeSpan.FromMilliseconds(0), TimeSpan.FromMilliseconds(5000)) },  // 0 → 5s
    VideoEditStretchMode.Letterbox,
    0,      // streamNumber
    1.0);   // rate

VideoSource file2Segments = new VideoSource(
    videoFileName2,
    new[] { new FileSegment(TimeSpan.FromMilliseconds(2000), TimeSpan.FromMilliseconds(6000)) }, // 2s → 6s
    VideoEditStretchMode.Letterbox,
    0,      // streamNumber
    1.0);   // rate

// Añadir a la línea de tiempo en secuencia. El arg de posición es TimeSpan?, no un int.
VideoEdit1.Input_AddVideoFile(file1Segments);
VideoEdit1.Input_AddVideoFile(file2Segments, TimeSpan.FromMilliseconds(5000));

Dependencias Requeridas¶

Para usar esta funcionalidad, necesitarás instalar los paquetes redistribuibles apropiados:

Redistribuibles de Video Edit SDK:
paquete x86
paquete x64

Para información sobre cómo instalar o desplegar estos redistribuibles en los PCs de tus usuarios, consulta la guía de despliegue.

Conclusión¶

Extraer y combinar múltiples segmentos de un archivo de video es una técnica poderosa para crear contenido de video dinámico en tus aplicaciones. Siguiendo los pasos descritos en esta guía, puedes implementar esta funcionalidad en tus aplicaciones C# con mínimo esfuerzo.

Este enfoque te da control detallado sobre qué porciones de un video se incluyen en tu salida final, permitiendo posibilidades de edición creativas sin requerir herramientas complejas de edición de video manual.

Visita nuestro repositorio de GitHub para más muestras de código y ejemplos.