.NET でのプレゼンテーションにおける動画フレームの管理

このページの概要

Aspose.Slides for .NET を使用して、PowerPoint および OpenDocument スライドに動画フレームをプログラムで追加および抽出する方法を学びます。高速ハウツーガイド。

はじめに

プレゼンテーションに適切に配置された動画は、メッセージをより魅力的にし、聴衆とのエンゲージメントレベルを高めることができます。

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");
}

Web ソースからの動画フレームの作成

Microsoft の新しいバージョンの PowerPoint は、プレゼンテーションでオンライン動画をサポートしています。使用したい動画がオンライン（例: 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 では、IVideoFrame.TrimFromStart と IVideoFrame.TrimFromEnd を使用して、動画の開始位置と終了位置をミリ秒単位で設定することで、再生される部分を制御できます。これらの設定はプレゼンテーション内の動画再生設定を変更しますが、埋め込まれた動画のバイナリデータそのものをカットしたり変更したりはしません。

トリム設定の設定

動画フレームを作成し、トリム設定を行う手順:

Presentation クラスのインスタンスを作成します。
プレゼンテーションに IVideo オブジェクトを追加します。
スライドに IVideoFrame オブジェクトを追加します。
IVideoFrame.TrimFromStart と IVideoFrame.TrimFromEnd を使用して start と end の値を設定します。
変更したプレゼンテーションを保存します。

以下のコード例は、埋め込まれた動画の再生時に最初の 2.5 秒と最後の 1 秒をスキップする方法を示しています。

using var presentation = new Presentation();

var videoData = File.ReadAllBytes("video.mp4");
var video = presentation.Videos.AddVideo(videoData);

var slide = presentation.Slides[0];
var videoFrame = slide.Shapes.AddVideoFrame(50, 50, 640, 360, video);

videoFrame.TrimFromStart = 2500f;
videoFrame.TrimFromEnd = 1000f;

presentation.Save("video_with_trim.pptx", SaveFormat.Pptx);

トリム設定の取得

既存のトリム設定を確認するには、プレゼンテーションを読み込み、最初のスライド上のシェイプの中から IVideoFrame オブジェクトを見つけ、IVideoFrame.TrimFromStart と IVideoFrame.TrimFromEnd の値を取得します。

以下のコード例は、最初のスライド上の最初の動画フレームを取得し、ミリ秒単位のトリム設定をレポートします。

using var presentation = new Presentation("video_with_trim.pptx");

var slide = presentation.Slides[0];
foreach (var shape in slide.Shapes)
{
    if (shape is IVideoFrame videoFrame)
    {
        var trimFromStart = videoFrame.TrimFromStart;
        var trimFromEnd = videoFrame.TrimFromEnd;

        Console.WriteLine($"Trim from start: {trimFromStart} ms");
        Console.WriteLine($"Trim from end: {trimFromEnd} ms");

        break;
    }
}

動画キャプションの管理

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 で変更できる動画再生パラメータは何ですか？

playback mode（自動またはクリック時）と looping を VideoFrame オブジェクトのプロパティで制御できます。

動画を追加すると PPTX ファイルサイズは増加しますか？

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

既存の VideoFrame の位置やサイズを変更せずに動画だけを差し替えられますか？

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

埋め込まれた動画のコンテンツタイプ（MIME）を取得できますか？

はい。埋め込まれた動画には content type があり、読み取ってディスクに保存する際などに利用できます。

.NET を使用したプレゼンテーションでの画像変換エフェクトの管理