مدیریت فریمهای ویدئویی در ارائهها با استفاده از 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 از ویدئوهای آنلاین در ارائهها پشتیبانی میکند. اگر ویدئویی که میخواهید استفاده کنید به صورت آنلاین در دسترس باشد (مثلاً در 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 به شما امکان میدهد تا بخشی از ویدئو که پخش میشود را با تنظیم مقادیر trim-from-start و trim-from-end از طریق IVideoFrame::set_TrimFromStart و IVideoFrame::set_TrimFromEnd کنترل کنید. هر دو مقدار بر حسب میلیثانیه مشخص میشوند و تعیین میکنند چه مقدار زمان از ابتدای و انتهای ویدئو بهطور متوالی حذف شود. این تنظیمات تنظیمات پخش ویدئو در ارائه را تغییر میدهند؛ آنها ویدئوی جاسازیشده را قطع یا بهصورت دیگری تغییر نمیدهند.
تنظیمات برش
برای ایجاد یک فریم ویدئویی و تنظیمات برش آن:
- یک نمونه از کلاس Presentation ایجاد کنید.
- یک شیء IVideo را به ارائه اضافه کنید.
- یک شیء IVideoFrame را به یک اسلاید اضافه کنید.
- مقادیر trim-from-start و trim-from-end را از طریق IVideoFrame::set_TrimFromStart و IVideoFrame::set_TrimFromEnd تنظیم کنید.
- ارائه اصلاحشده را ذخیره کنید.
مثال کد زیر 2.5 ثانیه اول و یک ثانیه آخر یک ویدئوی جاسازیشده را در طول پخش نادیده میگیرد:
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(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();
خواندن تنظیمات برش
برای بررسی تنظیمات برش موجود، یک ارائه را بارگذاری کنید، شیء IVideoFrame را میان اشکال اسلاید اول پیدا کنید، و مقادیر را از طریق IVideoFrame::get_TrimFromStart و IVideoFrame::get_TrimFromEnd بخوانید.
مثال کد زیر اولین فریم ویدئویی را در اسلاید اول پیدا کرده و تنظیمات برش آن را بر حسب میلیثانیه گزارش میدهد:
auto presentation = MakeObject<Presentation>(u"video_with_trim.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : slide->get_Shapes())
{
if (ObjectExt::Is<IVideoFrame>(shape))
{
auto videoFrame = ExplicitCast<IVideoFrame>(shape);
auto trimFromStart = videoFrame->get_TrimFromStart();
auto trimFromEnd = videoFrame->get_TrimFromEnd();
Console::WriteLine(u"Trim from start: {0} ms", trimFromStart);
Console::WriteLine(u"Trim from end: {0} ms", trimFromEnd);
break;
}
}
presentation->Dispose();
مدیریت زیرنویسهای ویدئویی
Aspose.Slides به شما امکان میدهد تا زیرنویسهای بسته برای فریمهای ویدئویی در ارائههای PowerPoint را مدیریت کنید. زیرنویسها در قالب WebVTT ذخیره میشوند و از طریق متد IVideoFrame::get_CaptionTracks در دسترس هستند.
افزودن زیرنویس به فریم ویدئویی
برای افزودن زیرنویس به فریم ویدئویی:
- یک نمونه از کلاس Presentation ایجاد کنید.
- یک ویدئو به ارائه اضافه کنید.
- یک شیء IVideoFrame را به یک اسلاید اضافه کنید.
- از ICaptionsCollection که توسط get_CaptionTracks بازگردانده میشود استفاده کنید تا یک ترک زیرنویس 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 همچنین یک overload فراهم میکند که به شما اجازه میدهد زیرنویسها را از یک جریان (stream) اضافه کنید.
استخراج زیرنویسها از فریم ویدئویی
برای استخراج زیرنویسها از فریم ویدئویی:
- ارائهای که شامل ویدئو است را بارگذاری کنید.
- شیء 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();
اگر فقط نیاز به حذف یک ترک زیرنویس دارید، بهجای Clear از متدهای Remove یا RemoveAt استفاده کنید.
استخراج ویدئو از اسلاید
علاوه بر افزودن ویدئو به اسلایدها، 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 را داخل فریم تعویض کنید در حالی که شمایل (shape) را حفظ میکنید؛ این یک سناریوی رایج برای بهروزرسانی رسانه در یک طرح موجود است.
آیا میتوان نوع محتوا (MIME) یک ویدئوی جاسازیشده را تعیین کرد؟
بله. یک ویدئوی جاسازیشده دارای یک content type است که میتوانید آن را بخوانید و استفاده کنید، برای مثال هنگام ذخیرهسازی آن بر روی دیسک.