Video-Frames in Präsentationen in .NET verwalten

Worum es auf dieser Seite geht

Erfahren Sie, wie Sie programmatisch Video-Frames in PowerPoint- und OpenDocument-Folien mit Aspose.Slides für .NET hinzufügen und extrahieren. Schnelle Anleitung.

Einleitung

Ein gut platziertes Video in einer Präsentation kann Ihre Botschaft überzeugender machen und die Engagement‑Level Ihres Publikums erhöhen.

PowerPoint ermöglicht das Hinzufügen von Videos zu einer Folie in einer Präsentation auf zwei Arten:

Ein lokales Video hinzufügen oder einbetten (auf Ihrem Gerät gespeichert)
Ein Online‑Video hinzufügen (aus einer Webquelle wie YouTube).

Um Ihnen das Hinzufügen von Videos (Video‑Objekten) zu einer Präsentation zu ermöglichen, stellt Aspose.Slides die IVideo‑Schnittstelle, die IVideoFrame‑Schnittstelle und weitere relevante Typen bereit.

Ein eingebettetes Video‑Frame erstellen

Wenn die Videodatei, die Sie zu Ihrer Folie hinzufügen möchten, lokal gespeichert ist, können Sie einen Video‑Frame erstellen, um das Video in Ihre Präsentation einzubetten.

Erstellen Sie eine Instanz der Presentation Klasse.
Holen Sie sich die Referenz einer Folie über deren Index.
Fügen Sie ein IVideo-Objekt hinzu und übergeben Sie den Pfad zur Videodatei, um das Video in die Präsentation einzubetten.
Fügen Sie ein IVideoFrame-Objekt hinzu, um einen Frame für das Video zu erstellen.
Speichern Sie die geänderte Präsentation.

Dieser C#‑Code zeigt, wie Sie ein lokal gespeichertes Video zu einer Präsentation hinzufügen:

// Instanziiert die Presentation-Klasse
using (Presentation pres = new Presentation("pres.pptx"))
{
    // Lädt das Video
    using (FileStream fileStream = new FileStream("Wildlife.mp4", FileMode.Open, FileAccess.Read))
    {
        IVideo video = pres.Videos.AddVideo(fileStream, LoadingStreamBehavior.KeepLocked);
        
        // Holt die erste Folie und fügt einen Video-Frame hinzu
        pres.Slides[0].Shapes.AddVideoFrame(10, 10, 150, 250, video);
        
        // Speichert die Präsentation auf dem Datenträger
        pres.Save("pres-with-video.pptx", SaveFormat.Pptx);
    }
}

Alternativ können Sie ein Video hinzufügen, indem Sie seinen Dateipfad direkt an die AddVideoFrame‑Methode übergeben:

using (Presentation pres = new Presentation())
{
    ISlide sld = pres.Slides[0];
    IVideoFrame vf = sld.Shapes.AddVideoFrame(50, 150, 300, 150, "video1.avi");
}

Ein Video‑Frame mit Video aus einer Web‑Quelle erstellen

Neuere Versionen von Microsoft PowerPoint unterstützen Online‑Videos in Präsentationen. Wenn das Video, das Sie verwenden möchten, online verfügbar ist (z. B. auf YouTube), können Sie es über seinen Web‑Link zu Ihrer Präsentation hinzufügen.

Erstellen Sie eine Instanz der Presentation Klasse.
Holen Sie sich die Referenz einer Folie über deren Index.
Fügen Sie ein IVideo-Objekt hinzu und übergeben Sie den Link zum Video.
Legen Sie ein Vorschaubild für den Video‑Frame fest.
Speichern Sie die Präsentation.

Dieser C#‑Code zeigt, wie Sie ein Video aus dem Web zu einer Folie in einer PowerPoint‑Präsentation hinzufügen:

public static void Run()
{
    // Instanziert ein Presentation-Objekt, das eine Präsentationsdatei darstellt 
    using (Presentation pres = new Presentation())
    {
        AddVideoFromYouTube(pres, "Tj75Arhq5ho");
        pres.Save("AddVideoFrameFromWebSource_out.pptx", SaveFormat.Pptx);
    }
}

