C++ を使用したプレゼンテーションでのビデオ フレームの管理
イントロダクション
ビデオはアイデアを説明し、聴衆を引き付けるのに役立ちます。Aspose.Slides for C++ を使用すると、スライドにビデオフレームを追加し、再生設定を調整し、キャプションを管理し、埋め込まれたビデオデータを抽出できます。
PowerPoint はローカルビデオと、YouTube ビデオなどのオンラインビデオへのリンクをサポートしています。
ビデオデータとビデオフレームを表すために、Aspose.Slides は IVideo インターフェイス、IVideoFrame インターフェイス、およびその他の関連型を提供します。
埋め込みビデオフレームの作成
スライドに追加したいビデオ ファイルがローカルに保存されている場合、ビデオフレームを作成してプレゼンテーションにビデオを埋め込むことができます。
この例は、既存のプレゼンテーションの最初のスライドにローカルビデオを埋め込み、結果を保存します。フレームの座標とサイズはポイント単位です。ストリームは保存が完了するまで開いたままになります。これは、LoadingStreamBehavior::KeepLocked がプレゼンテーションが使用している間ロックを保持するためです。
#include <system/io/file.h>
#include <system/io/file_stream.h>
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoCollection.h>
#include <Export/SaveFormat.h>
#include <LoadingStreamBehavior.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto slide = presentation->get_Slide(0);
auto videoStream = File::OpenRead(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoStream, LoadingStreamBehavior::KeepLocked);
slide->get_Shapes()->AddVideoFrame(10, 10, 150, 250, video);
presentation->Save(u"embedded_video.pptx", SaveFormat::Pptx);
presentation->Dispose();
videoStream->Dispose();
ローカルビデオ パスを直接 AddVideoFrame に渡すこともできます。この例は、新しいプレゼンテーションの最初のスライドにビデオを埋め込みます。ビデオはプレゼンテーションが保存されるまでアクセス可能である必要があります。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <Export/SaveFormat.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
slide->get_Shapes()->AddVideoFrame(50, 150, 300, 150, u"video.avi");
presentation->Save(u"video_from_path.pptx", SaveFormat::Pptx);
presentation->Dispose();
Web ソースのビデオでビデオフレームを作成
Microsoft PowerPoint はプレゼンテーションでオンラインビデオをサポートしています。YouTube ビデオなどのオンラインビデオへのリンクを含むビデオフレームを作成できます。
この例は、YouTube ビデオのリンクとサムネイルを最初のスライドに追加します。別のビデオを使用するにはビデオ識別子を置き換えてください。set_PlayMode メソッドは自動再生を要求します。サムネイルのダウンロードとビデオの再生にはインターネット接続が必要です。プレゼンテーションビューアーもオンラインビデオ再生をサポートしている必要があります。
#include <net/web_client.h>
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <DOM/VideoPlayModePreset.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/ISlidesPicture.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
auto webClient = MakeObject<System::Net::WebClient>();
String videoId = u"aqz-KE-bpKQ";
auto videoUrl = String::Format(u"https://www.youtube.com/embed/{0}", videoId);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(10, 10, 427, 240, videoUrl);
videoFrame->set_PlayMode(VideoPlayModePreset::Auto);
auto thumbnailUrl = String::Format(u"https://img.youtube.com/vi/{0}/hqdefault.jpg", videoId);
auto thumbnailData = webClient->DownloadData(thumbnailUrl);
auto thumbnail = presentation->get_Images()->AddImage(thumbnailData);
videoFrame->get_PictureFormat()->get_Picture()->set_Image(thumbnail);
presentation->Save(u"online_video.pptx", SaveFormat::Pptx);
presentation->Dispose();
全画面モードでビデオを再生
トレーニング用プレゼンテーションでは、ソフトウェア デモを全画面モードで再生して、観客が詳細を見ることができます。set_FullScreenMode は true を受け取り、再生中にこの動作を有効にします。
この例はプレゼンテーションを開き、最初のスライド上の最初の IVideoFrame を見つけて全画面再生を有効にします。入力プレゼンテーションは、最初のスライドに既存のビデオフレームが少なくとも 1 つ含まれている必要があります。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"training.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
videoFrame->set_FullScreenMode(true);
break;
}
}
presentation->Save(u"full_screen_video.pptx", SaveFormat::Pptx);
presentation->Dispose();
全画面再生はビデオの表示方法を制御します。別に、set_PlayMode は自動開始かクリック開始かを制御し、set_PlayLoopMode は繰り返しの有無を制御します。開始動作を選択するには、VideoPlayModePreset::Auto or VideoPlayModePreset::OnClick に再生モードを設定します。この例は既存の開始設定とループ設定を保持します。
再生後にビデオを巻き戻す
トレーニング用プレゼンテーションでは、デモ ビデオを冒頭に戻すことで、プレゼンターが再び再生できるようにします。set_RewindVideo に true を渡すと、再生が終了した後にビデオを冒頭に戻します。
この例はプレゼンテーションを開き、最初のスライド上の最初の IVideoFrame を見つけて巻き戻しを有効にします。ループを無効にして再生が完了できるようにし、クリック開始に設定します。入力プレゼンテーションは、最初のスライドに既存のビデオフレームが少なくとも 1 つ含まれている必要があります。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
#include <DOM/VideoPlayModePreset.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
auto presentation = MakeObject<Presentation>(u"training.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
videoFrame->set_RewindVideo(true);
videoFrame->set_PlayLoopMode(false);
videoFrame->set_PlayMode(VideoPlayModePreset::OnClick);
break;
}
}
presentation->Save(u"rewind_video.pptx", SaveFormat::Pptx);
presentation->Dispose();
巻き戻しはビデオを再び開始せずに冒頭に戻します。対照的に、set_PlayLoopMode を有効にすると自動的に再生が繰り返されます。ビデオを最後まで再生させて再度再生できる状態にしたい場合はループを無効にしてください。set_PlayMode は自動開始かクリック開始かを個別に制御します。この例では VideoPlayModePreset::OnClick を使用し、プレゼンターが再生開始を制御できるようにしています。ループ設定の後に再生モードを設定してください。巻き戻しは set_FullScreenMode とは独立して機能します。
ビデオフレームをトリムする
IVideoFrame::set_TrimFromStart と IVideoFrame::set_TrimFromEnd を使用して、再生時にビデオの開始部または終了部の一部をスキップできます。両方の値はミリ秒単位です。トリミングは埋め込まれたビデオデータを変更せずに再生設定を変更します。
トリム設定の設定
この例はローカルビデオを埋め込み、再生時に最初の 2.5 秒と最後の 1 秒をスキップします。再生可能なセグメントが残るように、ビデオは 3.5 秒以上の長さが必要です。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
auto videoData = File::ReadAllBytes(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoData);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(50, 50, 640, 360, video);
videoFrame->set_TrimFromStart(2500.0f);
videoFrame->set_TrimFromEnd(1000.0f);
presentation->Save(u"video_with_trim.pptx", SaveFormat::Pptx);
presentation->Dispose();
トリム設定の取得
この例は最初のスライド上の最初のビデオフレームのトリム値(ミリ秒)を出力します。プレゼンテーションは少なくとも 1 つのスライドを含む必要があります。そのスライドにビデオフレームがない場合は何も出力されません。前の例は 2500 と 1000 の値を生成します。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
#include <system/console.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace System;
auto presentation = MakeObject<Presentation>(u"video_with_trim.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
Console::WriteLine(String::Format(u"Trim from start: {0} ms", videoFrame->get_TrimFromStart()));
Console::WriteLine(String::Format(u"Trim from end: {0} ms", videoFrame->get_TrimFromEnd()));
break;
}
}
presentation->Dispose();
ビデオキャプションの管理
Aspose.Slides は PowerPoint プレゼンテーション内のビデオフレームに対してクローズドキャプションを管理できる機能を提供します。キャプションは WebVTT 形式で保存され、IVideoFrame::get_CaptionTracks メソッドで取得できます。
ビデオフレームにキャプションを追加
この例はローカルビデオを埋め込み、English というラベルの WebVTT キャプショントラックを追加します。キャプションのタイムスタンプはビデオに合わせる必要があります。保存されたプレゼンテーションにはビデオとキャプションの両方が含まれます。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <DOM/ICaptionsCollection.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
auto videoData = File::ReadAllBytes(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoData);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(0, 0, 100, 100, video);
videoFrame->get_CaptionTracks()->Add(u"English", u"track.vtt");
presentation->Save(u"video_with_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();
ICaptionsCollection インターフェイスは、ストリームからキャプションを追加できるオーバーロードも提供します。
ビデオフレームからキャプションを抽出
この例は最初のスライド上のビデオフレームからすべてのキャプショントラックを個別の WebVTT ファイルとして保存します。連番が出力ファイルを区別します。コンソールには抽出されたトラック数が表示されます。プレゼンテーションは少なくとも 1 つのスライドを含む必要があります。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <system/io/file.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
#include <system/console.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/ICaptions.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);
auto trackCount = 0;
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
for (auto&& captionTrack : IterateOver(videoFrame->get_CaptionTracks()))
{
trackCount++;
auto outputPath = String::Format(u"captions_{0}.vtt", trackCount);
File::WriteAllBytes(outputPath, captionTrack->get_BinaryData());
}
}
}
Console::WriteLine(String::Format(u"Caption tracks extracted: {0}", trackCount));
presentation->Dispose();
各 ICaptions オブジェクトは、キャプション ID、ラベル、バイナリ データ、UTF-8 文字列としてのキャプションテキストを公開します。
ビデオフレームからキャプションを削除
この例は最初のスライド上の最初のシェイプ位置にあるビデオフレームからすべてのキャプションを削除し、結果を保存します。スライドとシェイプが存在し、シェイプがビデオフレームであることを前提としています。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <Export/SaveFormat.h>
#include <DOM/ICaptionsCollection.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
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 の代わりに Remove または RemoveAt メソッドを使用してください。
ビデオキャプションを検索
ICaptions::get_DataAsString はヘッダー、タイミング行、キャプションテキストを含む完全な WebVTT トラックを返します。話されたフレーズとそのタイムスタンプを見つけるには、メモリ内のキューを読み取ります。たとえば、スライド 2 の英語トラックは次のテキストを含む可能性があります:
WEBVTT Café tour
00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
この例は captioned_media.pptx を開き、各スライド上のトップレベルビデオフレームのキャプショントラックを IVideoFrame::get_CaptionTracks で読み取ります。プレーンテキストのキューでは、タイミング行に --> が含まれ、空行でキューが終了します。キャプションに “café” が含まれる場合、例はスライド番号、トラックラベル、元のタイミング行、完全なキャプションを出力します。検索は大文字と小文字を区別しません。
#include <DOM/Presentation.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/ICaptions.h>
#include <system/console.h>
#include <system/enumerator_adapter.h>
#include <system/io/string_reader.h>
#include <system/smart_ptr.h>
#include <system/string_comparison.h>
using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"captioned_media.pptx");
for (auto&& slide : IterateOver(presentation->get_Slides()))
{
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
auto videoFrame = AsCast<IVideoFrame>(shape);
if (!videoFrame)
continue;
for (auto&& track : IterateOver(videoFrame->get_CaptionTracks()))
{
auto reader = MakeObject<StringReader>(track->get_DataAsString());
for (auto timing = reader->ReadLine(); !timing.IsNull(); timing = reader->ReadLine())
{
if (!timing.Contains(u"-->"))
continue;
String caption;
for (auto line = reader->ReadLine(); !String::IsNullOrEmpty(line); line = reader->ReadLine())
{
if (!String::IsNullOrEmpty(caption))
caption += u"\n";
caption += line;
}
if (caption.IndexOf(u"caf\u00E9", StringComparison::OrdinalIgnoreCase) >= 0)
{
Console::WriteLine(String::Format(u"Slide {0} | {1} | {2}", slide->get_SlideNumber(), track->get_Label(), timing));
Console::WriteLine(caption);
}
}
}
}
}
presentation->Dispose();
“café” を検索するとサンプルトラックで 1 件の一致が得られます。検索はヘッダーをスキップし、出力でタイミング設定を保持します。
Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
スライドからビデオを抽出
ビデオをスライドに追加するだけでなく、Aspose.Slides はプレゼンテーションに埋め込まれたビデオを抽出する機能も提供します。
この例は各スライドから埋め込まれたビデオを個別の番号付きバイナリ ファイルとして抽出します。埋め込みデータがないリンクビデオはスキップされます。コンソールには各ビデオの MIME タイプと総数が表示されます。出力は汎用的な .bin 拡張子を使用します。必要に応じて報告されたメディアタイプに合わせて変更してください。
#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/IShapeCollection.h>
#include <DOM/IVideoFrame.h>
#include <DOM/ISlideCollection.h>
#include <DOM/IVideo.h>
#include <system/io/file.h>
#include <system/enumerator_adapter.h>
#include <system/object_ext.h>
#include <system/console.h>
#include <system/smart_ptr.h>
using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;
auto presentation = MakeObject<Presentation>(u"presentation_with_videos.pptx");
auto videoCount = 0;
for (auto&& slide : IterateOver(presentation->get_Slides()))
{
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
auto video = videoFrame->get_EmbeddedVideo();
if (video == nullptr)
{
Console::WriteLine(u"Skipped a linked video: no embedded data is available.");
continue;
}
videoCount++;
auto outputPath = String::Format(u"extracted_video_{0}.bin", videoCount);
File::WriteAllBytes(outputPath, video->get_BinaryData());
Console::WriteLine(String::Format(u"Video {0}: {1}", videoCount, video->get_ContentType()));
}
}
}
Console::WriteLine(String::Format(u"Embedded videos extracted: {0}", videoCount));
presentation->Dispose();
FAQ
ビデオフレームの再生パラメータで変更できるものは何ですか?
playback mode(自動またはクリック時)と looping を制御できます。これらのオプションは VideoFrame オブジェクトのメソッドで利用可能です。
ビデオを追加すると PPTX ファイルのサイズは増えますか?
はい。ローカルビデオを埋め込むと、バイナリ データがドキュメントに含まれるため、プレゼンテーションのサイズはビデオ ファイルのサイズに比例して増加します。オンラインビデオへのリンクとサムネイルを追加する場合、プレゼンテーションはビデオデータではなくリンクとプレビュー画像を保存するため、サイズ増加は通常小さくなります。
既存のビデオフレーム内のビデオを位置やサイズを変更せずに差し替えることはできますか?
はい。フレーム内の video content を入れ替えることで、シェイプのジオメトリを保持したままビデオを更新できます。これは既存レイアウトのメディアを更新する一般的なシナリオです。
埋め込みビデオのコンテンツタイプ(MIME)を取得できますか?
はい。埋め込まれたビデオには content type があり、これを読み取って例としてディスクに保存する際などに使用できます。