使用 Node.js 管理演示文稿中的视频帧

介绍

视频可以帮助解释概念并吸引观众。Aspose.Slides for Node.js via Java 让您能够向幻灯片添加视频帧、调整播放设置、管理字幕,并提取嵌入的视频数据。

PowerPoint 支持本地视频和指向在线视频的链接,例如 YouTube 视频。

为了表示视频数据和视频帧,Aspose.Slides 提供了 Video 类、VideoFrame 类以及其他相关类型。

创建嵌入式视频帧

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

此示例将本地视频嵌入现有演示文稿的第一张幻灯片并保存结果。帧坐标和尺寸使用点(points)为单位。由于 LoadingStreamBehavior.KeepLocked 在演示文稿使用流期间保持其锁定,流会保持打开状态直至保存完成。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    try {
        const slide = presentation.getSlides().get_Item(0);

        const video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
        slide.getShapes().addVideoFrame(10, 10, 150, 250, video);

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

您也可以直接将本地视频路径传递给 addVideoFrame。此示例将在新演示文稿的第一张幻灯片上嵌入视频。视频必须保持可访问,直至演示文稿保存完成。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    slide.getShapes().addVideoFrame(50, 150, 300, 150, "video.avi");

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

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

Microsoft PowerPoint 支持在演示文稿中使用在线视频。您可以创建一个链接到在线视频(例如 YouTube 视频)的视频帧。

此示例向第一张幻灯片添加 YouTube 视频链接和缩略图。将视频标识符替换为其他视频即可使用其他视频。setPlayMode 方法请求自动播放。下载缩略图和播放视频都需要互联网访问。演示文稿查看器还必须支持在线视频播放。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const videoId = "aqz-KE-bpKQ";
    const videoUrl = "https://www.youtube.com/embed/" + videoId;
    const videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
    videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);

    const thumbnailUrl = "https://img.youtube.com/vi/" + videoId + "/hqdefault.jpg";
    const thumbnailLocation = java.newInstanceSync("java.net.URL", thumbnailUrl);
    const thumbnailStream = thumbnailLocation.openStream();
    try {
        const thumbnail = presentation.getImages().addImage(thumbnailStream);
        videoFrame.getPictureFormat().getPicture().setImage(thumbnail);
    } finally {
        thumbnailStream.close();
    }

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

全屏播放视频

在培训演示中,您可以全屏播放软件演示,使观众能够看到细节。调用 setFullScreenMode 并传入 true 可在播放期间启用此行为。

此示例打开演示文稿,查找第一张幻灯片上的第一个 VideoFrame,并启用全屏播放。输入的演示文稿必须至少包含一张幻灯片,并在第一张幻灯片上已有视频帧。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

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

    for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            videoFrame.setFullScreenMode(true);
            break;
        }
    }

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

全屏播放决定视频的显示方式。独立地,setPlayMode 控制是自动播放还是点击播放,setPlayLoopMode 控制是否循环。要选择开始行为,请将播放模式设置为 VideoPlayModePreset.Auto or VideoPlayModePreset.OnClick。示例会保留现有的开始和循环设置。

播放结束后倒回视频

在培训演示中,将演示视频倒回到起点可以让演讲者再次播放。调用 setRewindVideo 并传入 true 可在播放结束后将视频倒回到起点。

此示例打开演示文稿,查找第一张幻灯片上的第一个 VideoFrame,并启用倒回。它会关闭循环以便播放能够完成,并将播放模式设置为点击启动。输入的演示文稿必须至少包含一张幻灯片,并在第一张幻灯片上已有视频帧。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

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

    for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            videoFrame.setRewindVideo(true);
            videoFrame.setPlayLoopMode(false);
            videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.OnClick);
            break;
        }
    }

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

倒回视频会将其返回到开头而不重新启动。相比之下,调用 setPlayLoopMode 并传入 true 会自动循环播放。希望视频播放结束并保持可重新播放时,请保持循环关闭。setPlayMode 独立控制自动或点击启动;本示例使用 VideoPlayModePreset.OnClick 以便演讲者自行决定何时开始播放。请在设置循环后再设置播放模式,如示例所示。倒回功能与 setFullScreenMode 相互独立。

修剪视频帧

使用 VideoFrame.setTrimFromStart 和 VideoFrame.setTrimFromEnd 可在播放期间跳过视频开头或结尾的部分。两个数值均以毫秒为单位。修剪会更改播放设置,但不修改嵌入的视频数据。

设置修剪参数

此示例嵌入本地视频并在播放时跳过前 2.5 秒和最后 1 秒。请使用时长大于 3.5 秒的视频,以确保剩余可播放片段。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const videoBuffer = fs.readFileSync("video.mp4");
    const videoData = java.newArray("byte", Array.from(videoBuffer));
    const video = presentation.getVideos().addVideo(videoData);

    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 {
    presentation.dispose();
}

读取修剪参数

此示例以毫秒为单位打印第一张幻灯片上第一个视频帧的修剪值。演示文稿必须至少包含一张幻灯片。如果该幻灯片没有视频帧,则不会输出任何内容。前面的示例会产生 2500 和 1000 的值。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

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

    for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            console.log("Trim from start: " + videoFrame.getTrimFromStart() + " ms");
            console.log("Trim from end: " + videoFrame.getTrimFromEnd() + " ms");
            break;
        }
    }
} finally {
    presentation.dispose();
}

管理视频字幕

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

向视频帧添加字幕

