Videókeretek kezelése prezentációkban PHP használatával

Bevezetés

A videók segíthetnek az ötletek magyarázatában és a közönség bevonásában. Az Aspose.Slides for PHP via Java lehetővé teszi, hogy videókereteket adjon a diákhoz, módosítsa a lejátszási beállításokat, kezelje a feliratokat, és kinyerje a beágyazott videó adatokat.

A PowerPoint támogatja a helyi videókat és az online videókra mutató hivatkozásokat, például a YouTube‑videókat.

A videóadatok és videókeretek ábrázolásához az Aspose.Slides biztosítja a Video osztályt, a VideoFrame osztályt, és más releváns típusokat.

Beágyazott videókeret létrehozása

Ha a diára felvenni kívánt videófájl helyileg van tárolva, létrehozhat egy videókeretet a videó bemutatóba való beágyazásához.

Ez a példa egy helyi videót ágyaz be a meglévő bemutató első diájára, és elmenti az eredményt. A keret koordinátái és méretei pontban vannak megadva. A stream nyitva marad a mentés befejezéséig, mert a LoadingStreamBehavior::KeepLocked zárolva tartja, amíg a bemutató használja.

use aspose\slides\LoadingStreamBehavior;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
$videoStream = null;
try {
    $videoStream = new Java("java.io.FileInputStream", "video.mp4");
    $slide = $presentation->getSlides()->get_Item(0);

    $video = $presentation->getVideos()->addVideo($videoStream, LoadingStreamBehavior::KeepLocked);
    $slide->getShapes()->addVideoFrame(10, 10, 150, 250, $video);

    $presentation->save("embedded_video.pptx", SaveFormat::Pptx);
} finally {
    if ($videoStream !== null) {
        $videoStream->close();
    }
    $presentation->dispose();
}

Átadhatja a helyi videó elérési útját közvetlenül a addVideoFrame metódusnak. Ez a példa a videót egy új bemutató első diájára ágyazza be. A videónak elérhetőnek kell maradnia, amíg a bemutatót el nem mentik.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $slide->getShapes()->addVideoFrame(50, 150, 300, 150, "video.avi");

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

Videókeret létrehozása webes forrásból származó videóval

A Microsoft PowerPoint támogatója az online videók beillesztését a bemutatókba. Létrehozhat egy videókeretet, amely egy online videóra hivatkozik, például egy YouTube‑videóra.

Ez a példa egy YouTube‑videó hivatkozást és miniatűr képet ad az első diához. Cserélje ki a videó azonosítót egy másik videó használatához. A setPlayMode metódus automatikus lejátszást kér. A miniatűr letöltése és a videó lejátszása internetkapcsolatot igényel. A bemutató megjelenítőnek szintén támogatnia kell az online videó lejátszását.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\VideoPlayModePreset;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $videoId = "aqz-KE-bpKQ";
    $videoUrl = "https://www.youtube.com/embed/" . $videoId;
    $videoFrame = $slide->getShapes()->addVideoFrame(10, 10, 427, 240, $videoUrl);
    $videoFrame->setPlayMode(VideoPlayModePreset::Auto);

    $thumbnailUrl = "https://img.youtube.com/vi/" . $videoId . "/hqdefault.jpg";
    $thumbnailLocation = new Java("java.net.URL", $thumbnailUrl);
    $thumbnailStream = $thumbnailLocation->openStream();
    try {
        $thumbnail = $presentation->getImages()->addImage($thumbnailStream);
        $videoFrame->getPictureFormat()->getPicture()->setImage($thumbnail);
    } finally {
        $thumbnailStream->close();
    }

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

Videó lejátszása teljes képernyős módban

Egy képzési bemutatóban lejátszhat egy szoftverdemonstrációt teljes képernyőn, hogy a közönség lássa a részleteket. Hívja meg a setFullScreenMode metódust true értékkel, hogy ezt a viselkedést engedélyezze a lejátszás során.

