Quản lý khung video trong bản trình bày bằng PHP

Trang này nói về điều gì

Tìm hiểu cách thêm và trích xuất khung video một cách lập trình trong các slide PowerPoint và OpenDocument bằng Aspose.Slides cho PHP qua Java. Hướng dẫn nhanh cách thực hiện.

Giới thiệu

Một video được đặt đúng vị trí trong bản trình bày có thể làm cho thông điệp của bạn trở nên hấp dẫn hơn và tăng mức độ tương tác với khán giả.

PowerPoint cho phép bạn thêm video vào một slide trong bản trình bày theo hai cách:

Thêm hoặc nhúng video cục bộ (được lưu trên máy của bạn)
Thêm video trực tuyến (từ nguồn web như YouTube).

Để cho phép bạn thêm video (đối tượng video) vào bản trình bày, Aspose.Slides cung cấp lớp Video, lớp VideoFrame và các kiểu liên quan khác.

Tạo khung video nhúng

Nếu tệp video bạn muốn thêm vào slide được lưu cục bộ, bạn có thể tạo một khung video để nhúng video vào bản trình bày.

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới slide thông qua chỉ mục của nó.
Thêm một đối tượng Video và truyền đường dẫn tệp video để nhúng video vào bản trình bày.
Thêm một đối tượng VideoFrame để tạo khung cho video.
Lưu bản trình bày đã sửa đổi.

Đoạn mã PHP sau cho bạn thấy cách thêm video được lưu cục bộ vào bản trình bày:

  # Khởi tạo lớp Presentation
  $pres = new Presentation("pres.pptx");
  try {
    # Tải video
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
    # Lấy slide đầu tiên và thêm khung video
    $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(10, 10, 150, 250, $video);
    # Lưu bản trình bày vào đĩa
    $pres->save("pres-with-video.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ngoài ra, bạn có thể thêm video bằng cách truyền trực tiếp đường dẫn tệp vào phương thức 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();
    }
  }

Tạo khung video với video từ nguồn web

Microsoft PowerPoint 2013 và mới hơn hỗ trợ video YouTube trong bản trình bày. Nếu video bạn muốn sử dụng có sẵn trực tuyến (ví dụ: trên YouTube), bạn có thể thêm nó vào bản trình bày qua liên kết web của nó.

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới slide thông qua chỉ mục của nó.
Thêm một đối tượng Video và truyền liên kết đến video.
Đặt hình thu nhỏ cho khung video.
Lưu bản trình bày.

Đoạn mã PHP sau cho bạn thấy cách thêm video từ web vào một slide trong bản trình bày PowerPoint:

  # Khởi tạo một đối tượng Presentation đại diện cho tệp bản trình bày
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Cắt xén khung video

Aspose.Slides cho phép bạn kiểm soát phần nào của video sẽ được phát bằng cách thiết lập giá trị trim-from-start và trim-from-end thông qua VideoFrame::setTrimFromStart và VideoFrame::setTrimFromEnd. Cả hai giá trị đều được chỉ định bằng mili giây và xác định thời gian bị bỏ qua từ đầu và cuối video, tương ứng. Các thiết lập này thay đổi cách phát video trong bản trình bày; chúng không cắt hoặc sửa đổi dữ liệu nhị phân của video đã nhúng.

Đặt thiết lập cắt xén

Để tạo một khung video và thiết lập các giá trị cắt xén:

Tạo một thể hiện của lớp Presentation.
Thêm một đối tượng Video vào bản trình bày.
Thêm một đối tượng VideoFrame vào slide.
Đặt giá trị trim-from-start và trim-from-end thông qua VideoFrame::setTrimFromStart và VideoFrame::setTrimFromEnd.
Lưu bản trình bày đã sửa đổi.

Đoạn mã sau bỏ qua 2,5 giây đầu và 1 giây cuối của video đã nhúng khi phát:

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

Đọc thiết lập cắt xén

Để kiểm tra các thiết lập cắt xén hiện có, tải một bản trình bày, tìm đối tượng VideoFrame trong các shape trên slide đầu tiên, và đọc các giá trị qua VideoFrame::getTrimFromStart và VideoFrame::getTrimFromEnd.

Đoạn mã sau tìm khung video đầu tiên trên slide đầu tiên và báo cáo các thiết lập cắt xén tính bằng mili giây:

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

Quản lý phụ đề video

