Audio‑Frames in Präsentationen mit PHP verwalten
Übersicht
Ein Audio‑Frame ermöglicht das Abspielen eines Sounds auf einer Folie. Mit Aspose.Slides für PHP via Java können Sie einen Audio‑Clip einbetten, das Bild auswählen, das ihn darstellt, die Wiedergabe anpassen und Untertitel hinzufügen. Sie können auch einen einem Folienübergang zugewiesenen Sound abrufen.
Audio‑Frames erstellen
Verwenden Sie addAudioFrameEmbedded , um einen lokalen Audio‑Clip auf der ersten Folie einzubetten. Die ersten beiden Koordinaten positionieren den Frame auf der Folie, und die nächsten beiden Werte legen seine Breite und Höhe fest, alles in Punkten. Dieses Beispiel ruft setPlayMode auf, um den Clip automatisch zu starten, und ruft setVolume auf, um die laute Voreinstellung auszuwählen.
use aspose\slides\AudioPlayModePreset;
use aspose\slides\AudioVolumeMode;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioStream = new Java("java.io.FileInputStream", "audio.wav");
try {
$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(50, 150, 100, 100, $audioStream);
} finally {
$audioStream->close();
}
$audioFrame->setPlayMode(AudioPlayModePreset::Auto);
$audioFrame->setVolume(AudioVolumeMode::Loud);
$presentation->save("AudioFrameEmbed_out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Thumbnail des Audio‑Frames ändern
Standardmäßig zeigt ein Audio‑Frame ein Lautsprechersymbol an. Um ein benutzerdefiniertes Thumbnail anzuzeigen, fügen Sie der Präsentation mit addImage ein Bild hinzu und setzen es mit setImage auf das Bild des Frames. Das Beispiel verwendet ein JPEG als Thumbnail für einen eingebetteten Audio‑Clip.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioStream = new Java("java.io.FileInputStream", "audio.wav");
try {
$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(150, 100, 50, 50, $audioStream);
} finally {
$audioStream->close();
}
$imageStream = new Java("java.io.FileInputStream", "eagle.jpeg");
try {
$thumbnail = $presentation->getImages()->addImage($imageStream);
} finally {
$imageStream->close();
}
$audioFrame->getPictureFormat()->getPicture()->setImage($thumbnail);
$presentation->save("example_out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Audio‑Wiedergabeoptionen ändern
Die Audio‑Optionen von PowerPoint bestimmen, wann ein Clip startet, wie laut er ist und wie er während einer Bildschirmpräsentation funktioniert.

| PowerPoint‑Steuerelement | Aspose.Slides für PHP via Java‑Methode |
|---|---|
| Start | setPlayMode |
| Lautstärke‑Voreinstellung | setVolume |
| Wiedergabe über Folien hinweg | setPlayAcrossSlides |
| Schleife bis gestoppt | setPlayLoopMode |
| Während der Präsentation ausblenden | setHideAtShowing |
| Nach der Wiedergabe zurückspulen | setRewindAudio |
| Einblenden | setFadeInDuration |
| Ausblenden | setFadeOutDuration |
| Audio‑Startzeit zuschneiden | setTrimFromStart |
| Audio‑Endzeit zuschneiden | setTrimFromEnd |
| Lautstärkeregler | setVolumeValue |
Das Beispiel findet den ersten Audio‑Frame auf der ersten Folie, ruft setPlayMode auf, um die Wiedergabe bei einem Klick zu starten, und wählt die niedrige Lautstärke‑Voreinstellung aus. Der Clip wird über Folien hinweg fortgesetzt, wobei die Schleife deaktiviert ist. Das Symbol bleibt während der Präsentation ausgeblendet, und der Clip wird nach der Wiedergabe zurückgespult.
use aspose\slides\AudioPlayModePreset;
use aspose\slides\AudioVolumeMode;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("AudioFrameEmbed_out.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioFrameType = new JavaClass("com.aspose.slides.AudioFrame");
$audioFrame = null;
$shapes = $slide->getShapes();
$shapeCount = java_values($shapes->size());
for ($i = 0; $i < $shapeCount; $i++) {
$shape = $shapes->get_Item($i);
if (java_instanceof($shape, $audioFrameType)) {
$audioFrame = $shape;
break;
}
}
if ($audioFrame !== null) {
$audioFrame->setPlayAcrossSlides(true);
$audioFrame->setPlayLoopMode(false);
$audioFrame->setPlayMode(AudioPlayModePreset::OnClick);
$audioFrame->setVolume(AudioVolumeMode::Low);
$audioFrame->setHideAtShowing(true);
$audioFrame->setRewindAudio(true);
$presentation->save("AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);
} else {
echo "The first slide has no audio frame.\n";
}
} finally {
$presentation->dispose();
}
Für einen Clip, der länger als 3,5 Sekunden ist, überspringt dieses Beispiel die ersten 1,5 Sekunden und die letzten 2 Sekunden. setTrimFromEnd nimmt die Dauer, die am Ende des Clips weggelassen werden soll. Um die in PowerPoint angezeigte Endzeit zu erhalten, ziehen Sie diesen Versatz von der Gesamtdauer des Clips ab. Der zugeschnittene Clip blendet über 200 Millisekunden ein und über 500 Millisekunden aus. Alle vier Methoden erwarten Werte in Millisekunden.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioStream = new Java("java.io.FileInputStream", "audio.wav");
try {
$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(50, 50, 100, 100, $audioStream);
} finally {
$audioStream->close();
}
$audioFrame->setTrimFromStart(1500);
$audioFrame->setTrimFromEnd(2000);
$audioFrame->setFadeInDuration(200);
$audioFrame->setFadeOutDuration(500);
$presentation->save("AudioFrameTrimFade_out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Um die Wiedergabelautstärke auf einen bestimmten Prozentsatz einzustellen, verwenden Sie setVolumeValue. Dieses Beispiel setzt den ersten Audio‑Frame auf der ersten Folie auf 85 %.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("AudioFrameEmbed_out.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioFrameType = new JavaClass("com.aspose.slides.AudioFrame");
$audioFrame = null;
$shapes = $slide->getShapes();
$shapeCount = java_values($shapes->size());
for ($i = 0; $i < $shapeCount; $i++) {
$shape = $shapes->get_Item($i);
if (java_instanceof($shape, $audioFrameType)) {
$audioFrame = $shape;
break;
}
}
if ($audioFrame !== null) {
$audioFrame->setVolumeValue(85);
$presentation->save("AudioFrameValue_out.pptx", SaveFormat::Pptx);
} else {
echo "The first slide has no audio frame.\n";
}
} finally {
$presentation->dispose();
}
Audio‑Untertitel verwalten
Jeder Audio‑Frame bietet über getCaptionTracks Zugriff auf seine Untertitelspuren. Verwenden Sie die Sammlung, um WebVTT‑Untertitel dem Clip hinzuzufügen, vorhandene Spuren zu exportieren oder zu entfernen.
Audio‑Untertitel hinzufügen
Das Beispiel bettet einen Audio‑Clip auf der ersten Folie ein und verwendet add, um eine lokale WebVTT‑Spur hinzuzufügen. Das erste Argument liefert die Spurenbezeichnung, das zweite identifiziert die Datei mit den zeitlich abgestimmten Untertiteln.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioStream = new Java("java.io.FileInputStream", "audio.wav");
try {
$audioFrame = $slide->getShapes()->addAudioFrameEmbedded(10, 10, 50, 50, $audioStream);
} finally {
$audioStream->close();
}
$audioFrame->getCaptionTracks()->add("English", "track.vtt");
$presentation->save("audio_with_captions.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Audio‑Untertitel extrahieren
Dieses Beispiel exportiert jede Untertitelspur, die an einem Audio‑Frame auf der ersten Folie angehängt ist. Es schreibt die von getBinaryData zurückgegebenen Bytes in eine WebVTT‑Datei und verwendet die von getCaptionId zurückgegebene Kennung als Dateinamen, sodass jede Spur eine separate Ausgabe hat.
use aspose\slides\Presentation;
$presentation = new Presentation("audio_with_captions.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioFrameType = new JavaClass("com.aspose.slides.AudioFrame");
$shapes = $slide->getShapes();
$shapeCount = java_values($shapes->size());
for ($i = 0; $i < $shapeCount; $i++) {
$shape = $shapes->get_Item($i);
if (!java_instanceof($shape, $audioFrameType)) {
continue;
}
$tracks = $shape->getCaptionTracks();
$trackCount = java_values($tracks->getCount());
for ($j = 0; $j < $trackCount; $j++) {
$track = $tracks->get_Item($j);
$fileName = $track->getCaptionId() . ".vtt";
$audioCaptions = $track->getBinaryData();
$output = new Java("java.io.FileOutputStream", $fileName);
try {
$output->write($audioCaptions);
} finally {
$output->close();
}
}
}
} finally {
$presentation->dispose();
}
Audio‑Untertitel entfernen
Verwenden Sie remove oder removeAt, um eine einzelne Spur zu löschen. Das Beispiel verwendet clear, um alle Untertitel vom ersten Audio‑Frame auf der ersten Folie zu entfernen, während der Clip erhalten bleibt.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("audio_with_captions.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioFrameType = new JavaClass("com.aspose.slides.AudioFrame");
$audioFrame = null;
$shapes = $slide->getShapes();
$shapeCount = java_values($shapes->size());
for ($i = 0; $i < $shapeCount; $i++) {
$shape = $shapes->get_Item($i);
if (java_instanceof($shape, $audioFrameType)) {
$audioFrame = $shape;
break;
}
}
if ($audioFrame !== null) {
$audioFrame->getCaptionTracks()->clear();
$presentation->save("audio_without_captions.pptx", SaveFormat::Pptx);
} else {
echo "The first slide has no audio frame.\n";
}
} finally {
$presentation->dispose();
}
Eine Zeile in Audio‑Untertiteln finden
Um eine Zeile in den Audio‑Untertiteln auf der ersten Folie zu finden, durchsuchen Sie den von getDataAsString zurückgegebenen Text im Speicher. In einem Klartext‑WebVTT‑Cue enthält die Zeitzeile -->, die Untertitelzeilen folgen darauf, und eine leere Zeile beendet den Cue. Dieses Beispiel gibt die Spurenbezeichnung und jede Untertitelzeile aus, die „café“ enthält.
use aspose\slides\Presentation;
$presentation = new Presentation("audio_with_captions.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$audioFrameType = new JavaClass("com.aspose.slides.AudioFrame");
$shapes = $slide->getShapes();
$shapeCount = java_values($shapes->size());
for ($i = 0; $i < $shapeCount; $i++) {
$shape = $shapes->get_Item($i);
if (!java_instanceof($shape, $audioFrameType)) {
continue;
}
$tracks = $shape->getCaptionTracks();
$trackCount = java_values($tracks->getCount());
for ($j = 0; $j < $trackCount; $j++) {
$track = $tracks->get_Item($j);
$inCue = false;
$captions = (string) $track->getDataAsString();
foreach (preg_split('/\R/u', $captions) as $line) {
if ($line === "") {
$inCue = false;
} elseif (strpos($line, "-->") !== false) {
$inCue = true;
} elseif ($inCue && preg_match('/café/iu', $line)) {
echo $track->getLabel() . ": " . $line . "\n";
}
}
}
}
} finally {
$presentation->dispose();
}
Audio extrahieren
Ein Folienübergang kann einen eigenen Sound haben. Um ihn abzurufen, rufen Sie getSound beim Folienübergang auf. Das Beispiel greift auf die von getBinaryData zurückgegebenen Bytes zu und gibt die Anzahl der Bytes aus. Hat die erste Folie keinen Übergangssound, wird stattdessen eine Meldung ausgegeben.
use aspose\slides\Presentation;
$presentation = new Presentation("AudioSlide.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$sound = $slide->getSlideShowTransition()->getSound();
if (java_is_null($sound)) {
echo "The first slide has no transition sound.\n";
} else {
$audioData = $sound->getBinaryData();
$array = new JavaClass("java.lang.reflect.Array");
echo "Transition sound: " . $array->getLength($audioData) . " bytes.\n";
}
} finally {
$presentation->dispose();
}
FAQ
Kann ich denselben Audio‑Clip auf mehreren Folien wiederverwenden, ohne ihn zu duplizieren?
Ja. Fügen Sie den Clip einmal zur audio collection der Präsentation hinzu und übergeben Sie dasselbe Audio‑Objekt bei jedem Aufruf von addAudioFrameEmbedded an die jeweilige Folie.
Kann ich den Sound in einem bestehenden Audio‑Frame ersetzen?
Ja. Für einen verknüpften Sound verwenden Sie setLinkPathLong, um auf die Ersatzdatei zu verweisen. Für einen eingebetteten Sound wählen Sie einen anderen Clip aus der Audio‑Sammlung der Präsentation mit setEmbeddedAudio. Beide Vorgehensweisen erhalten den bestehenden Frame.
Verändert das Trimmen die in der Präsentation gespeicherten Audiodaten?
Nein. setTrimFromStart und setTrimFromEnd setzen nur die Wiedergabegrenzen. Sie können den vollständigen Clip weiterhin über getEmbeddedAudio abrufen.