У管理ление видеокадрами в презентациях на Python

Введение

Видео может помочь объяснить идеи и привлечь аудиторию. Aspose.Slides for Python via .NET позволяет добавлять видеокадры на слайды, менять настройки воспроизведения, управлять субтитрами и извлекать встроенные видеоданные.

PowerPoint поддерживает локальные видео и ссылки на онлайн‑видео, такие как видео YouTube.

Для представления видеоданных и видеокадров Aspose.Slides предоставляет класс Video , класс VideoFrame и другие соответствующие типы.

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

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

В этом примере локальное видео встраивается на первый слайд существующей презентации и сохраняется результат. Координаты и размеры кадра указаны в пунктах. Поток остаётся открытым до завершения сохранения, потому что LoadingStreamBehavior.KEEP_LOCKED удерживает его, пока презентация его использует.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slide = presentation.slides[0]

    with open("video.mp4", "rb") as video_stream:
        video = presentation.videos.add_video(video_stream, slides.LoadingStreamBehavior.KEEP_LOCKED)
        slide.shapes.add_video_frame(10, 10, 150, 250, video)

        presentation.save("embedded_video.pptx", slides.export.SaveFormat.PPTX)

Вы также можете передать путь к локальному видео непосредственно в add_video_frame. В этом примере видео встраивается на первый слайд новой презентации. Видео должно оставаться доступным до сохранения презентации.

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    slide.shapes.add_video_frame(50, 150, 300, 150, "video.avi")

    presentation.save("video_from_path.pptx", slides.export.SaveFormat.PPTX)

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

Microsoft PowerPoint поддерживает онлайн‑видео в презентациях. Вы можете создать видеокадр, который ссылается на онлайн‑видео, например, видео YouTube.

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

from urllib.request import urlopen
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    video_id = "aqz-KE-bpKQ"
    video_url = f"https://www.youtube.com/embed/{video_id}"
    video_frame = slide.shapes.add_video_frame(10, 10, 427, 240, video_url)
    video_frame.play_mode = slides.VideoPlayModePreset.AUTO

    thumbnail_url = f"https://img.youtube.com/vi/{video_id}/hqdefault.jpg"
    with urlopen(thumbnail_url) as response:
        thumbnail_data = response.read()
    thumbnail = presentation.images.add_image(thumbnail_data)
    video_frame.picture_format.picture.image = thumbnail

    presentation.save("online_video.pptx", slides.export.SaveFormat.PPTX)

Воспроизведение видео в полноэкранном режиме

В обучающей презентации вы можете воспроизводить демонстрацию программного обеспечения в полноэкранном режиме, чтобы аудитория могла видеть детали. Установите full_screen_mode в True, чтобы включить это поведение во время воспроизведения.

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

import aspose.slides as slides

with slides.Presentation("training.pptx") as presentation:
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.VideoFrame):
            shape.full_screen_mode = True
            break

    presentation.save("full_screen_video.pptx", slides.export.SaveFormat.PPTX)

Полноэкранное воспроизведение управляет тем, как отображается видео. Независимо от этого, play_mode управляет тем, начинается ли воспроизведение автоматически или по щелчку, а play_loop_mode — повторяется ли оно. Чтобы выбрать поведение запуска, задайте режим воспроизведения VideoPlayModePreset.AUTO or VideoPlayModePreset.ON_CLICK. Пример сохраняет существующие настройки запуска и цикла.

Перемотка видео после воспроизведения

В обучающей презентации возврат демонстрационного видео в начало готовит его к повторному воспроизведению. Установите rewind_video в True, чтобы вернуть видео в начало после завершения воспроизведения.

В этом примере открывается презентация, находится первый VideoFrame на первом слайде и включается перемотка. Он отключает зацикливание, чтобы воспроизведение могло завершиться, и задаёт запуск по щелчку. Входная презентация должна содержать как минимум один слайд с существующим видеокадром на первом слайде.

import aspose.slides as slides

with slides.Presentation("training.pptx") as presentation:
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.VideoFrame):
            shape.rewind_video = True
            shape.play_loop_mode = False
            shape.play_mode = slides.VideoPlayModePreset.ON_CLICK
            break

    presentation.save("rewind_video.pptx", slides.export.SaveFormat.PPTX)

Перемотка возвращает видео в начало без повторного запуска. В отличие от этого, включение play_loop_mode автоматически повторяет воспроизведение. Оставляйте зацикливание отключённым, когда нужно, чтобы видео закончилось и было готово к повторному запуску. play_mode независимо контролирует автоматический или по‑щелчку старт; в этом примере используется VideoPlayModePreset.ON_CLICK, чтобы презентатор сам выбирал, когда начать воспроизведение. Устанавливайте режим воспроизведения после настройки зацикливания, как показано в примере. Перемотка работает независимо от full_screen_mode.

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

Используйте VideoFrame.trim_from_start и VideoFrame.trim_from_end для пропуска части начала или конца видео во время воспроизведения. Обе величины задаются в миллисекундах. Обрезка меняет параметры воспроизведения без изменения встроенных видеоданных.

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

