Gerenciar Quadros de Vídeo em Apresentações no .NET

Introdução

Um vídeo bem colocado em uma apresentação pode tornar sua mensagem mais impactante e aumentar os níveis de engajamento com o seu público.

O PowerPoint permite que você adicione vídeos a um slide em uma apresentação de duas maneiras:

  • Adicionar ou incorporar um vídeo local (armazenado em sua máquina)
  • Adicionar um vídeo online (de uma fonte web como o YouTube).

Para permitir que você adicione vídeos (objetos de vídeo) a uma apresentação, o Aspose.Slides fornece a interface IVideo , a interface IVideoFrame e outros tipos relevantes.

Criar um Quadro de Vídeo Incorporado

Se o arquivo de vídeo que você deseja adicionar ao seu slide estiver armazenado localmente, você pode criar um quadro de vídeo para incorporar o vídeo em sua apresentação.

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência de um slide através de seu índice.
  3. Adicione um objeto IVideo e passe o caminho do arquivo de vídeo para incorporar o vídeo à apresentação.
  4. Adicione um objeto IVideoFrame para criar um quadro para o vídeo.
  5. Salve a apresentação modificada.

Este código C# demonstra como adicionar um vídeo armazenado localmente a uma apresentação:

// Instancia a classe Presentation
using (Presentation pres = new Presentation("pres.pptx"))
{
    // Carrega o vídeo
    using (FileStream fileStream = new FileStream("Wildlife.mp4", FileMode.Open, FileAccess.Read))
    {
        IVideo video = pres.Videos.AddVideo(fileStream, LoadingStreamBehavior.KeepLocked);
        
        // Obtém o primeiro slide e adiciona um videoframe
        pres.Slides[0].Shapes.AddVideoFrame(10, 10, 150, 250, video);
        
        // Salva a apresentação no disco
        pres.Save("pres-with-video.pptx", SaveFormat.Pptx);
    }
}

Alternativamente, você pode adicionar um vídeo passando seu caminho de arquivo diretamente para o método AddVideoFrame:

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

Criar um Quadro de Vídeo com Vídeo de uma Fonte Web

Versões mais recentes do Microsoft PowerPoint suportam vídeos online em apresentações. Se o vídeo que você deseja usar estiver disponível online (por exemplo, no YouTube), você pode adicioná-lo à sua apresentação através do seu link web.

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência de um slide através de seu índice.
  3. Adicione um objeto IVideo e passe o link para o vídeo.
  4. Defina uma miniatura para o quadro de vídeo.
  5. Salve a apresentação.

Este código C# demonstra como adicionar um vídeo da web a um slide em uma apresentação do PowerPoint:

public static void Run()
{
    // Instancia um objeto Presentation que representa um arquivo de apresentação 
    using (Presentation pres = new Presentation())
    {
        AddVideoFromYouTube(pres, "Tj75Arhq5ho");
        pres.Save("AddVideoFrameFromWebSource_out.pptx", SaveFormat.Pptx);
    }
}

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

    // Carrega a miniatura
    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));
    }
}

Cortar um Quadro de Vídeo

O Aspose.Slides permite que você controle qual parte de um vídeo é reproduzida definindo os valores trim‑from‑start e trim‑from‑end através de IVideoFrame.TrimFromStart e IVideoFrame.TrimFromEnd. Ambos os valores são especificados em milissegundos e definem quanto tempo é ignorado do início e do fim do vídeo, respectivamente. Essas configurações alteram as propriedades de reprodução do vídeo na apresentação; elas não cortam nem modificam os dados binários do vídeo incorporado.

Definir Configurações de Corte

Para criar um quadro de vídeo e definir suas configurações de corte:

  1. Crie uma instância da classe Presentation .
  2. Adicione um objeto IVideo à apresentação.
  3. Adicione um objeto IVideoFrame a um slide.
  4. Defina os valores trim‑from‑start e trim‑from‑end através de IVideoFrame.TrimFromStart e IVideoFrame.TrimFromEnd.
  5. Salve a apresentação modificada.

O exemplo de código a seguir ignora os primeiros 2,5 segundos e o último segundo de um vídeo incorporado durante a reprodução:

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

Ler Configurações de Corte

Para inspecionar as configurações de corte existentes, carregue uma apresentação, encontre um objeto IVideoFrame entre as formas do primeiro slide e leia os valores através de IVideoFrame.TrimFromStart e IVideoFrame.TrimFromEnd.

O exemplo de código a seguir encontra o primeiro quadro de vídeo no primeiro slide e relata suas configurações de corte em milissegundos:

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