Ez a példa megnyit egy bemutatót, megtalálja az első VideoFrame keretet az első dián, és engedélyezi a teljes képernyős lejátszást. A bemeneti bemutatónak legalább egy diát kell tartalmaznia, amelyen az első dián már létező videókeret van.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("training.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;
            $videoFrame->setFullScreenMode(true);
            break;
        }
    }

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

A teljes képernyős lejátszás szabályozza, hogy a videó hogyan jelenik meg. Függetlenül, a setPlayMode szabályozza, automatikusan vagy kattintásra indul-e, és a setPlayLoopMode azt, hogy ismétlődik-e. A kezdési viselkedés kiválasztásához állítsa be a lejátszási módot a VideoPlayModePreset::Auto or VideoPlayModePreset::OnClick értékre. A példa megtartja a meglévő kezdési és ismétlődési beállításokat.

Videó visszatekerése lejátszás után

Egy képzési bemutatóban a demonstrációs videó visszatekerése az elejére lehetővé teszi, hogy az előadó újból lejátszhassa. Hívja meg a setRewindVideo metódust true értékkel, hogy a videó a lejátszás befejezése után visszatérjen az elejére.

Ez a példa megnyit egy bemutatót, megtalálja az első VideoFrame keretet az első dián, és engedélyezi a visszatekerést. Kikapcsolja a ciklikus lejátszást, hogy a lejátszás befejeződhessen, és beállítja, hogy kattintásra induljon. A bemeneti bemutatónak legalább egy diát kell tartalmaznia, amelyen az első dián már létező videókeret van.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\VideoPlayModePreset;

$presentation = new Presentation("training.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;
            $videoFrame->setRewindVideo(true);
            $videoFrame->setPlayLoopMode(false);
            $videoFrame->setPlayMode(VideoPlayModePreset::OnClick);
            break;
        }
    }

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

A visszatekerés a videót az elejére helyezi anélkül, hogy újra elindulna. Ezzel szemben a setPlayLoopMode true értékkel való meghívása automatikusan ismétli a lejátszást. Tartsa a ciklikus lejátszást kikapcsolva, ha azt szeretné, hogy a videó befejeződjön és készen álljon az újrajátszásra. A setPlayMode önállóan szabályozza az automatikus vagy kattintásos indítást; ez a példa a VideoPlayModePreset::OnClick értéket használja, hogy az előadó ellenőrizhesse, mikor kezdődjön a lejátszás. Állítsa be a lejátszási módot a ciklus beállítása után, ahogy a példában látható. A visszatekerés függetlenül működik a setFullScreenMode beállítástól.

Videókeret vágása

Használja a VideoFrame::setTrimFromStart és a VideoFrame::setTrimFromEnd metódusokat a videó elejének vagy végének egy részének kihagyásához a lejátszás során. Mindkét érték ezredmásodpercben van. A vágás módosítja a lejátszási beállításokat anélkül, hogy a beágyazott videó adatot módosítaná.

Vágási beállítások megadása

Ez a példa egy helyi videót ágyaz be, és a lejátszás során kihagyja az első 2,5 másodpercet és az utolsó másodpercet. Használjon 3,5 másodpercnél hosszabb videót, hogy lejátszható szegmens maradjon.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $videoFile = new Java("java.io.File", "video.mp4");
    $videoPath = $videoFile->toPath();
    $videoData = java("java.nio.file.Files")->readAllBytes($videoPath);
    $video = $presentation->getVideos()->addVideo($videoData);

    $videoFrame = $slide->getShapes()->addVideoFrame(50, 50, 640, 360, $video);
    $videoFrame->setTrimFromStart(2500);
    $videoFrame->setTrimFromEnd(1000);

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

Vágási beállítások kiolvasása

Ez a példa kiírja az első videókeret vágási értékeit az első dián ezredmásodpercben. A bemutatónak legalább egy diát kell tartalmaznia. Ha az a dia nem tartalmaz videókeretet, semmit sem ír ki. Az előző példa 2500 és 1000 értékeket ad.

use aspose\slides\Presentation;

