使用 JavaScript 在演示文稿中管理视频帧

本页内容简介

学习使用 Aspose.Slides for Node.js（通过 Java）在 PowerPoint 和 OpenDocument 幻灯片中以编程方式添加和提取视频帧。快速使用指南。

介绍

在演示文稿中恰当地放置视频可以使您的信息更具说服力，并提升观众的参与度。

PowerPoint 允许您以两种方式向演示文稿的幻灯片添加视频：

添加或嵌入本地视频（存储在您的计算机上）
添加在线视频（来自诸如 YouTube 的网页来源）。

为了让您向演示文稿添加视频（video 对象），Aspose.Slides 提供了 Video 类、VideoFrame 类以及其他相关类型。

创建嵌入式视频帧

如果您要添加到幻灯片的视频文件存储在本地，则可以创建视频帧将视频嵌入到演示文稿中。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
添加一个 Video 对象，并传入视频文件路径以将视频嵌入演示文稿中。
添加一个 VideoFrame 对象来为视频创建帧。
保存修改后的演示文稿。

// 实例化 Presentation 类
var pres = new aspose.slides.Presentation("pres.pptx");
try {
    // 加载视频
    var fileStream = java.newInstanceSync("java.io.FileInputStream", "Wildlife.mp4");
    var video = pres.getVideos().addVideo(fileStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
    // 获取第一张幻灯片并添加视频帧
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);
    // 将演示文稿保存到磁盘
    pres.save("pres-with-video.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

或者，您可以直接将文件路径传递给 addVideoFrame(float x, float y, float width, float height, IVideo video) 方法来添加视频：

var pres = new aspose.slides.Presentation();
try {
    var sld = pres.getSlides().get_Item(0);
    var vf = sld.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi");
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

使用来自网络来源的视频创建视频帧

Microsoft PowerPoint 2013 及更高版本支持在演示文稿中使用 YouTube 视频。如果您要使用的视频可在线获取（例如在 YouTube 上），可以通过其网页链接将其添加到演示文稿中。

创建一个 Presentation 类的实例
通过索引获取幻灯片的引用。
添加一个 Video 对象，并传入视频的链接。
为视频帧设置缩略图。
保存演示文稿。

// 实例化一个表示演示文稿文件的 Presentation 对象
var pres = new aspose.slides.Presentation();
try {
    addVideoFromYouTube(pres, "Tj75Arhq5ho");
    pres.save("out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

async function addVideoFromYouTube(pres, videoID) {
    let slide = pres.getSlides().get_Item(0);
    let videoUrl = "https://www.youtube.com/embed/" + videoID;
    let videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
    
    videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);

    let thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";

    try {
        const imageStream = await getImageStream(thumbnailUri);
        let image = pres.getImages().addImage(imageStream);
        videoFrame.getPictureFormat().getPicture().setImage(image);
    } catch (error) {
        console.error("Error loading thumbnail:", error);
    }
}

async function getImageStream(url) {
    return new Promise((resolve, reject) => {
        http.get(url, (response) => {
            if (response.statusCode === 200) {
                resolve(response);
            } else {
                reject(new Error(`Failed to load image: ${response.statusCode}`));
            }
        }).on('error', (e) => {
            reject(e);
        });
    });
}

裁剪视频帧

Aspose.Slides 允许您通过 VideoFrame.setTrimFromStart 和 VideoFrame.setTrimFromEnd 设置 trim-from-start 和 trim-from-end 值，以控制播放视频的哪一部分。这两个值以毫秒为单位，分别定义从视频开头和结尾跳过的时间长度。这些设置会更改演示文稿中的视频播放设置，但不会裁剪或以其他方式修改嵌入的视频二进制数据。

设置裁剪参数

要创建视频帧并设置其裁剪参数，请执行以下操作：

创建一个 Presentation 类的实例。
向演示文稿添加一个 Video 对象。
向幻灯片添加一个 VideoFrame 对象。
通过 VideoFrame.setTrimFromStart 和 VideoFrame.setTrimFromEnd 设置 trim-from-start 和 trim-from-end 值。
保存修改后的演示文稿。

const presentation = new aspose.slides.Presentation();
try {
    const videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    try {
        const video = presentation.getVideos().addVideo(
            videoStream, aspose.slides.LoadingStreamBehavior.ReadStreamAndRelease);
        const slide = presentation.getSlides().get_Item(0);
        const videoFrame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video);

        videoFrame.setTrimFromStart(2500);
        videoFrame.setTrimFromEnd(1000);

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

读取裁剪参数

要检查现有的裁剪参数，加载演示文稿，在第一张幻灯片的形状中找到 VideoFrame 对象，并通过 VideoFrame.getTrimFromStart 和 VideoFrame.getTrimFromEnd 读取相应的值。

下面的代码示例会查找第一张幻灯片上的第一个视频帧，并以毫秒为单位报告其裁剪参数：

const presentation = new aspose.slides.Presentation("video_with_trim.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const shapeCount = slide.getShapes().size();
    for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            const trimFromStart = videoFrame.getTrimFromStart();
            const trimFromEnd = videoFrame.getTrimFromEnd();

            console.log("Trim from start: " + trimFromStart + " ms");
            console.log("Trim from end: " + trimFromEnd + " ms");
            break;
        }
    }
} finally {
    presentation.dispose();
}

管理视频字幕

Aspose.Slides 允许您在 PowerPoint 演示文稿中管理视频帧的闭合字幕。字幕以 WebVTT 格式存储，并可通过 VideoFrame.getCaptionTracks 方法获取。

向视频帧添加字幕

向视频帧添加字幕的步骤如下：

创建一个 Presentation 类的实例。
向演示文稿添加视频。
向幻灯片添加一个 VideoFrame 对象。
使用 CaptionsCollection 集合添加 WebVTT 字幕轨道。
保存修改后的演示文稿。

下面的代码演示了如何向视频帧添加字幕：

let presentation = new aspose.slides.Presentation();
try {
    let videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    let video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);

    let slide = presentation.getSlides().get_Item(0);
    let videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);

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

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

CaptionsCollection 类还提供了 addFromStream 方法，允许您从流中添加字幕。

从视频帧提取字幕

从视频帧提取字幕的步骤如下：

加载包含该视频的演示文稿。
找到目标 VideoFrame 对象。
遍历 CaptionsCollection 集合。
将每个字幕轨道保存为 .vtt 文件。

下面的代码演示了如何从视频帧提取字幕：

let presentation = new aspose.slides.Presentation("video_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.VideoFrame")) {
            let videoFrame = shape;
            let trackCount = videoFrame.getCaptionTracks().getCount();
            for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
                let captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
                // 将字幕轨道保存为 WebVTT 文件。
                let filePath = captionTrack.getCaptionId() + ".vtt";
                let captionData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(filePath, captionData);
            }
        }
    }
} finally {
    presentation.dispose();
}

