Audio keretek kezelése prezentációkban Java-val
Áttekintés
Az audio keret lehetővé teszi, hogy hangot játssz le egy dián. Az Aspose.Slides for Java-val beágyazhatsz egy audio klipet, kiválaszthatod a képét, amely azt ábrázolja, beállíthatod a lejátszást, és feliratokat csatolhatsz. A diákátmenethez rendelt hangot is lekérheted.
Audio keretek létrehozása
Használd a addAudioFrameEmbedded a helyi audio klip beágyazásához az első dián. Az első két koordináta helyezi el a keretet a dián, a következő két érték a szélességét és magasságát állítja be, mind pontban. Ez a példa meghívja a setPlayMode a klip automatikus indításához, és meghívja a setVolume a hangos előre beállított érték kiválasztásához.
import com.aspose.slides.*;
import java.io.FileInputStream;
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
try (FileInputStream audioStream = new FileInputStream("audio.wav")) {
IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, audioStream);
audioFrame.setPlayMode(AudioPlayModePreset.Auto);
audioFrame.setVolume(AudioVolumeMode.Loud);
presentation.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az audio keret bélyegképének módosítása
Alapértelmezés szerint egy audio keret egy hangszóró ikont jelenít meg. Egy egyéni bélyegkép megjelenítéséhez adj egy képet a prezentációhoz a addImage segítségével, és állítsd be a keret képként a setImage segítségével. A példa egy JPEG-et használ egy beágyazott audio klip bélyegképéhez.
import com.aspose.slides.*;
import java.io.FileInputStream;
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
try (FileInputStream audioStream = new FileInputStream("audio.wav");
FileInputStream imageStream = new FileInputStream("eagle.jpeg")) {
IPPImage thumbnail = presentation.getImages().addImage(imageStream);
IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
audioFrame.getPictureFormat().getPicture().setImage(thumbnail);
presentation.save("example_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az audio lejátszási beállítások módosítása
A PowerPoint Audio Options vezérlői meghatározzák, hogy mikor indul a klip, mennyire hangos, és hogyan viselkedik a diavetítés során.

| PowerPoint vezérlő | Aspose.Slides for Java metódus |
|---|---|
| Indítás | setPlayMode |
| Hangerő előbeállítása | setVolume |
| Lejátszás diákon át | setPlayAcrossSlides |
| Ismétlés leállításig | setPlayLoopMode |
| Elrejtés a vetítés alatt | setHideAtShowing |
| Visszatekerés lejátszás után | setRewindAudio |
| Beúsztatás | setFadeInDuration |
| Kifakadás | setFadeOutDuration |
| Audio vágás kezdési idő | setTrimFromStart |
| Audio vágás befejezési idő | setTrimFromEnd |
| Hangerő csúszka | setVolumeValue |
A példa megtalálja az első audio keretet az első dián, meghívja a setPlayMode a lejátszás indításához kattintásra, és kiválasztja az alacsony hangerő előbeállítást. A klip a diákon át folytatódik, a loopolás le van tiltva. Az ikon a vetítés során rejtve marad, és a klip lejátszás után visszatekeredik.
import com.aspose.slides.*;
Presentation presentation = new Presentation("AudioFrameEmbed_out.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAudioFrame audioFrame = null;
for (IShape shape : slide.getShapes()) {
if (shape instanceof IAudioFrame) {
audioFrame = (IAudioFrame) shape;
break;
}
}
if (audioFrame != null) {
audioFrame.setPlayMode(AudioPlayModePreset.OnClick);
audioFrame.setVolume(AudioVolumeMode.Low);
audioFrame.setPlayAcrossSlides(true);
audioFrame.setPlayLoopMode(false);
audioFrame.setHideAtShowing(true);
audioFrame.setRewindAudio(true);
presentation.save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
} else {
System.out.println("The first slide has no audio frame.");
}
} finally {
presentation.dispose();
}
Egy 3,5 másodpercnél hosszabb klip esetén ez a példa kihagyja az első 1,5 másodpercet és az utolsó 2 másodpercet. A setTrimFromEnd a klip végéről elhagyandó időt veszi. A PowerPointban látható befejezési időhez vonja le ezt az eltolást a teljes klip időtartamából. A vágott klip 200 ms alatt beúszik és 500 ms alatt kifakul. Mind a négy metódus értékeket ezredmásodpercben vár.
import com.aspose.slides.*;
import java.io.FileInputStream;
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
try (FileInputStream audioStream = new FileInputStream("audio.wav")) {
IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audioStream);
audioFrame.setTrimFromStart(1500f);
audioFrame.setTrimFromEnd(2000f);
audioFrame.setFadeInDuration(200f);
audioFrame.setFadeOutDuration(500f);
presentation.save("AudioFrameTrimFade_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A lejátszási hangerő egy adott százalékra állításához használd a setVolumeValue. Ez a példa az első audio keretet az első dián 85 %-ra állítja.
import com.aspose.slides.*;
Presentation presentation = new Presentation("AudioFrameEmbed_out.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAudioFrame audioFrame = null;
for (IShape shape : slide.getShapes()) {
if (shape instanceof IAudioFrame) {
audioFrame = (IAudioFrame) shape;
break;
}
}
if (audioFrame != null) {
audioFrame.setVolumeValue(85f);
presentation.save("AudioFrameValue_out.pptx", SaveFormat.Pptx);
} else {
System.out.println("The first slide has no audio frame.");
}
} finally {
presentation.dispose();
}
Audio feliratok kezelése
Minden audio keret hozzáférést biztosít a felirat sávjaihoz a getCaptionTracks segítségével. Használd a gyűjteményt WebVTT feliratok csatolásához a kliphez, meglévő sávok exportálásához vagy eltávolításához.
Audio feliratok hozzáadása
A példa egy audio klipet ágyaz be az első dián, és a add segítségével csatol egy helyi WebVTT sávot. Az első argumentum a sáv címkéjét adja meg, a második a feliratokat tartalmazó fájlt határozza meg.
import com.aspose.slides.*;
import java.io.FileInputStream;
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
try (FileInputStream audioStream = new FileInputStream("audio.wav")) {
IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(10, 10, 50, 50, audioStream);
audioFrame.getCaptionTracks().add("English", "track.vtt");
presentation.save("audio_with_captions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Audio feliratok kinyerése
Ez a példa exportálja az első dián lévő audio kerethez csatolt minden felirat sávot. A getBinaryData által visszaadott bájtokat egy WebVTT fájlba írja, és a getCaptionId által visszaadott azonosítót használja fájlnévként, hogy minden sáv külön fájlként kerüljön ki.
import com.aspose.slides.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (!(shape instanceof IAudioFrame)) {
continue;
}
IAudioFrame audioFrame = (IAudioFrame) shape;
for (ICaptions track : audioFrame.getCaptionTracks()) {
Path output = Paths.get(track.getCaptionId() + ".vtt");
Files.write(output, track.getBinaryData());
}
}
} finally {
presentation.dispose();
}
Audio feliratok eltávolítása
Használd a remove vagy removeAt metódust egy egyedi sáv törléséhez. A példa a clear segítségével eltávolítja az összes feliratot az első audio keretből az első dián, miközben megőrzi a klipet.
import com.aspose.slides.*;
Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAudioFrame audioFrame = null;
for (IShape shape : slide.getShapes()) {
if (shape instanceof IAudioFrame) {
audioFrame = (IAudioFrame) shape;
break;
}
}
if (audioFrame != null) {
audioFrame.getCaptionTracks().clear();
presentation.save("audio_without_captions.pptx", SaveFormat.Pptx);
} else {
System.out.println("The first slide has no audio frame.");
}
} finally {
presentation.dispose();
}
Sor keresése audio feliratokban
Az első dián lévő audio feliratokban egy sor megtalálásához keresd a getDataAsString által visszaadott szöveget a memóriában. Egy egyszerű szöveges WebVTT cue-ban az idővonal sort --> tartalmazza, a felirat sorok ezt követik, és egy üres sor zárja a cue-t. Ez a példa kiírja a sáv címkéjét és minden olyan feliratsort, amely „café” szót tartalmaz.
import com.aspose.slides.*;
import java.util.Locale;
Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (!(shape instanceof IAudioFrame)) {
continue;
}
IAudioFrame audioFrame = (IAudioFrame) shape;
for (ICaptions track : audioFrame.getCaptionTracks()) {
boolean inCue = false;
String captions = track.getDataAsString();
for (String line : captions.split("\\R")) {
if (line.isEmpty()) {
inCue = false;
} else if (line.contains("-->")) {
inCue = true;
} else if (inCue && line.toLowerCase(Locale.ROOT).contains("café")) {
System.out.println(track.getLabel() + ": " + line);
}
}
}
}
} finally {
presentation.dispose();
}
Audio kinyerése
Egy diákátmenetnek saját hangja lehet. A lekéréshez hívd a getSound metódust a diákátmeneten. A példa a getBinaryData által visszaadott bájtokat használja, és kiírja a bájtok számát. Ha az első diáknak nincs átmeneti hangja, akkor egy üzenetet ír ki.
import com.aspose.slides.*;
Presentation presentation = new Presentation("AudioSlide.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAudio sound = slide.getSlideShowTransition().getSound();
if (sound != null) {
byte[] audioData = sound.getBinaryData();
System.out.println("Transition sound: " + audioData.length + " bytes.");
} else {
System.out.println("The first slide has no transition sound.");
}
} finally {
presentation.dispose();
}
GYIK
Újra felhasználhatom ugyanazt az audio klipet több dián anélkül, hogy megdupláznám?
Igen. A klipet egyszer add hozzá a prezentáció audio collection gyűjteményéhez, és minden diához a addAudioFrameEmbedded ugyanazt az audio objektumot adod át.
Lecserélhetem egy meglévő audio keret hangját?
Igen. A hivatkozott hang esetén használd a setLinkPathLong metódust az új fájlra mutatáshoz. Beágyazott hang esetén válassz egy másik klipet a prezentáció audio gyűjteményéből a setEmbeddedAudio segítségével. Mindkét módszer megőrzi a meglévő keretet.
A vágás módosítja a prezentációban tárolt audio adatot?
Nem. A setTrimFromStart és a setTrimFromEnd a lejátszási határokat állítja be. A teljes klip továbbra is lekérhető a getEmbeddedAudio segítségével.