Управление видеокадрами в презентациях с использованием Java

О чём эта страница

Узнайте, как программно добавлять и извлекать видеокадры в слайдах PowerPoint и OpenDocument с помощью Aspose.Slides для Java. Быстрое руководство.

Введение

Правильно размещённое видео в презентации может сделать ваше сообщение более убедительным и повысить уровень вовлечённости аудитории.

PowerPoint позволяет добавлять видео на слайд в презентации двумя способами:

Добавить или внедрить локальное видео (хранящееся на вашем компьютере)
Добавить онлайн‑видео (из веб‑источника, например YouTube).

Чтобы вы могли добавлять видеоматериалы (видеообъекты) в презентацию, Aspose.Slides предоставляет интерфейс IVideo, интерфейс IVideoFrame и другие соответствующие типы.

Создание встроенных видеокадров

Если файл видео, который вы хотите добавить на слайд, хранится локально, вы можете создать видеокадр для внедрения видео в презентацию.

Создайте экземпляр класса Presentation .
Получите ссылку на слайд по его индексу.
Добавьте объект IVideo и передайте путь к файлу видео для внедрения его в презентацию.
Добавьте объект IVideoFrame для создания кадра видео.
Сохраните изменённую презентацию.

Этот Java‑код показывает, как добавить локальное видео в презентацию:

// Создаёт экземпляр класса Presentation
Presentation pres = new Presentation("pres.pptx");
try {
    // Загружает видео
    FileInputStream fileStream = new FileInputStream("Wildlife.mp4");
    
    IVideo video = pres.getVideos().addVideo(fileStream, LoadingStreamBehavior.KeepLocked);

    // Получает первый слайд и добавляет видеокадр
    pres.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video);

    // Сохраняет презентацию на диск
    pres.save("pres-with-video.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Кроме того, вы можете добавить видео, передав его путь непосредственно в метод 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();
}

Создание видеокадров с видео из веб‑источников

Microsoft PowerPoint 2013 and newer поддерживает видео YouTube в презентациях. Если нужное вам видео доступно онлайн (например, на YouTube), вы можете добавить его в презентацию через веб‑ссылку.

Создайте экземпляр класса Presentation .
Получите ссылку на слайд по его индексу.
Добавьте объект IVideo и передайте ссылку на видео.
Установите миниатюру для видеокадра.
Сохраните презентацию.

Этот Java‑код показывает, как добавить видео из интернета на слайд презентации PowerPoint:

// Создаёт объект Presentation, представляющий файл презентации
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)
{
    // Добавляет видеокадр
    IVideoFrame videoFrame = pres.getSlides().get_Item(0).getShapes().addVideoFrame(
            10, 10, 427, 240, "https://www.youtube.com/embed/" + videoID);
    videoFrame.setPlayMode(VideoPlayModePreset.Auto);

    // Загружает миниатюру
    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();
    }
}

Обрезка видеокадра

Aspose.Slides позволяет управлять тем, какая часть видео воспроизводится, задавая значения trim‑from‑start и trim‑from‑end через методы IVideoFrame.setTrimFromStart и IVideoFrame.setTrimFromEnd. Оба значения указываются в миллисекундах и определяют, сколько времени пропускается с начала и конца видео соответственно. Эти настройки меняют параметры воспроизведения видео в презентации; они не обрезают и не изменяют встроенные бинарные данные видео.

Установить параметры обрезки

Чтобы создать видеокадр и задать ему параметры обрезки:

Создайте экземпляр класса Presentation .
Добавьте объект IVideo в презентацию.
Добавьте объект IVideoFrame на слайд.
Установите значения trim‑from‑start и trim‑from‑end через IVideoFrame.setTrimFromStart и IVideoFrame.setTrimFromEnd.
Сохраните изменённую презентацию.

Ниже пример кода, который пропускает первые 2,5 секунды и последнюю секунду внедрённого видео при воспроизведении:

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

Прочитать параметры обрезки

