Gestire i fotogrammi video nelle presentazioni usando PHP

Di cosa tratta questa pagina

Impara ad aggiungere ed estrarre programmaticamente i fotogrammi video in presentazioni PowerPoint e OpenDocument usando Aspose.Slides per PHP via Java. Guida rapida pratica.

Introduzione

Un video posizionato correttamente in una presentazione può rendere il tuo messaggio più incisivo e aumentare il livello di coinvolgimento del pubblico.

PowerPoint consente di aggiungere video a una diapositiva di una presentazione in due modi:

Aggiungere o incorporare un video locale (memorizzato sul tuo computer)
Aggiungere un video online (da una fonte web come YouTube).

Per consentirti di aggiungere video (oggetti video) a una presentazione, Aspose.Slides fornisce la classe Video , la classe VideoFrame e altri tipi correlati.

Crea fotogrammi video incorporati

Se il file video che desideri aggiungere alla diapositiva è memorizzato localmente, puoi creare un fotogramma video per incorporare il video nella presentazione.

Crea un’istanza della classe Presentation .
Ottieni un riferimento alla diapositiva tramite il suo indice.
Aggiungi un oggetto Video e passa il percorso del file video per incorporare il video nella presentazione.
Aggiungi un oggetto VideoFrame per creare un fotogramma per il video.
Salva la presentazione modificata.

Questo codice PHP mostra come aggiungere un video memorizzato localmente a una presentazione:

  # Istanzia la classe Presentation
  $pres = new Presentation("pres.pptx");
  try {
    # Carica il video
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
    # Ottiene la prima diapositiva e aggiunge un fotogramma video
    $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(10, 10, 150, 250, $video);
    # Salva la presentazione su disco
    $pres->save("pres-with-video.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

In alternativa, è possibile aggiungere un video passando direttamente il suo percorso file al metodo 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();
    }
  }

Crea fotogrammi video con video da fonti web

Microsoft PowerPoint 2013 e versioni successive supporta i video YouTube nelle presentazioni. Se il video che desideri utilizzare è disponibile online (ad esempio su YouTube), puoi aggiungerlo alla presentazione tramite il suo link web.

Crea un’istanza della classe Presentation .
Ottieni un riferimento alla diapositiva tramite il suo indice.
Aggiungi un oggetto Video e passa il link al video.
Imposta una miniatura per il fotogramma video.
Salva la presentazione.

Questo codice PHP mostra come aggiungere un video dal web a una diapositiva in una presentazione PowerPoint:

  # Istanzia un oggetto Presentation che rappresenta un file di presentazione
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ritaglia un fotogramma video

Aspose.Slides consente di controllare quale parte di un video viene riprodotta impostando i valori trim-from-start e trim-from-end tramite VideoFrame::setTrimFromStart e VideoFrame::setTrimFromEnd. Entrambi i valori sono specificati in millisecondi e definiscono quanto tempo viene saltato dall’inizio e dalla fine del video, rispettivamente. Queste impostazioni modificano le impostazioni di riproduzione del video nella presentazione; non tagliano né modificano i dati binari del video incorporato.

Imposta le impostazioni di ritaglio

Per creare un fotogramma video e impostare le sue impostazioni di ritaglio:

Crea un’istanza della classe Presentation .
Aggiungi un oggetto Video alla presentazione.
Aggiungi un oggetto VideoFrame a una diapositiva.
Imposta i valori trim-from-start e trim-from-end tramite VideoFrame::setTrimFromStart e VideoFrame::setTrimFromEnd .
Salva la presentazione modificata.

Il seguente esempio di codice salta i primi 2,5 secondi e l’ultimo secondo di un video incorporato durante la riproduzione:

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

Leggi le impostazioni di ritaglio

Per esaminare le impostazioni di ritaglio esistenti, carica una presentazione, trova un oggetto VideoFrame tra le forme della prima diapositiva e leggi i valori tramite VideoFrame::getTrimFromStart e VideoFrame::getTrimFromEnd .

Il seguente esempio di codice trova il primo fotogramma video sulla prima diapositiva e riporta le sue impostazioni di ritaglio in millisecondi:

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

