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

创建音频帧

Aspose.Slides for Node.js via Java 允许您将音频文件添加到幻灯片中。音频文件作为音频帧嵌入在幻灯片中。

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

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

// 实例化一个表示演示文稿文件的 Presentation 类
const pres = new aspose.slides.Presentation();
try {
    // 获取第一张幻灯片
    const sld = pres.getSlides().get_Item(0);
    // 加载 wav 音频文件到流
    const fstr = java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "audio.wav"));
    // 添加音频帧
    const audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    // 设置音频的播放模式和音量
    audioFrame.setPlayMode(aspose.slides.AudioPlayModePreset.Auto);
    audioFrame.setVolume(aspose.slides.AudioVolumeMode.Loud);
    // 将 PowerPoint 文件写入磁盘
    pres.save("AudioFrameEmbed_out.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

更改音频帧缩略图

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

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

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    // 向幻灯片添加音频帧，并指定位置和大小。
    const audioStream = java.newInstanceSync("java.io.FileInputStream", "sample2.mp3");
    const audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();
    // 向演示文稿资源添加图像。
    let picture;
    const image = aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

更改音频播放选项

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

Microsoft PowerPoint 中的 Audio Options 面板：

example1_image

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 controll 对应 AudioFrame.setVolumeValue 方法。它允许您以百分比方式更改音频音量。

以下是更改 Audio Play 选项的方法：

创建或获取 Audio Frame。
为要调整的 Audio Frame 属性设置新值。
保存修改后的 PowerPoint 文件。

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

const pres = new aspose.slides.Presentation("AudioFrameEmbed_out.pptx");
try {
    // 获取 AudioFrame 形状
    const audioFrame = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    // 将播放模式设置为单击播放
    audioFrame.setPlayMode(aspose.slides.AudioPlayModePreset.OnClick);
    // 将音量设置为低
    audioFrame.setVolume(aspose.slides.AudioVolumeMode.Low);
    // 将音频设置为跨幻灯片播放
    audioFrame.setPlayAcrossSlides(true);
    // 禁用音频循环
    audioFrame.setPlayLoopMode(false);
    // 在幻灯片放映期间隐藏 AudioFrame
    audioFrame.setHideAtShowing(true);
    // 在播放后将音频倒回到起始位置
    audioFrame.setRewindAudio(true);
    // 将 PowerPoint 文件保存到磁盘
    pres.save("AudioFrameEmbed_changed.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

下面的 JavaScript 示例展示了如何添加带嵌入音频的新音频帧、剪辑它并设置淡入淡出持续时间：

const pres = new aspose.slides.Presentation();
try {
    const slide = pres.getSlides().get_Item(0);
    
    const audioData = java.newArray("byte", Array.from(fs.readFileSync("sampleaudio.mp3")));
    const audio = pres.getAudios().addAudio(audioData);
    const audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audio);

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

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

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

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

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

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

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

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

管理音频字幕

Aspose.Slides 允许您通过 getCaptionTracks 方法向音频帧添加闭合字幕。该方法返回一个 CaptionsCollection，您可以使用它添加 WebVTT 字幕轨道、遍历现有轨道，并在必要时将其删除。

添加音频字幕

使用 getCaptionTracks 方法将一个或多个字幕轨道附加到音频帧。在下面的示例中，首先向幻灯片添加音频文件，然后从 .vtt 文件加载新的字幕轨道。

let presentation = new aspose.slides.Presentation();
try {
    let audioStream = java.newInstanceSync("java.io.FileInputStream", "audio.mp3");
    let audio = presentation.getAudios().addAudio(audioStream);
    audioStream.close();

    let slide = presentation.getSlides().get_Item(0);
    let audioFrame = slide.getShapes().addAudioFrameEmbedded(10, 10, 50, 50, audio);

    // 从 WebVTT 文件中添加新的字幕轨道。
    audioFrame.getCaptionTracks().add("New track", "track.vtt");

    presentation.save("audio_with_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

提取音频字幕

您可以遍历与音频帧关联的字幕轨道并将其保存为 .vtt 文件。每个字幕轨道都公开其二进制数据和唯一标识符，可在导出字幕时使用。

let presentation = new aspose.slides.Presentation("audio_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let shapeCount = slide.getShapes().size();
    for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
        let shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.AudioFrame")) {
            let audioFrame = shape;
            let trackCount = audioFrame.getCaptionTracks().getCount();
            for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
                let captionTrack = audioFrame.getCaptionTracks().get_Item(trackIndex);
                // 将字幕轨道保存为 .vtt 文件。
                let filePath = captionTrack.getCaptionId() + ".vtt";
                let captionData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(filePath, captionData);
            }
        }
    }
} finally {
    presentation.dispose();
}

删除音频字幕

要从音频帧中删除字幕，请使用 CaptionsCollection 提供的方法，例如 clear、remove 或 removeAt。下面的示例删除了音频帧中的所有字幕轨道。

let presentation = new aspose.slides.Presentation("audio_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let audioFrame = slide.getShapes().get_Item(0); // 类型: aspose.slides.AudioFrame

    // 从音频帧中删除所有字幕轨道。
    audioFrame.getCaptionTracks().clear();

    presentation.save("audio_without_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

提取音频

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

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

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

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

常见问题

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

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

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

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

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

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

演示文稿查看器