Hantera videoramar i presentationer med C++

Vad den här sidan handlar om

Lär dig att programatiskt lägga till och extrahera videoramar i PowerPoint- och OpenDocument-bilder med Aspose.Slides för C++. Snabb instruktionsguide.

Introduktion

En välplacerad video i en presentation kan göra ditt budskap mer övertygande och öka engagemangsgraden hos din publik.

PowerPoint låter dig lägga till videor på en bild i en presentation på två sätt:

Lägg till eller bädda in en lokal video (lagrad på din dator)
Lägg till en online-video (från en webbkälla såsom YouTube).

För att du ska kunna lägga till videor (videoobjekt) i en presentation tillhandahåller Aspose.Slides IVideo-gränssnittet, IVideoFrame-gränssnittet och andra relevanta typer.

Skapa en inbäddad videoram

Om videofilen du vill lägga till på din bild är lagrad lokalt kan du skapa ett videoram för att bädda in videon i din presentation.

Skapa en instans av Presentation-klassen.
Hämta en bilds referens via dess index.
Lägg till ett IVideo-objekt och ange videofilens sökväg för att bädda in videon i presentationen.
Lägg till ett IVideoFrame-objekt för att skapa ett ram för videon.
Spara den ändrade presentationen.

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

// Laddar videon
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);

// Hämtar den första bilden och lägger till ett videoram
pres->get_Slide(0)->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 150.0f, 250.0f, video);

// Sparar presentationen till disk
pres->Save(u"pres-with-video.pptx", SaveFormat::Pptx);

Alternativt kan du lägga till en video genom att ange dess filsökväg direkt till metoden 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");

Skapa ett videoram med video från en webbkälla

Nyare versioner av Microsoft PowerPoint stödjer online‑videor i presentationer. Om videon du vill använda är tillgänglig online (t.ex. på YouTube) kan du lägga till den i din presentation via dess webblänk.

Skapa en instans av Presentation-klassen
Hämta en bilds referens via dess index.
Lägg till ett IVideo-objekt och ange länken till videon.
Ange en miniatyrbild för videoramen.
Spara presentationen.

// Sökvägen till dokumentkatalogen.
const String outPath = u"../out/AddVideoFrameFromWebSource_out.pptx";
const String filePath = u"../templates/video1.avi";

// Skapar ett Presentation-objekt som representerar en presentationsfil
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// Hämtar den första bilden
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// Lägger till ett videoram 
System::SharedPtr<IVideoFrame> vf = slide->get_Shapes()->AddVideoFrame(10, 10, 427, 240,u"https://www.youtube.com/embed/Tj75Arhq5ho");

// Ställer in uppspelningsläge och volym för videon
vf->set_PlayMode(VideoPlayModePreset::Auto);

//Sparar presentationen till disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Trimma ett videoram

Aspose.Slides låter dig kontrollera vilken del av en video som spelas genom att ställa in värdena trim-from-start och trim-from-end via IVideoFrame::set_TrimFromStart och IVideoFrame::set_TrimFromEnd. Båda värdena anges i millisekunder och definierar hur mycket tid som hoppas över i början respektive slutet av videon. Dessa inställningar ändrar videouppspelningsinställningarna i presentationen; de skär inte eller ändrar på den inbäddade videons binära data.

Ange triminställningar

För att skapa ett videoram och ange dess triminställningar:

Skapa en instans av Presentation-klassen.
Lägg till ett IVideo-objekt i presentationen.
Lägg till ett IVideoFrame-objekt till en bild.
Ange värdena trim-from-start och trim-from-end via IVideoFrame::set_TrimFromStart och IVideoFrame::set_TrimFromEnd.
Spara den ändrade presentationen.

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();

Läs triminställningar

För att inspektera befintliga triminställningar, ladda en presentation, hitta ett IVideoFrame-objekt bland formerna på den första bilden och läs värdena via IVideoFrame::get_TrimFromStart och 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();

