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

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

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

Введение

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

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

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

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

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

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

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

Этот C++‑код показывает, как добавить локально сохранённое видео в презентацию:

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

// Загружает видео
System::SharedPtr<System::IO::FileStream> fileStream = System::MakeObject<System::IO::FileStream>(u"Wildlife.mp4", System::IO::FileMode::Open, System::IO::FileAccess::Read);
System::SharedPtr<IVideo> video = pres->get_Videos()->AddVideo(fileStream, LoadingStreamBehavior::KeepLocked);

// Получает первый слайд и добавляет видеокадр
pres->get_Slide(0)->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 150.0f, 250.0f, video);

// Сохраняет презентацию на диск
pres->Save(u"pres-with-video.pptx", SaveFormat::Pptx);

В качестве альтернативы вы можете добавить видео, передав путь к файлу напрямую методу AddVideoFrame():

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

System::SharedPtr<ISlide> sld = pres->get_Slide(0);
System::SharedPtr<IVideoFrame> vf = sld->get_Shapes()->AddVideoFrame(50.0f, 150.0f, 300.0f, 150.0f, u"video1.avi");

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

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

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

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

// Путь к директории документов.
const String outPath = u"../out/AddVideoFrameFromWebSource_out.pptx";
const String filePath = u"../templates/video1.avi";

// Создаёт объект Presentation, представляющий файл презентации
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// Получает первый слайд
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// Добавляет видеокадр 
System::SharedPtr<IVideoFrame> vf = slide->get_Shapes()->AddVideoFrame(10, 10, 427, 240,u"https://www.youtube.com/embed/Tj75Arhq5ho");

// Устанавливает режим воспроизведения и громкость видео
vf->set_PlayMode(VideoPlayModePreset::Auto);

//Сохраняет презентацию на диск
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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

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

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

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

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

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

auto presentation = MakeObject<Presentation>();

auto videoData = File::ReadAllBytes(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoData);

auto slide = presentation->get_Slide(0);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(50, 50, 640, 360, video);

videoFrame->set_TrimFromStart(2500.0f);
videoFrame->set_TrimFromEnd(1000.0f);

presentation->Save(u"video_with_trim.pptx", SaveFormat::Pptx);
presentation->Dispose();

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

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

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

auto presentation = MakeObject<Presentation>(u"video_with_trim.pptx");

auto slide = presentation->get_Slide(0);
for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IVideoFrame>(shape))
    {
        auto videoFrame = ExplicitCast<IVideoFrame>(shape);
        auto trimFromStart = videoFrame->get_TrimFromStart();
        auto trimFromEnd = videoFrame->get_TrimFromEnd();

        Console::WriteLine(u"Trim from start: {0} ms", trimFromStart);
        Console::WriteLine(u"Trim from end: {0} ms", trimFromEnd);

        break;
    }
}

presentation->Dispose();

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

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

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

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

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

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

auto presentation = MakeObject<Presentation>();

auto videoData = File::ReadAllBytes(u"video.mp4");
auto video = presentation->get_Videos()->AddVideo(videoData);

auto slide = presentation->get_Slide(0);
auto videoFrame = slide->get_Shapes()->AddVideoFrame(0, 0, 100, 100, video);

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

presentation->Save(u"video_with_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

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

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

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

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

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

auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);

for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IVideoFrame>(shape))
    {
        auto videoFrame = ExplicitCast<IVideoFrame>(shape);
        for (auto&& captionTrack : videoFrame->get_CaptionTracks())
        {
            // Сохраняет дорожку субтитров в файл WebVTT.
            auto filePath = captionTrack->get_CaptionId().ToString() + u".vtt";
            File::WriteAllBytes(filePath, captionTrack->get_BinaryData());
        }
    }
}

presentation->Dispose();

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

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

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

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

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

auto presentation = MakeObject<Presentation>(u"video_with_captions.pptx");
auto slide = presentation->get_Slide(0);
auto videoFrame = ExplicitCast<IVideoFrame>(slide->get_Shape(0));

// Удаляет все субтитры из видеокадра.
videoFrame->get_CaptionTracks()->Clear();

presentation->Save(u"video_without_captions.pptx", SaveFormat::Pptx);
presentation->Dispose();

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

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

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

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

Этот C++‑код демонстрирует, как извлечь видео со слайда презентации:

// Путь к директории документов.
const System::String templatePath = u"../templates/Video.pptx";
const System::String outPath = u"../out/Video_out";

auto presentation = System::MakeObject<Presentation>(templatePath);
for (auto&& slide : presentation->get_Slides())
{
    for (auto&& shape : slide->get_Shapes())
    {
        if (System::ObjectExt::Is<VideoFrame>(shape))
        {
            System::SharedPtr<VideoFrame> vf = System::AsCast<VideoFrame>(shape);
            System::String type = vf->get_EmbeddedVideo()->get_ContentType();
            type = type.Remove(0, type.LastIndexOf('/') + 1);
            auto buffer = vf->get_EmbeddedVideo()->get_BinaryData();

            auto stream = System::MakeObject<System::IO::FileStream>(
                outPath + type, System::IO::FileMode::Create, System::IO::FileAccess::Write,
                System::IO::FileShare::Read);
            stream->Write(buffer, 0, buffer->get_Length());
        }
    }
}

FAQ

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

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

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

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

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

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

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

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

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