Saltar a contenido

Establecer Niveles de Volumen Personalizados para Pistas de Audio en Aplicaciones C

Video Edit SDK .Net VideoEditCore

Descripción General

Gestionar los niveles de volumen de audio es un aspecto crítico de las aplicaciones de producción y edición de video. Esta guía demuestra cómo implementar controles de volumen individuales para pistas de audio separadas en tu aplicación .NET.

Detalles de Implementación

Establecer niveles de volumen personalizados para pistas de audio da a tus usuarios un control más preciso sobre su mezcla de audio. Cada pista puede tener su propia configuración de volumen independiente, permitiendo un equilibrio de audio de calidad profesional.

Implementación de Código de Ejemplo

El siguiente ejemplo en C# muestra cómo aplicar un efecto de envolvente de volumen a una pista de audio:

// AudioVolumeEnvelopeEffect(level) fija un volumen constante para la pista.
// Las propiedades opcionales StartTime / StopTime (TimeSpan) restringen el
// efecto a una ventana temporal.
var volume = new AudioVolumeEnvelopeEffect(level: 10);

// La sobrecarga de 5 argumentos de Input_AddAudioFile toma un AudioSource
// (no un string), así que envuelve la ruta del archivo antes de pasarla con
// el arreglo de efectos.
// Firma: Input_AddAudioFile(AudioSource, TimeSpan? timelineInsertTime = null,
//   int targetStreamIndex = 0, AudioTrackEffect[] effects = null,
//   TimelineAudioTrackCustomSettings = null)
var audioSource = new AudioSource(audioFile);
VideoEdit1.Input_AddAudioFile(audioSource, null, 0, new[] { volume });

Entender los Parámetros

  • AudioVolumeEnvelopeEffect(level: 10): envolvente de volumen constante. level es un int; usa las propiedades StartTime/StopTime (ambas TimeSpan) para limitar el efecto a una ventana temporal.
  • audioFile (string) debe envolverse en un new AudioSource(...) — la sobrecarga con arreglo de efectos de Input_AddAudioFile solo acepta un AudioSource, no un nombre de archivo en crudo.
  • Input_AddAudioFile: añade el archivo de audio a la línea de tiempo aplicando los efectos al stream de audio elegido.

Dependencias Requeridas

Para implementar esta funcionalidad, necesitarás los siguientes paquetes redistribuibles:

Información de Despliegue

Para información sobre cómo instalar o desplegar los componentes requeridos en los sistemas de tus usuarios finales, por favor consulta nuestra guía de despliegue.

Recursos Adicionales

Para más ejemplos de código y técnicas de implementación, visita nuestro repositorio de GitHub con proyectos de ejemplo completos.