private static void AddVideoFromYouTube(Presentation pres, string videoId)
{
    // Fügt einen Video-Frame hinzu
    IVideoFrame videoFrame = pres.Slides[0].Shapes.AddVideoFrame(10, 10, 427, 240, "https://www.youtube.com/embed/" + videoId);
    videoFrame.PlayMode = VideoPlayModePreset.Auto;

    // Lädt das Vorschaubild
    using (WebClient client = new WebClient())
    {
        string thumbnailUri = "http://img.youtube.com/vi/" + videoId + "/hqdefault.jpg";
        videoFrame.PictureFormat.Picture.Image = pres.Images.AddImage(client.DownloadData(thumbnailUri));
    }
}

Trimmen eines Video‑Frames

Aspose.Slides ermöglicht die Steuerung, welcher Teil eines Videos abgespielt wird, indem die Werte trim‑from‑start und trim‑from‑end über IVideoFrame.TrimFromStart und IVideoFrame.TrimFromEnd festgelegt werden. Beide Werte werden in Millisekunden angegeben und bestimmen, wie viel Zeit am Anfang bzw. Ende des Videos übersprungen wird. Diese Einstellungen ändern die Wiedergabeparameter im Präsentations‑Dokument; sie schneiden das eingebettete Video‑Binärdaten nicht zu oder verändern sie anderweitig.

Trim‑Einstellungen festlegen

Um einen Video‑Frame zu erstellen und seine Trim‑Einstellungen festzulegen:

Erstellen Sie eine Instanz der Presentation‑Klasse.
Fügen Sie ein IVideo-Objekt zur Präsentation hinzu.
Fügen Sie ein IVideoFrame-Objekt zu einer Folie hinzu.
Setzen Sie die Werte trim‑from‑start und trim‑from‑end über IVideoFrame.TrimFromStart und IVideoFrame.TrimFromEnd.
Speichern Sie die geänderte Präsentation.

Das folgende Codebeispiel überspringt die ersten 2,5 Sekunden und die letzte Sekunde eines eingebetteten Videos während der Wiedergabe:

using var presentation = new Presentation();

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

var slide = presentation.Slides[0];
var videoFrame = slide.Shapes.AddVideoFrame(50, 50, 640, 360, video);

videoFrame.TrimFromStart = 2500f;
videoFrame.TrimFromEnd = 1000f;

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

Trim‑Einstellungen auslesen

Um vorhandene Trim‑Einstellungen zu prüfen, laden Sie eine Präsentation, finden ein IVideoFrame-Objekt unter den Formen auf der ersten Folie und lesen die Werte über IVideoFrame.TrimFromStart und IVideoFrame.TrimFromEnd aus.

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)
    {
        var trimFromStart = videoFrame.TrimFromStart;
        var trimFromEnd = videoFrame.TrimFromEnd;

        Console.WriteLine($"Trim from start: {trimFromStart} ms");
        Console.WriteLine($"Trim from end: {trimFromEnd} ms");

        break;
    }
}

Video‑Untertitel verwalten

Aspose.Slides ermöglicht das Verwalten von Closed‑Captions für Video‑Frames in PowerPoint‑Präsentationen. Untertitel werden im WebVTT‑Format gespeichert und über die Eigenschaft IVideoFrame.CaptionTracks bereitgestellt.

Untertitel zu einem Video‑Frame hinzufügen

Erstellen Sie eine Instanz der Presentation‑Klasse.
Fügen Sie ein Video zur Präsentation hinzu.
Fügen Sie ein IVideoFrame‑Objekt zu einer Folie hinzu.
Verwenden Sie die CaptionTracks‑Auflistung, um eine WebVTT‑Untertitelspur hinzuzufügen.
Speichern Sie die geänderte Präsentation.

Der folgende Code zeigt, wie Sie Untertitel zu einem Video‑Frame hinzufügen:

using (Presentation presentation = new Presentation())
{
    byte[] videoData = File.ReadAllBytes("video.mp4");
    IVideo video = presentation.Videos.AddVideo(videoData);

    ISlide slide = presentation.Slides[0];
    IVideoFrame videoFrame = slide.Shapes.AddVideoFrame(0, 0, 100, 100, video);

    // Fügt eine neue Untertitelspur aus einer WebVTT-Datei hinzu.
    videoFrame.CaptionTracks.Add("English", "track.vtt");

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

Die ICaptionsCollection‑Schnittstelle bietet zudem eine Überladung, mit der Sie Untertitel aus einem Stream hinzufügen können.

Untertitel aus einem Video‑Frame extrahieren

Laden Sie die Präsentation, die das Video enthält.
Suchen Sie das Ziel‑IVideoFrame‑Objekt.
Iterieren Sie durch die CaptionTracks‑Auflistung.
Speichern Sie jede Untertitelspur in einer .vtt‑Datei.

using (Presentation presentation = new Presentation("video_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    foreach (IShape shape in slide.Shapes)
    {
        if (shape is IVideoFrame videoFrame)
        {
            foreach (ICaptions captionTrack in videoFrame.CaptionTracks)
            {
                // Speichert die Untertitelspur in einer WebVTT-Datei.
                string filePath = $"{captionTrack.CaptionId}.vtt";
                File.WriteAllBytes(filePath, captionTrack.BinaryData);
            }
        }
    }
}

Jedes ICaptions‑Objekt stellt die Untertitel‑ID, das Label, die Binärdaten und den Untertiteltext als UTF‑8‑String bereit.

Untertitel aus einem Video‑Frame entfernen

Laden Sie die Präsentation, die das Video enthält.
Holen Sie das Ziel‑IVideoFrame‑Objekt.
Entfernen Sie Untertitelspuren aus der CaptionTracks‑Auflistung.
Speichern Sie die geänderte Präsentation.

using (Presentation presentation = new Presentation("video_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IVideoFrame videoFrame = slide.Shapes[0] as IVideoFrame;

    // Entfernt alle Untertitel vom Video-Frame.
    videoFrame.CaptionTracks.Clear();

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

Wenn Sie nur eine Untertitelspur entfernen möchten, verwenden Sie die Remove‑ oder RemoveAt‑Methoden anstelle von Clear.

Video aus einer Folie extrahieren

Neben dem Hinzufügen von Videos zu Folien ermöglicht Aspose.Slides das Extrahieren von in Präsentationen eingebetteten Videos.

Erstellen Sie eine Instanz der Presentation‑Klasse, um die Präsentation zu laden, die das Video enthält.
Iterieren Sie durch alle ISlide‑Objekte.
Iterieren Sie durch alle IShape‑Objekte, um ein VideoFrame zu finden.
Speichern Sie das Video auf dem Datenträger.

// Instanziert ein Presentation-Objekt, das eine Präsentationsdatei darstellt
Presentation presentation = new Presentation("Video.pptx");

// Durchläuft die Folien
foreach (ISlide slide in presentation.Slides)
{
    // Durchläuft die Formen
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // Speichert das Video auf dem Datenträger, sobald ein VideoFrame, das das Video enthält, gefunden wird
        if (shape is VideoFrame)
        {
            IVideoFrame vf = shape as IVideoFrame;
            String type = vf.EmbeddedVideo.ContentType;
            int ss = type.LastIndexOf('/');
            type = type.Remove(0, type.LastIndexOf('/') + 1);
            Byte[] buffer = vf.EmbeddedVideo.BinaryData;
            using (FileStream stream = new FileStream("NewVideo_out." + type, FileMode.Create, FileAccess.Write, FileShare.Read))
            {                                                     
                stream.Write(buffer, 0, buffer.Length);
            }
        }
    }
}

FAQ

Welche Video‑Wiedergabeparameter können für einen VideoFrame geändert werden?

Sie können den Wiedergabemodus (automatisch oder beim Klicken) und das Looping steuern. Diese Optionen stehen über die Eigenschaften des VideoFrame‑Objekts zur Verfügung.

Wirkt sich das Hinzufügen eines Videos auf die PPTX-Dateigröße aus?

Ja. Beim Einbetten eines lokalen Videos werden die Binärdaten in das Dokument aufgenommen, sodass die Präsentationsgröße proportional zur Dateigröße zunimmt. Beim Hinzufügen eines Online‑Videos werden nur ein Link und ein Vorschaubild eingebettet, sodass die Größenzunahme geringer ist.

Kann ich das Video in einem vorhandenen VideoFrame ersetzen, ohne Position und Größe zu ändern?

Ja. Sie können den Video‑Inhalt im Frame austauschen, während die Geometrie der Form erhalten bleibt; das ist ein gängiges Szenario zum Aktualisieren von Medien in einem bestehenden Layout.

Kann der Inhaltstyp (MIME) eines eingebetteten Videos ermittelt werden?

Ja. Ein eingebettetes Video hat einen Content‑Typ, den Sie auslesen und beispielsweise beim Speichern auf die Festplatte verwenden können.

Verwalten von Bildtransformations‑Effekten in Präsentationen mit .NET