Gerenciar Legendas de Vídeo

O Aspose.Slides permite que você gerencie legendas fechadas para quadros de vídeo em apresentações PowerPoint. As legendas são armazenadas no formato WebVTT e são expostas através da propriedade IVideoFrame.CaptionTracks.

Adicionar Legendas a um Quadro de Vídeo

Para adicionar legendas a um quadro de vídeo:

  1. Crie uma instância da classe Presentation .
  2. Adicione um vídeo à apresentação.
  3. Adicione um objeto IVideoFrame a um slide.
  4. Use a coleção CaptionTracks para adicionar uma faixa de legenda WebVTT.
  5. Salve a apresentação modificada.

O código a seguir mostra como adicionar legendas a um quadro de vídeo:

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

    // Adiciona uma nova faixa de legendas a partir de um arquivo WebVTT.
    videoFrame.CaptionTracks.Add("English", "track.vtt");

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

A interface ICaptionsCollection também fornece uma sobrecarga que permite adicionar legendas a partir de um stream.

Extrair Legendas de um Quadro de Vídeo

Para extrair legendas de um quadro de vídeo:

  1. Carregue a apresentação que contém o vídeo.
  2. Encontre o objeto IVideoFrame alvo.
  3. Percorra a coleção CaptionTracks.
  4. Salve cada faixa de legenda em um arquivo .vtt.

O código a seguir mostra como extrair legendas de um quadro de vídeo:

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)
            {
                // Salva a faixa de legendas em um arquivo WebVTT.
                string filePath = $"{captionTrack.CaptionId}.vtt";
                File.WriteAllBytes(filePath, captionTrack.BinaryData);
            }
        }
    }
}

Cada objeto ICaptions expõe o identificador da legenda, o rótulo, os dados binários e o texto da legenda como uma string UTF‑8.

Remover Legendas de um Quadro de Vídeo

Para remover legendas de um quadro de vídeo:

  1. Carregue a apresentação que contém o vídeo.
  2. Obtenha o objeto IVideoFrame alvo.
  3. Remova as faixas de legenda da coleção CaptionTracks.
  4. Salve a apresentação modificada.

O código a seguir mostra como remover todas as legendas de um quadro de vídeo:

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

    // Remove todas as legendas do quadro de vídeo.
    videoFrame.CaptionTracks.Clear();

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

Se precisar remover apenas uma faixa de legenda, use os métodos Remove ou RemoveAt em vez de Clear.

Extrair Vídeo de um Slide

Além de adicionar vídeos a slides, o Aspose.Slides permite extrair vídeos incorporados em apresentações.

  1. Crie uma instância da classe Presentation para carregar a apresentação que contém o vídeo.
  2. Percorra todos os objetos ISlide.
  3. Percorra todos os objetos IShape para encontrar um VideoFrame.
  4. Salve o vídeo no disco.

Este código C# demonstra como extrair o vídeo de um slide de apresentação:

// Instancia um objeto Presentation que representa um arquivo de apresentação 
Presentation presentation = new Presentation("Video.pptx");

// Itera pelos slides
foreach (ISlide slide in presentation.Slides)
{
    // Itera pelas formas
    foreach (IShape shape in presentation.Slides[0].Shapes)
    {
        // Salva o vídeo no disco assim que um VideoFrame contendo o vídeo for encontrado
        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

Quais parâmetros de reprodução de vídeo podem ser alterados para um VideoFrame?

Você pode controlar o modo de reprodução (automático ou ao clicar) e o looping. Essas opções estão disponíveis através das propriedades do objeto VideoFrame.

Adicionar um vídeo afeta o tamanho do arquivo PPTX?

Sim. Quando você incorpora um vídeo local, os dados binários são incluídos no documento, portanto o tamanho da apresentação aumenta proporcionalmente ao tamanho do arquivo. Quando você adiciona um vídeo online, um link e uma miniatura são incorporados, de modo que o aumento de tamanho é menor.

Posso substituir o vídeo em um VideoFrame existente sem alterar sua posição e tamanho?

Sim. Você pode trocar o conteúdo do vídeo dentro do quadro preservando a geometria da forma; esse é um cenário comum para atualizar mídia em um layout existente.

É possível determinar o tipo de conteúdo (MIME) de um vídeo incorporado?

Sim. Um vídeo incorporado possui um tipo de conteúdo que pode ser lido e usado, por exemplo, ao salvá‑lo no disco.

Gerenciar Efeitos de Transformação de Imagem em Apresentações com .NET