.NET でプレゼンテーションのビデオフレームを管理する

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

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

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

ビデオオブジェクトをプレゼンテーションに追加できるように、Aspose.Slides は IVideo インターフェイス、IVideoFrame インターフェイス、およびその他の関連型を提供しています。

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

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

Presentation クラスのインスタンスを作成します。
インデックスを使ってスライドの参照を取得します。
ビデオを埋め込むためにビデオファイルのパスを渡して IVideo オブジェクトを追加します。
ビデオ用のフレームを作成するために IVideoFrame オブジェクトを追加します。
変更したプレゼンテーションを保存します。

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

// Presentation クラスのインスタンスを作成します
using (Presentation pres = new Presentation("pres.pptx"))
{
    // ビデオを読み込みます
    using (FileStream fileStream = new FileStream("Wildlife.mp4", FileMode.Open, FileAccess.Read))
    {
        IVideo video = pres.Videos.AddVideo(fileStream, LoadingStreamBehavior.KeepLocked);
        
        // 最初のスライドを取得し、ビデオフレームを追加します
        pres.Slides[0].Shapes.AddVideoFrame(10, 10, 150, 250, video);
        
        // プレゼンテーションをディスクに保存します
        pres.Save("pres-with-video.pptx", SaveFormat.Pptx);
    }
}

または、ビデオのファイルパスを直接 AddVideoFrame メソッドに渡してビデオを追加することもできます。

using (Presentation pres = new Presentation())
{
    ISlide sld = pres.Slides[0];
    IVideoFrame vf = sld.Shapes.AddVideoFrame(50, 150, 300, 150, "video1.avi");
}

ウェブソースからのビデオフレームの作成

Microsoft PowerPoint 2013 以降はプレゼンテーションで YouTube ビデオの使用をサポートしています。使用したいビデオがオンライン（例: YouTube）にある場合は、ウェブリンクを介してプレゼンテーションに追加できます。

Presentation クラスのインスタンスを作成します。
インデックスを使ってスライドの参照を取得します。
ビデオへのリンクを渡して IVideo オブジェクトを追加します。
ビデオフレームのサムネイルを設定します。
プレゼンテーションを保存します。

この C# コードは、ウェブ上のビデオを PowerPoint スライドに追加する方法を示しています。

public static void Run()
{
    // プレゼンテーション ファイルを表す Presentation オブジェクトのインスタンスを作成します 
    using (Presentation pres = new Presentation())
    {
        AddVideoFromYouTube(pres, "Tj75Arhq5ho");
        pres.Save("AddVideoFrameFromWebSource_out.pptx", SaveFormat.Pptx);
    }
}

private static void AddVideoFromYouTube(Presentation pres, string videoId)
{
    // VideoFrame を追加します
    IVideoFrame videoFrame = pres.Slides[0].Shapes.AddVideoFrame(10, 10, 427, 240, "https://www.youtube.com/embed/" + videoId);
    videoFrame.PlayMode = VideoPlayModePreset.Auto;

    // サムネイルを読み込みます
    using (WebClient client = new WebClient())
    {
        string thumbnailUri = "http://img.youtube.com/vi/" + videoId + "/hqdefault.jpg";
        videoFrame.PictureFormat.Picture.Image = pres.Images.AddImage(client.DownloadData(thumbnailUri));
    }
}

ビデオキャプションの管理

Aspose.Slides は、PowerPoint プレゼンテーション内のビデオフレームのクローズドキャプションを管理できるようにします。キャプションは WebVTT 形式で保存され、IVideoFrame.CaptionTracks プロパティを介して取得できます。

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

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

Presentation クラスのインスタンスを作成します。
プレゼンテーションにビデオを追加します。
スライドに IVideoFrame オブジェクトを追加します。
CaptionTracks コレクションを使用して WebVTT キャプショントラックを追加します。
変更したプレゼンテーションを保存します。

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

