Gerenciar Quadros de Vídeo em Apresentações Usando Java
Introdução
Os vídeos podem ajudar a explicar ideias e envolver o público. Aspose.Slides for Java permite adicionar quadros de vídeo aos slides, ajustar as configurações de reprodução, gerenciar legendas e extrair dados de vídeo incorporados.
O PowerPoint oferece suporte a vídeos locais e links para vídeos online, como vídeos do YouTube.
Para representar dados de vídeo e quadros de vídeo, 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 slide estiver armazenado localmente, pode criar um quadro de vídeo para incorporar o vídeo à sua apresentação.
Este exemplo incorpora um vídeo local no primeiro slide de uma apresentação existente e salva o resultado. As coordenadas e dimensões do quadro estão em pontos. O fluxo permanece aberto até que a gravação termine porque LoadingStreamBehavior.KeepLocked o mantém bloqueado enquanto a apresentação o utiliza.
import com.aspose.slides.*;
import java.io.FileInputStream;
Presentation presentation = new Presentation("presentation.pptx");
try (FileInputStream videoStream = new FileInputStream("video.mp4")) {
ISlide slide = presentation.getSlides().get_Item(0);
IVideo video = presentation.getVideos().addVideo(videoStream, LoadingStreamBehavior.KeepLocked);
slide.getShapes().addVideoFrame(10, 10, 150, 250, video);
presentation.save("embedded_video.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Você também pode passar um caminho de vídeo local diretamente para addVideoFrame. Este exemplo incorpora o vídeo no primeiro slide de uma nova apresentação. O vídeo deve permanecer acessível até que a apresentação seja salva.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
slide.getShapes().addVideoFrame(50, 150, 300, 150, "video.avi");
presentation.save("video_from_path.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Criar um Quadro de Vídeo com Vídeo de uma Fonte Web
O Microsoft PowerPoint oferece suporte a vídeos online em apresentações. Você pode criar um quadro de vídeo que vincula a um vídeo online, como um vídeo do YouTube.
Este exemplo adiciona um link de vídeo do YouTube e uma miniatura ao primeiro slide. Substitua o identificador do vídeo para usar outro vídeo. O método modo de reprodução solicita reprodução automática. Baixar a miniatura e reproduzir o vídeo requer acesso à internet. O visualizador da apresentação também deve oferecer suporte à reprodução de vídeo online.
import com.aspose.slides.*;
import java.io.InputStream;
import java.net.URL;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
String videoId = "aqz-KE-bpKQ";
String videoUrl = "https://www.youtube.com/embed/" + videoId;
IVideoFrame videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
videoFrame.setPlayMode(VideoPlayModePreset.Auto);
String thumbnailUrl = "https://img.youtube.com/vi/" + videoId + "/hqdefault.jpg";
URL thumbnailLocation = new URL(thumbnailUrl);
try (InputStream thumbnailStream = thumbnailLocation.openStream()) {
IPPImage thumbnail = presentation.getImages().addImage(thumbnailStream);
videoFrame.getPictureFormat().getPicture().setImage(thumbnail);
}
presentation.save("online_video.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Reproduzir um Vídeo em Modo Tela Cheia
Em uma apresentação de treinamento, você pode reproduzir uma demonstração de software em modo tela cheia para que o público veja os detalhes. Chame modo tela cheia com true para habilitar esse comportamento durante a reprodução.
Este exemplo abre uma apresentação, localiza o primeiro IVideoFrame no primeiro slide e habilita a reprodução em tela cheia. A apresentação de entrada deve conter ao menos um slide com um quadro de vídeo existente no primeiro slide.
import com.aspose.slides.*;
Presentation presentation = new Presentation("training.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame) shape;
videoFrame.setFullScreenMode(true);
break;
}
}
presentation.save("full_screen_video.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A reprodução em tela cheia controla como o vídeo é exibido. De forma independente, modo de reprodução controla se ele inicia automaticamente ou ao clique, e modo de repetição controla se ele se repete. Para escolher o comportamento de início, defina o modo de reprodução para VideoPlayModePreset.Auto ou VideoPlayModePreset.OnClick. O exemplo preserva as configurações de início e repetição existentes.
Retroceder um Vídeo Após a Reprodução
Em uma apresentação de treinamento, devolver um vídeo de demonstração ao início o deixa pronto para o apresentador reproduzi-lo novamente. Chame setRewindVideo com true para retornar o vídeo ao início após a conclusão da reprodução.
Este exemplo abre uma apresentação, localiza o primeiro IVideoFrame no primeiro slide e habilita o retrocesso. Ele desabilita a repetição para que a reprodução possa terminar e define a reprodução para iniciar ao clique. A apresentação de entrada deve conter ao menos um slide com um quadro de vídeo existente no primeiro slide.
import com.aspose.slides.*;
Presentation presentation = new Presentation("training.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame) shape;
videoFrame.setRewindVideo(true);
videoFrame.setPlayLoopMode(false);
videoFrame.setPlayMode(VideoPlayModePreset.OnClick);
break;
}
}
presentation.save("rewind_video.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
O retrocesso retorna o vídeo ao início sem iniciá‑lo novamente. Em contraste, chamar modo de repetição com true repete a reprodução automaticamente. Mantenha a repetição desativada quando quiser que o vídeo termine e permaneça pronto para ser reproduzido novamente. modo de reprodução controla independentemente o início automático ou ao clique; este exemplo usa VideoPlayModePreset.OnClick para que o apresentador controle quando a reprodução começa. Defina o modo de reprodução após a configuração de repetição, como mostrado no exemplo. O retrocesso funciona independentemente de modo tela cheia.
Cortar um Quadro de Vídeo
Use IVideoFrame.setTrimFromStart e IVideoFrame.setTrimFromEnd para pular parte do início ou do fim de um vídeo durante a reprodução. Ambos os valores estão em milissegundos. O corte altera as configurações de reprodução sem modificar os dados de vídeo incorporados.
Definir Configurações de Corte
Este exemplo incorpora um vídeo local e pula os primeiros 2,5 segundos e o último segundo durante a reprodução. Use um vídeo com mais de 3,5 segundos para que permaneça um segmento reproduzível.
import com.aspose.slides.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
Path videoPath = Paths.get("video.mp4");
byte[] videoData = Files.readAllBytes(videoPath);
IVideo video = presentation.getVideos().addVideo(videoData);
IVideoFrame videoFrame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video);
videoFrame.setTrimFromStart(2500f);
videoFrame.setTrimFromEnd(1000f);
presentation.save("video_with_trim.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ler Configurações de Corte
Este exemplo exibe os valores de corte do primeiro quadro de vídeo no primeiro slide em milissegundos. A apresentação deve conter ao menos um slide. Se esse slide não possuir quadro de vídeo, nada será exibido. O exemplo anterior produz valores de 2500 e 1000.
import com.aspose.slides.*;
Presentation presentation = new Presentation("video_with_trim.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame) shape;
System.out.println("Trim from start: " + videoFrame.getTrimFromStart() + " ms");
System.out.println("Trim from end: " + videoFrame.getTrimFromEnd() + " ms");
break;
}
}
} finally {
presentation.dispose();
}
Gerenciar Legendas de Vídeo
Aspose.Slides permite gerenciar legendas fechadas para quadros de vídeo em apresentações do PowerPoint. As legendas são armazenadas no formato WebVTT e são expostas através do método IVideoFrame.getCaptionTracks .
Adicionar Legendas a um Quadro de Vídeo
Este exemplo incorpora um vídeo local e adiciona uma faixa de legenda WebVTT rotulada como English. Os timestamps da legenda devem coincidir com o vídeo. A apresentação salva inclui tanto o vídeo quanto suas legendas.
import com.aspose.slides.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
Path videoPath = Paths.get("video.mp4");
byte[] videoData = Files.readAllBytes(videoPath);
IVideo video = presentation.getVideos().addVideo(videoData);
IVideoFrame videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);
videoFrame.getCaptionTracks().add("English", "track.vtt");
presentation.save("video_with_captions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A interface ICaptionsCollection também fornece uma sobrecarga que permite adicionar legendas a partir de um fluxo.
Extrair Legendas de um Quadro de Vídeo
Este exemplo salva todas as faixas de legenda dos quadros de vídeo no primeiro slide como arquivos WebVTT separados. Números sequenciais mantêm os arquivos de saída distintos. O console relata o número de faixas extraídas. A apresentação deve conter ao menos um slide.
import com.aspose.slides.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
Presentation presentation = new Presentation("video_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
int trackCount = 0;
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame) shape;
for (ICaptions captionTrack : videoFrame.getCaptionTracks()) {
trackCount++;
Path outputPath = Paths.get("captions_" + trackCount + ".vtt");
Files.write(outputPath, captionTrack.getBinaryData());
}
}
}
System.out.println("Caption tracks extracted: " + trackCount);
} finally {
presentation.dispose();
}
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
Este exemplo remove todas as legendas do quadro de vídeo na primeira posição de forma no primeiro slide e salva o resultado. Assume‑se que o slide e a forma existam e que a forma seja um quadro de vídeo.
import com.aspose.slides.*;
Presentation presentation = new Presentation("video_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IVideoFrame videoFrame = (IVideoFrame) slide.getShapes().get_Item(0);
videoFrame.getCaptionTracks().clear();
presentation.save("video_without_captions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
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 aos slides, o Aspose.Slides permite extrair vídeos incorporados em apresentações.
Este exemplo extrai vídeos incorporados de cada slide em arquivos binários separados e numerados. Vídeos vinculados são ignorados porque não possuem dados incorporados. O console exibe o tipo MIME de cada vídeo e a contagem total. A saída usa a extensão genérica .bin; altere‑a para corresponder ao tipo de mídia relatado quando necessário.
import com.aspose.slides.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
Presentation presentation = new Presentation("presentation_with_videos.pptx");
try {
int videoCount = 0;
for (ISlide slide : presentation.getSlides()) {
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame) shape;
IVideo video = videoFrame.getEmbeddedVideo();
if (video == null) {
System.out.println("Skipped a linked video: no embedded data is available.");
continue;
}
videoCount++;
Path outputPath = Paths.get("extracted_video_" + videoCount + ".bin");
Files.write(outputPath, video.getBinaryData());
System.out.println("Video " + videoCount + ": " + video.getContentType());
}
}
}
System.out.println("Embedded videos extracted: " + videoCount);
} finally {
presentation.dispose();
}
Perguntas Frequentes
Quais parâmetros de reprodução de vídeo podem ser alterados para um quadro de vídeo?
Você pode controlar o modo de reprodução (automático ou ao clique) e a repetição. Essas opções estão disponíveis através dos métodos 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 cresce proporcionalmente ao tamanho do arquivo. Quando você cria um link para um vídeo online e adiciona uma miniatura, a apresentação armazena o link e a imagem de pré‑visualização em vez dos dados do vídeo, de modo que o aumento de tamanho costuma ser menor.
Posso substituir o vídeo em um quadro de vídeo existente sem alterar sua posição e tamanho?
Sim. Você pode trocar o conteúdo de vídeo dentro do quadro preservando a geometria da forma; este é um cenário comum para atualizar a 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 você pode ler e usar, por exemplo ao salvá‑lo no disco.