Hantera videoramar i presentationer med PHP

Introduktion

En väl placerad video i en presentation kan göra ditt budskap mer övertygande och öka engagemangsnivåerna hos din publik.

PowerPoint låter dig lägga till videor på en bild i en presentation på två sätt:

  • Lägg till eller bädda in en lokal video (sparad på din maskin)
  • Lägg till en online-video (från en webbkälla såsom YouTube).

För att låta dig lägga till videor (videoobjekt) i en presentation tillhandahåller Aspose.Slides klassen Video , klassen VideoFrame och andra relevanta typer.

Skapa inbäddade videoramar

Om videofilen du vill lägga till på din bild är lagrad lokalt kan du skapa en videoram för att bädda in videon i din presentation.

  1. Skapa en instans av klassen Presentation .
  2. Hämta en bilds referens via dess index.
  3. Lägg till ett Video -objekt och skicka videofilens sökväg för att bädda in videon i presentationen.
  4. Lägg till ett VideoFrame -objekt för att skapa en ram för videon.
  5. Spara den ändrade presentationen.

Denna PHP‑kod visar hur du lägger till en lokalt lagrad video i en presentation:

  # Instansierar Presentation-klassen
  $pres = new Presentation("pres.pptx");
  try {
    # Laddar videon
    $fileStream = new Java("java.io.FileInputStream", "Wildlife.mp4");
    $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
    # Hämtar den första bilden och lägger till en videoram
    $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(10, 10, 150, 250, $video);
    # Sparar presentationen till disk
    $pres->save("pres-with-video.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Alternativt kan du lägga till en video genom att skicka dess filsökväg direkt till metoden 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();
    }
  }

Skapa videoramar med video från webbkällor

Microsoft PowerPoint 2013 och senare stödjer YouTube‑videor i presentationer. Om videon du vill använda finns online (t.ex. på YouTube) kan du lägga till den i din presentation via dess webblänk.

  1. Skapa en instans av klassen Presentation
  2. Hämta en bilds referens via dess index.
  3. Lägg till ett Video -objekt och skicka länken till videon.
  4. Ställ in en miniatyrbild för videoramen.
  5. Spara presentationen.

Denna PHP‑kod visar hur du lägger till en video från webben till en bild i en PowerPoint‑presentation:

  # Instansierar ett Presentation-objekt som representerar en presentationsfil
  $pres = new Presentation();
  try {
    addVideoFromYouTube($pres, "Tj75Arhq5ho");
    $pres->save("out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Trimma en videoram

Aspose.Slides låter dig styra vilken del av en video som spelas upp genom att ange värdena trim-from-start och trim-from-end via VideoFrame::setTrimFromStart och VideoFrame::setTrimFromEnd. Båda värdena anges i millisekunder och definierar hur mycket tid som hoppas över i början respektive slutet av videon. Dessa inställningar ändrar videouppspelningsinställningarna i presentationen; de klipper inte eller på annat sätt modifierar den inbäddade videons binära data.

Ställ in triminställningar

För att skapa en videoram och ange dess trim‑inställningar:

  1. Skapa en instans av klassen Presentation .
  2. Lägg till ett Video -objekt i presentationen.
  3. Lägg till ett VideoFrame -objekt på en bild.
  4. Ange värdena trim-from-start och trim-from-end via VideoFrame::setTrimFromStart och VideoFrame::setTrimFromEnd .
  5. Spara den ändrade presentationen.

Följande kodexempel hoppar över de första 2,5 sekunderna och den sista sekunden av en inbäddad video under uppspelning:

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

Läs triminställningar

För att inspektera befintliga trim‑inställningar, öppna en presentation, hitta ett VideoFrame -objekt bland formerna på den första bilden, och läs värdena via VideoFrame::getTrimFromStart och VideoFrame::getTrimFromEnd .

Följande kodexempel hittar den första videoramen på den första bilden och rapporterar dess trim‑inställningar i millisekunder:

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

Hantera videobildtexter

Aspose.Slides låter dig hantera stängda bildtexter för videoramar i PowerPoint‑presentationer. Bildtexter lagras i WebVTT‑format och exponeras via metoden VideoFrame::getCaptionTracks .

Lägg till bildtexter till en videoram

För att lägga till bildtexter till en videoram:

  1. Skapa en instans av klassen Presentation .
  2. Lägg till en video i presentationen.
  3. Lägg till ett VideoFrame -objekt på en bild.
  4. Använd samlingen CaptionsCollection som returneras av getCaptionTracks för att lägga till ett WebVTT‑bildtextspår.
  5. Spara den ändrade presentationen.

Följande kod visar hur du lägger till bildtexter till en videoram:

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

    // Lägger till ett nytt bildtextspår från en WebVTT-fil.
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

Klassen CaptionsCollection erbjuder också en överlagring som låter dig lägga till bildtexter från en ström.

Extrahera bildtexter från en videoram

För att extrahera bildtexter från en videoram:

  1. Läs in presentationen som innehåller videon.
  2. Hitta mål-VideoFrame -objektet.
  3. Iterera genom samlingen getCaptionTracks .
  4. Spara varje bildtextspår till en .vtt‑fil.

Följande kod visar hur du extraherar bildtexter från en videoram:

$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);
                // Sparar bildtextspåret till en WebVTT-fil.
                $filePath = $captionTrack->getCaptionId() . ".vtt";
                file_put_contents($filePath, $captionTrack->getBinaryData());
            }
        }
    }
} finally {
    $presentation->dispose();
}

