Python을 사용해 프레젠테이션에서 비디오 프레임 관리

소개

프레젠테이션에 적절히 배치된 비디오는 메시지를 더욱 설득력 있게 만들고 청중과의 참여도를 높일 수 있습니다.

PowerPoint에서는 프레젠테이션의 슬라이드에 비디오를 추가하는 두 가지 방법을 제공합니다:

  • 로컬 비디오 추가 또는 삽입(내 컴퓨터에 저장된 비디오)
  • 온라인 비디오 추가(YouTube와 같은 웹 소스에서)

프레젠테이션에 비디오(비디오 개체)를 추가할 수 있도록 Aspose.Slides는 Video 클래스, VideoFrame 클래스 및 기타 관련 유형을 제공합니다.

임베드된 비디오 프레임 만들기

슬라이드에 추가하려는 비디오 파일이 로컬에 저장되어 있는 경우, 비디오 프레임을 만들어 프레젠테이션에 비디오를 임베드할 수 있습니다.

  1. Presentation 클래스의 인스턴스를 생성합니다.
  2. 인덱스로 슬라이드에 대한 참조를 얻습니다.
  3. 비디오 파일 데이터를 전달하여 Video 개체를 추가하고 프레젠테이션에 비디오를 임베드합니다.
  4. VideoFrame 개체를 추가하여 비디오 프레임을 생성합니다.
  5. 수정된 프레젠테이션을 저장합니다.
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()

또는 비디오 파일 경로를 직접 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()

웹 소스 비디오를 사용한 비디오 프레임 만들기

Microsoft PowerPoint 2013 및 이후 버전은 프레젠테이션에서 YouTube 비디오를 지원합니다. 사용하려는 비디오가 온라인에 제공되는 경우(예: YouTube), 해당 웹 링크를 통해 프레젠테이션에 추가할 수 있습니다.

  1. Presentation 클래스의 인스턴스를 생성합니다.
  2. 인덱스로 슬라이드에 대한 참조를 얻습니다.
  3. VideoFrame 개체를 추가하고 비디오 링크를 전달합니다.
  4. 비디오 프레임의 썸네일을 설정합니다.
  5. 프레젠테이션을 저장합니다.
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)

    # 썸네일을 로드합니다.
    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()

비디오 프레임 트리밍

Aspose.Slides에서는 VideoFrame.setTrimFromStartVideoFrame.setTrimFromEnd 메서드를 통해 trim-from-start와 trim-from-end 값을 설정함으로써 재생되는 비디오 부분을 제어할 수 있습니다. 두 값은 밀리초 단위로 지정되며 각각 비디오 시작 부분과 끝 부분에서 건너뛸 시간을 정의합니다. 이러한 설정은 프레젠테이션의 비디오 재생 설정을 변경하지만 임베드된 비디오 바이너리 데이터를 잘라내거나 수정하지는 않습니다.

트림 설정 지정

비디오 프레임을 만들고 트림 설정을 지정하려면:

  1. Presentation 클래스의 인스턴스를 생성합니다.
  2. Video 개체를 프레젠테이션에 추가합니다.
  3. VideoFrame 개체를 슬라이드에 추가합니다.
  4. VideoFrame.setTrimFromStartVideoFrame.setTrimFromEnd 메서드를 통해 trim-from-start와 trim-from-end 값을 설정합니다.
  5. 수정된 프레젠테이션을 저장합니다.
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()

트림 설정 읽기

기존 트림 설정을 확인하려면 프레젠테이션을 로드하고, 첫 번째 슬라이드의 도형 중에서 VideoFrame 개체를 찾아 VideoFrame.getTrimFromStartVideoFrame.getTrimFromEnd 메서드를 통해 값을 읽습니다.

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()

비디오 캡션 관리

Aspose.Slides에서는 PowerPoint 프레젠테이션의 비디오 프레임에 대한 폐쇄 캡션을 관리할 수 있습니다. 캡션은 WebVTT 형식으로 저장되며 VideoFrame.getCaptionTracks 메서드를 통해 노출됩니다.

비디오 프레임에 캡션 추가

