Gestire i fotogrammi video nelle presentazioni usando Java
Introduzione
Un video ben posizionato in una presentazione può rendere il tuo messaggio più efficace e aumentare il livello di coinvolgimento del pubblico.
PowerPoint consente di aggiungere video a una diapositiva in una presentazione in due modi:
- Aggiungere o incorporare un video locale (memorizzato sul tuo computer)
- Aggiungere un video online (da una fonte web come YouTube).
Per consentirti di aggiungere video (oggetti video) a una presentazione, Aspose.Slides fornisce l’interfaccia IVideo , l’interfaccia IVideoFrame e altri tipi pertinenti.
Crea fotogrammi video incorporati
Se il file video che desideri aggiungere alla diapositiva è memorizzato localmente, puoi creare un fotogramma video per incorporare il video nella presentazione.
- Crea un’istanza della classe Presentazione .
- Ottieni un riferimento alla diapositiva tramite il suo indice.
- Aggiungi un oggetto IVideo e passa il percorso del file video per incorporare il video nella presentazione.
- Aggiungi un oggetto IVideoFrame per creare un fotogramma per il video.
- Salva la presentazione modificata.
Questo codice Java mostra come aggiungere un video memorizzato localmente a una presentazione:
// Istanzia la classe Presentation
Presentation pres = new Presentation("pres.pptx");
try {
// Carica il video
FileInputStream fileStream = new FileInputStream("Wildlife.mp4");
IVideo video = pres.getVideos().addVideo(fileStream, LoadingStreamBehavior.KeepLocked);
// Ottiene la prima diapositiva e aggiunge un fotogramma video
pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);
// Salva la presentazione su disco
pres.save("pres-with-video.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
In alternativa, puoi aggiungere un video passando direttamente il suo percorso file al metodo addVideoFrame(float x, float y, float width, float height, IVideo video) :
Presentation pres = new Presentation();
try {
ISlide sld = pres.getSlides().get_Item(0);
IVideoFrame vf = sld.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi");
} finally {
if (pres != null) pres.dispose();
}
Crea fotogrammi video da fonti web
Microsoft PowerPoint 2013 e versioni successive supporta i video di YouTube nelle presentazioni. Se il video che desideri utilizzare è disponibile online (ad es. su YouTube), puoi aggiungerlo alla presentazione tramite il suo collegamento web.
- Crea un’istanza della classe Presentazione
- Ottieni un riferimento alla diapositiva tramite il suo indice.
- Aggiungi un oggetto IVideo e passa il collegamento al video.
- Imposta una miniatura per il fotogramma video.
- Salva la presentazione.
Questo codice Java mostra come aggiungere un video dal web a una diapositiva in una presentazione PowerPoint:
// Istanzia un oggetto Presentation che rappresenta un file di presentazione
Presentation pres = new Presentation();
try {
addVideoFromYouTube(pres, "Tj75Arhq5ho");
pres.save("out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
private static void addVideoFromYouTube(Presentation pres, String videoID)
{
// Aggiunge un videoFrame
IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(
10, 10, 427, 240, "https://www.youtube.com/embed/" + videoID);
videoFrame.setPlayMode(VideoPlayModePreset.Auto);
// Carica la miniatura
String thumbnailUri = "http://img.youtube.com/vi/" + videoID + "/hqdefault.jpg";
URL url;
try {
url = new URL(thumbnailUri);
videoFrame.getPictureFormat().getPicture().setImage(pres.getImages().addImage(url.openStream()));
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
Ritaglia un fotogramma video
Aspose.Slides consente di controllare quale parte di un video viene riprodotta impostando i valori trim‑from‑start e trim‑from‑end tramite IVideoFrame.setTrimFromStart e IVideoFrame.setTrimFromEnd. Entrambi i valori sono specificati in millisecondi e definiscono quanto tempo viene saltato rispettivamente dall’inizio e dalla fine del video. Queste impostazioni modificano le impostazioni di riproduzione del video nella presentazione; non ritagliano né modificano in altro modo i dati binari del video incorporato.
Imposta le impostazioni di ritaglio
Per creare un fotogramma video e impostare le sue impostazioni di ritaglio:
- Crea un’istanza della classe Presentazione .
- Aggiungi un oggetto IVideo alla presentazione.
- Aggiungi un oggetto IVideoFrame a una diapositiva.
- Imposta i valori trim‑from‑start e trim‑from‑end tramite IVideoFrame.setTrimFromStart e IVideoFrame.setTrimFromEnd.
- Salva la presentazione modificata.
Il seguente esempio di codice salta i primi 2,5 secondi e l’ultimo secondo di un video incorporato durante la riproduzione:
Presentation presentation = new Presentation();
try {
FileInputStream videoStream = new FileInputStream("video.mp4");
try {
IVideo video = presentation.getVideos().addVideo(
videoStream, LoadingStreamBehavior.ReadStreamAndRelease);
ISlide slide = presentation.getSlides().get_Item(0);
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 {
videoStream.close();
}
} finally {
presentation.dispose();
}
Leggi le impostazioni di ritaglio
Per ispezionare le impostazioni di ritaglio esistenti, carica una presentazione, trova un oggetto IVideoFrame tra le forme della prima diapositiva e leggi i valori tramite IVideoFrame.getTrimFromStart e IVideoFrame.getTrimFromEnd.
Il seguente esempio di codice trova il primo fotogramma video sulla prima diapositiva e restituisce le sue impostazioni di ritaglio in millisecondi:
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;
float trimFromStart = videoFrame.getTrimFromStart();
float trimFromEnd = videoFrame.getTrimFromEnd();
System.out.println("Trim from start: " + trimFromStart + " ms");
System.out.println("Trim from end: " + trimFromEnd + " ms");
break;
}
}
} finally {
presentation.dispose();
}
Gestisci i sottotitoli video
Aspose.Slides consente di gestire i sottotitoli chiusi per i fotogrammi video nelle presentazioni PowerPoint. I sottotitoli sono memorizzati in formato WebVTT e sono accessibili tramite il metodo IVideoFrame.getCaptionTracks .
Aggiungi sottotitoli a un fotogramma video
Per aggiungere sottotitoli a un fotogramma video:
- Crea un’istanza della classe Presentazione .
- Aggiungi un video alla presentazione.
- Aggiungi un oggetto IVideoFrame a una diapositiva.
- Usa la ICaptionsCollection restituita da getCaptionTracks per aggiungere una traccia di sottotitoli WebVTT.
- Salva la presentazione modificata.
Il seguente codice mostra come aggiungere sottotitoli a un fotogramma video:
Presentation presentation = new Presentation();
try {
byte[] videoData = Files.readAllBytes(Paths.get("video.mp4"));
IVideo video = presentation.getVideos().addVideo(videoData);
ISlide slide = presentation.getSlides().get_Item(0);
IVideoFrame videoFrame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video);
// Aggiunge una nuova traccia di sottotitoli da un file WebVTT.
videoFrame.getCaptionTracks().add("English", "track.vtt");
presentation.save("video_with_captions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
L’interfaccia ICaptionsCollection fornisce anche un overload che consente di aggiungere sottotitoli da uno stream.
Estrai i sottotitoli da un fotogramma video
Per estrarre i sottotitoli da un fotogramma video:
- Carica la presentazione che contiene il video.
- Trova l’oggetto IVideoFrame di destinazione.
- Itera attraverso le tracce di sottotitoli nella ICaptionsCollection .
- Salva ogni traccia di sottotitoli in un file
.vtt.
Il seguente codice mostra come estrarre i sottotitoli da un fotogramma video:
Presentation presentation = new Presentation("video_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
for (IShape shape : slide.getShapes()) {
if (shape instanceof IVideoFrame) {
IVideoFrame videoFrame = (IVideoFrame)shape;
for (ICaptions captionTrack : videoFrame.getCaptionTracks()) {
// Salva la traccia di sottotitoli in un file WebVTT.
String filePath = captionTrack.getCaptionId().toString() + ".vtt";
Files.write(Paths.get(filePath), captionTrack.getBinaryData());
}
}
}
} finally {
presentation.dispose();
}
Ogni oggetto ICaptions espone l’identificatore del sottotitolo, l’etichetta, i dati binari e il testo del sottotitolo come stringa UTF‑8.
Rimuovi i sottotitoli da un fotogramma video
Per rimuovere i sottotitoli da un fotogramma video:
- Carica la presentazione che contiene il video.
- Ottieni l’oggetto IVideoFrame di destinazione.
- Rimuovi le tracce di sottotitoli dalla ICaptionsCollection .
- Salva la presentazione modificata.
Il seguente codice mostra come rimuovere tutti i sottotitoli da un fotogramma video:
Presentation presentation = new Presentation("video_with_captions.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IVideoFrame videoFrame = (IVideoFrame)slide.getShapes().get_Item(0);
// Rimuove tutti i sottotitoli dal fotogramma video.
videoFrame.getCaptionTracks().clear();
presentation.save("video_without_captions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Se devi rimuovere solo una traccia di sottotitoli, utilizza i metodi remove o removeAt invece di clear .
Estrai video dalle diapositive
Oltre ad aggiungere video alle diapositive, Aspose.Slides consente di estrarre i video incorporati nelle presentazioni.
- Crea un’istanza della classe Presentazione per caricare la presentazione che contiene il video.
- Itera attraverso tutti gli oggetti ISlide .
- Itera attraverso tutti gli oggetti IShape per trovare un VideoFrame .
- Salva il video su disco.
Questo codice Java mostra come estrarre il video da una diapositiva di una presentazione:
// Istanzia un oggetto Presentation che rappresenta un file di presentazione
Presentation pres = new Presentation("VideoSample.pptx");
try {
for (ISlide slide : pres.getSlides())
{
for (IShape shape : slide.getShapes())
{
if (shape instanceof VideoFrame)
{
IVideoFrame vf = (IVideoFrame) shape;
String type = vf.getEmbeddedVideo().getContentType();
int ss = type.lastIndexOf('-');
byte[] buffer = vf.getEmbeddedVideo().getBinaryData();
//Ottiene l'estensione del file
int charIndex = type.indexOf("/");
type = type.substring(charIndex + 1);
FileOutputStream fop = new FileOutputStream("testing2." + type);
fop.write(buffer);
fop.flush();
fop.close();
}
}
}
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
FAQ
Quali parametri di riproduzione video possono essere modificati per un VideoFrame?
Puoi controllare la modalità di riproduzione (automatica o al clic) e il looping. Queste opzioni sono disponibili tramite le proprietà dell’oggetto VideoFrame .
L’aggiunta di un video influisce sulla dimensione del file PPTX?
Sì. Quando incorpori un video locale, i dati binari sono inclusi nel documento, quindi la dimensione della presentazione cresce proporzionalmente alla dimensione del file. Quando aggiungi un video online, vengono incorporati un collegamento e una miniatura, quindi l’aumento di dimensione è minore.
Posso sostituire il video in un VideoFrame esistente senza modificare la sua posizione e dimensione?
Sì. Puoi scambiare il contenuto video all’interno del fotogramma mantenendo la geometria della forma; è uno scenario comune per aggiornare i media in un layout esistente.
È possibile determinare il tipo di contenuto (MIME) di un video incorporato?
Sì. Un video incorporato ha un tipo di contenuto che puoi leggere e utilizzare, ad esempio quando lo salvi su disco.