在 .NET 中管理演示文稿的视频帧

在演示文稿中合理放置视频可以使您的信息更具说服力，并提升观众的参与度。

PowerPoint 允许您以两种方式向演示文稿中的幻灯片添加视频：

添加或嵌入本地视频（存储在您的计算机上）
添加在线视频（来自诸如 YouTube 的网络来源）。

为了让您向演示文稿添加视频（视频对象），Aspose.Slides 提供了 IVideo 接口、IVideoFrame 接口以及其他相关类型。

创建嵌入式视频帧

如果要添加到幻灯片的视频文件存储在本地，您可以创建视频帧将视频嵌入到演示文稿中。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
添加一个 IVideo 对象，并传入视频文件路径以将视频嵌入演示文稿。
添加一个 IVideoFrame 对象，以创建视频的帧。
保存修改后的演示文稿。

下面的 C# 代码演示了如何向演示文稿添加本地存储的视频：

// 实例化 Presentation 类
using (Presentation pres = new Presentation("pres.pptx"))
{
    // 加载视频
    using (FileStream fileStream = new FileStream("Wildlife.mp4", FileMode.Open, FileAccess.Read))
    {
        IVideo video = pres.Videos.AddVideo(fileStream, LoadingStreamBehavior.KeepLocked);
        
        // 获取第一张幻灯片并添加视频帧
        pres.Slides[0].Shapes.AddVideoFrame(10, 10, 150, 250, video);
        
        // 将演示文稿保存到磁盘
        pres.Save("pres-with-video.pptx", SaveFormat.Pptx);
    }
}

或者，您可以直接将文件路径传递给 AddVideoFrame 方法来添加视频：

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

使用网络来源视频创建视频帧

Microsoft PowerPoint 2013 及更高版本支持在演示文稿中使用 YouTube 视频。如果您要使用的视频已在网络上可用（例如在 YouTube 上），可以通过其网络链接将其添加到演示文稿中。

创建一个 Presentation 类的实例
通过索引获取幻灯片的引用。
添加一个 IVideo 对象，并传入视频链接。
为视频帧设置缩略图。
保存演示文稿。

下面的 C# 代码演示了如何从网络向 PowerPoint 演示文稿的幻灯片添加视频：

public static void Run()
{
    // 实例化一个表示演示文稿文件的 Presentation 对象 
    using (Presentation pres = new Presentation())
    {
        AddVideoFromYouTube(pres, "Tj75Arhq5ho");
        pres.Save("AddVideoFrameFromWebSource_out.pptx", SaveFormat.Pptx);
    }
}

private static void AddVideoFromYouTube(Presentation pres, string videoId)
{
    // 添加一个 VideoFrame
    IVideoFrame videoFrame = pres.Slides[0].Shapes.AddVideoFrame(10, 10, 427, 240, "https://www.youtube.com/embed/" + videoId);
    videoFrame.PlayMode = VideoPlayModePreset.Auto;

    // 加载缩略图
    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));
    }
}

管理视频字幕

Aspose.Slides 允许您管理 PowerPoint 演示文稿中视频帧的闭合字幕。字幕以 WebVTT 格式存储，并可通过 IVideoFrame.CaptionTracks 属性访问。

向视频帧添加字幕

向视频帧添加字幕的步骤：

创建一个 Presentation 类的实例。
向演示文稿添加视频。
向幻灯片添加一个 IVideoFrame 对象。
使用 CaptionTracks 集合添加 WebVTT 字幕轨道。
保存修改后的演示文稿。

下面的代码演示了如何向视频帧添加字幕：

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

    // 添加一个来自 WebVTT 文件的新字幕轨道。
    presentation.Save("video_with_captions.pptx", SaveFormat.Pptx);
}

ICaptionsCollection 接口还提供了一个重载，允许您从流中添加字幕。

从视频帧提取字幕

从视频帧提取字幕的步骤：

加载包含视频的演示文稿。
查找目标 IVideoFrame 对象。
遍历 CaptionTracks 集合。
将每个字幕轨道保存为 .vtt 文件。

下面的代码演示了如何从视频帧提取字幕：

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)
            {
                // 保存字幕轨道到 WebVTT 文件。
                string filePath = $"{captionTrack.CaptionId}.vtt";
                File.WriteAllBytes(filePath, captionTrack.BinaryData);
            }
        }
    }
}

每个 ICaptions 对象提供字幕标识符、标签、二进制数据以及以 UTF-8 字符串形式的字幕文本。

从视频帧移除字幕

从视频帧移除字幕的步骤：

加载包含视频的演示文稿。
获取目标 IVideoFrame 对象。
从 CaptionTracks 集合中移除字幕轨道。
保存修改后的演示文稿。

下面的代码演示了如何从视频帧中移除所有字幕：

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

    // 删除视频帧中的所有字幕。
    videoFrame.CaptionTracks.Clear();

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

如果只需移除单个字幕轨道，请使用 Remove 或 RemoveAt 方法，而不是 Clear。

从幻灯片中提取视频

除了向幻灯片添加视频，Aspose.Slides 还允许您提取嵌入在演示文稿中的视频。

创建一个 Presentation 类的实例，以加载包含视频的演示文稿。
遍历所有 ISlide 对象。
遍历所有 IShape 对象，以查找 VideoFrame。
将视频保存到磁盘。

下面的 C# 代码演示了如何提取演示文稿幻灯片中的视频：

// 实例化一个表示演示文稿文件的 Presentation 对象 
Presentation presentation = new Presentation("Video.pptx");

// 遍历幻灯片
foreach (ISlide slide in presentation.Slides)
{
    // 遍历形状
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // 找到包含视频的 VideoFrame 后将视频保存到磁盘
        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);
            }
        }
    }
}

常见问题

可以更改 VideoFrame 的哪些视频播放参数？

您可以控制 playback mode（自动或点击）和 looping 参数。这些选项可通过 VideoFrame 对象的属性进行设置。

添加视频会影响 PPTX 文件大小吗？

是的。嵌入本地视频时，二进制数据会包含在文档中，因此演示文稿大小会随文件大小按比例增长。添加在线视频时，只会嵌入链接和缩略图，因此大小增幅较小。

我可以在不更改位置和大小的情况下替换已有 VideoFrame 中的视频吗？

可以。您可以在保持形状几何不变的前提下，替换帧内的 video content，这在更新已有布局中的媒体时很常见。

可以确定嵌入视频的内容类型（MIME）吗？

可以。嵌入的视频具有可读取的 content type，您可以在保存到磁盘等场景中使用它。