Hantera videoram i presentationer i .NET

Introduktion

Video kan hjälpa till att förklara idéer och engagera en publik. Aspose.Slides för .NET låter dig lägga till video­ramar på bilder, justera uppspelningsinställningar, hantera undertexter och extrahera inbäddade videodata.

PowerPoint stödjer lokala videor och länkar till online‑videor, såsom YouTube‑videor.

För att representera videodata och video­ramar tillhandahåller Aspose.Slides gränssnitten IVideo och IVideoFrame samt andra relevanta typer.

Skapa en inbäddad video­ram

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

Det här exemplet bäddar in en lokal video på den första bilden i en befintlig presentation och sparar resultatet. Ramens koordinater och dimensioner är i punkter. Strömmen förblir öppen tills sparandet är slutfört eftersom LoadingStreamBehavior.KeepLocked låser den medan presentationen använder den.

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var slide = presentation.Slides[0];

using var videoStream = File.OpenRead("video.mp4");
var video = presentation.Videos.AddVideo(videoStream, LoadingStreamBehavior.KeepLocked);
slide.Shapes.AddVideoFrame(10, 10, 150, 250, video);

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

Du kan också skicka en lokal videoväg direkt till AddVideoFrame. Detta exempel bäddar in videon på den första bilden i en ny presentation. Videon måste förbli åtkomlig tills presentationen har sparats.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

slide.Shapes.AddVideoFrame(50, 150, 300, 150, "video.avi");

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

Ställ in videovolym exakt

I Aspose.Slides för .NET 26.11 eller senare sätter IVideoFrame.VolumeValue en flyttalspostpercentage från 0 till 100. Använd den när Volume‑förinställningarna är för grova. Till exempel begär 75.5f 75,5 % volym.

Det här exemplet kräver Aspose.Slides för .NET 26.11 eller senare samt en lokal video.mp4. Det bäddar in videon, initierar uppspelning explicit, sparar presentationen och läser tillbaka den lagrade procentsatsen.

using System;
using System.IO;
using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Export;

var volume = 75.5f;
if (float.IsNaN(volume) || float.IsInfinity(volume) || volume < 0 || volume > 100)
{
    Console.WriteLine("Use a finite volume from 0 to 100.");
    return;
}

using (var presentation = new Presentation())
{
    var videoBytes = File.ReadAllBytes("video.mp4");
    var video = presentation.Videos.AddVideo(videoBytes);
    var frame = presentation.Slides[0].Shapes.AddVideoFrame(50, 50, 320, 180, video);
    frame.PlayMode = VideoPlayModePreset.Auto;
    frame.VolumeValue = volume;
    presentation.Save("video-volume.pptx", SaveFormat.Pptx);
}

using var saved = new Presentation("video-volume.pptx");
var savedFrame = saved.Slides[0].Shapes.OfType<IVideoFrame>().First();
Console.WriteLine(savedFrame.VolumeValue);

Validera inmatningen själv; förlita dig inte på att settern förkastar värden utanför det dokumenterade intervallet. Förinställningarna Låg, Medium och Hög motsvarar 20, 50 respektive 80 i 26.11. Att ange en förinställning kan ersätta en tidigare procentsats, så tilldela procentsatsen sist när du behöver ett exakt värde. Använd AudioVolumeMode.Mute för den explicita tyst‑inställningen; ett numeriskt nollvärde och förinställnings‑enum är inte utbytbara tillstånd.

Ställ explicit in PlayMode när du även konfigurerar en länkad video, och håll dess mediafil tillgänglig för betraktaren. Att spara och öppna igen verifierar den lagrade inställningen; faktisk uppspelning och ljudnivå beror på presentationsspelaren och dess ljudinställningar.

Skapa en video­ram med video från en webbkälla

Microsoft PowerPoint stödjer online‑videor i presentationer. Du kan skapa en video­ram som länkar till en online‑video, till exempel en YouTube‑video.

Det här exemplet lägger till en YouTube‑videolänk och miniatyrbild på den första bilden. Byt ut video‑identifieraren för att använda en annan video. Inställningen PlayMode begär automatisk uppspelning. Nedladdning av miniatyren och uppspelning av videon kräver internetanslutning. presentationsvisaren måste också stödja online‑videouppspelning.

using System.Net.Http;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

