使用 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 Audio Options controls for an audio frame

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 获取完整剪辑。