Varje Captions -objekt exponerar bildtextens identifierare, etikett, binärdata och bildtext som en UTF‑8‑sträng.

Ta bort bildtexter från en videoram

För att ta bort bildtexter från en videoram:

  1. Läs in presentationen som innehåller videon.
  2. Hämta mål-VideoFrame -objektet.
  3. Ta bort bildtextspår från samlingen getCaptionTracks .
  4. Spara den ändrade presentationen.

Följande kod visar hur du tar bort alla bildtexter från en videoram:

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

    // Tar bort alla bildtexter från videoramen.
    $videoFrame->getCaptionTracks()->clear();

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

Om du bara behöver ta bort ett bildtextspår, använd metoderna remove eller removeAt i stället för clear.

Extrahera video från bilder

Förutom att lägga till videor i bilder låter Aspose.Slides dig extrahera videor som är inbäddade i presentationer.

  1. Skapa en instans av klassen Presentation för att läsa in presentationen som innehåller videon.
  2. Iterera genom alla Slide -objekt.
  3. Iterera genom alla Shape -objekt för att hitta en VideoFrame .
  4. Spara videon till disk.

Denna PHP‑kod visar hur du extraherar videon på en presentationsbild:

  # Instansierar ett Presentation-objekt som representerar en presentationsfil
  $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();
          # Hämtar filändelsen
          $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

Vilka videouppspelningsparametrar kan ändras för en VideoFrame?

Du kan styra uppspelningsläget (auto eller vid klick) och loopning. Dessa alternativ är tillgängliga via objektets egenskaper på VideoFrame .

Påverkar tillägg av en video PPTX‑filens storlek?

Ja. När du bäddar in en lokal video inkluderas binary‑data i dokumentet, så presentationens storlek ökar proportionellt mot filens storlek. När du lägger till en online‑video bäddas en länk och en miniatyrbild in, så storleksökningen blir mindre.

Kan jag ersätta videon i en befintlig VideoFrame utan att ändra dess position och storlek?

Ja. Du kan byta ut video‑innehållet i ramen samtidigt som du bevarar formens geometri; detta är ett vanligt scenario för att uppdatera media i en befintlig layout.

Kan innehållstypen (MIME) för en inbäddad video bestämmas?

Ja. En inbäddad video har en content type som du kan läsa och använda, till exempel när du sparar den till disk.

Hantera bildtransformeringseffekter i presentationer med PHP