Gestisci i sottotitoli video

Aspose.Slides consente di gestire i sottotitoli chiusi per i fotogrammi video nelle presentazioni PowerPoint. I sottotitoli sono memorizzati nel formato WebVTT e sono accessibili tramite il metodo VideoFrame::getCaptionTracks .

Aggiungi sottotitoli a un fotogramma video

Per aggiungere sottotitoli a un fotogramma video:

Crea un’istanza della classe Presentation .
Aggiungi un video alla presentazione.
Aggiungi un oggetto VideoFrame a una diapositiva.
Utilizza la collezione CaptionsCollection restituita da getCaptionTracks per aggiungere una traccia di sottotitoli WebVTT.
Salva la presentazione modificata.

Il seguente codice mostra come aggiungere i sottotitoli a un fotogramma 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);

    // Aggiunge una nuova traccia di sottotitoli da un file WebVTT.
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

La classe CaptionsCollection fornisce anche una sovraccarica che consente di aggiungere i sottotitoli da uno stream.

Estrai i sottotitoli da un fotogramma video

Per estrarre i sottotitoli da un fotogramma video:

Carica la presentazione che contiene il video.
Trova l’oggetto VideoFrame di destinazione.
Itera attraverso la collezione getCaptionTracks .
Salva ogni traccia di sottotitoli in un file .vtt .

Il seguente codice mostra come estrarre i sottotitoli da un fotogramma 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);
                // Salva la traccia dei sottotitoli in un file WebVTT.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Ogni oggetto Captions espone l’identificatore del sottotitolo, l’etichetta, i dati binari e il testo del sottotitolo come stringa UTF-8.

Rimuovi i sottotitoli da un fotogramma video

Per rimuovere i sottotitoli da un fotogramma video:

Carica la presentazione che contiene il video.
Ottieni l’oggetto VideoFrame di destinazione.
Rimuovi le tracce dei sottotitoli dalla collezione getCaptionTracks .
Salva la presentazione modificata.

Il seguente codice mostra come rimuovere tutti i sottotitoli da un fotogramma video:

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

    // Rimuove tutti i sottotitoli dal fotogramma video.
    $videoFrame->getCaptionTracks()->clear();

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

Se è necessario rimuovere solo una traccia di sottotitoli, usa i metodi remove o removeAt invece di clear.

Estrai video dalle diapositive

Oltre ad aggiungere video alle diapositive, Aspose.Slides consente di estrarre i video incorporati nelle presentazioni.

Crea un’istanza della classe Presentation per caricare la presentazione contenente il video.
Itera attraverso tutti gli oggetti Slide .
Itera attraverso tutti gli oggetti Shape per trovare un VideoFrame .
Salva il video su disco.

Questo codice PHP mostra come estrarre il video da una diapositiva di una presentazione:

  # Istanzia un oggetto Presentation che rappresenta un file di presentazione
  $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();
          # Ottiene l'estensione del 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

Quali parametri di riproduzione video possono essere modificati per un VideoFrame?

È possibile controllare la playback mode (automatica o al clic) e il looping. Queste opzioni sono disponibili tramite le proprietà dell’oggetto VideoFrame .

L’aggiunta di un video influisce sulla dimensione del file PPTX?

Sì. Quando incorpori un video locale, i dati binari sono inclusi nel documento, quindi la dimensione della presentazione cresce proporzionalmente alla dimensione del file. Quando aggiungi un video online, vengono incorporati un link e una miniatura, quindi l’aumento di dimensione è minore.

Posso sostituire il video in un VideoFrame esistente senza modificare la sua posizione e dimensione?

Sì. È possibile scambiare il video content all’interno del fotogramma mantenendo la geometria della forma; questo è uno scenario comune per aggiornare i media in un layout esistente.

È possibile determinare il tipo di contenuto (MIME) di un video incorporato?

Sì. Un video incorporato ha un content type che è possibile leggere e utilizzare, ad esempio quando lo si salva su disco.

Gestire gli effetti di trasformazione delle immagini nelle presentazioni con PHP