$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;
            echo "Trim from start: " . java_values($videoFrame->getTrimFromStart()) . " ms\n";
            echo "Trim from end: " . java_values($videoFrame->getTrimFromEnd()) . " ms\n";
            break;
        }
    }
} finally {
    $presentation->dispose();
}

Videó feliratok kezelése

Az Aspose.Slides lehetővé teszi a zárt feliratok kezelését a PowerPoint bemutatók videókereteihez. A feliratok WebVTT formátumban vannak tárolva, és a VideoFrame::getCaptionTracks metóduson keresztül érhetők el.

Feliratok hozzáadása videókerethez

Ez a példa egy helyi videót ágyaz be, és egy English (angol) címkéjű WebVTT felirat sávot ad hozzá. A felirat időbélyegeinek meg kell egyezniük a videóval. A mentett bemutató tartalmazza a videót és a feliratokat is.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $videoFile = new Java("java.io.File", "video.mp4");
    $videoPath = $videoFile->toPath();
    $videoData = java("java.nio.file.Files")->readAllBytes($videoPath);
    $video = $presentation->getVideos()->addVideo($videoData);

    $videoFrame = $slide->getShapes()->addVideoFrame(0, 0, 100, 100, $video);
    $videoFrame->getCaptionTracks()->add("English", "track.vtt");

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

A CaptionsCollection osztály is biztosít egy túlterhelést, amely lehetővé teszi feliratok hozzáadását streamből.

Feliratok kinyerése videókeretből

Ez a példa az első dián lévő videókeretek összes feliratsávját különálló WebVTT fájlokként menti. A sorozatszámok biztosítják a kimeneti fájlok egyediségét. A konzol jelentést ad a kinyert sávok számáról. A bemutatónak legalább egy diát kell tartalmaznia.

use aspose\slides\Presentation;

$presentation = new Presentation("video_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $trackCount = 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;
            $captionCount = java_values($videoFrame->getCaptionTracks()->getCount());
            for ($trackIndex = 0; $trackIndex < $captionCount; $trackIndex++) {
                $captionTrack = $videoFrame->getCaptionTracks()->get_Item($trackIndex);
                $trackCount++;
                $outputStream = new Java("java.io.FileOutputStream", "captions_" . $trackCount . ".vtt");
                try {
                    $outputStream->write($captionTrack->getBinaryData());
                } finally {
                    $outputStream->close();
                }
            }
        }
    }

    echo "Caption tracks extracted: " . $trackCount . "\n";
} finally {
    $presentation->dispose();
}

Minden Captions objektum tartalmazza a felirat azonosítóját, címkéjét, bináris adatait, és a felirat szövegét UTF‑8 karakterláncként.

Feliratok eltávolítása videókeretből

Ez a példa eltávolítja az összes feliratot az első dián az első alakzat pozíciójában lévő videókeretről, és elmenti az eredményt. Feltételezi, hogy a dia és az alakzat létezik, és hogy az alakzat videókeret.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("video_with_captions.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $videoFrame = $slide->getShapes()->get_Item(0);
    $videoFrame->getCaptionTracks()->clear();

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

Ha csak egy feliratsávot szeretne eltávolítani, használja a remove vagy a removeAt metódusokat a clear helyett.

Videó feliratok keresése

A Captions::getDataAsString visszaadja a teljes WebVTT sávot, beleértve a fejlécet, az időzítési sorokat és a felirat szöveget. A memóriában kereshet a képletek között, hogy megtalálja a kimondott kifejezést és annak időbélyegét. Például a 2. dián egy angol sáv a következő szöveget tartalmazhatja.

WEBVTT Café tour

00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

A példa megnyitja a captioned_media.pptx fájlt, és a VideoFrame::getCaptionTracks metódust használja, hogy beolvassa minden dia minden felső szintű videókeretének sávjait. Egy egyszerű szöveges képletben az időzítési sor --> karaktert tartalmaz, és egy üres sor jelzi a képlet végét. Ha a felirat tartalmazza a „café” szót bármilyen betűméretben, a példa kiírja a dia számát, a sáv címkéjét, az eredeti időzítési sort és a teljes feliratot.

use aspose\slides\Presentation;

$presentation = new Presentation("captioned_media.pptx");
try {
    $slideCount = java_values($presentation->getSlides()->size());
    for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $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"))) {
                continue;
            }
            $trackCount = java_values($shape->getCaptionTracks()->getCount());
            for ($index = 0; $index < $trackCount; $index++) {
                $track = $shape->getCaptionTracks()->get_Item($index);
                $lines = preg_split('/\r\n|\n|\r/', java_values($track->getDataAsString()));
                $lineCount = count($lines);
                for ($i = 0; $i < $lineCount; $i++) {
                    $timing = $lines[$i];
                    if (strpos($timing, "-->") === false) {
                        continue;
                    }
                    $captionLines = [];
                    while (++$i < $lineCount && $lines[$i] !== "") {
                        $captionLines[] = $lines[$i];
                    }
                    $caption = implode("\n", $captionLines);
                    if (preg_match('/café/iu', $caption)) {
                        printf("Slide %d | %s | %s\n", java_values($slide->getSlideNumber()), java_values($track->getLabel()), $timing);
                        echo $caption, "\n";
                    }
                }
            }
        }
    }
} finally {
    $presentation->dispose();
}

