Gerenciar áudio em apresentações usando PHP

Visão geral

Este artigo explica como trabalhar com quadros de áudio no Aspose.Slides. Ele mostra como adicionar áudio incorporado aos slides, personalizar a miniatura do quadro de áudio, configurar opções de reprodução como volume, repetição, ocultação, corte e durações de fade, e extrair áudio usado em transições de apresentação de slides.

Criar quadros de áudio

Aspose.Slides for PHP via Java permite que você adicione arquivos de áudio aos slides. Os arquivos de áudio são incorporados nos slides como quadros de áudio.

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência de um slide através de seu índice.
  3. Carregue o fluxo do arquivo de áudio que deseja incorporar no slide.
  4. Adicione o quadro de áudio incorporado (contendo o arquivo de áudio) ao slide.
  5. Defina PlayMode e Volume expostos pelo objeto AudioFrame.
  6. Salve a apresentação modificada.

Este código PHP mostra como adicionar um quadro de áudio incorporado a um slide:

// Instancia uma classe Presentation que representa um arquivo de apresentação
$pres = new Presentation();
try {
    # Obtém o primeiro slide
    $sld = $pres->getSlides()->get_Item(0);
    # Carrega o arquivo de som wav para o fluxo
    $fstr = new Java("java.io.FileInputStream", new Java("java.io.File", "audio.wav"));
    # Adiciona o Quadro de Áudio
    $audioFrame = $sld->getShapes()->addAudioFrameEmbedded(50, 150, 100, 100, $fstr);
    $fstr->close();
    # Define o modo de reprodução e o volume do áudio
    $audioFrame->setPlayMode(AudioPlayModePreset->Auto);
    $audioFrame->setVolume(AudioVolumeMode->Loud);
    # Grava o arquivo PowerPoint no disco
    $pres->save("AudioFrameEmbed_out.pptx", SaveFormat::Pptx);
} catch(JavaException e) {
} finally {
    if (!java_is_null($pres)) $pres.dispose();
}

Alterar a miniatura do quadro de áudio

Ao adicionar um arquivo de áudio a uma apresentação, o áudio aparece como um quadro com uma imagem padrão (veja a imagem na seção abaixo). Você pode alterar a imagem de visualização do quadro de áudio (definir sua imagem preferida).

Este código PHP mostra como alterar a miniatura ou imagem de visualização de um quadro de áudio:

$presentation = new Presentation();
try {
	$slide = $presentation->getSlides()->get_Item(0);
	# Adiciona um quadro de áudio ao slide com posição e tamanho especificados.
	$audioStream = new Java("java.io.FileInputStream", "sample2.mp3");
	$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(150, 100, 50, 50, $audioStream);
	$audioStream->close();
	# Adiciona uma imagem aos recursos da apresentação.
	$picture;
	$image = Images->fromFile("eagle.jpeg");
	try {
		$picture = $presentation->getImages()->addImage($image);
	} finally {
		if (!java_is_null($image)) {
			$image->dispose();
		}
	}
	# Define a imagem para o quadro de áudio.
	$audioFrame->getPictureFormat()->getPicture()->setImage($picture);// <-----

	# Salva a apresentação modificada no disco
	$presentation->save("example_out.pptx", SaveFormat::Pptx);
} catch (JavaException $e) {
} finally {
	if (!java_is_null($presentation)) {
		$presentation->dispose();
	}
}

Alterar opções de reprodução de áudio

Aspose.Slides for PHP via Java permite que você altere opções que controlam a reprodução ou propriedades de um áudio. Por exemplo, é possível ajustar o volume, reproduzir o áudio em loop ou até ocultar o ícone do áudio.

O painel Opções de áudio no Microsoft PowerPoint:

example1_image

Opções de áudio do PowerPoint que correspondem às propriedades do Aspose.Slides AudioFrame:

Opções de Edição do PowerPoint que correspondem às propriedades do Aspose.Slides AudioFrame:

O controle de volume no painel de áudio do PowerPoint corresponde ao método AudioFrame::setVolumeValue. Ele permite alterar o volume do áudio em porcentagem.

Assim você altera as opções de reprodução de áudio:

  1. Criar (Create) ou obter o quadro de áudio.
  2. Defina novos valores para as propriedades do quadro de áudio que deseja ajustar.
  3. Salve o arquivo PowerPoint modificado.

Este código PHP demonstra uma operação em que as opções de um áudio são ajustadas:

$pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    # Obtém a forma AudioFrame
    $audioFrame = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # Define o modo de reprodução para reproduzir ao clicar
    $audioFrame->setPlayMode(AudioPlayModePreset->OnClick);
    # Define o volume como Baixo
    $audioFrame->setVolume(AudioVolumeMode->Low);
    # Define o áudio para reproduzir em todos os slides
    $audioFrame->setPlayAcrossSlides(true);
    # Desativa o loop para o áudio
    $audioFrame->setPlayLoopMode(false);
    # Oculta o AudioFrame durante a apresentação de slides
    $audioFrame->setHideAtShowing(true);
    # Rebobina o áudio para o início após a reprodução
    $audioFrame->setRewindAudio(true);
    # Salva o arquivo PowerPoint no disco
    $pres->save("AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);
} finally {
	if (!java_is_null($pres)) {
		$pres->dispose();
	}
}