Hantera undertexter för video

Aspose.Slides låter dig hantera stängda undertexter för videoramar i PowerPoint‑presentationer. Undertexterna lagras i WebVTT‑format och exponeras via metoden IVideoFrame::get_CaptionTracks.

Lägg till undertexter i ett videoram

För att lägga till undertexter i ett videoram:

Skapa en instans av Presentation-klassen.
Lägg till en video i presentationen.
Lägg till ett IVideoFrame-objekt till en bild.
Använd ICaptionsCollection som returneras av get_CaptionTracks för att lägga till ett WebVTT‑undertextspår.
Spara den ändrade presentationen.

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

// Lägger till ett nytt undertextspår från en WebVTT-fil.
videoFrame->get_CaptionTracks()->Add(u"English", u"track.vtt");

presentation->Save(u"video_with_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

ICaptionsCollection‑gränssnittet tillhandahåller även en överlagring som låter dig lägga till undertexter från en ström.

Extrahera undertexter från ett videoram

För att extrahera undertexter från ett videoram:

Ladda presentationen som innehåller videon.
Hitta mål‑IVideoFrame-objektet.
Iterera genom undertextspåren som returneras av get_CaptionTracks.
Spara varje undertextspår till en .vtt‑fil.

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())
        {
            // Sparar undertextspåret till en WebVTT-fil.
            auto filePath = captionTrack->get_CaptionId().ToString() + u".vtt";
            File::WriteAllBytes(filePath, captionTrack->get_BinaryData());
        }
    }
}

presentation->Dispose();

Varje ICaptions-objekt exponerar undertextens identifierare, etikett, binärdata och undertextdata som en UTF‑8‑sträng.

Ta bort undertexter från ett videoram

För att ta bort undertexter från ett videoram:

Ladda presentationen som innehåller videon.
Hämta mål‑IVideoFrame-objektet.
Ta bort undertextspår från samlingen som returneras av get_CaptionTracks.
Spara den ändrade presentationen.

auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);
auto videoFrame = ExplicitCast<IVideoFrame>(slide->get_Shape(0));

// Tar bort alla undertexter från videoramen.
videoFrame->get_CaptionTracks()->Clear();

presentation->Save(u"video_without_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

Om du bara behöver ta bort ett enskilt undertextspår, använd metoderna Remove eller RemoveAt istället för Clear.

Extrahera video från en bild

Förutom att lägga till videor på bilder låter Aspose.Slides dig extrahera videor som är inbäddade i presentationer.

Skapa en instans av Presentation-klassen för att ladda presentationen som innehåller videon.
Iterera genom alla ISlide‑objekt.
Iterera genom alla IShape‑objekt för att hitta en VideoFrame.
Spara videon till disk.

// Sökvägen till dokumentkatalogen.
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());
        }
    }
}

FAQ

Vilka videouppspelningsparametrar kan ändras för ett VideoFrame?

Du kan styra uppspelningsläge (auto eller vid klick) och loopning. Dessa alternativ finns tillgängliga via egenskaperna för VideoFrame.

Påverkar tillägg av en video PPTX‑filens storlek?

Ja. När du bäddar in en lokal video inkluderas den binära datan i dokumentet, så presentationens storlek ökar proportionellt mot filens storlek. När du lägger till en online‑video, bäddas en länk och en miniatyrbild in, så storleksökningen blir mindre.

Kan jag ersätta videon i ett befintligt VideoFrame utan att ändra dess position och storlek?

Ja. Du kan byta ut videoinnehållet i ramen samtidigt som du bevarar figurens geometri; detta är ett vanligt scenario för att uppdatera media i en befintlig layout.

Kan innehållstypen (MIME) för en inbäddad video bestämmas?

Ja. En inbäddad video har en innehållstyp som du kan läsa och använda, till exempel när du sparar den till disk.

Hantera bildtransformeringseffekter i presentationer med C++