使用 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():
    jpype.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 設定裁切起始與結束值。
儲存已修改的簡報。

以下程式碼範例在播放時跳過嵌入影片的前 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 簡報的影片框架中管理隱蔽字幕（closed captions）。字幕以 WebVTT 格式儲存，並可透過 VideoFrame.getCaptionTracks 方法取得。

為影片框架加入字幕

將字幕加入影片框架的步驟：

建立 Presentation 類別的實例。
在簡報中加入影片。
在投影片上加入 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。

加入影片會影響 PPTX 檔案大小嗎？

會的。當您嵌入本機影片時，二進位資料會寫入文件，簡報大小會隨檔案大小成比例增加。加入線上影片時，只會嵌入連結與縮圖，檔案大小的增幅較小。

是否可以在不變更位置與尺寸的前提下，取代既有 VideoFrame 中的影片？

可以。您可交換 video content 而保留形狀的幾何資訊，這是更新既有版面中媒體的常見情境。

能否判斷嵌入影片的內容類型（MIME）？

可以。嵌入的影片具備可透過 content type 讀取的 MIME 類型，您亦可在儲存至磁碟時使用此資訊。

使用 Python 在簡報中管理圖像變換效果