Video‑frames beheren in presentaties met C++
Inleiding
Video’s kunnen helpen ideeën uit te leggen en een publiek te boeien. Aspose.Slides for C++ stelt u in staat video‑frames aan dia’s toe te voegen, afspeelinstellingen aan te passen, ondertitels te beheren en ingesloten videogegevens te extraheren.
PowerPoint ondersteunt lokale video’s en koppelingen naar online video’s, zoals YouTube‑video’s.
Om video‑gegevens en video‑frames weer te geven, biedt Aspose.Slides de IVideo interface, IVideoFrame interface, en andere relevante typen.
Maak een ingebed video‑frame
Als het videobestand dat u aan uw dia wilt toevoegen lokaal is opgeslagen, kunt u een video‑frame maken om de video in uw presentatie in te sluiten.
Dit voorbeeld voegt een lokale video in op de eerste dia van een bestaande presentatie en slaat het resultaat op. Frame‑coördinaten en afmetingen zijn in points. De stream blijft open tot het opslaan is voltooid omdat LoadingStreamBehavior::KeepLocked deze vergrendeld houdt terwijl de presentatie deze gebruikt.
#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();
U kunt ook een lokaal video‑pad rechtstreeks doorgeven aan AddVideoFrame. Dit voorbeeld voegt de video in op de eerste dia van een nieuwe presentatie. De video moet toegankelijk blijven tot de presentatie is opgeslagen.
#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();
Maak een video‑frame met video van een webbron
Microsoft PowerPoint ondersteunt online video’s in presentaties. U kunt een video‑frame maken dat naar een online video koppelt, zoals een YouTube‑video.
Dit voorbeeld voegt een YouTube‑videokoppeling en miniatuur toe aan de eerste dia. Vervang de video‑identifier om een andere video te gebruiken. De set_PlayMode‑methode vraagt om automatische afspelen. Het downloaden van de miniatuur en het afspelen van de video vereisen internettoegang. De presentatieweergave moet ook online video‑afspelen ondersteunen.
#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();
Speel een video af in volledig‑scherm modus
In een trainingspresentatie kunt u een software‑demo afspelen in volledig‑scherm modus zodat het publiek de details kan zien. set_FullScreenMode accepteert true om dit gedrag tijdens het afspelen in te schakelen.
Dit voorbeeld opent een presentatie, zoekt het eerste IVideoFrame op de eerste dia, en schakelt volledig‑scherm afspelen in. De invoerpresentatie moet minstens één dia bevatten met een bestaand video‑frame op de eerste dia.
#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();
Volledig‑scherm afspelen bepaalt hoe de video wordt weergegeven. Onafhankelijk daarvan regelt set_PlayMode of deze automatisch of bij klik start, en set_PlayLoopMode of deze herhaalt. Om het startgedrag te kiezen, stelt u de afspeelmodus in op VideoPlayModePreset::Auto of VideoPlayModePreset::OnClick. Het voorbeeld behoudt de bestaande start‑ en lussinstellingen.
Terugspoelen van een video na afspelen
In een trainingspresentatie maakt het terugspoelen van een demonstratie‑video naar het begin deze weer klaar voor de presentator om opnieuw af te spelen. Roep set_RewindVideo aan met true om de video na afloop van het afspelen naar het begin te retourneren.
Dit voorbeeld opent een presentatie, zoekt het eerste IVideoFrame op de eerste dia, en schakelt terugspoelen in. Het schakelt lussen uit zodat het afspelen kan eindigen en stelt afspelen in om op klik te starten. De invoerpresentatie moet minstens één dia bevatten met een bestaand video‑frame op de eerste dia.
#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();
Terugspoelen zet de video terug naar het begin zonder deze opnieuw te starten. Daarentegen laat het inschakelen van set_PlayLoopMode de afspeelcyclus automatisch herhalen. Houd lussen uitgeschakeld wanneer u wilt dat de video eindigt en klaar blijft om opnieuw afgespeeld te worden. set_PlayMode regelt onafhankelijk of het automatisch of bij klik start; dit voorbeeld gebruikt VideoPlayModePreset::OnClick zodat de presentator bepaalt wanneer het afspelen begint. Stel de afspeelmodus in na de lusinstelling, zoals in het voorbeeld getoond. Terugspoelen werkt onafhankelijk van set_FullScreenMode.
Trimmen van een video‑frame
Gebruik IVideoFrame::set_TrimFromStart en IVideoFrame::set_TrimFromEnd om bij het afspelen een deel aan het begin of einde van een video over te slaan. Beide waarden zijn in milliseconden. Trimmen wijzigt afspeelinstellingen zonder de ingesloten videogegevens te wijzigen.
Triminstellingen instellen
Dit voorbeeld voegt een lokale video in en slaat de eerste 2,5 seconde en de laatste seconde over tijdens het afspelen. Gebruik een video die langer is dan 3,5 seconde zodat er een afspeelbaar segment overblijft.
#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();
Triminstellingen lezen
Dit voorbeeld print de trim‑waarden van het eerste video‑frame op de eerste dia in milliseconden. De presentatie moet minstens één dia bevatten. Als die dia geen video‑frame heeft, wordt er niets afgedrukt. Het voorgaande voorbeeld levert waarden van 2500 en 1000 op.
#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();
Beheer video‑ondertitels
Aspose.Slides stelt u in staat gesloten ondertitels voor video‑frames in PowerPoint‑presentaties te beheren. Ondertitels worden opgeslagen in WebVTT‑formaat en toegankelijk gemaakt via de IVideoFrame::get_CaptionTracks‑methode.
Ondertitels toevoegen aan een video‑frame
Dit voorbeeld voegt een lokale video in en voegt een WebVTT‑ondertiteltrack met het label English toe. De tijdstempels van de ondertitels moeten overeenkomen met de video. De opgeslagen presentatie bevat zowel de video als de ondertitels.
#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();
De ICaptionsCollection interface biedt ook een overload die u toestaat ondertitels vanuit een stream toe te voegen.
Ondertitels extraheren uit een video‑frame
Dit voorbeeld slaat alle ondertiteltracks van video‑frames op de eerste dia op als afzonderlijke WebVTT‑bestanden. Sequentiële nummers houden de uitvoerbestanden verschillend. De console meldt het aantal geëxtraheerde tracks. De presentatie moet minstens één dia bevatten.
#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();
Elk ICaptions object geeft de ondertitel‑identifier, het label, binaire data en ondertiteltekst weer als een UTF‑8‑string.
Ondertitels verwijderen uit een video‑frame
Dit voorbeeld verwijdert alle ondertitels van het video‑frame op de eerste vormpositie op de eerste dia en slaat het resultaat op. Het gaat ervan uit dat de dia en vorm bestaan en dat de vorm een video‑frame is.
#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();
Als u slechts één ondertiteltrack moet verwijderen, gebruik dan de Remove of RemoveAt methoden in plaats van Clear .
Zoek video‑ondertitels
ICaptions::get_DataAsString retourneert de volledige WebVTT‑track, inclusief de header, tijdsregels en ondertiteltekst. Om een uitgesproken frase en de bijbehorende tijdstempel te vinden, leest u de cues in het geheugen. Bijvoorbeeld, een Engelse track op dia 2 kan de volgende tekst bevatten:
WEBVTT Café tour
00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
Het voorbeeld opent captioned_media.pptx en leest de ondertiteltracks van elk top‑level video‑frame op elke dia met behulp van IVideoFrame::get_CaptionTracks. In een platte‑tekst cue bevat de tijdslijn --> en een lege regel beëindigt de cue. Wanneer de ondertitel “café” bevat, print het voorbeeld het dia‑nummer, track‑label, originele tijdslijn en volledige ondertitel. De zoekopdracht negeert hoofdlettergebruik.
#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();
Zoeken naar “café” levert één overeenkomst op voor de voorbeeldtrack. De zoekopdracht slaat de header over en behoudt de tijdinstelling in de uitvoer.
Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.
Video extraheren uit een dia
Naast het toevoegen van video’s aan dia’s, stelt Aspose.Slides u in staat video’s die in presentaties zijn ingesloten te extraheren.
Dit voorbeeld extraheert ingesloten video’s van elke dia naar afzonderlijke, genummerde binaire bestanden. Gelinkte video’s worden overgeslagen omdat ze geen ingesloten data hebben. De console drukt het MIME‑type van elke video en het totale aantal af. Output gebruikt de generieke .bin extensie; wijzig deze om overeen te komen met het gerapporteerde mediatype indien nodig.
#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();
Veelgestelde vragen
Welke videoweergave‑parameters kunnen voor een video‑frame worden aangepast?
U kunt de playback mode (auto of bij klik) en looping regelen. Deze opties zijn beschikbaar via de methoden van het VideoFrame‑object.
Heeft het toevoegen van een video invloed op de grootte van het PPTX‑bestand?
Ja. Wanneer u een lokale video insluit, wordt de binaire data opgenomen in het document, waardoor de presentatiegrootte evenredig met de bestandsgrootte toeneemt. Wanneer u koppelt naar een online video en een miniatuur toevoegt, slaat de presentatie de koppeling en het voorbeeldbeeld op in plaats van de videogegevens, waardoor de omvangstoename doorgaans kleiner is.
Kan ik de video in een bestaand video‑frame vervangen zonder positie en grootte te wijzigen?
Ja. U kunt de video content in het frame uitwisselen terwijl u de geometrie van de vorm behoudt; dit is een veelvoorkomend scenario om media in een bestaande lay‑out bij te werken.
Kan het contenttype (MIME) van een ingesloten video worden bepaald?
Ja. Een ingesloten video heeft een content type dat u kunt lezen en gebruiken, bijvoorbeeld bij het opslaan op schijf.