# Gerenciar Quadros de Vídeo em Apresentações Usando C++ > Aprenda a adicionar e extrair programaticamente quadros de vídeo em slides PowerPoint e OpenDocument usando Aspose.Slides para C++. Guia rápido passo a passo. Source: https://docs.aspose.com/slides/pt/cpp/video-frame/ Updated: 2026-06-10 ## **Introdução** Um vídeo bem posicionado em uma apresentação pode tornar sua mensagem mais atraente e aumentar os níveis de engajamento com o público. 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 no seu computador) * 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](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideo/) , a interface [IVideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/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 está armazenado localmente, você pode criar um quadro de vídeo para incorporar o vídeo na sua apresentação. 1. Crie uma instância da classe [Presentation ](https://reference.aspose.com/slides/pt/cpp/aspose.slides/presentation/) . 1. Obtenha a referência de um slide através do seu índice. 1. Adicione um objeto [IVideo](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideo/) e passe o caminho do arquivo de vídeo para incorporar o vídeo à apresentação. 1. Adicione um objeto [IVideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/) para criar um quadro para o vídeo. 1. Salve a apresentação modificada. Este código C++ mostra como adicionar um vídeo armazenado localmente a uma apresentação: ```c++ System::SharedPtr pres = System::MakeObject(u"pres.pptx"); // Loads the video System::SharedPtr fileStream = System::MakeObject(u"Wildlife.mp4", System::IO::FileMode::Open, System::IO::FileAccess::Read); System::SharedPtr video = pres->get_Videos()->AddVideo(fileStream, LoadingStreamBehavior::KeepLocked); // Gets the first slide and adds a videoframe pres->get_Slide(0)->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 150.0f, 250.0f, video); // Saves the presentation to disk pres->Save(u"pres-with-video.pptx", SaveFormat::Pptx); ``` Como alternativa, você pode adicionar um vídeo passando o caminho do arquivo diretamente para o método [AddVideoFrame()](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ishapecollection/addvideoframe/) : ``` c++ System::SharedPtr pres = System::MakeObject(); System::SharedPtr sld = pres->get_Slide(0); System::SharedPtr vf = sld->get_Shapes()->AddVideoFrame(50.0f, 150.0f, 300.0f, 150.0f, u"video1.avi"); ``` ## **Criar um Quadro de Vídeo com Vídeo de uma Fonte Web** O Microsoft [PowerPoint 2013 e mais recentes](https://support.microsoft.com/en-us/office/versions-of-powerpoint-that-support-online-videos-2a0e184d-af50-4da9-b530-e4355ac436a9?ui=en-us&rs=en-us&ad=us) suporta vídeos do YouTube em apresentações. Se o vídeo que você deseja usar está disponível online (por exemplo, no YouTube), você pode adicioná‑lo à sua apresentação através do link da web. 1. Crie uma instância da classe [Presentation ](https://reference.aspose.com/slides/pt/cpp/aspose.slides/presentation/) . 1. Obtenha a referência de um slide através do seu índice. 1. Adicione um objeto [IVideo](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideo/) e passe o link para o vídeo. 1. Defina uma miniatura para o quadro de vídeo. 1. Salve a apresentação. Este código C++ mostra como adicionar um vídeo da web a um slide em uma apresentação PowerPoint: ```c++ // O caminho para o diretório de documentos. const String outPath = u"../out/AddVideoFrameFromWebSource_out.pptx"; const String filePath = u"../templates/video1.avi"; // Instancia um objeto Presentation que representa um arquivo de apresentação SharedPtr pres = MakeObject(); // Acessa o primeiro slide SharedPtr slide = pres->get_Slides()->idx_get(0); // Adiciona um Quadro de Vídeo System::SharedPtr vf = slide->get_Shapes()->AddVideoFrame(10, 10, 427, 240,u"https://www.youtube.com/embed/Tj75Arhq5ho"); // Define o modo de reprodução e o volume do vídeo vf->set_PlayMode(VideoPlayModePreset::Auto); //Salva a apresentação no disco pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx); ``` ## **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 do método [IVideoFrame::get_CaptionTracks](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/get_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](https://reference.aspose.com/slides/pt/cpp/aspose.slides/presentation/) . 1. Adicione um vídeo à apresentação. 1. Adicione um objeto [IVideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/) a um slide. 1. Use a [ICaptionsCollection](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptionscollection/) retornada por [get_CaptionTracks](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/get_captiontracks/) para adicionar uma faixa de legenda WebVTT. 1. Salve a apresentação modificada. O código a seguir mostra como adicionar legendas a um quadro de vídeo: ```cpp auto presentation = MakeObject(); 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); // Adds a new captions track from a WebVTT file. videoFrame->get_CaptionTracks()->Add(u"English", u"track.vtt"); presentation->Save(u"video_with_captions.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` A interface [ICaptionsCollection](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptionscollection/) também fornece uma sobrecarga que permite adicionar legendas a partir de um fluxo. **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. 1. Encontre o objeto [IVideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/) alvo. 1. Itere através das faixas de legenda retornadas por [get_CaptionTracks](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/get_captiontracks/) . 1. Salve cada faixa de legenda em um arquivo `.vtt` . O código a seguir mostra como extrair legendas de um quadro de vídeo: ```cpp auto presentation = MakeObject(u"video_with_captions.pptx"); auto slide = presentation->get_Slide(0); for (auto&& shape : slide->get_Shapes()) { if (ObjectExt::Is(shape)) { auto videoFrame = ExplicitCast(shape); for (auto&& captionTrack : videoFrame->get_CaptionTracks()) { // Salva a faixa de legendas em um arquivo WebVTT. auto filePath = captionTrack->get_CaptionId().ToString() + u".vtt"; File::WriteAllBytes(filePath, captionTrack->get_BinaryData()); } } } presentation->Dispose(); ``` Cada objeto [ICaptions](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptions/) expõe o identificador da legenda, rótulo, dados binários e os dados 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. 1. Obtenha o objeto [IVideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/) alvo. 1. Remova as faixas de legenda da coleção retornada por [get_CaptionTracks](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ivideoframe/get_captiontracks/) . 1. Salve a apresentação modificada. O código a seguir mostra como remover todas as legendas de um quadro de vídeo: ```cpp auto presentation = MakeObject(u"video_with_captions.pptx"); auto slide = presentation->get_Slide(0); auto videoFrame = ExplicitCast(slide->get_Shape(0)); // Remove todas as legendas do quadro de vídeo. videoFrame->get_CaptionTracks()->Clear(); presentation->Save(u"video_without_captions.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Se precisar remover apenas uma faixa de legenda, use os métodos [Remove](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptionscollection/remove/) ou [RemoveAt](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptionscollection/removeat/) em vez de [Clear](https://reference.aspose.com/slides/pt/cpp/aspose.slides/icaptionscollection/clear/) . ## **Extrair Vídeo de um Slide** Além de adicionar vídeos aos slides, o Aspose.Slides permite que você extraia vídeos incorporados em apresentações. 1. Crie uma instância da classe [Presentation](https://reference.aspose.com/slides/pt/cpp/aspose.slides/presentation/) para carregar a apresentação que contém o vídeo. 2. Itere por todos os objetos [ISlide](https://reference.aspose.com/slides/pt/cpp/aspose.slides/islide/) . 3. Itere por todos os objetos [IShape](https://reference.aspose.com/slides/pt/cpp/aspose.slides/ishape/) para encontrar um [VideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/videoframe/) . 4. Salve o vídeo no disco. Este código C++ mostra como extrair o vídeo de um slide de apresentação: ```c++ // O caminho para o diretório de documentos. const System::String templatePath = u"../templates/Video.pptx"; const System::String outPath = u"../out/Video_out"; auto presentation = System::MakeObject(templatePath); for (auto&& slide : presentation->get_Slides()) { for (auto&& shape : slide->get_Shapes()) { if (System::ObjectExt::Is(shape)) { System::SharedPtr vf = System::AsCast(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( outPath + type, System::IO::FileMode::Create, System::IO::FileAccess::Write, System::IO::FileShare::Read); stream->Write(buffer, 0, buffer->get_Length()); } } } ``` ## **Perguntas Frequentes** **Quais parâmetros de reprodução de vídeo podem ser alterados para um VideoFrame?** Você pode controlar o [playback mode](https://reference.aspose.com/slides/pt/cpp/aspose.slides/videoframe/set_playmode/) (automático ou ao clicar) e o [looping](https://reference.aspose.com/slides/pt/cpp/aspose.slides/videoframe/set_playloopmode/) . Essas opções estão disponíveis nas propriedades do objeto [VideoFrame](https://reference.aspose.com/slides/pt/cpp/aspose.slides/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 [video content](https://reference.aspose.com/slides/pt/cpp/aspose.slides/videoframe/set_embeddedvideo/) dentro do quadro preservando a geometria da forma; este é 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 [content type](https://reference.aspose.com/slides/pt/cpp/aspose.slides/video/get_contenttype/) que você pode ler e usar, por exemplo ao salvá‑lo no disco.