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

本页内容简介

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

简介

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

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

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

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

创建嵌入式视频帧

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

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

以下 Python 代码演示了如何将本地存储的视频添加到演示文稿中：

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("pres.pptx")
try:
    video_data = Path("Wildlife.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    presentation.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video)
    presentation.save("pres-with-video.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

或者，您可以直接将视频文件路径传递给 addVideoFrame 方法来添加视频：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi")
finally:
    presentation.dispose()

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

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

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

以下 Python 代码演示了如何将网络视频添加到 PowerPoint 演示文稿的幻灯片中：

from urllib.request import urlopen

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpway.startJVM()

from asposeslides.api import Presentation, SaveFormat, VideoPlayModePreset

video_id = "Tj75Arhq5ho"
presentation = Presentation()
try:
    video_frame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 427, 240, "https://www.youtube.com/embed/" + video_id)
    video_frame.setPlayMode(VideoPlayModePreset.Auto)

    # 加载缩略图。
    thumbnail_uri = "https://img.youtube.com/vi/" + video_id + "/hqdefault.jpg"
    try:
        with urlopen(thumbnail_uri) as response:
            thumbnail_data = response.read()
        java_thumbnail_data = jpype.JArray(jpype.JByte)(thumbnail_data)
        thumbnail = presentation.getImages().addImage(java_thumbnail_data)
        video_frame.getPictureFormat().getPicture().setImage(thumbnail)
    except OSError as error:
        print("Could not load the thumbnail:", error)

    presentation.save("out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

剪裁视频帧

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 值。
保存修改后的演示文稿。

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

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video)

    video_frame.setTrimFromStart(2500.0)
    video_frame.setTrimFromEnd(1000.0)
    presentation.save("video_with_trim.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

读取剪裁参数

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

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("video_with_trim.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            trim_from_start = shape.getTrimFromStart()
            trim_from_end = shape.getTrimFromEnd()
            print(f"Trim from start: {trim_from_start} ms")
            print(f"Trim from end: {trim_from_end} ms")
            break
finally:
    presentation.dispose()

管理视频字幕

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

向视频帧添加字幕

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

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

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video)

    # 添加来自 WebVTT 文件的新字幕轨道。
    video_frame.getCaptionTracks().add("English", "track.vtt")
    presentation.save("video_with_captions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

CaptionsCollection 类还提供了一个重载，允许您从流中添加字幕。

从视频帧提取字幕

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

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

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("video_with_captions.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            for caption_track in shape.getCaptionTracks():
                # 将字幕轨道保存为 WebVTT 文件。
                file_path = Path(str(caption_track.getCaptionId()) + ".vtt")
                caption_data = bytes(caption_track.getBinaryData())
                file_path.write_bytes(caption_data)
finally:
    presentation.dispose()

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

从视频帧移除字幕

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

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, VideoFrame

presentation = Presentation("video_with_captions.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().get_Item(0)
    if isinstance(video_frame, VideoFrame):
        # 删除视频帧中的所有字幕。
        video_frame.getCaptionTracks().clear()
        presentation.save("video_without_captions.pptx", SaveFormat.Pptx)
    else:
        print("The shape is not a video frame.")
finally:
    presentation.dispose()

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

从幻灯片提取视频

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

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

以下 Python 代码演示了如何提取演示文稿幻灯片中的视频：

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("VideoSample.pptx")
try:
    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if isinstance(shape, VideoFrame):
                video = shape.getEmbeddedVideo()
                if video is not None:
                    content_type = str(video.getContentType())
                    file_extension = content_type.split("/", 1)[-1]
                    video_data = bytes(video.getBinaryData())
                    Path("testing2." + file_extension).write_bytes(video_data)
                else:
                    print("The video frame has no embedded video.")
finally:
    presentation.dispose()

FAQ

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

您可以通过 VideoFrame 对象的属性控制 playback mode（自动或单击）和 looping。这些选项可通过 VideoFrame 对象的属性获得。

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

会。嵌入本地视频时，二进制数据会包含在文档中，演示文稿大小会随文件大小等比例增加。添加在线视频时，只会嵌入链接和缩略图，因此大小增幅较小。

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

可以。您可以在保持形状几何不变的情况下交换帧内的视频内容，这在更新已有布局中的媒体时非常常见。

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

可以。嵌入的视频具有可读取的内容类型，例如在保存到磁盘时可使用该信息。

使用 Python 在演示文稿中管理图像变换效果