Este exemplo PHP mostra como adicionar um novo quadro de áudio incorporado, recortá‑lo e definir as durações de fade:

$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);

    // Define o deslocamento inicial do corte para 1,5 segundos
    $audioFrame->setTrimFromStart(1500);
    // Define o deslocamento final do corte para 2 segundos
    $audioFrame->setTrimFromEnd(2000);

    // Define a duração do fade-in para 200 ms
    $audioFrame->setFadeInDuration(200);
    // Define a duração do fade-out para 500 ms
    $audioFrame->setFadeOutDuration(500);

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

O trecho de código a seguir mostra como recuperar um quadro de áudio incorporado e definir seu volume para 85%:

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

    // Obtém a forma do quadro de áudio
    $audioFrame = $slide->getShapes()->get_Item(0);

    // Define o volume do áudio para 85%
    $audioFrame->setVolumeValue(85);

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

Gerenciar legendas de áudio

Aspose.Slides permite que você adicione legendas fechadas a um quadro de áudio através do método getCaptionTracks. Esse método devolve uma CaptionsCollection, que permite adicionar faixas de legenda WebVTT, iterar pelas faixas existentes e removê‑las quando necessário.

Adicionar legendas de áudio

Use o método getCaptionTracks para associar uma ou mais faixas de legenda a um quadro de áudio. No exemplo a seguir, um arquivo de áudio é adicionado a um slide e, em seguida, uma nova faixa de legenda é carregada de um arquivo .vtt.

$presentation = new Presentation();
try {
    $audioData = file_get_contents("audio.mp3");
    $audio = $presentation->getAudios()->addAudio($audioData);

    $slide = $presentation->getSlides()->get_Item(0);
    $audioFrame = $slide->getShapes()->addAudioFrameEmbedded(10, 10, 50, 50, $audio);

    // Adiciona uma nova faixa de legenda a partir de um arquivo WebVTT.
    $audioFrame->getCaptionTracks()->add("New track", "track.vtt");

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

Extrair legendas de áudio

É possível iterar pelas faixas de legenda associadas a um quadro de áudio e salvá‑las como arquivos .vtt. Cada faixa de legenda expõe seus dados binários e identificador único, que podem ser usados ao exportar legendas.

$presentation = new Presentation("audio_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shapeCount = java_values($slide->getShapes()->size());
    for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) {
        $shape = $slide->getShapes()->get_Item($shapeIndex);
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AudioFrame"))) {
            $audioFrame = $shape;
            $trackCount = java_values($audioFrame->getCaptionTracks()->getCount());
            for ($trackIndex = 0; $trackIndex < $trackCount; $trackIndex++) {
                $captionTrack = $audioFrame->getCaptionTracks()->get_Item($trackIndex);
                // Salve cada faixa de legenda como um arquivo .vtt.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Remover legendas de áudio

Para remover legendas de um quadro de áudio, use os métodos fornecidos por CaptionsCollection, como clear, remove ou removeAt. O exemplo a seguir remove todas as faixas de legenda de um quadro de áudio.

$presentation = new Presentation($folderPath . "audio_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $audioFrame = $slide->getShapes()->get_Item(0); // tipo: AudioFrame

    // Remova todas as faixas de legenda do quadro de áudio.
    $audioFrame->getCaptionTracks()->clear();

    $presentation->save($folderPath . "audio_without_captions.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Extrair áudio

Aspose.Slides for PHP via Java permite que você extraia o som usado em transições de apresentação de slides. Por exemplo, é possível extrair o som usado em um slide específico.

  1. Crie uma instância da classe Presentation e carregue a apresentação que contém o áudio.
  2. Obtenha a referência do slide relevante através de seu índice.
  3. Acesse as transições de slide show do slide.
  4. Extraia o som em dados de bytes.

Este código mostra como extrair o áudio usado em um slide:

# Instancia uma classe Presentation que representa um arquivo de apresentação
$pres = new Presentation("AudioSlide.pptx");
$Array = new java_class("java.lang.reflect.Array");
try {
	# Acessa o slide desejado
	$slide = $pres->getSlides()->get_Item(0);
	# Obtém os efeitos de transição de apresentação de slides para o slide
	$transition = $slide->getSlideShowTransition();
	# Extrai o som em um array de bytes
	$audio = $transition->getSound()->getBinaryData();
	echo("Length: " . $Array->getLength($audio));
} finally {
	if (!java_is_null($pres)) {
		$pres->dispose();
	}
}

FAQ

Posso reutilizar o mesmo recurso de áudio em vários slides sem aumentar o tamanho do arquivo?

Sim. Adicione o áudio uma vez à coleção de áudio compartilhada da apresentação e crie quadros de áudio adicionais que façam referência a esse recurso existente. Isso evita a duplicação de dados de mídia e mantém o tamanho da apresentação sob controle.

Posso substituir o som em um quadro de áudio existente sem recriar a forma?

Sim. Para um som vinculado, atualize o caminho do link para apontar para o novo arquivo. Para um som incorporado, troque o objeto embedded audio por outro da coleção de áudio da apresentação. A formatação do quadro e a maioria das configurações de reprodução permanecem intactas.

O recorte altera os dados de áudio subjacentes armazenados na apresentação?

Não. O recorte ajusta apenas os limites de reprodução. Os bytes originais do áudio permanecem inalterados e acessíveis através do áudio incorporado ou da coleção de áudio da apresentação.