此示例嵌入本地视频并添加标记为 English 的 WebVTT 字幕轨道。字幕时间戳应与视频匹配。保存的演示文稿将同时包含视频及其字幕。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const videoBuffer = fs.readFileSync("video.mp4");
    const videoData = java.newArray("byte", Array.from(videoBuffer));
    const video = presentation.getVideos().addVideo(videoData);

    const videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);
    videoFrame.getCaptionTracks().add("English", "track.vtt");

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

CaptionsCollection 类还提供了 addFromStream 方法,可从流中添加字幕。

从视频帧提取字幕

此示例将第一张幻灯片上所有视频帧的字幕轨道保存为单独的 WebVTT 文件。顺序编号确保输出文件互不冲突。控制台会报告提取的轨道数量。演示文稿必须至少包含一张幻灯片。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");

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

    let trackCount = 0;
    for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            const videoFrame = shape;
            for (let trackIndex = 0; trackIndex < videoFrame.getCaptionTracks().getCount(); trackIndex++) {
                const captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
                trackCount++;
                const outputPath = "captions_" + trackCount + ".vtt";
                const outputData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(outputPath, outputData);
            }
        }
    }

    console.log("Caption tracks extracted: " + trackCount);
} finally {
    presentation.dispose();
}

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

从视频帧删除字幕

此示例删除第一张幻灯片上第一个形状位置的视频帧中的所有字幕并保存结果。它假设幻灯片和形状均存在且该形状是视频帧。

const aspose = { slides: require("aspose.slides.via.java") };

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

    const videoFrame = slide.getShapes().get_Item(0);
    videoFrame.getCaptionTracks().clear();

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

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

搜索视频字幕

Captions.getDataAsString 方法返回整个 WebVTT 轨道,包括标题、时间线和字幕文本。您可以在内存中搜索字幕文本,以查找特定短语及其时间戳。例如,第 2 张幻灯片上的英文轨道可能包含如下提示:

WEBVTT Café tour

00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

此示例打开 captioned_media.pptx,并使用 VideoFrame.getCaptionTracks 读取每张幻灯片上每个顶层视频帧的轨道。在纯文本提示中,时间线包含 -->,空行结束提示。对于每个字幕中包含 “café” (不区分大小写)的情况,示例会打印幻灯片编号、轨道标签、原始时间线以及完整字幕。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("captioned_media.pptx");
try {
    const slides = presentation.getSlides();
    for (let slideIndex = 0; slideIndex < slides.size(); slideIndex++) {
        const slide = slides.get_Item(slideIndex);
        const shapes = slide.getShapes();
        for (let shapeIndex = 0; shapeIndex < shapes.size(); shapeIndex++) {
            const shape = shapes.get_Item(shapeIndex);
            if (!java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
                continue;
            }

            const tracks = shape.getCaptionTracks();
            for (let trackIndex = 0; trackIndex < tracks.getCount(); trackIndex++) {
                const track = tracks.get_Item(trackIndex);
                const lines = track.getDataAsString().split(/\r\n|\n|\r/);
                for (let i = 0; i < lines.length; i++) {
                    const timing = lines[i];
                    if (!timing.includes("-->")) {
                        continue;
                    }
                    const start = i + 1;
                    i = start;
                    while (i < lines.length && lines[i] !== "") {
                        i++;
                    }
                    const caption = lines.slice(start, i).join("\n");
                    if (caption.toLowerCase().includes("café")) {
                        console.log(`Slide ${slide.getSlideNumber()} | ${track.getLabel()} | ${timing}`);
                        console.log(caption);
                    }
                }
            }
        }
    }
} finally {
    presentation.dispose();
}

搜索 “café” 在示例轨道中找到一次匹配。搜索会跳过轨道标题并在输出中保留时间设置和换行。

Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

从幻灯片中提取视频

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

此示例将每张幻灯片上的嵌入视频提取为单独的编号二进制文件。关联视频会被跳过,因为它们没有嵌入数据。控制台会打印每个视频的 MIME 类型及总数。输出使用通用的 .bin 扩展名;如有需要,请将其更改为对应的媒体类型。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const fs = require("fs");

const presentation = new aspose.slides.Presentation("presentation_with_videos.pptx");
try {
    let videoCount = 0;
    for (let slideIndex = 0; slideIndex < presentation.getSlides().size(); slideIndex++) {
        const slide = presentation.getSlides().get_Item(slideIndex);
        for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
            const shape = slide.getShapes().get_Item(shapeIndex);
            if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
                const videoFrame = shape;
                const video = videoFrame.getEmbeddedVideo();
                if (video == null) {
                    console.log("Skipped a linked video: no embedded data is available.");
                    continue;
                }

                videoCount++;
                const outputPath = "extracted_video_" + videoCount + ".bin";
                const outputData = Buffer.from(video.getBinaryData());
                fs.writeFileSync(outputPath, outputData);
                console.log("Video " + videoCount + ": " + video.getContentType());
            }
        }
    }

    console.log("Embedded videos extracted: " + videoCount);
} finally {
    presentation.dispose();
}

常见问题

可以更改视频帧的哪些播放参数?

您可以控制 playback mode(自动或点击)和 looping。这些选项可通过 VideoFrame 对象的方法进行设置。

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

会的。当您嵌入本地视频时,二进制数据会包含在文档中,因此演示文稿大小会随视频文件大小成比例增长。若您链接到在线视频并添加缩略图,演示文稿只存储链接和预览图像,而不是视频数据,大小增长通常较小。

可以在不更改位置和尺寸的情况下替换现有视频帧中的视频吗?

可以。您可以在保持形状几何属性不变的情况下,交换帧内的 video content,这在更新已有布局中的媒体时非常常见。

是否可以确定嵌入视频的内容类型(MIME)?

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