Gestionar marcos de vídeo en presentaciones utilizando Java

Un vídeo bien colocado en una presentación puede hacer que su mensaje sea más convincente y aumentar los niveles de participación de la audiencia.

PowerPoint le permite añadir vídeos a una diapositiva de una presentación de dos maneras:

Añadir o incrustar un vídeo local (almacenado en su equipo)
Añadir un vídeo en línea (desde una fuente web como YouTube).

Para permitirle añadir vídeos (objetos de vídeo) a una presentación, Aspose.Slides proporciona la interfaz IVideo , la interfaz IVideoFrame y otros tipos relevantes.

Crear marcos de vídeo incrustados

Si el archivo de vídeo que desea añadir a su diapositiva está almacenado localmente, puede crear un marco de vídeo para incrustar el vídeo en su presentación.

Cree una instancia de la clase Presentation.
Obtenga la referencia de una diapositiva a través de su índice.
Añada un objeto IVideo y pase la ruta del archivo de vídeo para incrustar el vídeo en la presentación.
Añada un objeto IVideoFrame para crear un marco para el vídeo.
Guarde la presentación modificada.

Este código Java le muestra cómo añadir un vídeo almacenado localmente a una presentación:

// Instancia la clase Presentation
Presentation pres = new Presentation("pres.pptx");
try {
    // Carga el vídeo
    FileInputStream fileStream = new FileInputStream("Wildlife.mp4");
    
    IVideo video = pres.getVideos().addVideo(fileStream, LoadingStreamBehavior.KeepLocked);

    // Obtiene la primera diapositiva y añade un marco de vídeo
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);

    // Guarda la presentación en disco
    pres.save("pres-with-video.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Alternativamente, puede añadir un vídeo pasando directamente su ruta de archivo al método 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();
}

Crear marcos de vídeo con vídeo de fuentes web

Microsoft PowerPoint 2013 y versiones posteriores admite vídeos de YouTube en presentaciones. Si el vídeo que desea usar está disponible en línea (por ejemplo, en YouTube), puede añadirlo a su presentación mediante su enlace web.

Cree una instancia de la clase Presentation
Obtenga la referencia de una diapositiva a través de su índice.
Añada un objeto IVideo y pase el enlace al vídeo.
Establezca una miniatura para el marco de vídeo.
Guarde la presentación.

Este código Java le muestra cómo añadir un vídeo desde la web a una diapositiva en una presentación de PowerPoint:

// Instancia un objeto Presentation que representa un archivo de presentación 
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)
{
    // Añade 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);

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

Gestionar subtítulos de vídeo

Aspose.Slides le permite gestionar subtítulos cerrados para marcos de vídeo en presentaciones de PowerPoint. Los subtítulos se almacenan en formato WebVTT y se exponen mediante el método IVideoFrame.getCaptionTracks .

Añadir subtítulos a un marco de vídeo

Para añadir subtítulos a un marco de vídeo:

Cree una instancia de la clase Presentation .
Añada un vídeo a la presentación.
Añada un objeto IVideoFrame a una diapositiva.
Utilice la ICaptionsCollection devuelta por getCaptionTracks para añadir una pista de subtítulos WebVTT.
Guarde la presentación modificada.

El siguiente código le muestra cómo añadir subtítulos a un marco de vídeo:

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);

    // Añade una nueva pista de subtítulos desde un archivo WebVTT.
    videoFrame.getCaptionTracks().add("English", "track.vtt");

    presentation.save("video_with_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

La interfaz ICaptionsCollection también proporciona una sobrecarga que permite añadir subtítulos desde un flujo.

Extraer subtítulos de un marco de vídeo

Para extraer subtítulos de un marco de vídeo:

Cargue la presentación que contiene el vídeo.
Encuentre el objeto IVideoFrame objetivo.
Itere a través de las pistas de subtítulos en la ICaptionsCollection .
Guarde cada pista de subtítulos en un archivo .vtt.

El siguiente código le muestra cómo extraer subtítulos de un marco de vídeo:

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()) {
                // Guarda la pista de subtítulos en un archivo WebVTT.
                String filePath = captionTrack.getCaptionId().toString() + ".vtt";
                Files.write(Paths.get(filePath), captionTrack.getBinaryData());
            }
        }
    }
} finally {
    presentation.dispose();
}

Cada objeto ICaptions expone el identificador del subtítulo, la etiqueta, los datos binarios y el texto del subtítulo como una cadena UTF-8.

Eliminar subtítulos de un marco de vídeo

Para eliminar subtítulos de un marco de vídeo:

Cargue la presentación que contiene el vídeo.
Obtenga el objeto IVideoFrame objetivo.
Elimine las pistas de subtítulos de la ICaptionsCollection .
Guarde la presentación modificada.

El siguiente código le muestra cómo eliminar todos los subtítulos de un marco de vídeo:

Presentation presentation = new Presentation("video_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IVideoFrame videoFrame = (IVideoFrame)slide.getShapes().get_Item(0);

    // Elimina todos los subtítulos del marco de vídeo.
    videoFrame.getCaptionTracks().clear();

    presentation.save("video_without_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Si necesita eliminar solo una pista de subtítulos, utilice los métodos remove o removeAt en lugar de clear .

Extraer vídeo de diapositivas

Además de añadir vídeos a las diapositivas, Aspose.Slides le permite extraer los vídeos incrustados en presentaciones.

Cree una instancia de la clase Presentation para cargar la presentación que contiene el vídeo.
Itere a través de todos los objetos ISlide .
Itere a través de todos los objetos IShape para encontrar un VideoFrame .
Guarde el vídeo en el disco.

Este código Java le muestra cómo extraer el vídeo de una diapositiva de presentación:

// Instancia un objeto Presentation que representa un archivo de presentación 
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();

                //Obtiene la extensión del archivo
                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

¿Qué parámetros de reproducción de vídeo pueden modificarse en un VideoFrame?

Puede controlar el modo de reproducción (automático o con clic) y el bucle. Estas opciones están disponibles a través de las propiedades del objeto VideoFrame .

¿Afecta la incorporación de un vídeo al tamaño del archivo PPTX?

Sí. Cuando incrusta un vídeo local, los datos binarios se incluyen en el documento, por lo que el tamaño de la presentación crece proporcionalmente al tamaño del archivo. Cuando añade un vídeo en línea, se incrustan un enlace y una miniatura, por lo que el aumento de tamaño es menor.

¿Puedo sustituir el vídeo en un VideoFrame existente sin cambiar su posición y tamaño?

Sí. Puede intercambiar el contenido del vídeo dentro del marco conservando la geometría de la forma; este es un escenario habitual para actualizar medios en un diseño existente.

¿Se puede determinar el tipo de contenido (MIME) de un vídeo incrustado?

Sí. Un vídeo incrustado tiene un tipo de contenido que puede leer y utilizar, por ejemplo al guardarlo en el disco.