使用 Java 管理演示文稿中的音频

创建音频帧

Aspose.Slides for Java 允许您向幻灯片添加音频文件。音频文件以音频帧的形式嵌入幻灯片中。

1. 创建 Presentation 类的实例。
2. 通过索引获取幻灯片的引用。
3. 加载要嵌入幻灯片的音频文件流。
4. 将包含音频文件的嵌入音频帧添加到幻灯片。
5. 设置由 IAudioFrame 对象公开的 PlayMode 和 Volume。
6. 保存修改后的演示文稿。

下面的 Java 代码展示了如何向幻灯片添加嵌入式音频帧：

// 实例化一个表示演示文稿文件的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 将 wav 声音文件加载到流中
    FileInputStream fstr = new FileInputStream(new File("audio.wav"));

    // 添加音频帧
    IAudioFrame audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    
    // 设置音频的播放模式和音量
    audioFrame.setPlayMode(AudioPlayModePreset.Auto);
    audioFrame.setVolume(AudioVolumeMode.Loud);

    // 将 PowerPoint 文件写入磁盘
    pres.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

更改音频帧缩略图

将音频文件添加到演示文稿时，音频会以带有标准默认图片的帧形式出现（见下方图片）。您可以更改音频帧的预览图像（设置您喜欢的图片）。

下面的 Java 代码展示了如何更改音频帧的缩略图或预览图像：

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // 添加音频帧到幻灯片，指定位置和大小。
    FileInputStream audioStream = new FileInputStream("sample2.mp3");
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();

    // 将图像添加到演示文稿资源中。
    IPPImage picture;
    IImage image = Images.fromFile("eagle.jpeg");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // 为音频帧设置图像。
    audioFrame.getPictureFormat().getPicture().setImage(picture); // <-----
    //保存修改后的演示文稿到磁盘
    presentation.save("example_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

更改音频播放选项

Aspose.Slides for Java 允许您更改控制音频播放的选项或属性。例如，您可以调节音频音量、设置音频循环播放，甚至隐藏音频图标。

Microsoft PowerPoint 中的 Audio Options 面板：

PowerPoint Audio Options 对应 Aspose.Slides AudioFrame 属性：

• Start 下拉列表对应 AudioFrame.setPlayMode 方法
• Volume 对应 AudioFrame.setVolume 方法
• Play Across Slides 对应 AudioFrame.setPlayAcrossSlides 方法
• Loop until Stopped 对应 AudioFrame.setPlayLoopMode 方法
• Hide During Show 对应 AudioFrame.setHideAtShowing 方法
• Rewind after Playing 对应 AudioFrame.setRewindAudio 方法

PowerPoint Editing 选项对应 Aspose.Slides AudioFrame 属性：

• Fade In 对应 AudioFrame.setFadeInDuration 方法
• Fade Out 对应 AudioFrame.setFadeOutDuration 方法
• Trim Audio Start Time 对应 AudioFrame.setTrimFromStart 方法
• Trim Audio End Time 的数值等于音频时长减去 AudioFrame.setTrimFromEnd 方法的值

PowerPoint 音频控制面板上的 Volume 控件 对应 AudioFrame.setVolumeValue 方法，可按百分比更改音频音量。

更改音频播放选项的步骤：

1. Сreate 或获取音频帧。
2. 为需要调整的音频帧属性设置新值。
3. 保存修改后的 PowerPoint 文件。

下面的 Java 代码演示了调整音频选项的操作：

Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    // 获取 AudioFrame 形状
    AudioFrame audioFrame = (AudioFrame)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    // 将播放模式设置为点击时播放
    audioFrame.setPlayMode(AudioPlayModePreset.OnClick);

    // 将音量设置为低
    audioFrame.setVolume(AudioVolumeMode.Low);

    // 设置音频跨幻灯片播放
    audioFrame.setPlayAcrossSlides(true);

    // 禁用音频循环
    audioFrame.setPlayLoopMode(false);

    // 幻灯片放映期间隐藏 AudioFrame
    audioFrame.setHideAtShowing(true);

    // 播放后将音频倒回起始位置
    audioFrame.setRewindAudio(true);

    // 将 PowerPoint 文件保存到磁盘
    pres.save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

下面的 Java 示例展示了如何添加一个带嵌入音频的新音频帧、剪裁它并设置淡入淡出时长：

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    
    byte[] audioData = Files.readAllBytes(Paths.get("sampleaudio.mp3"));
    IAudio audio = pres.getAudios().addAudio(audioData);
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audio);

    // 将裁剪起始偏移设置为 1.5 秒
    audioFrame.setTrimFromStart(1500f);
    // 将裁剪结束偏移设置为 2 秒
    audioFrame.setTrimFromEnd(2000f);

    // 将淡入持续时间设置为 200 毫秒
    audioFrame.setFadeInDuration(200f);
    // 将淡出持续时间设置为 500 毫秒
    audioFrame.setFadeOutDuration(500f);

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

下面的代码示例展示了如何检索带嵌入音频的音频帧并将其音量设置为 85%：

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

    // 获取音频帧形状
    IAudioFrame audioFrame = (IAudioFrame)slide.getShapes().get_Item(0);

    // 将音频音量设置为 85%
    audioFrame.setVolumeValue(85f);

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

提取音频

Aspose.Slides for Java 允许您提取幻灯片放映转换中使用的声音。例如，您可以提取特定幻灯片使用的声音。

1. 创建 Presentation 类的实例并加载包含音频的演示文稿。
2. 通过索引获取相关幻灯片的引用。
3. 访问该幻灯片的 slideshow transitions。
4. 提取声音的字节数据。

下面的 Java 代码展示了如何提取幻灯片中使用的音频：

// 实例化一个表示演示文稿文件的 Presentation 类
Presentation pres = new Presentation("AudioSlide.pptx");
try {
    // 访问所需的幻灯片
    ISlide slide = pres.getSlides().get_Item(0);
    
    // 获取幻灯片的幻灯片放映过渡效果
    ISlideShowTransition transition = slide.getSlideShowTransition();
    
    //提取声音为字节数组
    byte[] audio = transition.getSound().getBinaryData();
    System.out.println("Length: " + audio.length);
} finally {
    if (pres != null) pres.dispose();
}

常见问题

我可以在多个幻灯片之间复用同一个音频资源而不会增大文件大小吗？

可以。将音频一次性添加到演示文稿的共享 audio collection 中，然后创建引用该已有资源的其他音频帧。这样可避免复制媒体数据，保持演示文稿体积可控。

我能在不重新创建形状的情况下替换现有音频帧中的声音吗？

可以。对于链接的声音，更新 link path 以指向新文件。对于嵌入的声音，将 embedded audio 对象替换为演示文稿的 audio collection 中的另一个对象。帧的格式和大多数播放设置保持不变。

裁剪会改变演示文稿中存储的底层音频数据吗？

不会。裁剪仅调整播放边界。原始音频字节保持不变，仍可通过嵌入的音频或演示文稿的音频集合访问。