Gestionar audio en presentaciones usando PHP

Crear fotogramas de audio

Aspose.Slides for PHP via Java le permite agregar archivos de audio a las diapositivas. Los archivos de audio se incrustan en las diapositivas como fotogramas de audio.

Cree una instancia de la clase Presentation.
Obtenga la referencia de una diapositiva mediante su índice.
Cargue la secuencia del archivo de audio que desea incrustar en la diapositiva.
Agregue el fotograma de audio incrustado (que contiene el archivo de audio) a la diapositiva.
Establezca PlayMode y Volume expuestos por el objeto IAudioFrame.
Guarde la presentación modificada.

Este código PHP le muestra cómo agregar un fotograma de audio incrustado a una diapositiva:

// Instancia una clase Presentation que representa un archivo de presentación
$pres = new Presentation();
try {
    # Obtiene la primera diapositiva
    $sld = $pres->getSlides()->get_Item(0);
    # Carga el archivo de sonido wav al flujo
    $fstr = new Java("java.io.FileInputStream", new Java("java.io.File", "audio.wav"));
    # Agrega el fotograma de audio
    $audioFrame = $sld->getShapes()->addAudioFrameEmbedded(50, 150, 100, 100, $fstr);
    $fstr->close();
    # Establece el modo de reproducción y el volumen del audio
    $audioFrame->setPlayMode(AudioPlayModePreset->Auto);
    $audioFrame->setVolume(AudioVolumeMode->Loud);
    # Escribe el archivo PowerPoint en disco
    $pres->save("AudioFrameEmbed_out.pptx", SaveFormat::Pptx);
} catch(JavaException e) {
} finally {
    if (!java_is_null($pres)) $pres.dispose();
}

Cambiar la miniatura del fotograma de audio

Cuando agrega un archivo de audio a una presentación, el audio aparece como un fotograma con una imagen predeterminada estándar (vea la imagen en la sección siguiente). Cambie la imagen de vista previa del fotograma de audio (establezca la imagen que prefiera).

Este código PHP le muestra cómo cambiar la miniatura o la imagen de vista previa de un fotograma de audio:

$presentation = new Presentation();
try {
	$slide = $presentation->getSlides()->get_Item(0);
	# Agrega un fotograma de audio a la diapositiva con una posición y tamaño especificados.
	$audioStream = new Java("java.io.FileInputStream", "sample2.mp3");
	$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(150, 100, 50, 50, $audioStream);
	$audioStream->close();
	# Agrega una imagen a los recursos de la presentación.
	$picture;
	$image = Images->fromFile("eagle.jpeg");
	try {
		$picture = $presentation->getImages()->addImage($image);
	} finally {
		if (!java_is_null($image)) {
			$image->dispose();
		}
	}
	# Establece la imagen para el fotograma de audio.
	$audioFrame->getPictureFormat()->getPicture()->setImage($picture);// <-----

	# Guarda la presentación modificada en disco
	$presentation->save("example_out.pptx", SaveFormat::Pptx);
} catch (JavaException $e) {
} finally {
	if (!java_is_null($presentation)) {
		$presentation->dispose();
	}
}

Cambiar opciones de reproducción de audio

Aspose.Slides for PHP via Java le permite cambiar opciones que controlan la reproducción o propiedades de un audio. Por ejemplo, puede ajustar el volumen de un audio, establecer que el audio se reproduzca en bucle o incluso ocultar el ícono de audio.

El panel Audio Options en Microsoft PowerPoint: example1_image

Las Audio Options de PowerPoint que corresponden a las propiedades de Aspose.Slides AudioFrame :

Start la lista desplegable coincide con el método AudioFrame.setPlayMode
Volume coincide con el método AudioFrame.setVolume
Play Across Slides coincide con el método AudioFrame.setPlayAcrossSlides
Loop until Stopped coincide con el método AudioFrame.setPlayLoopMode
Hide During Show coincide con el método AudioFrame.setHideAtShowing
Rewind after Playing coincide con el método AudioFrame.setRewindAudio

Opciones de Editing de PowerPoint que corresponden a las propiedades de Aspose.Slides AudioFrame :

Fade In coincide con el método AudioFrame.setFadeInDuration
Fade Out coincide con el método AudioFrame.setFadeOutDuration
Trim Audio Start Time coincide con el método AudioFrame.setTrimFromStart
Trim Audio End Time el valor equivale a la duración del audio menos el valor del método AudioFrame.setTrimFromEnd

El Volume controll de PowerPoint en el panel de control de audio corresponde al método AudioFrame.setVolumeValue. Le permite cambiar el volumen del audio como un porcentaje.

Así es como cambia las opciones de reproducción de audio:

Crear o obtenga el fotograma de audio.
Establezca nuevos valores para las propiedades del fotograma de audio que desea ajustar.
Guarde el archivo de PowerPoint modificado.

