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

本页内容简介

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

简介

视频可以帮助解释理念并吸引受众。Aspose.Slides for Python via Java 允许您向幻灯片添加视频帧、调整播放设置、管理字幕并提取嵌入的视频数据。

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

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

创建嵌入式视频帧

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

此示例在现有演示文稿的第一页上嵌入本地视频并保存结果。帧坐标和尺寸使用点（points）单位。Python 从磁盘读取视频字节，JPype 将其转换为 Java 字节数组后再将视频添加到演示文稿。

from pathlib import Path

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)

    video = presentation.getVideos().addVideo(java_video_data)
    slide.getShapes().addVideoFrame(10, 10, 150, 250, video)

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

您也可以直接将本地视频路径传递给 addVideoFrame。此示例在新演示文稿的第一页嵌入视频。视频必须在演示文稿保存之前保持可访问。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

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

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

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

Microsoft PowerPoint 支持在演示文稿中使用在线视频。您可以创建指向在线视频（例如 YouTube 视频）的视频帧。

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

from urllib.request import urlopen

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, VideoPlayModePreset

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    video_id = "aqz-KE-bpKQ"
    video_url = "https://www.youtube.com/embed/" + video_id
    video_frame = slide.getShapes().addVideoFrame(10, 10, 427, 240, video_url)
    video_frame.setPlayMode(VideoPlayModePreset.Auto)

    thumbnail_url = "https://img.youtube.com/vi/" + video_id + "/hqdefault.jpg"
    with urlopen(thumbnail_url) 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)

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

全屏播放视频

在培训演示中，您可以以全屏模式播放软件演示，让观众看到细节。调用 setFullScreenMode 并传入 True 可在播放期间启用此行为。

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

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, VideoFrame

presentation = Presentation("training.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            shape.setFullScreenMode(True)
            break

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

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

播放后倒回视频

在培训演示中，将演示视频倒回到起始位置可以让演示者再次播放。调用 setRewindVideo 并传入 True 可在播放结束后将视频返回到开头。

此示例打开演示文稿，查找第一页上的第一个 VideoFrame，并启用倒回。它禁用循环以让播放完成，并将播放设置为点击启动。输入的演示文稿必须至少在第一页包含一个现有的视频帧。

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, VideoFrame, VideoPlayModePreset

presentation = Presentation("training.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            shape.setRewindVideo(True)
            shape.setPlayLoopMode(False)
            shape.setPlayMode(VideoPlayModePreset.OnClick)
            break

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

倒回会将视频返回到起始位置而不再次启动。相反，调用 setPlayLoopMode 并传入 True 会自动循环播放。当您希望视频播放完毕后保持可重新播放状态时，请禁用循环。setPlayMode 独立控制自动或点击启动；本示例使用 VideoPlayModePreset.OnClick，因此由演示者控制何时开始播放。请按示例所示先设置循环，再设置播放模式。倒回与 setFullScreenMode 无关，独立工作。

剪辑视频帧

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

设置剪辑参数

此示例嵌入本地视频，并在播放时跳过前 2.5 秒和最后 1 秒。请使用时长超过 3.5 秒的视频，以保证仍有可播放的片段。

from pathlib import Path

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)

    video = presentation.getVideos().addVideo(java_video_data)
    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()

读取剪辑参数

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

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 方法获取。

向视频帧添加字幕

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

from pathlib import Path

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)

    video = presentation.getVideos().addVideo(java_video_data)
    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 类还提供了一个重载，允许您从流中添加字幕。

从视频帧提取字幕

此示例将第一页上所有视频帧的字幕轨道保存为单独的 WebVTT 文件。使用顺序编号以保持输出文件唯一。控制台会报告提取的轨道数量。演示文稿必须至少包含一页。

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)

    track_count = 0
    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            for caption_track in shape.getCaptionTracks():
                track_count += 1
                output_path = Path(f"captions_{track_count}.vtt")
                caption_data = bytes(caption_track.getBinaryData())
                output_path.write_bytes(caption_data)

    print(f"Caption tracks extracted: {track_count}")
finally:
    presentation.dispose()

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

从视频帧移除字幕

此示例移除第一页第一形状位置视频帧的所有字幕并保存结果。它假设该页和形状存在且该形状是视频帧。

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 还可以提取嵌入在演示文稿中的视频。

此示例将每页上的嵌入视频提取为单独的、带编号的二进制文件。链接视频会被跳过，因为它们没有嵌入数据。控制台打印每个视频的 MIME 类型和总计数。输出使用通用的 .bin 扩展名；如有需要可改为匹配报告的媒体类型。

from pathlib import Path

import jpype
import asposeslides

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

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("presentation_with_videos.pptx")
try:
    video_count = 0
    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if isinstance(shape, VideoFrame):
                video = shape.getEmbeddedVideo()
                if video is None:
                    print("Skipped a linked video: no embedded data is available.")
                    continue

                video_count += 1
                output_path = Path(f"extracted_video_{video_count}.bin")
                video_data = bytes(video.getBinaryData())
                output_path.write_bytes(video_data)
                print(f"Video {video_count}: {video.getContentType()}")

    print(f"Embedded videos extracted: {video_count}")
finally:
    presentation.dispose()

常见问题

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

您可以控制 playback mode（自动或点击）和 looping。这些选项可通过 VideoFrame 对象的方法使用。

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

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

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

可以。您可以在保持形状几何不变的情况下替换帧内的 video content；这是在现有布局中更新媒体的常见场景。

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

可以。嵌入视频拥有可读取的 content type，例如在保存到磁盘时使用。

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