# C++ を使用したプレゼンテーションでのビデオフレームの管理

> Aspose.Slides for C++ を使用して、PowerPoint および OpenDocument のスライドでビデオフレームをプログラムで追加および抽出する方法を学びます。迅速なハウツーガイド。

Source: https://docs.aspose.com/slides/ja/cpp/video-frame/
Updated: 2026-04-27

プレゼンテーションに適切に配置されたビデオは、メッセージをより説得力のあるものにし、オーディエンスとのエンゲージメントレベルを高めることができます。

PowerPoint では、プレゼンテーションのスライドにビデオを追加する方法が 2 つあります。

* ローカルビデオ（マシンに保存されているビデオ）を追加または埋め込む
* オンラインビデオ（YouTube などの Web ソース）を追加する

ビデオ（ビデオオブジェクト）をプレゼンテーションに追加できるように、Aspose.Slides は [IVideo](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideo/) インターフェイス、[IVideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/) インターフェイス、およびその他の関連型を提供します。

## **埋め込みビデオフレームの作成**

スライドに追加したいビデオファイルがローカルに保存されている場合、プレゼンテーションにビデオを埋め込むビデオフレームを作成できます。

1. [Presentation](https://reference.aspose.com/slides/ja/cpp/aspose.slides/presentation/) クラスのインスタンスを作成します。  
1. インデックスを使用してスライドの参照を取得します。  
1. [IVideo](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideo/) オブジェクトを追加し、ビデオファイルパスを渡してプレゼンテーションにビデオを埋め込みます。  
1. [IVideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/) オブジェクトを追加してビデオ用のフレームを作成します。  
1. 変更したプレゼンテーションを保存します。

この C++ コードは、ローカルに保存されたビデオをプレゼンテーションに追加する方法を示しています。

```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()](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ishapecollection/addvideoframe/) メソッドにファイルパスを直接渡してビデオを追加することもできます。

``` c++
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");
```

## **Web ソースからのビデオでビデオフレームを作成する**

Microsoft の [PowerPoint 2013 以降](https://support.microsoft.com/en-us/office/versions-of-powerpoint-that-support-online-videos-2a0e184d-af50-4da9-b530-e4355ac436a9?ui=en-us&rs=en-us&ad=us) は、プレゼンテーションで YouTube ビデオをサポートしています。使用したいビデオがオンライン（例: YouTube）にある場合、その Web リンクを使用してプレゼンテーションに追加できます。

1. [Presentation](https://reference.aspose.com/slides/ja/cpp/aspose.slides/presentation/) クラスのインスタンスを作成します。  
1. インデックスを使用してスライドの参照を取得します。  
1. [IVideo](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideo/) オブジェクトを追加し、ビデオへのリンクを渡します。  
1. ビデオフレームのサムネイルを設定します。  
1. プレゼンテーションを保存します。

この C++ コードは、Web からビデオを取得して PowerPoint のスライドに追加する方法を示しています。

```c++
// ドキュメントディレクトリへのパスです。
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](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/get_captiontracks/) メソッドを介して取得できます。

**ビデオフレームにキャプションを追加する**

ビデオフレームにキャプションを追加する手順は次のとおりです。

1. [Presentation](https://reference.aspose.com/slides/ja/cpp/aspose.slides/presentation/) クラスのインスタンスを作成します。  
1. プレゼンテーションにビデオを追加します。  
1. スライドに [IVideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/) オブジェクトを追加します。  
1. [get_CaptionTracks](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/get_captiontracks/) が返す [ICaptionsCollection](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptionscollection/) を使用して WebVTT キャプショントラックを追加します。  
1. 変更したプレゼンテーションを保存します。

以下のコードは、ビデオフレームにキャプションを追加する方法を示しています。

```cpp
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](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptionscollection/) インターフェイスは、ストリームからキャプションを追加できるオーバーロードも提供します。

**ビデオフレームからキャプションを抽出する**

ビデオフレームからキャプションを抽出する手順は次のとおりです。

1. ビデオを含むプレゼンテーションを読み込みます。  
1. 対象の [IVideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/) オブジェクトを検索します。  
1. [get_CaptionTracks](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/get_captiontracks/) が返すキャプショントラックを列挙します。  
1. 各キャプショントラックを `.vtt` ファイルとして保存します。

以下のコードは、ビデオフレームからキャプションを抽出する方法を示しています。

```cpp
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](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptions/) オブジェクトは、キャプション識別子、ラベル、バイナリデータ、および UTF-8 文字列としてのキャプションデータを公開します。

