在 Android 上管理簡報中的影片框架

簡介

在簡報中恰當地放置影片可以讓您的訊息更具說服力，並提升觀眾的參與度。

PowerPoint 允許您以兩種方式將影片加入簡報的投影片中：

新增或嵌入本機影片（儲存在您的電腦上）
新增線上影片（來自如 YouTube 等網路來源）

為了讓您能在簡報中加入影片（video 物件），Aspose.Slides 提供了 IVideo 介面、IVideoFrame 介面，以及其他相關類型。

建立嵌入式影片框架

如果您要加入投影片的影片檔案儲存在本機，您可以建立影片框架將影片嵌入簡報中。

建立 Presentation 類別的實例。
透過索引取得投影片的參照。
新增一個 IVideo 物件，並傳入影片檔案路徑，以將影片嵌入簡報。
新增一個 IVideoFrame 物件，以為影片建立框架。
儲存修改後的簡報。

以下 Java 程式碼示範如何將本機儲存的影片加入簡報：

// 實例化 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 及更新版本支援在簡報中使用 YouTube 影片。如果您想使用的影片可於網路上取得（例如 YouTube），您可以透過其網路連結將其加入簡報。

建立 Presentation 類別的實例
透過索引取得投影片的參照。
新增一個 IVideo 物件，並傳入影片連結。
為影片框架設定縮圖。
儲存簡報。

以下 Java 程式碼示範如何將網路上的影片加入 PowerPoint 投影片：

// 實例化一個代表簡報檔案的 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 允許您管理 PowerPoint 簡報中影片框架的隱藏式字幕。字幕以 WebVTT 格式儲存，並可透過 IVideoFrame.getCaptionTracks 方法取得。

將字幕新增至影片框架

建立 Presentation 類別的實例。
將影片新增至簡報。
新增一個 IVideoFrame 物件至投影片。
使用由 getCaptionTracks 取得的 ICaptionsCollection 以新增 WebVTT 字幕軌道。
儲存修改後的簡報。

以下程式碼示範如何將字幕新增至影片框架：

Presentation presentation = new Presentation();
try {
    byte[] videoData = // "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 物件。
迭代由 getCaptionTracks 取得的字幕軌道。
將每個字幕軌道儲存為 .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 檔案。
                FileOutputStream outputStream = new FileOutputStream(captionTrack.getCaptionId() + ".vtt");
                outputStream.write(captionTrack.getBinaryData());
                outputStream.close();
            }
        }
    }
} finally {
    presentation.dispose();
}

每個 ICaptions 物件會公開字幕識別碼、標籤、二進位資料，以及作為 UTF-8 字串的字幕內容。

從影片框架移除字幕

載入包含影片的簡報。
取得目標 IVideoFrame 物件。
從由 getCaptionTracks 取得的集合中移除字幕軌道。
儲存修改後的簡報。

以下程式碼示範如何移除影片框架中的所有字幕：

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 物件的屬性控制播放模式（自動或點擊）以及迴圈播放。

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

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

我能在不變更位置與大小的情況下替換現有 VideoFrame 中的影片嗎？

可以。您可以在保持形狀幾何的前提下，使用 setEmbeddedVideo 交換框架內的影片內容，這是更新現有版面媒體的常見情境。

能否判斷嵌入式影片的內容類型 (MIME)？

可以。嵌入式影片具有可讀取的 content type，您可以在將其儲存至磁碟時使用此資訊。