using (Presentation presentation = new Presentation())
{
    byte[] videoData = File.ReadAllBytes("video.mp4");
    IVideo video = presentation.Videos.AddVideo(videoData);

    ISlide slide = presentation.Slides[0];
    IVideoFrame videoFrame = slide.Shapes.AddVideoFrame(0, 0, 100, 100, video);

    // WebVTT ファイルから新しいキャプショントラックを追加します。
    videoFrame.CaptionTracks.Add("English", "track.vtt");

    presentation.Save("video_with_captions.pptx", SaveFormat.Pptx);
}

ICaptionsCollection インターフェイスは、ストリームからキャプションを追加できるオーバーロードも提供します。

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

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

ビデオを含むプレゼンテーションをロードします。
対象の IVideoFrame オブジェクトを見つけます。
CaptionTracks コレクションを列挙します。
各キャプショントラックを .vtt ファイルとして保存します。

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

using (Presentation presentation = new Presentation("video_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    foreach (IShape shape in slide.Shapes)
    {
        if (shape is IVideoFrame videoFrame)
        {
            foreach (ICaptions captionTrack in videoFrame.CaptionTracks)
            {
                // キャプショントラックを WebVTT ファイルに保存します。
                string filePath = $"{captionTrack.CaptionId}.vtt";
                File.WriteAllBytes(filePath, captionTrack.BinaryData);
            }
        }
    }
}

各 ICaptions オブジェクトは、キャプション識別子、ラベル、バイナリデータ、UTF-8 文字列としてのキャプションテキストを公開します。

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

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

ビデオを含むプレゼンテーションをロードします。
対象の IVideoFrame オブジェクトを取得します。
CaptionTracks コレクションからキャプショントラックを削除します。
変更したプレゼンテーションを保存します。

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

using (Presentation presentation = new Presentation("video_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IVideoFrame videoFrame = slide.Shapes[0] as IVideoFrame;

    // ビデオフレームからすべてのキャプションを削除します。
    videoFrame.CaptionTracks.Clear();

    presentation.Save("video_without_captions.pptx", SaveFormat.Pptx);
}

1 つのキャプショントラックだけを削除したい場合は、Clear の代わりに Remove または RemoveAt メソッドを使用してください。

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

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

ビデオを含むプレゼンテーションをロードするために Presentation クラスのインスタンスを作成します。
すべての ISlide オブジェクトを列挙します。
すべての IShape オブジェクトを列挙し、VideoFrame を探します。
ビデオをディスクに保存します。

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

// プレゼンテーション ファイルを表す Presentation オブジェクトのインスタンスを作成します 
Presentation presentation = new Presentation("Video.pptx");

// スライドを反復処理します
foreach (ISlide slide in presentation.Slides)
{
    // シェイプを反復処理します
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // ビデオを含む VideoFrame が見つかったらビデオをディスクに保存します
        if (shape is VideoFrame)
        {
            IVideoFrame vf = shape as IVideoFrame;
            String type = vf.EmbeddedVideo.ContentType;
            int ss = type.LastIndexOf('/');
            type = type.Remove(0, type.LastIndexOf('/') + 1);
            Byte[] buffer = vf.EmbeddedVideo.BinaryData;
            using (FileStream stream = new FileStream("NewVideo_out." + type, FileMode.Create, FileAccess.Write, FileShare.Read))
            {                                                     
                stream.Write(buffer, 0, buffer.Length);
            }
        }
    }
}

FAQ

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

再生モード（自動またはクリック時）とループ設定を制御できます。これらのオプションは VideoFrame オブジェクトのプロパティで利用できます。

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

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

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

はい。フレーム内の video content を入れ替えることで、形状のジオメトリを保持したままビデオを更新できます。これは既存レイアウトのメディアを更新する一般的なシナリオです。

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

はい。埋め込みビデオには content type が設定されており、読み取ってディスクに保存する際などに利用できます。