Kelola Bingkai Video dalam Presentasi Menggunakan Python

Tentang apa halaman ini

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

Pendahuluan

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

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

Tambahkan atau sematkan video lokal (disimpan di mesin 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 terkait lainnya.

Membuat Bingkai Video Tersemat

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

Buat instance kelas Presentation .
Dapatkan referensi ke slide berdasarkan indeksnya.
Tambahkan objek Video dan berikan data file video untuk menyematkan video dalam presentasi.
Tambahkan objek VideoFrame untuk membuat bingkai bagi video.
Simpan presentasi yang dimodifikasi.

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

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("pres.pptx")
try:
    video_data = Path("Wildlife.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    presentation.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 150, 250, video)
    presentation.save("pres-with-video.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Sebagai alternatif, Anda dapat menambahkan video dengan mengirimkan jalur filenya langsung ke metode addVideoFrame :

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(50, 150, 300, 150, "video1.avi")
finally:
    presentation.dispose()

Buat Bingkai Video dengan Video dari Sumber Web

Microsoft PowerPoint 2013 dan 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.

Buat instance kelas Presentation .
Dapatkan referensi ke slide berdasarkan indeksnya.
Tambahkan objek VideoFrame dan berikan tautan ke video.
Atur gambar mini untuk bingkai video.
Simpan presentasi.

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

from urllib.request import urlopen

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, VideoPlayModePreset

video_id = "Tj75Arhq5ho"
presentation = Presentation()
try:
    video_frame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(10, 10, 427, 240, "https://www.youtube.com/embed/" + video_id)
    video_frame.setPlayMode(VideoPlayModePreset.Auto)

    # Muat gambar mini.
    thumbnail_uri = "https://img.youtube.com/vi/" + video_id + "/hqdefault.jpg"
    try:
        with urlopen(thumbnail_uri) as response:
            thumbnail_data = response.read()
        java_thumbnail_data = jpype.JArray(jpype.JByte)(thumbnail_data)
        thumbnail = presentation.getImages().addImage(java_thumbnail_data)
        video_frame.getPictureFormat().getPicture().setImage(thumbnail)
    except OSError as error:
        print("Could not load the thumbnail:", error)

    presentation.save("out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Memotong 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 mendefinisikan 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 tersemat.

Atur Pengaturan Potong

Untuk membuat bingkai video dan mengatur pengaturan potongnya:

Buat instance kelas Presentation .
Tambahkan objek Video ke presentasi.
Tambahkan objek VideoFrame ke slide.
Atur nilai trim-from-start dan trim-from-end melalui VideoFrame.setTrimFromStart dan VideoFrame.setTrimFromEnd .
Simpan presentasi yang dimodifikasi.

Contoh kode berikut melewatkan 2,5 detik pertama dan satu detik terakhir dari video tersemat selama pemutaran:

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(50, 50, 640, 360, video)

    video_frame.setTrimFromStart(2500.0)
    video_frame.setTrimFromEnd(1000.0)
    presentation.save("video_with_trim.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Baca Pengaturan Potong

Untuk memeriksa pengaturan potong yang ada, muat presentasi, temukan objek VideoFrame di antara bentuk 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 potongnya dalam milidetik:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("video_with_trim.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            trim_from_start = shape.getTrimFromStart()
            trim_from_end = shape.getTrimFromEnd()
            print(f"Trim from start: {trim_from_start} ms")
            print(f"Trim from end: {trim_from_end} ms")
            break
finally:
    presentation.dispose()

Kelola Caption Video

Aspose.Slides memungkinkan Anda mengelola caption tertutup untuk bingkai video dalam presentasi PowerPoint. Caption disimpan dalam format WebVTT dan dapat diakses melalui metode VideoFrame.getCaptionTracks .

Tambahkan Caption ke Bingkai Video

Untuk menambahkan caption ke bingkai video:

Buat instance kelas Presentation .
Tambahkan video ke presentasi.
Tambahkan objek VideoFrame ke slide.
Gunakan CaptionsCollection yang dikembalikan oleh getCaptionTracks untuk menambahkan trek caption WebVTT.
Simpan presentasi yang dimodifikasi.

Kode berikut menunjukkan cara menambahkan caption ke bingkai video:

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    video_data = Path("video.mp4").read_bytes()
    java_video_data = jpype.JArray(jpype.JByte)(video_data)
    video = presentation.getVideos().addVideo(java_video_data)
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().addVideoFrame(0, 0, 100, 100, video)

    # Tambahkan trek caption baru dari file WebVTT.
    video_frame.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 caption dari stream.

Ekstrak Caption dari Bingkai Video

Untuk mengekstrak caption dari bingkai video:

Muat presentasi yang berisi video.
Temukan objek VideoFrame target.
Iterasi melalui trek caption dalam CaptionsCollection .
Simpan setiap trek caption ke file .vtt .

Kode berikut menunjukkan cara mengekstrak caption dari bingkai video:

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("video_with_captions.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, VideoFrame):
            for caption_track in shape.getCaptionTracks():
                # Simpan trek caption ke file WebVTT.
                file_path = Path(str(caption_track.getCaptionId()) + ".vtt")
                caption_data = bytes(caption_track.getBinaryData())
                file_path.write_bytes(caption_data)
finally:
    presentation.dispose()

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

Hapus Caption dari Bingkai Video

Untuk menghapus caption dari bingkai video:

Muat presentasi yang berisi video.
Dapatkan objek VideoFrame target.
Hapus trek caption dari CaptionsCollection .
Simpan presentasi yang dimodifikasi.

Kode berikut menunjukkan cara menghapus semua caption dari bingkai video:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, VideoFrame

presentation = Presentation("video_with_captions.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    video_frame = slide.getShapes().get_Item(0)
    if isinstance(video_frame, VideoFrame):
        # Hapus semua caption dari bingkai video.
        video_frame.getCaptionTracks().clear()
        presentation.save("video_without_captions.pptx", SaveFormat.Pptx)
    else:
        print("The shape is not a video frame.")
finally:
    presentation.dispose()

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

Ekstrak Video dari Slide

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

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

Kode Python berikut menunjukkan cara mengekstrak video pada slide presentasi:

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, VideoFrame

presentation = Presentation("VideoSample.pptx")
try:
    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if isinstance(shape, VideoFrame):
                video = shape.getEmbeddedVideo()
                if video is not None:
                    content_type = str(video.getContentType())
                    file_extension = content_type.split("/", 1)[-1]
                    video_data = bytes(video.getBinaryData())
                    Path("testing2." + file_extension).write_bytes(video_data)
                else:
                    print("The video frame has no embedded video.")
finally:
    presentation.dispose()

FAQ

Parameter pemutaran video apa yang dapat diubah untuk VideoFrame?

Anda dapat mengontrol mode pemutaran (otomatis atau saat diklik) dan looping . 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 sebanding dengan ukuran file. Saat Anda menambahkan video daring, tautan dan gambar mini disematkan, sehingga peningkatan ukuran lebih kecil.

Dapatkah saya mengganti video dalam VideoFrame yang ada tanpa mengubah posisinya dan ukurannya?

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

Apakah tipe konten (MIME) dari video tersemat dapat ditentukan?

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

Kelola Efek Transformasi Gambar dalam Presentasi dengan Python