Beheer video‑frames in presentaties met PHP

Waar deze pagina over gaat

Leer hoe u programmatisch video‑frames kunt toevoegen en extraheren in PowerPoint‑ en OpenDocument‑slides met Aspose.Slides voor PHP via Java. Snelle stap‑voor‑stap‑gids.

Inleiding

Een goed geplaatst video in een presentatie kan uw boodschap overtuigender maken en de betrokkenheid van uw publiek vergroten.

PowerPoint maakt het mogelijk om video’s aan een dia in een presentatie toe te voegen op twee manieren:

Voeg een lokale video toe of embed deze (opgeslagen op uw computer)
Voeg een online video toe (van een webbron zoals YouTube).

Om u video’s (video‑objecten) aan een presentatie toe te laten voegen, biedt Aspose.Slides de klasse Video , de klasse VideoFrame , en andere relevante types.

Maak Ingebedde Video‑Frames

Als het videobestand dat u aan uw dia wilt toevoegen lokaal is opgeslagen, kunt u een video‑frame maken om de video in uw presentatie te embedden.

Maak een instantie van de klasse Presentation .
Haal een referentie naar een dia op via de index.
Voeg een Video‑object toe en geef het pad naar het videobestand op om de video in de presentatie te embedden.
Voeg een VideoFrame‑object toe om een frame voor de video te maken.
Sla de gewijzigde presentatie op.

Deze PHP‑code laat zien hoe u een lokaal opgeslagen video aan een presentatie kunt toevoegen:

  # Instantieert de Presentation‑klasse
  $pres = new Presentation("pres.pptx");
  try {
    # Laadt de video
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
    # Haalt de eerste dia op en voegt een videoframe toe
    $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(10, 10, 150, 250, $video);
    # Slaat de presentatie op schijf
    $pres->save("pres-with-video.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

U kunt ook een video toevoegen door het bestandspad rechtstreeks door te geven aan de methode 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();
    }
  }

Maak Video‑Frames met Video van Webbronnen

Microsoft PowerPoint 2013 en nieuwer ondersteunt YouTube‑video’s in presentaties. Als de video die u wilt gebruiken online beschikbaar is (bijv. op YouTube), kunt u deze via de web‑link aan uw presentatie toevoegen.

Maak een instantie van de klasse Presentation
Haal een referentie naar een dia op via de index.
Voeg een Video‑object toe en geef de link naar de video op.
Stel een miniatuurafbeelding in voor het video‑frame.
Sla de presentatie op.

Deze PHP‑code laat zien hoe u een video van het web aan een dia in een PowerPoint‑presentatie kunt toevoegen:

  # Instantieert een Presentation-object dat een presentiebestand vertegenwoordigt
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Trim een Video‑Frame

Met Aspose.Slides kunt u bepalen welk deel van een video wordt afgespeeld door de trim‑from‑start‑ en trim‑from‑end‑waarden in te stellen via VideoFrame::setTrimFromStart en VideoFrame::setTrimFromEnd. Beide waarden worden opgegeven in milliseconden en geven aan hoeveel tijd vanaf het begin respectievelijk het einde van de video wordt overgeslagen. Deze instellingen wijzigen de weergave‑instellingen van de video in de presentatie; ze knippen of wijzigen de ingebedde videobinaire gegevens niet.

Stel Trim‑Instellingen In

Om een video‑frame te maken en de trim‑instellingen in te stellen:

Maak een instantie van de klasse Presentation .
Voeg een Video‑object toe aan de presentatie.
Voeg een VideoFrame‑object toe aan een dia.
Stel de trim‑from‑start‑ en trim‑from‑end‑waarden in via VideoFrame::setTrimFromStart en VideoFrame::setTrimFromEnd .
Sla de gewijzigde presentatie op.

Het volgende codevoorbeeld slaat de eerste 2,5 seconde en de laatste seconde van een ingebedde video over tijdens het afspelen:

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

Lees Trim‑Instellingen

Om bestaande trim‑instellingen te inspecteren, laad een presentatie, vind een VideoFrame‑object onder de shapes op de eerste dia, en lees de waarden via VideoFrame::getTrimFromStart en VideoFrame::getTrimFromEnd .

Het volgende codevoorbeeld vindt het eerste video‑frame op de eerste dia en rapporteert de trim‑instellingen in milliseconden:

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