В этом примере локальное видео встраивается и пропускаются первые 2,5 секунды и последняя секунда во время воспроизведения. Используйте видео длиной более 3,5 секунды, чтобы оставался воспроизводимый сегмент.

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with open("video.mp4", "rb") as video_stream:
        video_data = video_stream.read()
    video = presentation.videos.add_video(video_data)

    video_frame = slide.shapes.add_video_frame(50, 50, 640, 360, video)
    video_frame.trim_from_start = 2500.0
    video_frame.trim_from_end = 1000.0

    presentation.save("video_with_trim.pptx", slides.export.SaveFormat.PPTX)

Чтение параметров обрезки

В этом примере выводятся значения обрезки первого видеокадра на первом слайде в миллисекундах. Презентация должна содержать как минимум один слайд. Если на этом слайде нет видеокадра, ничего не выводится. Предыдущий пример дает значения 2500 и 1000.

import aspose.slides as slides

with slides.Presentation("video_with_trim.pptx") as presentation:
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.VideoFrame):
            print(f"Trim from start: {shape.trim_from_start} ms")
            print(f"Trim from end: {shape.trim_from_end} ms")
            break

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

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

Добавление субтитров к видеокадру

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

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with open("video.mp4", "rb") as video_stream:
        video_data = video_stream.read()
    video = presentation.videos.add_video(video_data)

    video_frame = slide.shapes.add_video_frame(0, 0, 100, 100, video)
    video_frame.caption_tracks.add("English", "track.vtt")

    presentation.save("video_with_captions.pptx", slides.export.SaveFormat.PPTX)

Класс CaptionsCollection также предоставляет перегрузку, позволяющую добавить субтитры из потока.

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

В этом примере все дорожки субтитров из видеокадров на первом слайде сохраняются в отдельные файлы WebVTT. Последовательные номера делают файлы различимыми. Консоль выводит количество извлечённых дорожек. Презентация должна содержать как минимум один слайд.

import aspose.slides as slides

with slides.Presentation("video_with_captions.pptx") as presentation:
    slide = presentation.slides[0]

    track_count = 0
    for shape in slide.shapes:
        if isinstance(shape, slides.VideoFrame):
            for caption_track in shape.caption_tracks:
                track_count += 1
                output_path = f"captions_{track_count}.vtt"
                with open(output_path, "wb") as track_stream:
                    track_stream.write(bytes(caption_track.binary_data))

    print(f"Caption tracks extracted: {track_count}")

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

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

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

import aspose.slides as slides

with slides.Presentation("video_with_captions.pptx") as presentation:
    slide = presentation.slides[0]
    
    video_frame = slide.shapes[0]
    video_frame.caption_tracks.clear()

    presentation.save("video_without_captions.pptx", slides.export.SaveFormat.PPTX)

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

Поиск субтитров видео

Captions.data_as_string возвращает всю дорожку WebVTT, включая заголовок, строки тайминга и текст субтитров. Например, английская дорожка на слайде 2 может содержать такой cue:

WEBVTT Café tour

00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

В этом примере открывается captioned_media.pptx и читаются caption_tracks каждого видеокадра верхнего уровня на всех слайдах. Для каждого простого текста cue находят строку тайминга, содержащую -->, и собирают строки субтитров до следующей пустой строки или конца дорожки. Выполняется поиск текста субтитров на наличие слова “café” без учёта регистра, и выводятся номер слайда, метка дорожки, оригинальная строка тайминга и полный субтитр для каждого совпадения.

import aspose.slides as slides

with slides.Presentation("captioned_media.pptx") as presentation:
    for slide in presentation.slides:
        for shape in slide.shapes:
            if not isinstance(shape, slides.VideoFrame):
                continue

            for track in shape.caption_tracks:
                lines = iter(track.data_as_string.splitlines())
                for timing in lines:
                    if "-->" not in timing:
                        continue

                    caption_lines = []
                    for line in lines:
                        if not line:
                            break
                        caption_lines.append(line)

                    caption = "\n".join(caption_lines)
                    if "café" in caption.casefold():
                        print(f"Slide {slide.slide_number} | {track.label} | {timing}")
                        print(caption)

Образцовая дорожка даёт одно совпадение. “Café” в заголовке находится вне текста субтитров, а вывод сохраняет настройку тайминга и обе строки субтитров.

Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

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

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

В этом примере из каждого слайда извлекаются встроенные видео в отдельные нумерованные бинарные файлы. Связанные видео пропускаются, так как у них нет встроенных данных. Консоль выводит тип MIME каждого видео и общее количество. Вывод использует обобщённое расширение .bin; при необходимости замените его на соответствующее типу медиа.

import aspose.slides as slides

with slides.Presentation("presentation_with_videos.pptx") as presentation:
    video_count = 0
    for slide in presentation.slides:
        for shape in slide.shapes:
            if isinstance(shape, slides.VideoFrame):
                video = shape.embedded_video
                if video is None:
                    print("Skipped a linked video: no embedded data is available.")
                    continue

                video_count += 1
                output_path = f"extracted_video_{video_count}.bin"
                with open(output_path, "wb") as video_stream:
                    video_stream.write(bytes(video.binary_data))
                print(f"Video {video_count}: {video.content_type}")

    print(f"Embedded videos extracted: {video_count}")

Часто задаваемые вопросы

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

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

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

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

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

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

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

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