使用 Java 管理演示文稿中的视频帧

本页内容简介

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

介绍

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

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

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

为了让您能够向演示文稿添加视频（视频对象），Aspose.Slides 提供了 IVideo 接口、IVideoFrame 接口以及其他相关类型。

创建嵌入式视频帧

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

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

// 实例化 Presentation 类
Presentation pres = new Presentation("pres.pptx");
try {
    // 加载视频
    FileInputStream fileStream = new FileInputStream("Wildlife.mp4");
    
    IVideo video = pres.getVideos().addVideo(fileStream, LoadingStreamBehavior.KeepLocked);

    // 获取第一张幻灯片并添加视频帧
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);

    // 将演示文稿保存到磁盘
    pres.save("pres-with-video.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

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

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

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

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

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

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

private static void addVideoFromYouTube(Presentation pres, String videoID)
{
    // 添加视频帧
    IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(
            10, 10, 427, 240, "https://www.youtube.com/embed/" + videoID);
    videoFrame.setPlayMode(VideoPlayModePreset.Auto);

    // 加载缩略图
    String thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";
    URL url;

    try {
        url = new URL(thumbnailUri);
        videoFrame.getPictureFormat().getPicture().setImage(pres.getImages().addImage(url.openStream()));
    } catch (MalformedURLException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

剪裁视频帧

Aspose.Slides 允许您通过 IVideoFrame.setTrimFromStart 和 IVideoFrame.setTrimFromEnd 设置 trim-from-start 和 trim-from-end 值来控制播放的视频片段。这两个值以毫秒为单位，分别定义从视频开头和结尾跳过的时间。这些设置会更改演示文稿中的视频播放行为；它们不会裁剪或修改嵌入视频的二进制数据。

设置剪裁参数

要创建视频帧并设置其剪裁参数：

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

下面的代码示例在播放时跳过嵌入视频的前 2.5 秒和最后 1 秒：

Presentation presentation = new Presentation();
try {
    FileInputStream videoStream = new FileInputStream("video.mp4");
    try {
        IVideo video = presentation.getVideos().addVideo(
                videoStream, LoadingStreamBehavior.ReadStreamAndRelease);
        ISlide slide = presentation.getSlides().get_Item(0);
        IVideoFrame videoFrame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video);

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

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

读取剪裁参数

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

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

Presentation presentation = new Presentation("video_with_trim.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IVideoFrame) {
            IVideoFrame videoFrame = (IVideoFrame) shape;
            float trimFromStart = videoFrame.getTrimFromStart();
            float trimFromEnd = videoFrame.getTrimFromEnd();

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

管理视频字幕

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

向视频帧添加字幕

要向视频帧添加字幕：

创建一个 Presentation 类的实例。
向演示文稿添加视频。
向幻灯片添加一个 IVideoFrame 对象。
使用 getCaptionTracks 返回的 ICaptionsCollection 添加 WebVTT 字幕轨道。
保存已修改的演示文稿。

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

Presentation presentation = new Presentation();
try {
    byte[] videoData = Files.readAllBytes(Paths.get("video.mp4"));
    IVideo video = presentation.getVideos().addVideo(videoData);

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

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

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

ICaptionsCollection 接口还提供了一个重载，可让您从流中添加字幕。

从视频帧提取字幕

要从视频帧中提取字幕：

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

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

Presentation presentation = new Presentation("video_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IVideoFrame) {
            IVideoFrame videoFrame = (IVideoFrame)shape;
            for (ICaptions captionTrack : videoFrame.getCaptionTracks()) {
                // 将字幕轨道保存为 WebVTT 文件。
                String filePath = captionTrack.getCaptionId().toString() + ".vtt";
                Files.write(Paths.get(filePath), captionTrack.getBinaryData());
            }
        }
    }
} finally {
    presentation.dispose();
}

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

从视频帧移除字幕

要从视频帧中移除字幕：

加载包含视频的演示文稿。
获取目标 IVideoFrame 对象。
从 ICaptionsCollection 中移除字幕轨道。
保存已修改的演示文稿。

下面的代码展示了如何移除视频帧中的全部字幕：

Presentation presentation = new Presentation("video_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IVideoFrame videoFrame = (IVideoFrame)slide.getShapes().get_Item(0);

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

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

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

从幻灯片中提取视频

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

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

下面的 Java 代码展示了如何提取演示文稿幻灯片上的视频：

// 实例化表示演示文稿文件的 Presentation 对象 
Presentation pres = new Presentation("VideoSample.pptx");
try {
    for (ISlide slide : pres.getSlides()) 
    {
        for (IShape shape : slide.getShapes()) 
        {
            if (shape instanceof VideoFrame) 
            {
                IVideoFrame vf = (IVideoFrame) shape;
                String type = vf.getEmbeddedVideo().getContentType();
                int ss = type.lastIndexOf('-');
                byte[] buffer = vf.getEmbeddedVideo().getBinaryData();

                // 获取文件扩展名
                int charIndex = type.indexOf("/");
                type = type.substring(charIndex + 1);

                FileOutputStream fop = new FileOutputStream("testing2." + type);
                fop.write(buffer);
                fop.flush();
                fop.close();
            }
        }
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

FAQ

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

您可以通过 VideoFrame 对象的属性控制 playback mode（自动或单击播放）以及 looping（循环播放）。

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

会的。嵌入本地视频时，二进制数据会写入文档，文件大小会随视频文件大小等比例增长。添加在线视频时，仅嵌入链接和缩略图，增幅相对较小。

能否在不改变位置和大小的情况下替换现有 VideoFrame 中的视频？

可以。您可以在保持形状几何属性不变的前提下，使用 setEmbeddedVideo 替换帧内的视频内容，这在更新已有布局的媒体时非常常见。

能否确定嵌入视频的内容类型（MIME）？

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

使用 Java 管理演示文稿中的图像变换效果