在 Android 上管理演示文稿中的音频

创建音频帧

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

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
加载您想要嵌入到幻灯片中的音频文件流。
将嵌入的音频帧（包含音频文件）添加到幻灯片中。
设置由 IAudioFrame 对象公开的 PlayMode 和 Volume。
保存修改后的演示文稿。

// 实例化一个表示演示文稿文件的 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 Android via Java 允许您更改控制音频播放或属性的选项。例如，您可以调整音频音量、设置音频循环播放，甚至隐藏音频图标。

The Audio Options pane in Microsoft PowerPoint:

example1_image

PowerPoint Audio Options that correspond to Aspose.Slides AudioFrame properties:

Start 下拉列表对应 AudioFrame.PlayMode 属性
Volume 对应 AudioFrame.Volume 属性
Play Across Slides 对应 AudioFrame.PlayAcrossSlides 属性
Loop until Stopped 对应 AudioFrame.PlayLoopMode 属性
Hide During Show 对应 AudioFrame.HideAtShowing 属性
Rewind after Playing 对应 AudioFrame.RewindAudio 属性

PowerPoint Editing options that correspond to Aspose.Slides AudioFrame properties:

Fade In 对应 AudioFrame.FadeInDuration 属性
Fade Out 对应 AudioFrame.FadeOutDuration 属性
Trim Audio Start Time 对应 AudioFrame.TrimFromStart 属性
Trim Audio End Time 的值等于音频时长减去 AudioFrame.TrimFromEnd 属性的值

PowerPoint Volume controll 在音频控制面板上对应 AudioFrame.VolumeValue 属性。它允许您以百分比的方式更改音频音量。

以下是更改音频播放选项的方法：

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

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);
    
    FileInputStream audioData = new FileInputStream("sampleaudio.mp3");
    IAudio audio = pres.getAudios().addAudio(audioData, LoadingStreamBehavior.KeepLocked);
    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 Android via Java 允许您提取幻灯片放映过渡中使用的声音。例如，您可以提取特定幻灯片使用的声音。

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

此 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 中的其他音频。帧的格式及大多数播放设置保持不变。

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

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