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

本頁內容簡介

學習如何使用 Aspose.Slides for Android 透過 Java，以程式方式在 PowerPoint 與 OpenDocument 投影片中新增與擷取影片框架。快速操作指南。

簡介

在簡報中適時加入影片可以讓您的訊息更具說服力，並提升觀眾的參與度。

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

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

為了讓您能在簡報中加入影片（video objects），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 支援在簡報中使用線上影片。如果您要使用的影片已上傳至網路（例如 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 允許您透過 IVideoFrame.setTrimFromStart 與 IVideoFrame.setTrimFromEnd 設定 trim‑from‑start 與 trim‑from‑end 值，以控制播放的影片段落。兩個值皆以毫秒為單位，分別表示從影片開頭與結尾略過的時間長度。此設定會影響簡報中的影片播放行為，並不會切割或修改嵌入影片的二進位資料。

設定裁剪

建立影片框架並設定裁剪值的步驟：

建立一個 Presentation 類別的實例。
新增一個 IVideo 物件至簡報。
在投影片上新增一個 IVideoFrame 物件。
透過 IVideoFrame.setTrimFromStart 與 IVideoFrame.setTrimFromEnd 設定裁剪起始與結束值。
儲存已修改的簡報。

以下程式碼示範在播放時略過前 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 = // "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 物件的屬性控制 playback mode（自動或點擊）以及 looping。

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

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

我可以在不變更位置和尺寸的情況下，取代既有 VideoFrame 中的影片嗎？

可以。您可以在保留形狀幾何的前提下，使用 setEmbeddedVideo 交換框架內的影片內容，這在更新既有版面配置時相當常見。

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

可以。嵌入的影片具有可透過 getContentType 讀取的內容類型，您可將其用於儲存至磁碟等情境。

在 Android 上管理簡報中的影像變換效果