Este código PHP muestra una operación en la que se ajustan las opciones de un audio:

$pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    # Obtiene la forma AudioFrame
    $audioFrame = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # Establece el modo de reproducción a reproducir al hacer clic
    $audioFrame->setPlayMode(AudioPlayModePreset->OnClick);
    # Establece el volumen a bajo
    $audioFrame->setVolume(AudioVolumeMode->Low);
    # Establece que el audio se reproduzca a través de diapositivas
    $audioFrame->setPlayAcrossSlides(true);
    # Desactiva el bucle del audio
    $audioFrame->setPlayLoopMode(false);
    # Oculta el AudioFrame durante la presentación de diapositivas
    $audioFrame->setHideAtShowing(true);
    # Retrocede el audio al inicio después de reproducir
    $audioFrame->setRewindAudio(true);
    # Guarda el archivo PowerPoint en disco
    $pres->save("AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);
} finally {
	if (!java_is_null($pres)) {
		$pres->dispose();
	}
}

Este ejemplo PHP muestra cómo agregar un nuevo fotograma de audio con audio incrustado, recortarlo y establecer las duraciones de fundido:

$pres = new Presentation();
try {
    $slide = $pres->getSlides()->get_Item(0);

    $audioData = file_get_contents("sampleaudio.mp3");
    $audio = $pres->getAudios()->addAudio($audioData);
    $audioFrame = $slide->getShapes()->addAudioFrameEmbedded(50, 50, 100, 100, $audio);

    // Establece el desplazamiento de inicio del recorte a 1,5 segundos
    $audioFrame->setTrimFromStart(1500);
    // Establece el desplazamiento de fin del recorte a 2 segundos
    $audioFrame->setTrimFromEnd(2000);

    // Establece la duración del fundido de entrada a 200 ms
    $audioFrame->setFadeInDuration(200);
    // Establece la duración del fundido de salida a 500 ms
    $audioFrame->setFadeOutDuration(500);

    $pres->save("AudioFrameTrimFade_out.pptx", SaveFormat::Pptx);
} finally {
    $pres->dispose();
}

El siguiente ejemplo de código muestra cómo obtener un fotograma de audio con audio incrustado y establecer su volumen al 85%:

$pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    $slide = $pres->getSlides()->get_Item(0);

    // Obtiene la forma de fotograma de audio
    $audioFrame = $slide->getShapes()->get_Item(0);

    // Establece el volumen del audio al 85%
    $audioFrame->setVolumeValue(85);

    $pres->save("AudioFrameValue_out.pptx", SaveFormat::Pptx);
}
finally {
    $pres->dispose();
}

Extraer audio

Aspose.Slides for PHP via Java le permite extraer el sonido utilizado en las transiciones de la presentación de diapositivas. Por ejemplo, puede extraer el sonido usado en una diapositiva específica.

Cree una instancia de la clase Presentation y cargue la presentación que contiene el audio.
Obtenga la referencia de la diapositiva correspondiente mediante su índice.
Acceda a las slideshow transitions de la diapositiva.
Extraiga el sonido en datos de bytes.

Este código le muestra cómo extraer el audio utilizado en una diapositiva:

# Instancia una clase Presentation que representa un archivo de presentación
$pres = new Presentation("AudioSlide.pptx");
$Array = new java_class("java.lang.reflect.Array");
try {
	# Accede a la diapositiva deseada
	$slide = $pres->getSlides()->get_Item(0);
	# Obtiene los efectos de transición de la presentación para la diapositiva
	$transition = $slide->getSlideShowTransition();
	# Extrae el sonido en un arreglo de bytes
	$audio = $transition->getSound()->getBinaryData();
	echo("Length: " . $Array->getLength($audio));
} finally {
	if (!java_is_null($pres)) {
		$pres->dispose();
	}
}

FAQ

¿Puedo reutilizar el mismo recurso de audio en varias diapositivas sin aumentar el tamaño del archivo?

Sí. Añada el audio una vez a la audio collection compartida de la presentación y cree fotogramas de audio adicionales que hagan referencia a ese recurso existente. Esto evita duplicar los datos multimedia y mantiene el tamaño de la presentación bajo control.

¿Puedo reemplazar el sonido en un fotograma de audio existente sin recrear la forma?

Sí. Para un sonido vinculado, actualice la link path para que apunte al nuevo archivo. Para un sonido incrustado, reemplace el objeto embedded audio por otro de la audio collection de la presentación. El formato del fotograma y la mayoría de los ajustes de reproducción permanecen intactos.

¿El recorte cambia los datos de audio subyacentes almacenados en la presentación?

No. El recorte solo ajusta los límites de reproducción. Los bytes originales del audio permanecen sin modificar y son accesibles a través del audio incrustado o de la colección de audio de la presentación.