每个 Captions 对象都会公开字幕标识符、标签、二进制数据以及以 UTF-8 字符串形式的字幕文本。

从视频帧中移除字幕

从视频帧中移除字幕的步骤如下：

加载包含该视频的演示文稿。
获取目标 VideoFrame 对象。
从 CaptionsCollection 集合中移除字幕轨道。
保存修改后的演示文稿。

下面的代码演示了如何从视频帧中移除所有字幕：

let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let videoFrame = slide.getShapes().get_Item(0); // 类型: com.aspose.slides.VideoFrame

    // 删除视频帧中的所有字幕。
    videoFrame.getCaptionTracks().clear();

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

如果只需要移除单个字幕轨道，请使用 remove 或 removeAt 方法，而不是 clear。

从幻灯片提取视频

除了向幻灯片添加视频之外，Aspose.Slides 还允许您提取嵌入在演示文稿中的视频。

创建一个 Presentation 类的实例，以加载包含视频的演示文稿。
遍历所有 Slide 对象。
遍历所有 Shape 对象以查找 VideoFrame。
将视频保存到磁盘。

// 实例化一个表示演示文稿文件的 Presentation 对象
var pres = new aspose.slides.Presentation("VideoSample.pptx");
try {
    for (let i = 0; i < pres.getSlides().size(); i++) {
        let slide = pres.getSlides().get_Item(i);
        for (let j = 0; j < slide.getShapes().size(); j++) {
            let shape = slide.getShapes().get_Item(j);
            if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
                var vf = shape;
                console.log(shape);
                var type = vf.getEmbeddedVideo().getContentType();
                var ss = type.lastIndexOf('-');
                const buffer = Buffer.from(vf.getEmbeddedVideo().getBinaryData());
                console.log(buffer);
                // 获取文件扩展名
                var charIndex = type.indexOf("/");
                type = type.substring(charIndex + 1);
                fs.writeFileSync("testing2." + type, buffer);
            }
        }
    }
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

常见问题

可以更改 VideoFrame 的哪些视频播放参数？

您可以通过 playback mode（自动或点击）和 looping 来控制播放模式。这些选项可通过 VideoFrame 对象的属性进行设置。

添加视频会影响 PPTX 文件大小吗？

会的。当您嵌入本地视频时，视频的二进制数据会被写入文档，导致演示文稿的大小按视频文件大小成比例增长。添加在线视频时，仅嵌入链接和缩略图，大小增长较小。

我可以在不更改位置和大小的情况下替换现有 VideoFrame 中的视频吗？

可以。您可以在保留形状几何的前提下更换帧内的 video content；这在现有布局中更新媒体时很常见。

可以确定嵌入视频的内容类型（MIME）吗？

可以。嵌入的视频具有可读取的 content type，您可以在保存到磁盘等场景中使用它。

演示文稿查看器