使用 Java 管理演示文稿中的音频帧
概述
音频帧允许您在幻灯片上播放声音。使用 Aspose.Slides for Java,您可以嵌入音频剪辑,选择表示它的图像,调整播放,并附加字幕。您还可以检索分配给幻灯片切换的声音。
创建音频帧
使用 addAudioFrameEmbedded 在第一张幻灯片上嵌入本地音频剪辑。前两个坐标定位帧在幻灯片上的位置,后两个值设置其宽度和高度,单位为点。此示例调用 setPlayMode 自动启动剪辑,并调用 setVolume 选择响亮预设。
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();
}
更改音频帧缩略图
默认情况下,音频帧显示扬声器图标。要显示自定义缩略图,请使用 addImage 将图像添加到演示文稿中,并使用 setImage 将其设置为帧的图片。示例使用 JPEG 作为嵌入音频剪辑的缩略图。
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();
}
更改音频播放选项
PowerPoint 的 Audio Options 控件决定剪辑何时开始、音量大小以及在幻灯片放映期间的行为。

| PowerPoint 控件 | Aspose.Slides for Java 方法 |
|---|---|
| 开始 | setPlayMode |
| 音量预设 | setVolume |
| 跨幻灯片播放 | setPlayAcrossSlides |
| 循环直到停止 | setPlayLoopMode |
| 放映期间隐藏 | setHideAtShowing |
| 播放后倒带 | setRewindAudio |
| 淡入 | setFadeInDuration |
| 淡出 | setFadeOutDuration |
| 修剪音频开始时间 | setTrimFromStart |
| 修剪音频结束时间 | setTrimFromEnd |
| 音量滑块 | setVolumeValue |
示例查找第一张幻灯片上的第一个音频帧,调用 setPlayMode 在点击时开始播放,并选择低音量预设。剪辑在跨幻灯片播放时循环被禁用。图标在放映期间保持隐藏,剪辑在播放后倒带。
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();
}
对于时长超过 3.5 秒的剪辑,此示例跳过前 1.5 秒和后 2 秒。setTrimFromEnd 接受要从剪辑末尾省略的时长。要获取 PowerPoint 中显示的结束时间,需要用完整剪辑时长减去该偏移。修剪后的剪辑在 200 毫秒内淡入,在 500 毫秒内淡出。这四个方法的值均以毫秒为单位。
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();
}
要将播放音量设置为特定百分比,请使用 setVolumeValue。此示例将第一张幻灯片上的第一个音频帧音量设置为 85%。
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();
}
管理音频字幕
每个音频帧通过 getCaptionTracks 提供对其字幕轨道的访问。使用该集合可将 WebVTT 字幕附加到剪辑,导出现有轨道,或将其删除。
添加音频字幕
示例在第一张幻灯片上嵌入音频剪辑,并使用 add 附加本地 WebVTT 轨道。第一个参数提供轨道标签,第二个参数标识包含时间字幕的文件。
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();
}
提取音频字幕
此示例导出附加在第一张幻灯片上音频帧的每个字幕轨道。它将 getBinaryData 返回的字节写入 WebVTT 文件,并使用 getCaptionId 返回的标识符作为文件名,以便每个轨道都有单独的输出。
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();
}
删除音频字幕
使用 remove 或 removeAt 删除单个轨道。示例使用 clear 删除第一张幻灯片上第一个音频帧的所有字幕,同时保留剪辑。
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();
}
在音频字幕中查找行
要在第一张幻灯片的音频字幕中查找行,请在内存中搜索 getDataAsString 返回的文本。在纯文本 WebVTT 提示中,时间行包含 -->,其后是字幕行,空行结束提示。此示例打印轨道标签以及包含 “café” 的每行字幕。
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();
}
提取音频
幻灯片切换可以拥有自己的声音。要检索它,请在幻灯片切换上调用 getSound。示例访问 getBinaryData 返回的字节并打印字节数。如果第一张幻灯片没有切换声音,则打印一条消息。
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();
}
常见问题
我可以在多张幻灯片之间复用相同的音频剪辑而不进行复制吗?
可以。将剪辑一次添加到演示文稿的 audio collection 中,然后在每张幻灯片上将相同的音频对象传递给 addAudioFrameEmbedded。
我可以替换现有音频帧中的声音吗?
可以。对于链接的声音,使用 setLinkPathLong 指向替换文件。对于嵌入的声音,使用 setEmbeddedAudio 从演示文稿的音频集合中选择另一个剪辑。这两种方法都保留了现有帧。
修剪会更改存储在演示文稿中的音频数据吗?
不会。setTrimFromStart 和 setTrimFromEnd 只设置播放边界。您仍然可以通过 getEmbeddedAudio 获取完整剪辑。