**ビデオフレームからキャプションを削除する**

ビデオフレームからキャプションを削除する手順は次のとおりです。

1. ビデオを含むプレゼンテーションを読み込みます。  
1. 対象の [IVideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/) オブジェクトを取得します。  
1. [get_CaptionTracks](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ivideoframe/get_captiontracks/) が返すコレクションからキャプショントラックを削除します。  
1. 変更したプレゼンテーションを保存します。

以下のコードは、ビデオフレームからすべてのキャプションを削除する方法を示しています。

```cpp
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();
```

1 つのキャプショントラックだけを削除したい場合は、[Clear](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptionscollection/clear/) の代わりに [Remove](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptionscollection/remove/) または [RemoveAt](https://reference.aspose.com/slides/ja/cpp/aspose.slides/icaptionscollection/removeat/) メソッドを使用してください。

## **スライドからビデオを抽出する**

ビデオをスライドに追加するだけでなく、Aspose.Slides はプレゼンテーションに埋め込まれたビデオの抽出もサポートします。

1. ビデオを含むプレゼンテーションを読み込むために、[Presentation](https://reference.aspose.com/slides/ja/cpp/aspose.slides/presentation/) クラスのインスタンスを作成します。  
2. すべての [ISlide](https://reference.aspose.com/slides/ja/cpp/aspose.slides/islide/) オブジェクトを列挙します。  
3. すべての [IShape](https://reference.aspose.com/slides/ja/cpp/aspose.slides/ishape/) オブジェクトを列挙し、[VideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/videoframe/) を探します。  
4. ビデオをディスクに保存します。

この C++ コードは、プレゼンテーションのスライドからビデオを抽出する方法を示しています。

```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());
        }
    }
}
```

## **FAQ**

**VideoFrame の再生パラメータで変更できるものは何ですか？**

[playback mode](https://reference.aspose.com/slides/ja/cpp/aspose.slides/videoframe/set_playmode/)（自動またはクリック時）と [looping](https://reference.aspose.com/slides/ja/cpp/aspose.slides/videoframe/set_playloopmode/) を制御できます。これらのオプションは、[VideoFrame](https://reference.aspose.com/slides/ja/cpp/aspose.slides/videoframe/) オブジェクトのプロパティを通じて利用可能です。

**ビデオを追加すると PPTX ファイルのサイズは増加しますか？**

はい。ローカルビデオを埋め込むと、バイナリデータがドキュメントに含まれるため、ファイルサイズに比例してプレゼンテーションのサイズが増加します。オンラインビデオを追加する場合は、リンクとサムネイルが埋め込まれるだけなので、増加幅は小さくなります。

**既存の VideoFrame の位置やサイズを変更せずにビデオだけを差し替えることはできますか？**

はい。フレーム内の [video content](https://reference.aspose.com/slides/ja/cpp/aspose.slides/videoframe/set_embeddedvideo/) を入れ替えることで、シェイプのジオメトリを保持したままメディアを更新できます。これは既存レイアウトのメディア更新でよく使われるシナリオです。

**埋め込みビデオのコンテンツタイプ（MIME）を取得できますか？**

はい。埋め込みビデオには [content type](https://reference.aspose.com/slides/ja/cpp/aspose.slides/video/get_contenttype/) が設定されており、取得してディスクに保存する際などに利用できます。