Kelola Bingkai Video dalam Presentasi Menggunakan PHP

Tentang apa halaman ini

Pelajari cara menambahkan dan mengekstrak bingkai video secara programatik dalam slide PowerPoint dan OpenDocument menggunakan Aspose.Slides untuk PHP via Java. Panduan singkat cara melakukannya.

Pendahuluan

Video yang ditempatkan dengan tepat dalam presentasi dapat membuat pesan Anda lebih menarik dan meningkatkan tingkat keterlibatan dengan audiens.

PowerPoint memungkinkan Anda menambahkan video ke slide dalam presentasi dengan dua cara:

• Tambahkan atau sematkan video lokal (disimpan di komputer Anda)
• Tambahkan video daring (dari sumber web seperti YouTube).

Untuk memungkinkan Anda menambahkan video (objek video) ke presentasi, Aspose.Slides menyediakan kelas Video, kelas VideoFrame, dan tipe relevan lainnya.

Buat Bingkai Video Tertanam

Jika file video yang ingin Anda tambahkan ke slide disimpan secara lokal, Anda dapat membuat bingkai video untuk menyematkan video dalam presentasi Anda.

1. Buat instance kelas Presentation.
2. Dapatkan referensi slide melalui indeksnya.
3. Tambahkan objek Video dan berikan jalur file video untuk menyematkan video dalam presentasi.
4. Tambahkan objek VideoFrame untuk membuat bingkai video.
5. Simpan presentasi yang telah dimodifikasi.

Kode PHP berikut menunjukkan cara menambahkan video yang disimpan secara lokal ke presentasi:

  # Membuat instance kelas Presentation
  $pres = new Presentation("pres.pptx");
  try {
    # Memuat video
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
    # Mengambil slide pertama dan menambahkan bingkai video
    $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(10, 10, 150, 250, $video);
    # Menyimpan presentasi ke disk
    $pres->save("pres-with-video.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Sebagai alternatif, Anda dapat menambahkan video dengan memberikan jalur file secara langsung ke metode 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();
    }
  }

Buat Bingkai Video dengan Video dari Sumber Web

Microsoft PowerPoint 2013 dan yang lebih baru mendukung video YouTube dalam presentasi. Jika video yang ingin Anda gunakan tersedia secara daring (misalnya di YouTube), Anda dapat menambahkannya ke presentasi melalui tautan webnya.

1. Buat instance kelas Presentation.
2. Dapatkan referensi slide melalui indeksnya.
3. Tambahkan objek Video dan berikan tautan ke video.
4. Atur thumbnail untuk bingkai video.
5. Simpan presentasi.

Kode PHP berikut menunjukkan cara menambahkan video dari web ke slide dalam presentasi PowerPoint:

  # Membuat objek Presentation yang mewakili file presentasi
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Potong Bingkai Video

Aspose.Slides memungkinkan Anda mengontrol bagian video yang diputar dengan mengatur nilai trim-from-start dan trim-from-end melalui VideoFrame::setTrimFromStart dan VideoFrame::setTrimFromEnd. Kedua nilai ditentukan dalam milidetik dan menentukan berapa banyak waktu yang dilewati dari awal dan akhir video, masing‑masing. Pengaturan ini mengubah pengaturan pemutaran video dalam presentasi; mereka tidak memotong atau mengubah data biner video yang disematkan.

Atur Pengaturan Pemotongan

Untuk membuat bingkai video dan mengatur pengaturan pemotongannya:

1. Buat instance kelas Presentation.
2. Tambahkan objek Video ke presentasi.
3. Tambahkan objek VideoFrame ke slide.
4. Atur nilai trim-from-start dan trim-from-end melalui VideoFrame::setTrimFromStart dan VideoFrame::setTrimFromEnd.
5. Simpan presentasi yang telah dimodifikasi.

Contoh kode berikut melewati 2,5 detik pertama dan satu detik terakhir dari video yang disematkan selama pemutaran:

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

Baca Pengaturan Pemotongan

Untuk memeriksa pengaturan pemotongan yang ada, muat presentasi, temukan objek VideoFrame di antara shape pada slide pertama, dan baca nilai melalui VideoFrame::getTrimFromStart dan VideoFrame::getTrimFromEnd.