Beheer Video‑Ondertitels

Met Aspose.Slides kunt u gesloten ondertitels voor video‑frames in PowerPoint‑presentaties beheren. Ondertitels worden opgeslagen in WebVTT‑formaat en zijn toegankelijk via de methode VideoFrame::getCaptionTracks .

Voeg Ondertitels toe aan een Video‑Frame

Om ondertitels toe te voegen aan een video‑frame:

Maak een instantie van de klasse Presentation .
Voeg een video toe aan de presentatie.
Voeg een VideoFrame‑object toe aan een dia.
Gebruik de collectie CaptionsCollection die wordt geretourneerd door getCaptionTracks om een WebVTT‑ondertiteltrack toe te voegen.
Sla de gewijzigde presentatie op.

De volgende code laat zien hoe u ondertitels aan een video‑frame kunt toevoegen:

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

    // Voegt een nieuw ondertiteltrack toe vanuit een WebVTT-bestand.
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

De klasse CaptionsCollection biedt ook een overload waarmee u ondertitels vanuit een stream kunt toevoegen.

Extraheer Ondertitels uit een Video‑Frame

Om ondertitels uit een video‑frame te extraheren:

Laad de presentatie die de video bevat.
Vind het doel‑VideoFrame‑object.
Iterate door de collectie getCaptionTracks .
Sla elke ondertiteltrack op in een .vtt‑bestand.

De volgende code laat zien hoe u ondertitels uit een video‑frame kunt extraheren:

$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);
                // Slaat het ondertiteltrack op naar een WebVTT-bestand.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Elk Captions‑object maakt de ondertitel‑identifier, label, binaire data en ondertitel‑tekst beschikbaar als een UTF‑8‑string.

Verwijder Ondertitels uit een Video‑Frame

Om ondertitels uit een video‑frame te verwijderen:

Laad de presentatie die de video bevat.
Haal het doel‑VideoFrame‑object op.
Verwijder ondertiteltracks uit de collectie getCaptionTracks .
Sla de gewijzigde presentatie op.

De volgende code laat zien hoe u alle ondertitels uit een video‑frame kunt verwijderen:

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

    // Verwijdert alle ondertitels van het video-frame.
    $videoFrame->getCaptionTracks()->clear();

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

Als u slechts één ondertiteltrack wilt verwijderen, gebruik dan de methoden remove of removeAt in plaats van clear .

Video extraheren uit Slides

Naast het toevoegen van video’s aan dia’s, maakt Aspose.Slides het mogelijk om video’s die in presentaties zijn ingebed te extraheren.

Maak een instantie van de klasse Presentation om de presentatie met de video te laden.
Iterate door alle Slide‑objecten.
Iterate door alle Shape‑objecten om een VideoFrame te vinden.
Sla de video op schijf.

Deze PHP‑code laat zien hoe u de video op een presentatiedia kunt extraheren:

  # Instantieert een Presentation-object dat een presentiebestand vertegenwoordigt
  $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();
          # Haalt de bestandsextensie op
          $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

Welke video‑afspeelparameters kunnen worden gewijzigd voor een VideoFrame?

U kunt de playback‑mode (auto of bij klik) en het looping aanpassen. Deze opties zijn beschikbaar via de eigenschappen van het object VideoFrame .

Heeft het toevoegen van een video invloed op de bestandsgrootte van de PPTX?

Ja. Wanneer u een lokale video embedt, worden de binaire gegevens in het document opgenomen, waardoor de presentatiegrootte evenredig met de bestandsgrootte toeneemt. Wanneer u een online video toevoegt, worden een link en een miniatuurafbeelding ingebed, waardoor de grootte‑toename kleiner is.

Kan ik de video in een bestaand VideoFrame vervangen zonder de positie en grootte te wijzigen?

Ja. U kunt de video‑content binnen het frame verwisselen terwijl de geometrie van de shape behouden blijft; dit is een veelvoorkomend scenario voor het bijwerken van media in een bestaande lay-out.

Kan het inhoudstype (MIME) van een ingebedde video worden bepaald?

Ja. Een ingebedde video heeft een content type dat u kunt lezen en gebruiken, bijvoorbeeld bij het opslaan naar schijf.

Beheer afbeeldingstransformatie‑effecten in presentaties met PHP