using var httpClient = new HttpClient();

var videoId = "aqz-KE-bpKQ";
var videoUrl = $"https://www.youtube.com/embed/{videoId}";
var videoFrame = slide.Shapes.AddVideoFrame(10, 10, 427, 240, videoUrl);
videoFrame.PlayMode = VideoPlayModePreset.Auto;

var thumbnailUrl = $"https://img.youtube.com/vi/{videoId}/hqdefault.jpg";
var thumbnailData = httpClient.GetByteArrayAsync(thumbnailUrl).GetAwaiter().GetResult();
var thumbnail = presentation.Images.AddImage(thumbnailData);
videoFrame.PictureFormat.Picture.Image = thumbnail;

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

Spela upp en video i helskärmsläge

I en tränings‑presentation kan du spela upp en mjukvarudemonstration i helskärmsläge så att publiken kan se detaljerna. Ställ in FullScreenMode till true för att aktivera detta beteende under uppspelning.

Det här exemplet öppnar en presentation, hittar den första IVideoFrame på den första bilden och aktiverar helskärmsuppspelning. Inmatnings‑presentationen måste innehålla minst en bild med en befintlig video­ram på den första bilden.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("training.pptx");
var slide = presentation.Slides[0];

foreach (var shape in slide.Shapes)
{
    if (shape is IVideoFrame videoFrame)
    {
        videoFrame.FullScreenMode = true;
        break;
    }
}

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

Helskärmsuppspelning styr hur videon visas. Oberoende styr PlayMode om den startar automatiskt eller vid klick, och PlayLoopMode styr om den upprepas. För att välja startbeteendet, ställ in uppspelningsläget till VideoPlayModePreset.Auto eller VideoPlayModePreset.OnClick. Exemplet bevarar de befintliga start‑ och loop‑inställningarna.

Spola tillbaka en video efter uppspelning

I en tränings‑presentation gör återgång av en demonstrationsvideo till dess början den redo för presentatören att spela upp igen. Ställ in RewindVideo till true för att återföra videon till början efter att uppspelningen är klar.

Det här exemplet öppnar en presentation, hittar den första IVideoFrame på den första bilden och aktiverar spolning tillbaka. Det inaktiverar loopning så att uppspelningen kan avslutas och ställer in uppspelning att starta vid klick. Inmatnings‑presentationen måste innehålla minst en bild med en befintlig video­ram på den första bilden.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("training.pptx");
var slide = presentation.Slides[0];

foreach (var shape in slide.Shapes)
{
    if (shape is IVideoFrame videoFrame)
    {
        videoFrame.RewindVideo = true;
        videoFrame.PlayLoopMode = false;
        videoFrame.PlayMode = VideoPlayModePreset.OnClick;
        break;
    }
}

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

Spolning tillbaka returnerar videon till början utan att starta den igen. Däremot gör aktivering av PlayLoopMode att uppspelningen upprepas automatiskt. Håll loopning inaktiverad när du vill att videon ska färdigställas och vara redo att spelas igen. PlayMode styr oberoende om den startar automatiskt eller vid klick; detta exempel använder VideoPlayModePreset.OnClick så presentatören kontrollerar när uppspelningen startar. Ställ in uppspelningsläget efter loop‑inställningen, enligt exemplet. Spolning tillbaka fungerar oberoende av FullScreenMode.

Beskär en video­ram

Använd IVideoFrame.TrimFromStart och IVideoFrame.TrimFromEnd för att hoppa över en del av början eller slutet av en video under uppspelning. Båda värdena är i millisekunder. Beskärning ändrar uppspelningsinställningarna utan att ändra den inbäddade videodata.

Ange triminställningar

Det här exemplet bäddar in en lokal video och hoppar över de första 2,5 sekunderna samt den sista sekunden under uppspelning. Använd en video som är längre än 3,5 sekunder så att ett spelbart segment återstår.

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

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

var videoFrame = slide.Shapes.AddVideoFrame(50, 50, 640, 360, video);
videoFrame.TrimFromStart = 2500f;
videoFrame.TrimFromEnd = 1000f;

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

Läs triminställningar

Det här exemplet skriver ut trimvärdena för den första video­ramen på den första bilden i millisekunder. Presentationen måste innehålla minst en bild. Om den bilden saknar video­ram skrivs inget ut. Föregående exempel ger värdena 2500 och 1000.

