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

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

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

Введение

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

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

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

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

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

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

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

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

  # Создаёт экземпляр класса Presentation
  $pres = new Presentation("pres.pptx");
  try {
    # Загружает видео
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $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 (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Кроме того, вы можете добавить видео, передав путь к файлу напрямую в метод addVideoFrame(float x, float y, float width, float height, Video video) :

  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    $vf = $sld->getShapes()->addVideoFrame(50, 150, 300, 150, "video1.avi");
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

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

  # Создаёт объект Presentation, представляющий файл презентации
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

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

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

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

$presentation = new Presentation();
$videoStream = null;
try {
    $videoStream = new Java("java.io.FileInputStream", "video.mp4");
    $video = $presentation->getVideos()->addVideo(
        $videoStream, LoadingStreamBehavior::ReadStreamAndRelease);
    $slide = $presentation->getSlides()->get_Item(0);
    $videoFrame = $slide->getShapes()->addVideoFrame(50, 50, 640, 360, $video);

    $videoFrame->setTrimFromStart(2500);
    $videoFrame->setTrimFromEnd(1000);

    $presentation->save("video_with_trim.pptx", SaveFormat::Pptx);
} finally {
    if ($videoStream !== null) {
        $videoStream->close();
    }
    $presentation->dispose();
}

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

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

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

$presentation = new Presentation("video_with_trim.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shapeCount = java_values($slide->getShapes()->size());
    for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) {
        $shape = $slide->getShapes()->get_Item($shapeIndex);
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.VideoFrame"))) {
            $videoFrame = $shape;
            $trimFromStart = java_values($videoFrame->getTrimFromStart());
            $trimFromEnd = java_values($videoFrame->getTrimFromEnd());

            echo "Trim from start: " . $trimFromStart . " ms\n";
            echo "Trim from end: " . $trimFromEnd . " ms\n";
            break;
        }
    }
} finally {
    $presentation->dispose();
}

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

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

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

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

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

$presentation = new Presentation();
try {
    $videoData = file_get_contents("video.mp4");
    $video = $presentation->getVideos()->addVideo($videoData);

    $slide = $presentation->getSlides()->get_Item(0);
    $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();
}

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

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

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

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

$presentation = new Presentation("video_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shapeCount = java_values($slide->getShapes()->size());
    for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) {
        $shape = $slide->getShapes()->get_Item($shapeIndex);
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.VideoFrame"))) {
            $videoFrame = $shape;
            $trackCount = java_values($videoFrame->getCaptionTracks()->getCount());
            for ($trackIndex = 0; $trackIndex < $trackCount; $trackIndex++) {
                $captionTrack = $videoFrame->getCaptionTracks()->get_Item($trackIndex);
                // Сохраняет дорожку субтитров в файл WebVTT.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

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

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

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

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

$presentation = new Presentation("video_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $videoFrame = $slide->getShapes()->get_Item(0); // тип: VideoFrame

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

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

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

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

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

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

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

  # Создаёт объект Presentation, представляющий файл презентации
  $pres = new Presentation("VideoSample.pptx");
  try {
    foreach($pres->getSlides() as $slide) {
      foreach($slide->getShapes() as $shape) {
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.VideoFrame"))) {
          $vf = $shape;
          $type = $vf->getEmbeddedVideo()->getContentType();
          $ss = $type->lastIndexOf('-');
          $buffer = $vf->getEmbeddedVideo()->getBinaryData();
          # Получает расширение файла
          $charIndex = $type->indexOf("/");
          $type = $type->substring($charIndex + 1);
          $fop = new Java("java.io.FileOutputStream", "testing2." . $type);
          $fop->write($buffer);
          $fop->flush();
          $fop->close();
        }
      }
    }
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

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

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

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

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

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

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

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