Gérer les cadres vidéo dans les présentations avec Python

À propos de cette page

Apprenez à ajouter et extraire programmaticalement des cadres vidéo dans les diapositives PowerPoint et OpenDocument en utilisant Aspose.Slides pour Python via Java. Guide pratique rapide.

Introduction

Une vidéo bien placée dans une présentation peut rendre votre message plus percutant et augmenter le niveau d’engagement de votre public.

PowerPoint vous permet d’ajouter des vidéos à une diapositive d’une présentation de deux manières :

Ajouter ou incorporer une vidéo locale (stockée sur votre ordinateur)
Ajouter une vidéo en ligne (provenant d’une source Web telle que YouTube).

Pour vous permettre d’ajouter des vidéos (objets vidéo) à une présentation, Aspose.Slides fournit la classe Video, la classe VideoFrame et d’autres types pertinents.

Créer des cadres vidéo incorporés

Si le fichier vidéo que vous souhaitez ajouter à votre diapositive est stocké localement, vous pouvez créer un cadre vidéo pour incorporer la vidéo dans votre présentation.

Créer une instance de la classe Presentation.
Obtenir une référence à une diapositive par son index.
Ajouter un objet Video et transmettre les données du fichier vidéo pour incorporer la vidéo dans la présentation.
Ajouter un objet VideoFrame pour créer un cadre pour la vidéo.
Enregistrer la présentation modifiée.

Ce code Python vous montre comment ajouter une vidéo stockée localement à une présentation:

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

Alternativement, vous pouvez ajouter une vidéo en passant directement son chemin de fichier à la méthode 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()

Créer des cadres vidéo à partir de sources Web

Microsoft PowerPoint 2013 et versions ultérieures prend en charge les vidéos YouTube dans les présentations. Si la vidéo que vous souhaitez utiliser est disponible en ligne (par exemple sur YouTube), vous pouvez l’ajouter à votre présentation via son lien web.

Créer une instance de la classe Presentation.
Obtenir une référence à une diapositive par son index.
Ajouter un objet VideoFrame et transmettre le lien vers la vidéo.
Définir une vignette pour le cadre vidéo.
Enregistrer la présentation.

Ce code Python vous montre comment ajouter une vidéo provenant du web à une diapositive dans une présentation 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)

    # Charger la vignette.
    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()

Rogner un cadre vidéo

Aspose.Slides vous permet de contrôler la partie d’une vidéo qui est lue en définissant les valeurs trim-from-start et trim-from-end via VideoFrame.setTrimFromStart et VideoFrame.setTrimFromEnd. Les deux valeurs sont spécifiées en millisecondes et définissent le temps à ignorer au début et à la fin de la vidéo, respectivement. Ces paramètres modifient les réglages de lecture de la vidéo dans la présentation ; ils ne découpent pas et ne modifient pas les données binaires de la vidéo incorporée.

Définir les paramètres de rognage

Pour créer un cadre vidéo et définir ses paramètres de rognage :

Créer une instance de la classe Presentation.
Ajouter un objet Video à la présentation.
Ajouter un objet VideoFrame à une diapositive.
Définir les valeurs trim-from-start et trim-from-end via VideoFrame.setTrimFromStart et VideoFrame.setTrimFromEnd.
Enregistrer la présentation modifiée.

L’exemple de code suivant saute les 2,5 premières secondes et la dernière seconde d’une vidéo incorporée lors de la lecture :

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

Lire les paramètres de rognage

Pour inspecter les paramètres de rognage existants, chargez une présentation, trouvez un objet VideoFrame parmi les formes de la première diapositive, et lisez les valeurs via VideoFrame.getTrimFromStart et VideoFrame.getTrimFromEnd.

L’exemple de code suivant trouve le premier cadre vidéo sur la première diapositive et indique ses paramètres de rognage en millisecondes :

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

Gérer les sous-titres vidéo

Aspose.Slides vous permet de gérer les sous-titres fermés pour les cadres vidéo dans les présentations PowerPoint. Les sous-titres sont stockés au format WebVTT et sont accessibles via la méthode VideoFrame.getCaptionTracks.

Ajouter des sous-titres à un cadre vidéo

Pour ajouter des sous-titres à un cadre vidéo :