Contoh kode berikut menemukan bingkai video pertama pada slide pertama dan melaporkan pengaturan pemotongannya dalam milidetik:

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

Kelola Teks Tertutup Video

Aspose.Slides memungkinkan Anda mengelola teks tertutup (closed captions) untuk bingkai video dalam presentasi PowerPoint. Teks tertutup disimpan dalam format WebVTT dan dapat diakses melalui metode VideoFrame::getCaptionTracks.

Tambahkan Teks Tertutup ke Bingkai Video

Untuk menambahkan teks tertutup ke bingkai video:

1. Buat instance kelas Presentation.
2. Tambahkan video ke presentasi.
3. Tambahkan objek VideoFrame ke slide.
4. Gunakan koleksi CaptionsCollection yang dikembalikan oleh getCaptionTracks untuk menambahkan trek teks WebVTT.
5. Simpan presentasi yang telah dimodifikasi.

Kode berikut menunjukkan cara menambahkan teks tertutup ke bingkai 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);

    // Menambahkan trek teks baru dari file WebVTT.
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

Kelas CaptionsCollection juga menyediakan overload yang memungkinkan Anda menambahkan teks dari stream.

Ekstrak Teks Tertutup dari Bingkai Video

Untuk mengekstrak teks tertutup dari bingkai video:

1. Muat presentasi yang berisi video.
2. Temukan objek VideoFrame target.
3. Iterasi melalui koleksi getCaptionTracks.
4. Simpan setiap trek teks ke file .vtt.

Kode berikut menunjukkan cara mengekstrak teks tertutup dari bingkai 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);
                // Menyimpan trek teks ke file WebVTT.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Setiap objek Captions menampilkan identifier teks, label, data biner, dan teks caption sebagai string UTF‑8.

Hapus Teks Tertutup dari Bingkai Video

Untuk menghapus teks tertutup dari bingkai video:

1. Muat presentasi yang berisi video.
2. Dapatkan objek VideoFrame target.
3. Hapus trek teks dari koleksi getCaptionTracks.
4. Simpan presentasi yang telah dimodifikasi.

Kode berikut menunjukkan cara menghapus semua teks tertutup dari bingkai video:

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

    // Menghapus semua teks tertutup dari bingkai video.
    $videoFrame->getCaptionTracks()->clear();

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

Jika Anda perlu menghapus hanya satu trek teks, gunakan metode remove atau removeAt alih‑alih clear.

Ekstrak Video dari Slide

Selain menambahkan video ke slide, Aspose.Slides memungkinkan Anda mengekstrak video yang disematkan dalam presentasi.

1. Buat instance kelas Presentation untuk memuat presentasi yang berisi video.
2. Iterasi melalui semua objek Slide.
3. Iterasi melalui semua objek Shape untuk menemukan VideoFrame.
4. Simpan video ke disk.

Kode PHP berikut menunjukkan cara mengekstrak video pada slide presentasi:

  # Membuat objek Presentation yang mewakili file presentasi
  $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();
          # Mendapatkan ekstensi file
          $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();
    }
  }

FAQ

Parameter pemutaran video mana yang dapat diubah untuk VideoFrame?

Anda dapat mengontrol mode pemutaran (otomatis atau saat diklik) dan pengulangan. Opsi ini tersedia melalui properti objek VideoFrame.

Apakah menambahkan video memengaruhi ukuran file PPTX?

Ya. Ketika Anda menyematkan video lokal, data biner termasuk dalam dokumen, sehingga ukuran presentasi bertambah secara proporsional dengan ukuran file. Ketika Anda menambahkan video daring, tautan dan thumbnail disematkan, sehingga peningkatan ukuran lebih kecil.

Bisakah saya mengganti video dalam VideoFrame yang ada tanpa mengubah posisi dan ukurannya?

Ya. Anda dapat menukar konten video di dalam bingkai sambil mempertahankan geometri shape; ini merupakan skenario umum untuk memperbarui media dalam tata letak yang ada.

Dapatkah tipe konten (MIME) video yang disematkan ditentukan?

Ya. Video yang disematkan memiliki tipe konten yang dapat Anda baca dan gunakan, misalnya saat menyimpannya ke disk.