Aspose.Slides cho phép bạn quản lý phụ đề đóng (closed captions) cho các khung video trong bản trình bày PowerPoint. Phụ đề được lưu ở định dạng WebVTT và được truy cập thông qua phương pháp VideoFrame::getCaptionTracks.

Thêm phụ đề vào khung video

Để thêm phụ đề vào khung video:

Tạo một thể hiện của lớp Presentation.
Thêm một video vào bản trình bày.
Thêm một đối tượng VideoFrame vào slide.
Sử dụng bộ sưu tập CaptionsCollection trả về bởi getCaptionTracks để thêm một track phụ đề WebVTT.
Lưu bản trình bày đã sửa đổi.

Đoạn mã sau cho bạn thấy cách thêm phụ đề vào khung video:

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

    // Thêm một track phụ đề mới từ tệp WebVTT.
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

Lớp CaptionsCollection cũng cung cấp một overload cho phép bạn thêm phụ đề từ một luồng (stream).

Trích xuất phụ đề từ khung video

Để trích xuất phụ đề từ khung video:

Tải bản trình bày chứa video.
Tìm đối tượng VideoFrame mục tiêu.
Duyệt qua bộ sưu tập getCaptionTracks.
Lưu mỗi track phụ đề vào tệp .vtt.

Đoạn mã sau cho bạn thấy cách trích xuất phụ đề từ khung video:

$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);
                // Lưu track phụ đề vào tệp WebVTT.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Mỗi đối tượng Captions cung cấp mã nhận dạng phụ đề, nhãn, dữ liệu nhị phân và văn bản phụ đề dưới dạng chuỗi UTF‑8.

Xóa phụ đề khỏi khung video

Để xóa phụ đề khỏi khung video:

Tải bản trình bày chứa video.
Lấy đối tượng VideoFrame mục tiêu.
Xóa các track phụ đề khỏi bộ sưu tập getCaptionTracks.
Lưu bản trình bày đã sửa đổi.

Đoạn mã sau cho bạn thấy cách xóa tất cả phụ đề khỏi khung video:

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

    // Xóa tất cả phụ đề khỏi khung video.
    $videoFrame->getCaptionTracks()->clear();

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

Nếu bạn chỉ cần xóa một track phụ đề, hãy sử dụng phương pháp remove hoặc removeAt thay vì clear.

Trích xuất video từ slide

Ngoài việc thêm video vào slide, Aspose.Slides cho phép bạn trích xuất video đã nhúng trong bản trình bày.

Tạo một thể hiện của lớp Presentation để tải bản trình bày chứa video.
Duyệt qua tất cả các đối tượng Slide.
Duyệt qua tất cả các đối tượng Shape để tìm một VideoFrame.
Lưu video ra đĩa.

Đoạn mã PHP sau cho bạn thấy cách trích xuất video trên một slide của bản trình bày:

  # Khởi tạo một đối tượng Presentation đại diện cho tệp bản trình bày
  $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();
          # Lấy phần mở rộng tệp
          $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();
    }
  }

Câu hỏi thường gặp

Các tham số phát video nào có thể thay đổi cho một VideoFrame?

Bạn có thể kiểm soát chế độ phát lại (tự động hoặc khi nhấp) và vòng lặp. Các tùy chọn này có sẵn qua các thuộc tính của đối tượng VideoFrame.

Việc thêm video có ảnh hưởng đến kích thước tệp PPTX không?

Có. Khi bạn nhúng video cục bộ, dữ liệu nhị phân được đưa vào tài liệu, vì vậy kích thước bản trình bày tăng tỷ lệ với kích thước tệp. Khi bạn thêm video trực tuyến, một liên kết và hình thu nhỏ được nhúng, do đó tăng kích thước là ít hơn.

Tôi có thể thay thế video trong một VideoFrame hiện có mà không thay đổi vị trí và kích thước không?

Có. Bạn có thể hoán đổi nội dung video trong khung trong khi giữ nguyên hình học của shape; đây là kịch bản thường gặp khi cập nhật phương tiện trong bố cục hiện có.

Có thể xác định loại nội dung (MIME) của một video đã nhúng không?

Có. Một video đã nhúng có một loại nội dung mà bạn có thể đọc và sử dụng, ví dụ khi lưu nó ra đĩa.

Quản lý các hiệu ứng biến đổi ảnh trong bản trình chiếu bằng PHP