비디오 프레임에 캡션을 추가하려면:

  1. Presentation 클래스의 인스턴스를 생성합니다.
  2. 프레젠테이션에 비디오를 추가합니다.
  3. VideoFrame 개체를 슬라이드에 추가합니다.
  4. getCaptionTracks 로 반환된 CaptionsCollection 을 사용하여 WebVTT 캡션 트랙을 추가합니다.
  5. 수정된 프레젠테이션을 저장합니다.
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)

    # WebVTT 파일에서 새 캡션 트랙을 추가합니다.
    video_frame.getCaptionTracks().add("English", "track.vtt")
    presentation.save("video_with_captions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

CaptionsCollection 클래스는 스트림에서 캡션을 추가할 수 있는 오버로드도 제공합니다.

비디오 프레임에서 캡션 추출

비디오 프레임에서 캡션을 추출하려면:

  1. 비디오가 포함된 프레젠테이션을 로드합니다.
  2. 대상 VideoFrame 개체를 찾습니다.
  3. CaptionsCollection 에 있는 캡션 트랙을 반복합니다.
  4. 각 캡션 트랙을 .vtt 파일로 저장합니다.
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():
                # 캡션 트랙을 WebVTT 파일에 저장합니다.
                file_path = Path(str(caption_track.getCaptionId()) + ".vtt")
                caption_data = bytes(caption_track.getBinaryData())
                file_path.write_bytes(caption_data)
finally:
    presentation.dispose()

Captions 객체는 캡션 식별자, 레이블, 바이너리 데이터 및 UTF-8 문자열 형태의 캡션 텍스트를 노출합니다.

비디오 프레임에서 캡션 제거

비디오 프레임에서 캡션을 제거하려면:

  1. 비디오가 포함된 프레젠테이션을 로드합니다.
  2. 대상 VideoFrame 개체를 가져옵니다.
  3. CaptionsCollection 에서 캡션 트랙을 제거합니다.
  4. 수정된 프레젠테이션을 저장합니다.
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):
        # 비디오 프레임에서 모든 캡션을 제거합니다.
        video_frame.getCaptionTracks().clear()
        presentation.save("video_without_captions.pptx", SaveFormat.Pptx)
    else:
        print("The shape is not a video frame.")
finally:
    presentation.dispose()

하나의 캡션 트랙만 제거해야 하는 경우 clear 대신 remove 또는 removeAt 메서드를 사용하십시오.

슬라이드에서 비디오 추출

비디오를 슬라이드에 추가하는 것 외에도 Aspose.Slides에서는 프레젠테이션에 임베드된 비디오를 추출할 수 있습니다.

  1. 비디오가 포함된 프레젠테이션을 로드하기 위해 Presentation 클래스의 인스턴스를 생성합니다.
  2. 모든 Slide 객체를 반복합니다.
  3. 모든 Shape 객체를 반복하여 VideoFrame 를 찾습니다.
  4. 비디오를 디스크에 저장합니다.
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

VideoFrame에 대해 변경 가능한 비디오 재생 매개변수는 무엇입니까?

playback mode (자동 또는 클릭)와 looping을 제어할 수 있습니다. 이러한 옵션은 VideoFrame 개체의 속성을 통해 사용할 수 있습니다.

비디오를 추가하면 PPTX 파일 크기에 영향을 줍니까?

예. 로컬 비디오를 임베드하면 바이너리 데이터가 문서에 포함되어 파일 크기에 비례해 프레젠테이션 크기가 증가합니다. 온라인 비디오를 추가하면 링크와 썸네일만 임베드되므로 크기 증가가 훨씬 작습니다.

위치와 크기를 변경하지 않고 기존 VideoFrame의 비디오를 교체할 수 있습니까?

예. 프레임 내에서 video content를 교체하면 도형의 기하학적 속성을 유지하면서 미디어를 업데이트할 수 있는 일반적인 시나리오입니다.

임베드된 비디오의 콘텐츠 유형(MIME)을 확인할 수 있습니까?

예. 임베드된 비디오는 content type을 가지고 있으며, 이를 읽어 디스크에 저장할 때 활용할 수 있습니다.