Créer une instance de la classe Presentation.
Ajouter une vidéo à la présentation.
Ajouter un objet VideoFrame à une diapositive.
Utiliser le CaptionsCollection retourné par getCaptionTracks pour ajouter une piste de sous-titres WebVTT.
Enregistrer la présentation modifiée.

Le code suivant vous montre comment ajouter des sous-titres à un cadre vidéo:

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)

    # Ajouter une nouvelle piste de sous-titres à partir d'un fichier WebVTT.
    video_frame.getCaptionTracks().add("English", "track.vtt")
    presentation.save("video_with_captions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

La classe CaptionsCollection propose également une surcharge qui vous permet d’ajouter des sous-titres depuis un flux.

Extraire les sous-titres d’un cadre vidéo

Pour extraire les sous-titres d’un cadre vidéo :

Charger la présentation contenant la vidéo.
Trouver l’objet VideoFrame ciblé.
Parcourir les pistes de sous-titres dans le CaptionsCollection.
Enregistrer chaque piste de sous-titres dans un fichier .vtt.

Le code suivant vous montre comment extraire les sous-titres d’un cadre vidéo:

from pathlib import Path

import jpype
import asposeslides

if not jpipeline.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():
                # Enregistrer la piste de sous-titres dans un fichier WebVTT.
                file_path = Path(str(caption_track.getCaptionId()) + ".vtt")
                caption_data = bytes(caption_track.getBinaryData())
                file_path.write_bytes(caption_data)
finally:
    presentation.dispose()

Chaque objet Captions expose l’identifiant du sous-titre, l’étiquette, les données binaires et le texte du sous-titre sous forme de chaîne UTF‑8.

Supprimer les sous-titres d’un cadre vidéo

Pour supprimer les sous-titres d’un cadre vidéo :

Charger la présentation contenant la vidéo.
Obtenir l’objet VideoFrame ciblé.
Supprimer les pistes de sous-titres du CaptionsCollection.
Enregistrer la présentation modifiée.

Le code suivant vous montre comment supprimer tous les sous-titres d’un cadre vidéo:

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):
        # Supprimer tous les sous-titres du cadre vidéo.
        video_frame.getCaptionTracks().clear()
        presentation.save("video_without_captions.pptx", SaveFormat.Pptx)
    else:
        print("The shape is not a video frame.")
finally:
    presentation.dispose()

Si vous devez supprimer une seule piste de sous-titres, utilisez les méthodes remove ou removeAt au lieu de clear.

Extraire des vidéos des diapositives

En plus d’ajouter des vidéos aux diapositives, Aspose.Slides vous permet d’extraire les vidéos incorporées dans les présentations.

Créer une instance de la classe Presentation pour charger la présentation contenant la vidéo.
Parcourir toutes les objets Slide.
Parcourir toutes les objets Shape pour trouver un VideoFrame.
Enregistrer la vidéo sur le disque.

Ce code Python vous montre comment extraire la vidéo d’une diapositive de présentation:

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

Quels paramètres de lecture vidéo peuvent être modifiés pour un VideoFrame ?

Vous pouvez contrôler le mode de lecture (automatique ou au clic) et la boucle. Ces options sont disponibles via les propriétés de l’objet VideoFrame.

L’ajout d’une vidéo affecte-t‑il la taille du fichier PPTX ?

Oui. Lorsque vous incorporez une vidéo locale, les données binaires sont incluses dans le document, ce qui fait que la taille de la présentation augmente proportionnellement à la taille du fichier. Lorsque vous ajoutez une vidéo en ligne, un lien et une vignette sont incorporés, de sorte que l’augmentation de taille est moindre.

Puis‑je remplacer la vidéo d’un VideoFrame existant sans modifier sa position et sa taille ?

Oui. Vous pouvez échanger le contenu vidéo à l’intérieur du cadre tout en préservant la géométrie de la forme ; c’est un scénario courant pour mettre à jour les médias dans une mise en page existante.

Le type de contenu (MIME) d’une vidéo incorporée peut‑il être déterminé ?

Oui. Une vidéo incorporée possède un type de contenu que vous pouvez lire et utiliser, par exemple lors de son enregistrement sur le disque.

Gestion des effets de transformation d’image dans les présentations avec Python