using System;
using Aspose.Slides;

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)
    {
        Console.WriteLine($"Trim from start: {videoFrame.TrimFromStart} ms");
        Console.WriteLine($"Trim from end: {videoFrame.TrimFromEnd} ms");
        break;
    }
}

Hantera video­texter

Aspose.Slides låter dig hantera stängda undertexter för video­ramar i PowerPoint‑presentationer. Undertexterna lagras i WebVTT‑format och exponeras via egenskapen IVideoFrame.CaptionTracks.

Lägg till undertexter i en video­ram

Det här exemplet bäddar in en lokal video och lägger till ett WebVTT‑undertextspår märkt English. Undertextens tidsstämplar bör matcha videon. Den sparade presentationen innehåller både videon och dess undertexter.

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

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

var videoFrame = slide.Shapes.AddVideoFrame(0, 0, 100, 100, video);
videoFrame.CaptionTracks.Add("English", "track.vtt");

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

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

Extrahera undertexter från en video­ram

Det här exemplet sparar alla undertextspår från video­ramar på den första bilden som separata WebVTT‑filer. Sekventiella nummer håller utdatafilerna unika. Konsolen rapporterar antalet extraherade spår. Presentationen måste innehålla minst en bild.

using System;
using System.IO;
using Aspose.Slides;

using var presentation = new Presentation("video_with_captions.pptx");
var slide = presentation.Slides[0];

var trackCount = 0;
foreach (var shape in slide.Shapes)
{
    if (shape is IVideoFrame videoFrame)
    {
        foreach (var captionTrack in videoFrame.CaptionTracks)
        {
            trackCount++;
            var outputPath = $"captions_{trackCount}.vtt";
            File.WriteAllBytes(outputPath, captionTrack.BinaryData);
        }
    }
}

Console.WriteLine($"Caption tracks extracted: {trackCount}");

Varje ICaptions‑objekt exponerar undertextens identifierare, etikett, binära data och undertext som en UTF‑8‑sträng.

Ta bort undertexter från en video­ram

Det här exemplet tar bort alla undertexter från video­ramen på den första formens position på den första bilden och sparar resultatet. Det förutsätter att bilden och formen finns samt att formen är en video­ram.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("video_with_captions.pptx");
var slide = presentation.Slides[0];

var videoFrame = (IVideoFrame) slide.Shapes[0];
videoFrame.CaptionTracks.Clear();

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

Om du bara behöver ta bort ett 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.

Det här exemplet extraherar inbäddade videor från varje bild till separata, numrerade binära filer. Länkade videor hoppas över eftersom de saknar inbäddad data. Konsolen skriver ut varje videos MIME‑typ och det totala antalet. Utdata använder den generiska filändelsen .bin; ändra den för att matcha den rapporterade mediatypen om det behövs.

using System;
using System.IO;
using Aspose.Slides;

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

var videoCount = 0;
foreach (var slide in presentation.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IVideoFrame videoFrame)
        {
            var video = videoFrame.EmbeddedVideo;
            if (video == null)
            {
                Console.WriteLine("Skipped a linked video: no embedded data is available.");
                continue;
            }

            videoCount++;
            var outputPath = $"extracted_video_{videoCount}.bin";
            File.WriteAllBytes(outputPath, video.BinaryData);
            Console.WriteLine($"Video {videoCount}: {video.ContentType}");
        }
    }
}

Console.WriteLine($"Embedded videos extracted: {videoCount}");

Vanliga frågor

Vilka videouppspelningsparametrar kan ändras för en video­ram?

Du kan styra uppspelningsläget (auto eller vid klick) och loopning. Dessa alternativ finns tillgängliga via egenskaperna på objektet VideoFrame.

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

Ja. När du bäddar in en lokal video inkluderas binärdata i dokumentet, så presentationens storlek ökar i proportion till filens storlek. När du länkar till en online‑video och lägger till en miniatyr sparar presentationen länken och förhandsbilden istället för videodata, så storleksökningen är vanligtvis mindre.

Kan jag ersätta videon i en befintlig video­ram utan att ändra dess position och storlek?

Ja. Du kan byta ut videoinnehållet i ramen medan du bevarar formens 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.

Related features

Hantera bildtransformeringseffekter i presentationer med .NET