Gerenciar Quadros de Vídeo em Apresentações Usando JavaScript
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.
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 as classes Video e VideoFrame, além de outros tipos relevantes.
Criar 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.
- Crie uma instância da classe Presentation class.
- Obtenha a referência de um slide através de seu índice.
- Adicione um objeto Video e forneça o caminho do arquivo de vídeo para incorporá-lo na apresentação.
- Adicione um objeto VideoFrame para criar um quadro para o vídeo.
- Salve a apresentação modificada.
Este código JavaScript mostra como adicionar um vídeo armazenado localmente a uma apresentação:
// Instancia a classe Presentation
var pres = new aspose.slides.Presentation("pres.pptx");
try {
// Carrega o vídeo
var fileStream = java.newInstanceSync("java.io.FileInputStream", "Wildlife.mp4");
var video = pres.getVideos().addVideo(fileStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
// Obtém o primeiro slide e adiciona um videoframe
pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);
// Salva a apresentação no disco
pres.save("pres-with-video.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
if (pres != null) {
pres.dispose();
}
}
Alternativamente, você pode adicionar um vídeo passando seu caminho de arquivo diretamente para o método addVideoFrame(float x, float y, float width, float height, IVideo video) :
var pres = new aspose.slides.Presentation();
try {
var sld = pres.getSlides().get_Item(0);
var vf = sld.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi");
} finally {
if (pres != null) {
pres.dispose();
}
}
Criar Quadro de Vídeo com Vídeo de Fonte Web
O Microsoft PowerPoint 2013 e versões mais recentes suportam vídeos do YouTube 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 link web.
- Crie uma instância da classe Presentation class
- Obtenha a referência de um slide através de seu índice.
- Adicione um objeto Video e forneça o link para o vídeo.
- Defina uma miniatura para o quadro de vídeo.
- Salve a apresentação.
Este código JavaScript mostra como adicionar um vídeo da web a um slide em uma apresentação do PowerPoint:
// Instancia um objeto Presentation que representa um arquivo de apresentação
var pres = new aspose.slides.Presentation();
try {
addVideoFromYouTube(pres, "Tj75Arhq5ho");
pres.save("out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
if (pres != null) {
pres.dispose();
}
}
async function addVideoFromYouTube(pres, videoID) {
let slide = pres.getSlides().get_Item(0);
let videoUrl = "https://www.youtube.com/embed/" + videoID;
let videoFrame = slide.getShapes().addVideoFrame(10, 10, 427, 240, videoUrl);
videoFrame.setPlayMode(aspose.slides.VideoPlayModePreset.Auto);
let thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";
try {
const imageStream = await getImageStream(thumbnailUri);
let image = pres.getImages().addImage(imageStream);
videoFrame.getPictureFormat().getPicture().setImage(image);
} catch (error) {
console.error("Error loading thumbnail:", error);
}
}
async function getImageStream(url) {
return new Promise((resolve, reject) => {
http.get(url, (response) => {
if (response.statusCode === 200) {
resolve(response);
} else {
reject(new Error(`Failed to load image: ${response.statusCode}`));
}
}).on('error', (e) => {
reject(e);
});
});
}
Gerenciar Legendas de Vídeo
O 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 VideoFrame.getCaptionTracks.
Adicionar Legendas a um Quadro de Vídeo
Para adicionar legendas a um quadro de vídeo:
- Crie uma instância da classe Presentation .
- Adicione um vídeo à apresentação.
- Adicione um objeto VideoFrame a um slide.
- Use a coleção CaptionsCollection para adicionar uma trilha de legenda WebVTT.
- Salve a apresentação modificada.
O código a seguir mostra como adicionar legendas a um quadro de vídeo:
let presentation = new aspose.slides.Presentation();
try {
let videoStream = java.newInstanceSync("java.io.FileInputStream", "video.mp4");
let video = presentation.getVideos().addVideo(videoStream, aspose.slides.LoadingStreamBehavior.KeepLocked);
let slide = presentation.getSlides().get_Item(0);
let videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);
// Adiciona uma nova faixa de legendas a partir de um arquivo WebVTT.
videoFrame.getCaptionTracks().add("English", "track.vtt");
presentation.save("video_with_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A classe CaptionsCollection também fornece o método addFromStream 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:
- Carregue a apresentação que contém o vídeo.
- Encontre o objeto VideoFrame alvo.
- Itere através da coleção CaptionsCollection.
- Salve cada trilha de legenda em um arquivo
.vtt.
O código a seguir mostra como extrair legendas de um quadro de vídeo:
let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
let slide = presentation.getSlides().get_Item(0);
let shapeCount = slide.getShapes().size();
for (let shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++) {
let shape = slide.getShapes().get_Item(shapeIndex);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
let videoFrame = shape;
let trackCount = videoFrame.getCaptionTracks().getCount();
for (let trackIndex = 0; trackIndex < trackCount; trackIndex++) {
let captionTrack = videoFrame.getCaptionTracks().get_Item(trackIndex);
// Salva a faixa de legendas em um arquivo WebVTT.
let filePath = captionTrack.getCaptionId() + ".vtt";
let captionData = Buffer.from(captionTrack.getBinaryData());
fs.writeFileSync(filePath, captionData);
}
}
}
} finally {
presentation.dispose();
}
Cada objeto Captions expõe o identificador da legenda, rótulo, 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:
- Carregue a apresentação que contém o vídeo.
- Obtenha o objeto VideoFrame alvo.
- Remova as trilhas de legenda da coleção CaptionsCollection.
- Salve a apresentação modificada.
O código a seguir mostra como remover todas as legendas de um quadro de vídeo:
let presentation = new aspose.slides.Presentation("video_with_captions.pptx");
try {
let slide = presentation.getSlides().get_Item(0);
let videoFrame = slide.getShapes().get_Item(0); // tipo: com.aspose.slides.VideoFrame
// Remove todas as legendas do quadro de vídeo.
videoFrame.getCaptionTracks().clear();
presentation.save("video_without_captions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Se precisar remover apenas uma trilha 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.
- Crie uma instância da classe Presentation para carregar a apresentação que contém o vídeo.
- Itere por todos os objetos Slide.
- Itere por todos os objetos Shape para encontrar um VideoFrame.
- Salve o vídeo no disco.
Este código JavaScript mostra como extrair o vídeo de um slide de apresentação:
// Instancia um objeto Presentation que representa um arquivo de apresentação
var pres = new aspose.slides.Presentation("VideoSample.pptx");
try {
for (let i = 0; i < pres.getSlides().size(); i++) {
let slide = pres.getSlides().get_Item(i);
for (let j = 0; j < slide.getShapes().size(); j++) {
let shape = slide.getShapes().get_Item(j);
if (java.instanceOf(shape, "com.aspose.slides.VideoFrame")) {
var vf = shape;
console.log(shape);
var type = vf.getEmbeddedVideo().getContentType();
var ss = type.lastIndexOf('-');
const buffer = Buffer.from(vf.getEmbeddedVideo().getBinaryData());
console.log(buffer);
// Obtém a extensão do arquivo
var charIndex = type.indexOf("/");
type = type.substring(charIndex + 1);
fs.writeFileSync("testing2." + type, buffer);
}
}
}
} catch (e) {console.log(e);
} finally {
if (pres != null) {
pres.dispose();
}
}
FAQ
Quais parâmetros de reprodução de vídeo podem ser alterados para um VideoFrame?
É possível controlar o modo de reprodução (automático ou ao clicar) e o looping. Estas opções estão disponíveis nas 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 cresce 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; 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 tipo de conteúdo que você pode ler e usar, por exemplo ao salvá-lo no disco.