Marco de Audio

Creando un Marco de Audio

Aspose.Slides para C++ te permite agregar archivos de audio a las diapositivas. Los archivos de audio se integran en las diapositivas como marcos de audio.

Crea una instancia de la clase Presentation.
Obtén la referencia de una diapositiva a través de su índice.
Carga el flujo del archivo de audio que deseas integrar en la diapositiva.
Agrega el marco de audio integrado (que contiene el archivo de audio) a la diapositiva.
Establece PlayMode y Volume expuestos por el objeto IAudioFrame.
Guarda la presentación modificada.

Este código C++ te muestra cómo agregar un marco de audio integrado a una diapositiva:

// Instancia una clase Presentation que representa un archivo de presentación
auto pres = System::MakeObject<Presentation>();

// Obtiene la primera diapositiva
auto sld = pres->get_Slides()->idx_get(0);

// Carga el archivo de sonido wav en un flujo
auto fstr = System::MakeObject<FileStream>(u"sampleaudio.wav", FileMode::Open, FileAccess::Read);

// Agrega el Marco de Audio
auto audioFrame = sld->get_Shapes()->AddAudioFrameEmbedded(50.0f, 150.0f, 100.0f, 100.0f, fstr);

// Establece el Modo de Reproducción y el Volumen del Audio
audioFrame->set_PlayMode(AudioPlayModePreset::Auto);
audioFrame->set_Volume(AudioVolumeMode::Loud);

// Escribe el archivo de PowerPoint en el disco
pres->Save(u"AudioFrameEmbed_out.pptx", SaveFormat::Pptx);

Cambiar la Miniatura del Marco de Audio

Cuando agregas un archivo de audio a una presentación, el audio aparece como un marco con una imagen predeterminada estándar (ver la imagen en la sección siguiente). Puedes cambiar la miniatura del marco de audio (configura tu imagen preferida).

Este código C++ te muestra cómo cambiar la miniatura o la imagen de vista previa de un marco de audio:

auto presentation = System::MakeObject<Presentation>();
        
auto slide = presentation->get_Slides()->idx_get(0);
        
// Agrega un marco de audio a la diapositiva con una posición y tamaño específicos.
auto audioStream = System::MakeObject<System::IO::FileStream>(u"sample2.mp3", 
    System::IO::FileMode::Open, System::IO::FileAccess::Read);
    
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(150.0f, 100.0f, 50.0f, 50.0f, audioStream);
            
// Agrega una imagen a los recursos de la presentación.
auto imageStream = System::IO::File::OpenRead(u"eagle.jpeg");
auto audioImage = presentation->get_Images()->AddImage(imageStream);
            
// Establece la imagen para el marco de audio.
audioFrame->get_PictureFormat()->get_Picture()->set_Image(audioImage); // <-----
        
// Guarda la presentación modificada en el disco
presentation->Save(u"example_out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

Cambiar las Opciones de Reproducción de Audio

Aspose.Slides para C++ te permite cambiar opciones que controlan la reproducción o propiedades de un audio. Por ejemplo, puedes ajustar el volumen de un audio, configurar el audio para que se reproduzca en bucle, o incluso ocultar el ícono de audio.

El panel de Opciones de Audio en Microsoft PowerPoint:

example1_image

Las opciones de Audio de PowerPoint que corresponden a los métodos AudioFrame de Aspose.Slides:

La lista desplegable de Inicio de Opciones de Audio coincide con el método AudioFrame::get_PlayMode()
Volumen de Opciones de Audio coincide con el método AudioFrame::get_Volume()
Reproducir a través de Diapositivas coincide con el método AudioFrame::get_PlayAcrossSlides()
Repetir hasta detenerse coincide con el método AudioFrame::get_PlayLoopMode()
Ocultar durante la Presentación coincide con el método AudioFrame::get_HideAtShowing()
Retroceder después de Reproducir coincide con el método AudioFrame::get_RewindAudio()

Así es como cambias las opciones de Reproducción de Audio:

Crear o obtener el Marco de Audio.
Establece nuevos valores para las propiedades del Marco de Audio que deseas ajustar.
Guarda el archivo de PowerPoint modificado.

Este código C++ demuestra una operación en la que se ajustan las opciones de un audio:

auto pres = System::MakeObject<Presentation>(u"AudioFrameEmbed_out.pptx");

// Obtiene una forma
auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0);

// Convierte la forma a un marco de AudioFrame
auto audioFrame = System::ExplicitCast<AudioFrame>(shape);

// Establece el modo de Reproducción para reproducir al hacer clic
audioFrame->set_PlayMode(AudioPlayModePreset::OnClick);

// Establece el Volumen en Bajo
audioFrame->set_Volume(AudioVolumeMode::Low);

// Establece el audio para reproducir a través de las diapositivas
audioFrame->set_PlayAcrossSlides(true);

// Deshabilita el bucle para el audio
audioFrame->set_PlayLoopMode(false);

// Oculta el AudioFrame durante la presentación
audioFrame->set_HideAtShowing(true);

// Retrocede el audio al inicio después de reproducir
audioFrame->set_RewindAudio(true);

// Guarda el archivo de PowerPoint en el disco
pres->Save(u"AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);

Extraer Audio

Aspose.Slides para .NET te permite extraer el sonido utilizado en las transiciones de la presentación. Por ejemplo, puedes extraer el sonido utilizado en una diapositiva específica.

Crea una instancia de la clase Presentation y carga la presentación que contiene el audio.
Obtén la referencia de la diapositiva correspondiente a través de su índice.
Accede a las transiciones de la presentación para la diapositiva.
Extrae el sonido en datos de bytes.

Este código C++ te muestra cómo extraer el audio usado en una diapositiva:

String presName = u"AudioSlide.pptx";

// Instancia una clase Presentation que representa un archivo de presentación
auto pres = System::MakeObject<Presentation>(presName);

// Accede a la diapositiva deseada
auto slide = pres->get_Slides()->idx_get(0);

// Obtiene los efectos de transición de la presentación para la diapositiva
auto transition = slide->get_SlideShowTransition();

// Extrae el sonido en un arreglo de bytes
auto audio = transition->get_Sound()->get_BinaryData();

Console::WriteLine(String(u"Longitud: ") + audio->get_Length());