A „café” keresése egy egyezést ad a minta sávra. A keresés kizárja a sávfejlécet, és megőrzi az időzítési beállítást a kimenetben.

Slide 2 | English | 00:00:01.000 --> 00:00:03.000 align:start
Meet me at the café
near the station.

Videó kinyerése diából

A videók diákhoz adása mellett az Aspose.Slides lehetővé teszi a bemutatókba beágyazott videók kinyerését.

Ez a példa minden diáról kinyeri a beágyazott videókat különálló, számozott bináris fájlokba. A hivatkozott videók kihagyásra kerülnek, mivel nem tartalmaznak beágyazott adatot. A konzol kiírja minden videó MIME‑típusát és a teljes számot. A kimenet a generikus .bin kiterjesztést használja; szükség esetén változtassa meg a jelentett média típusnak megfelelően.

use aspose\slides\Presentation;

$presentation = new Presentation("presentation_with_videos.pptx");
try {
    $videoCount = 0;
    $slideCount = java_values($presentation->getSlides()->size());
    for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $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;
                $video = $videoFrame->getEmbeddedVideo();
                if (java_is_null($video)) {
                    echo "Skipped a linked video: no embedded data is available.\n";
                    continue;
                }

                $videoCount++;
                $outputStream = new Java("java.io.FileOutputStream", "extracted_video_" . $videoCount . ".bin");
                try {
                    $outputStream->write($video->getBinaryData());
                } finally {
                    $outputStream->close();
                }
                echo "Video " . $videoCount . ": " . java_values($video->getContentType()) . "\n";
            }
        }
    }

    echo "Embedded videos extracted: " . $videoCount . "\n";
} finally {
    $presentation->dispose();
}

FAQ

Milyen videó lejátszási paraméterek módosíthatók egy videókeretnél?

Megadhatja a lejátszási módot (automatikus vagy kattintásra) és a ciklust. Ezek a lehetőségek a VideoFrame objektum metódusain keresztül érhetők el.

A videó hozzáadása befolyásolja a PPTX fájlméretet?

Igen. Ha helyi videót ágyaz be, a bináris adat a dokumentumba kerül, így a bemutató mérete a fájlmérettel arányosan nő. Ha online videóra hivatkozik és egy miniatűrt ad hozzá, a bemutató a hivatkozást és az előnézeti képet tárolja a videóadat helyett, így a mérettömeg általában kisebb.

Lecserélhetem a videót egy meglévő videókeretben a pozíció és a méret módosítása nélkül?

Igen. Cserélheti a keretben lévő videótartalmat anélkül, hogy a forma geometriáját megváltoztatná; ez gyakori eset a médiák frissítésére egy meglévő elrendezésben.

Megállapítható a beágyazott videó tartalomtípusa (MIME)?

Igen. Egy beágyazott videónak van tartalomtípusa, amelyet kiolvashat és felhasználhat, például amikor lemezre menti.