Gestisci i frame video nelle presentazioni su Android

Introduzione

Un video posizionato in modo appropriato in una presentazione può rendere il tuo messaggio più persuasivo e aumentare il livello di coinvolgimento del pubblico.

PowerPoint ti consente di aggiungere video a una diapositiva in una presentazione in due modi:

Aggiungi o incorpora un video locale (memorizzato sul tuo computer)
Aggiungi 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 un frame video incorporato

Se il file video che desideri aggiungere alla diapositiva è memorizzato localmente, puoi creare un frame video per incorporare il video nella presentazione.

Crea un’istanza della classe Presentation class.
Ottieni il riferimento a una 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 frame 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 videoframe
    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 un frame video con video da una fonte web

Microsoft PowerPoint 2013 and newer 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 Presentation class
Ottieni il riferimento a una diapositiva tramite il suo indice.
Aggiungi un oggetto IVideo e passa il collegamento al video.
Imposta una miniatura per il frame video.
Salva la presentazione.

Questo codice Java mostra come aggiungere un video dal web a una diapositiva in una presentazione PowerPoint:

// Instanzia 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();
    }
}

Gestisci i sottotitoli video

Aspose.Slides ti consente di gestire i sottotitoli chiusi per i frame video nelle presentazioni PowerPoint. I sottotitoli sono memorizzati nel formato WebVTT e sono esposti tramite il metodo IVideoFrame.getCaptionTracks .

Aggiungi i sottotitoli a un frame video

Per aggiungere i sottotitoli a un frame video:

Crea un’istanza della classe Presentationclass.
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 codice seguente mostra come aggiungere i sottotitoli a un frame video:

Presentation presentation = new Presentation();
try {
    byte[] videoData = // "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 una sovraccarico che consente di aggiungere i sottotitoli da uno stream.

Estrai i sottotitoli da un frame video

Per estrarre i sottotitoli da un frame video:

Carica la presentazione che contiene il video.
Individua l’oggetto IVideoFrame di destinazione.
Itera tra le tracce di sottotitoli restituite da getCaptionTracks.
Salva ciascuna traccia di sottotitoli in un file .vtt.

Il codice seguente mostra come estrarre i sottotitoli da un frame 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.
                FileOutputStream outputStream = new FileOutputStream(captionTrack.getCaptionId() + ".vtt");
                outputStream.write(captionTrack.getBinaryData());
                outputStream.close();
            }
        }
    }
} finally {
    presentation.dispose();
}

Ogni oggetto ICaptions espone l’identificatore del sottotitolo, l’etichetta, i dati binari e i dati del sottotitolo come stringa UTF‑8.

Rimuovi i sottotitoli da un frame video

Per rimuovere i sottotitoli da un frame video:

Carica la presentazione che contiene il video.
Ottieni l’oggetto IVideoFrame di destinazione.
Rimuovi le tracce di sottotitoli dalla collezione restituita da getCaptionTracks.
Salva la presentazione modificata.

Il codice seguente mostra come rimuovere tutti i sottotitoli da un frame 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 frame 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 da una diapositiva

Oltre ad aggiungere video alle diapositive, Aspose.Slides consente di estrarre i video incorporati nelle presentazioni.

Crea un’istanza della classe Presentationper caricare la presentazione contenente il video.
Itera tra tutti gli oggetti ISlide.
Itera tra 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?

È possibile 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 vengono inseriti nel documento, quindi la dimensione della presentazione cresce in proporzione alla dimensione del file. Quando aggiungi un video online, vengono incorporati un collegamento e una miniatura, quindi l’incremento di dimensione è minore.

Posso sostituire il video in un VideoFrame esistente senza cambiare la sua posizione e dimensione?

Sì. È possibile scambiare il contenuto video all’interno del frame mantenendo la geometria della forma; questo è 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 possiede un tipo di contenuto che puoi leggere e utilizzare, ad esempio quando lo salvi su disco.