使用 JavaScript 在簡報中管理影片框架

簡介

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

PowerPoint 允許您以兩種方式將影片新增至簡報的投影片中：

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

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

建立嵌入式影片框架

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

1. 建立 Presentation 類別的實例。
2. 透過索引取得投影片的參考。
3. 新增一個 Video 物件，並傳入影片檔案路徑以將影片嵌入簡報。
4. 新增一個 VideoFrame 物件，以建立影片的框架。
5. 保存已修改的簡報。

以下 JavaScript 程式碼示範如何將本機儲存的影片新增至簡報：

// 實例化 Presentation 類別
var pres = new aspose.slides.Presentation("pres.pptx");
try {
    // 載入影片
    var fileStream = java.newInstanceSync("java.io.FileInputStream", "Wildlife.mp4");
    var video = pres.getVideos().addVideo(fileStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
    // 取得第一張投影片並新增影片框架
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);
    // 將簡報儲存至磁碟
    pres.save("pres-with-video.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

或者，您也可以直接將檔案路徑傳遞給 addVideoFrame(float x, float y, float width, float height, IVideo video) 方法以新增影片：

var pres = new aspose.slides.Presentation();
try {
    var sld = pres.getSlides().get_Item(0);
    var vf = sld.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi");
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

使用 Web 來源的影片建立影片框架

Microsoft PowerPoint 2013 及以後版本支援在簡報中使用 YouTube 影片。如果您想使用的影片可在線上取得（例如 YouTube），您可以透過其網路連結將其新增至簡報。

1. 建立 Presentation 類別的實例
2. 透過索引取得投影片的參考。
3. 新增一個 Video 物件，並傳入影片的連結。
4. 為影片框架設定縮圖。
5. 保存簡報。

以下 JavaScript 程式碼示範如何將線上影片新增至 PowerPoint 簡報的投影片中：

// 實例化一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation();
try {
    addVideoFromYouTube(pres, "Tj75Arhq5ho");
    pres.save("out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

async function addVideoFromYouTube(pres, videoID) {
    let slide = pres.getSlides().get_Item(0);
    let videoUrl = "https://www.youtube.com/embed/" + videoID;
    let videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
    
    videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);

    let thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";

    try {
        const imageStream = await getImageStream(thumbnailUri);
        let image = pres.getImages().addImage(imageStream);
        videoFrame.getPictureFormat().getPicture().setImage(image);
    } catch (error) {
        console.error("Error loading thumbnail:", error);
    }
}

async function getImageStream(url) {
    return new Promise((resolve, reject) => {
        http.get(url, (response) => {
            if (response.statusCode === 200) {
                resolve(response);
            } else {
                reject(new Error(`Failed to load image: ${response.statusCode}`));
            }
        }).on('error', (e) => {
            reject(e);
        });
    });
}

管理影片字幕

Aspose.Slides 允許您管理 PowerPoint 簡報中影片框架的隱藏式字幕。字幕以 WebVTT 格式儲存，並可透過 VideoFrame.getCaptionTracks 方法取得。

新增字幕至影片框架

若要為影片框架新增字幕：

1. 建立 Presentation類別的實例。
2. 將影片新增至簡報。
3. 在投影片中新增一個 VideoFrame 物件。
4. 使用 CaptionsCollection 集合來新增 WebVTT 字幕軌。
5. 保存已修改的簡報。

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

let presentation = new aspose.slides.Presentation();
try {
    let videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
    let video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);

    let slide = presentation.getSlides().get_Item(0);
    let videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);

    // 從 WebVTT 檔案新增字幕軌道。
    videoFrame.getCaptionTracks().add("English", "track.vtt");

    presentation.save("video_with_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

CaptionsCollection 類別也提供了 addFromStream 方法，可讓您從串流加入字幕。

從影片框架擷取字幕

若要從影片框架擷取字幕：

1. 載入包含該影片的簡報。
2. 找出目標 VideoFrame 物件。
3. 遍歷 CaptionsCollection 集合。
4. 將每條字幕軌保存為 .vtt 檔案。

以下程式碼示範如何從影片框架擷取字幕：

let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let shapeCount = slide.getShapes().size();
    for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
        let shape = slide.getShapes().get_Item(shapeIndex);
        if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
            let videoFrame = shape;
            let trackCount = videoFrame.getCaptionTracks().getCount();
            for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
                let captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
                // 將字幕軌道保存為 WebVTT 檔案。
                let filePath = captionTrack.getCaptionId() + ".vtt";
                let captionData = Buffer.from(captionTrack.getBinaryData());
                fs.writeFileSync(filePath, captionData);
            }
        }
    }
} finally {
    presentation.dispose();
}

每個 Captions 物件都會公開字幕的識別碼、標籤、二進位資料，以及以 UTF-8 字串形式的字幕文字。

從影片框架移除字幕

若要從影片框架移除字幕：

1. 載入包含該影片的簡報。
2. 取得目標 VideoFrame 物件。
3. 從 CaptionsCollection 集合中移除字幕軌。
4. 保存已修改的簡報。

以下程式碼示範如何從影片框架移除全部字幕：

let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let videoFrame = slide.getShapes().get_Item(0); // 類型: com.aspose.slides.VideoFrame

    // 從影片框架移除所有字幕。
    videoFrame.getCaptionTracks().clear();

    presentation.save("video_without_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

如果只需移除單一字幕軌，請使用 remove 或 removeAt 方法，而非 clear。

從投影片提取影片

除了將影片新增至投影片之外，Aspose.Slides 也允許您提取嵌入於簡報中的影片。

1. 建立 Presentation類別的實例，以載入包含影片的簡報。
2. 遍歷所有 Slide物件。
3. 遍歷所有 Shape物件以尋找 VideoFrame。
4. 將影片保存至磁碟。

以下 JavaScript 程式碼示範如何從簡報投影片中提取影片：

// 實例化一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation("VideoSample.pptx");
try {
    for (let i = 0; i < pres.getSlides().size(); i++) {
        let slide = pres.getSlides().get_Item(i);
        for (let j = 0; j < slide.getShapes().size(); j++) {
            let shape = slide.getShapes().get_Item(j);
            if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
                var vf = shape;
                console.log(shape);
                var type = vf.getEmbeddedVideo().getContentType();
                var ss = type.lastIndexOf('-');
                const buffer = Buffer.from(vf.getEmbeddedVideo().getBinaryData());
                console.log(buffer);
                // 取得檔案副檔名
                var charIndex = type.indexOf("/");
                type = type.substring(charIndex + 1);
                fs.writeFileSync("testing2." + type, buffer);
            }
        }
    }
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

常見問題

可以變更 VideoFrame 的哪些影片播放參數？

您可以控制 playback mode（自動或點擊播放）與 looping（循環播放）。這些選項可透過 VideoFrame 物件的屬性取得。

新增影片會影響 PPTX 檔案大小嗎？

會。當您嵌入本機影片時，二進位資料會包含在文件中，導致簡報大小隨檔案大小成比例增長。當您新增線上影片時，僅嵌入連結與縮圖，大小的增加較小。

我可以在不更改位置與大小的情況下取代既有 VideoFrame 的影片嗎？

可以。您可以在保留形狀尺寸與位置的情況下，交換框架內的 video content；這是更新既有版面媒體的常見情況。

可以判斷嵌入式影片的內容類型 (MIME) 嗎？

可以。嵌入式影片具有可讀取的 content type，例如在保存至磁碟時可加以使用。