Чтобы просмотреть существующие параметры обрезки, загрузите презентацию, найдите объект IVideoFrame среди фигур на первом слайде и получите значения через методы IVideoFrame.getTrimFromStart и IVideoFrame.getTrimFromEnd.

Следующий пример кода находит первый видеокадр на первом слайде и выводит его параметры обрезки в миллисекундах:

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

Управление субтитрами видео

Aspose.Slides позволяет управлять закрытыми субтитрами для видеокадров в презентациях PowerPoint. Субтитры хранятся в формате WebVTT и доступны через метод IVideoFrame.getCaptionTracks .

Добавить субтитры к видеокадру

Чтобы добавить субтитры к видеокадру:

Создайте экземпляр класса Presentation .
Добавьте видео в презентацию.
Добавьте объект IVideoFrame на слайд.
Используйте объект ICaptionsCollection, возвращаемый методом getCaptionTracks, чтобы добавить дорожку субтитров WebVTT.
Сохраните изменённую презентацию.

Следующий код показывает, как добавить субтитры к видеокадру:

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

    // Добавляет новую дорожку субтитров из файла WebVTT.
    videoFrame.getCaptionTracks().add("English", "track.vtt");

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

Интерфейс ICaptionsCollection также предоставляет перегрузку, позволяющую добавить субтитры из потока.

Извлечь субтитры из видеокадра

Чтобы извлечь субтитры из видеокадра:

Загрузите презентацию, содержащую видео.
Найдите целевой объект IVideoFrame .
Пройдитесь по дорожкам субтитров в ICaptionsCollection .
Сохраните каждую дорожку субтитров в файл с расширением .vtt .

Следующий код показывает, как извлечь субтитры из видеокадра:

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()) {
                // Сохраняет дорожку субтитров в файл WebVTT.
                String filePath = captionTrack.getCaptionId().toString() + ".vtt";
                Files.write(Paths.get(filePath), captionTrack.getBinaryData());
            }
        }
    }
} finally {
    presentation.dispose();
}

Каждый объект ICaptions раскрывает идентификатор субтитров, метку, бинарные данные и текст субтитров в виде строки UTF‑8.

Удалить субтитры из видеокадра

Чтобы удалить субтитры из видеокадра:

Загрузите презентацию, содержащую видео.
Получите целевой объект IVideoFrame .
Удалите дорожки субтитров из ICaptionsCollection .
Сохраните изменённую презентацию.

Следующий код показывает, как удалить все субтитры из видеокадра:

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

Если нужно удалить только одну дорожку субтитров, используйте методы remove или removeAt вместо clear .

Извлечение видео со слайдов

Помимо добавления видео в слайды, Aspose.Slides позволяет извлекать видео, внедрённые в презентации.

Создайте экземпляр класса Presentation для загрузки презентации, содержащей видео.
Пройдитесь по всем объектам ISlide .
Пройдитесь по всем объектам IShape в поиске VideoFrame .
Сохраните видео на диск.

Этот Java‑код показывает, как извлечь видео со слайда презентации:

// Создаёт объект Presentation, представляющий файл презентации 
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();

                // Получает расширение файла
                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

Какие параметры воспроизведения видео можно изменить для VideoFrame?

Вы можете управлять режимом воспроизведения (авто или по щелчку) и цикличностью. Эти параметры доступны через свойства объекта VideoFrame .

Влияет ли добавление видео на размер файла PPTX?

Да. При внедрении локального видео его бинарные данные включаются в документ, поэтому размер презентации растёт пропорционально размеру файла. При добавлении онлайн‑видео внедряется ссылка и миниатюра, поэтому увеличение размера меньше.

Можно ли заменить видео в существующем VideoFrame, не меняя его позицию и размер?

Да. Вы можете заменить видеоконтент внутри кадра, сохранив геометрию фигуры; это типичный сценарий обновления медиа в готовом макете.

Можно ли определить тип содержимого (MIME) встроенного видео?

Да. Встроенное видео имеет тип содержимого , который можно прочитать и использовать, например, при сохранении на диск.

Управление эффектами преобразования изображений в презентациях с Java