使用 C++ 管理簡報中的影片框架

簡介

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

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

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

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

建立嵌入式影片框架

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

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

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

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

// Loads the video
System::SharedPtr<System::IO::FileStream> fileStream = System::MakeObject<System::IO::FileStream>(u"Wildlife.mp4", System::IO::FileMode::Open, System::IO::FileAccess::Read);
System::SharedPtr<IVideo> video = pres->get_Videos()->AddVideo(fileStream, LoadingStreamBehavior::KeepLocked);

// Gets the first slide and adds a videoframe
pres->get_Slide(0)->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 150.0f, 250.0f, video);

// Saves the presentation to disk
pres->Save(u"pres-with-video.pptx", SaveFormat::Pptx);

或者，您也可以直接將檔案路徑傳遞給 AddVideoFrame() 方法來新增影片：

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

System::SharedPtr<ISlide> sld = pres->get_Slide(0);
System::SharedPtr<IVideoFrame> vf = sld->get_Shapes()->AddVideoFrame(50.0f, 150.0f, 300.0f, 150.0f, u"video1.avi");

建立來自網路來源的影片框架

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

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

以下 C++ 程式碼示範如何從網路將影片新增至 PowerPoint 簡報的投影片中：

// 文件目錄的路徑。
const String outPath = u"../out/AddVideoFrameFromWebSource_out.pptx";
const String filePath = u"../templates/video1.avi";

// 實例化一個代表簡報檔案的 Presentation 物件
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// 存取第一張投影片
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// 新增影片框架 
System::SharedPtr<IVideoFrame> vf = slide->get_Shapes()->AddVideoFrame(10, 10, 427, 240,u"https://www.youtube.com/embed/Tj75Arhq5ho");

// 設定影片的播放模式與音量
vf->set_PlayMode(VideoPlayModePreset::Auto);

//儲存簡報至磁碟
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

管理影片字幕

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

為影片框架新增字幕

建立 Presentation 類別的執行個體。
將影片新增至簡報。
在投影片上新增一個 IVideoFrame 物件。
使用由 get_CaptionTracks 回傳的 ICaptionsCollection 來新增 WebVTT 字幕軌。
儲存已修改的簡報。

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

auto presentation = MakeObject<Presentation>();

auto videoData = File::ReadAllBytes(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoData);

auto slide = presentation->get_Slide(0);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(0, 0, 100, 100, video);

// 從 WebVTT 檔案新增新的字幕軌。
videoFrame->get_CaptionTracks()->Add(u"English", u"track.vtt");

presentation->Save(u"video_with_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

ICaptionsCollection 介面亦提供一個載入串流以新增字幕的多載方法。

從影片框架提取字幕

載入包含影片的簡報。
找到目標的 IVideoFrame 物件。
迭代由 get_CaptionTracks 回傳的字幕軌。
將每條字幕軌儲存為 .vtt 檔案。

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

auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);

for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IVideoFrame>(shape))
    {
        auto videoFrame = ExplicitCast<IVideoFrame>(shape);
        for (auto&& captionTrack : videoFrame->get_CaptionTracks())
        {
            // 將字幕軌儲存為 WebVTT 檔案。
            auto filePath = captionTrack->get_CaptionId().ToString() + u".vtt";
            File::WriteAllBytes(filePath, captionTrack->get_BinaryData());
        }
    }
}

presentation->Dispose();

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

從影片框架移除字幕

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

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

auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);
auto videoFrame = ExplicitCast<IVideoFrame>(slide->get_Shape(0));

// 移除影片框架中的所有字幕。
videoFrame->get_CaptionTracks()->Clear();

presentation->Save(u"video_without_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

如果只需要移除單一字幕軌，請使用 Remove 或 RemoveAt 方法，取代 Clear。

從投影片中擷取影片

除了向投影片加入影片外，Aspose.Slides 也允許您擷取嵌入於簡報中的影片。

建立 Presentation 類別的執行個體，以載入包含影片的簡報。
迭代所有 ISlide 物件。
迭代所有 IShape 物件，以尋找 VideoFrame。
將影片儲存至磁碟。

以下 C++ 程式碼示範如何擷取簡報投影片中的影片：

// 文件目錄的路徑。
const System::String templatePath = u"../templates/Video.pptx";
const System::String outPath = u"../out/Video_out";

auto presentation = System::MakeObject<Presentation>(templatePath);
for (auto&& slide : presentation->get_Slides())
{
    for (auto&& shape : slide->get_Shapes())
    {
        if (System::ObjectExt::Is<VideoFrame>(shape))
        {
            System::SharedPtr<VideoFrame> vf = System::AsCast<VideoFrame>(shape);
            System::String type = vf->get_EmbeddedVideo()->get_ContentType();
            type = type.Remove(0, type.LastIndexOf('/') + 1);
            auto buffer = vf->get_EmbeddedVideo()->get_BinaryData();

            auto stream = System::MakeObject<System::IO::FileStream>(
                outPath + type, System::IO::FileMode::Create, System::IO::FileAccess::Write,
                System::IO::FileShare::Read);
            stream->Write(buffer, 0, buffer->get_Length());
        }
    }
}

常見問題

可以為 VideoFrame 更改哪些影片播放參數？
您可以控制 playback mode（自動或點擊）與 looping。這些選項可透過 VideoFrame 物件的屬性取得。

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

我可以在不更改位置和大小的情況下，替換現有 VideoFrame 中的影片嗎？
可以。您可以在保留形狀幾何的前提下，交換框架內的 video content，這是一種常見的更新既有版面媒體的情境。

是否能判斷嵌入影片的內容類型（MIME）？
可以。嵌入的影片具有可讀取的 content type，您可在儲存至磁碟等情況下加以使用。