使用 PHP 管理簡報中的投影片轉場

本頁內容簡介

使用 Aspose.Slides for PHP via Java 套用投影片轉場、設定自動投影片前進，並自訂 Morph 與其他轉場效果。

概述

投影片轉場控制投影片在投影片放映期間的出現方式。使用 Aspose.Slides for PHP via Java，您可以為每張投影片選擇轉場效果、設定透過滑鼠點擊或計時器前進的方式，並調整特定效果的選項。本文使用 PHP 範例套用轉場、設定精確的轉場持續時間、管理投影片計時，並在兩張投影片之間建立 Morph 轉場。範例同時展示如何將設定儲存為 PPTX 檔案。

新增投影片轉場

要套用轉場，使用Presentation類別載入簡報，然後透過getSlideShowTransition存取投影片的轉場設定。使用setType並傳入TransitionType列舉中的值，之後儲存簡報。

以下範例將 Circle 轉場套用於第一張投影片，將 Comb 轉場套用於第二張。請使用至少含有兩張投影片的 input.pptx 檔案。

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

$presentation = new Presentation("input.pptx");
try {
    if (java_values($presentation->getSlides()->size()) >= 2) {
        $presentation->getSlides()->get_Item(0)->getSlideShowTransition()->setType(TransitionType::Circle);
        $presentation->getSlides()->get_Item(1)->getSlideShowTransition()->setType(TransitionType::Comb);

        $presentation->save("slide-transitions.pptx", SaveFormat::Pptx);
    } else {
        echo "The input presentation must contain at least two slides." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

新增進階投影片轉場

您可以設定投影片在螢幕上停留的時間，以及是否透過滑鼠點擊前進投影片放映。以下方法控制此行為：

setAdvanceOnClick 允許觀眾透過點擊滑鼠前進。
setAdvanceAfter 啟用自動前進。
setAdvanceAfterTime 指定自動前進前的延遲時間（毫秒）。

同時啟用點擊與計時前進，可讓觀眾點擊前進或等待計時器。若只使用計時器，請將false傳給setAdvanceOnClick。此延遲控制投影片放映何時前進；它不會設定視覺轉場效果的持續時間。

此範例為前三張投影片指定不同效果，並分別在 3、5、7 秒後自動前進。這些投影片也可透過點擊前進。請使用至少含有三張投影片的 input.pptx 檔案。

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

$presentation = new Presentation("input.pptx");
try {
    if (java_values($presentation->getSlides()->size()) >= 3) {
        $firstTransition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
        $firstTransition->setType(TransitionType::Circle);
        $firstTransition->setAdvanceOnClick(true);
        $firstTransition->setAdvanceAfter(true);
        $firstTransition->setAdvanceAfterTime(3000);

        $secondTransition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
        $secondTransition->setType(TransitionType::Comb);
        $secondTransition->setAdvanceOnClick(true);
        $secondTransition->setAdvanceAfter(true);
        $secondTransition->setAdvanceAfterTime(5000);

        $thirdTransition = $presentation->getSlides()->get_Item(2)->getSlideShowTransition();
        $thirdTransition->setType(TransitionType::Zoom);
        $thirdTransition->setAdvanceOnClick(true);
        $thirdTransition->setAdvanceAfter(true);
        $thirdTransition->setAdvanceAfterTime(7000);

        $presentation->save("advanced-transitions.pptx", SaveFormat::Pptx);
    } else {
        echo "The input presentation must contain at least three slides." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

若要檢查是否已啟用計時前進，請呼叫getAdvanceAfter。僅有儲存的延遲並不表示計時器已啟動。

下一個範例開啟上面儲存的檔案，報告每個已啟用的計時器，並對延遲超過兩秒的投影片停用自動前進。對這些投影片啟用滑鼠點擊，然後儲存更新後的設定。

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

$presentation = new Presentation("advanced-transitions.pptx");
try {
    for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $transition = $slide->getSlideShowTransition();

        if (java_values($transition->getAdvanceAfter())) {
            echo "Slide " . java_values($slide->getSlideNumber()) . ": advance after " . java_values($transition->getAdvanceAfterTime()) . " ms." . PHP_EOL;

            if (java_values($transition->getAdvanceAfterTime()) > 2000) {
                $transition->setAdvanceAfter(false);
                $transition->setAdvanceOnClick(true);
            }
        }
    }

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

精確控制轉場時機

使用setDuration可在毫秒層級指定轉場效果的精確長度。投影片的getSlideShowTransition方法透過SlideShowTransition揭露這些設定：

方法	目的
setDuration	設定轉場效果本身的持續時間（毫秒）。
setAdvanceAfterTime	設定投影片自動前進前的延遲時間（毫秒）。傳入`true`給setAdvanceAfter以啟用此計時器。
setSpeed	從TransitionSpeed列舉中選擇預設的速度類別：Slow、Medium 或 Fast。當未指定精確持續時間時使用。

setDuration 只控制轉場效果；它不決定投影片的顯示時間。請分別設定自動前進的延遲時間。當未設定明確的持續時間時，Aspose.Slides 會根據轉場類型和getSpeed的值決定效果持續時間。

為每張投影片套用相同持續時間

為了保持節奏一致，對每張投影片套用相同的效果與精確持續時間。此範例載入 input.pptx，從TransitionType中選取 Fade，並將每個轉場的持續時間設為 750 毫秒。它另外在 5,000 毫秒後啟用自動前進，並停用滑鼠點擊前進，最後將結果儲存為 PPTX。

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

$presentation = new Presentation("input.pptx");
try {
    for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $transition = $slide->getSlideShowTransition();
        $transition->setType(TransitionType::Fade);
        $transition->setDuration(750);

        // 設定自動前進，與效果持續時間無關。
        $transition->setAdvanceAfter(true);
        $transition->setAdvanceAfterTime(5000);
        $transition->setAdvanceOnClick(false);
    }

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

為個別投影片設定不同的持續時間

不同的投影片可以使用不同的效果持續時間。例如，標題投影片使用較短的轉場，而章節介紹使用較長的轉場。此範例將第一張投影片的持續時間設為 500 毫秒，第二張設為 1,200 毫秒。請使用至少含有兩張投影片的 input.pptx 檔案。

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

$presentation = new Presentation("input.pptx");
try {
    if (java_values($presentation->getSlides()->size()) >= 2) {
        $firstTransition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
        $firstTransition->setType(TransitionType::Fade);
        $firstTransition->setDuration(500);

        $secondTransition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
        $secondTransition->setType(TransitionType::Push);
        $secondTransition->setDuration(1200);

        $presentation->save("individual-transition-durations.pptx", SaveFormat::Pptx);
    } else {
        echo "The input presentation must contain at least two slides." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

將轉場與動畫輸出協調

在製作animated GIF、HTML5 presentation或video時，請在匯出前設定精確的轉場持續時間，以符合預期的節奏。例如，場景之間使用 600 毫秒的淡入淡出，並分別調整每張投影片的前進延遲，以留出旁白或內容的時間。

對於 GIF 與影片，請將輸出幀率與效果持續時間協調：600 毫秒相當於 30fps 下的 18 幀。於 HTML5 匯出設定中啟用動畫轉場。檢查所選匯出格式支援的轉場與時機選項，並預覽輸出以確認同步。

讀取現有的轉場持續時間

在修改轉場之前呼叫getDuration以確定是否已儲存明確值。-1 表示未設定明確持續時間；非負值表示已儲存的毫秒持續時間。未設定的值並非計算出的播放持續時間：Aspose.Slides 會根據轉場類型和getSpeed的值決定該持續時間。設定轉場類型可能會初始化持續時間，因此請先檢查原始設定。

use aspose\slides\Presentation;

$presentation = new Presentation("input.pptx");
try {
    for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $transition = $slide->getSlideShowTransition();
        $duration = java_values($transition->getDuration());

        if ($duration >= 0) {
            echo "Slide " . java_values($slide->getSlideNumber()) . ": stored transition duration is " . $duration . " ms." . PHP_EOL;
        } else {
            echo "Slide " . java_values($slide->getSlideNumber()) . ": no explicit duration; timing depends on transition type " . java_values($transition->getType()) . " and speed " . java_values($transition->getSpeed()) . "." . PHP_EOL;
        }
    }
} finally {
    $presentation->dispose();
}

Morph 轉場

Morph 轉場會在連續投影片之間動畫化物件的變化。要建立簡單的 Morph 效果，先複製一張投影片，於複製稿上移動或調整物件大小，然後對第二張投影片套用 Morph 轉場。這樣轉場會對應的物件在原始與修改狀態之間動畫化。

以下範例建立一張含文字矩形的投影片，複製該投影片，並在複製稿上變更矩形的位置與大小，然後為第二張投影片選取TransitionType 列舉中的 Morph。使用支援 Morph 的簡報檢視器開啟已儲存的檔案，即可在投影片放映時看到效果。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TransitionType;

$presentation = new Presentation();
try {
    $firstSlide = $presentation->getSlides()->get_Item(0);
    $rectangle = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 400, 100);
    $rectangle->getTextFrame()->setText("Morph transition");

    $secondSlide = $presentation->getSlides()->addClone($firstSlide);
    $movedRectangle = $secondSlide->getShapes()->get_Item(0);
    $movedRectangle->setX(java_values($movedRectangle->getX()) + 100);
    $movedRectangle->setY(java_values($movedRectangle->getY()) + 50);
    $movedRectangle->setWidth(java_values($movedRectangle->getWidth()) - 200);
    $movedRectangle->setHeight(java_values($movedRectangle->getHeight()) - 10);

    $secondSlide->getSlideShowTransition()->setType(TransitionType::Morph);

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

Morph 轉場類型

TransitionMorphType 列舉控制 Morph 如何匹配與動畫化內容：

ByObject 將每個形狀視為整體物件。
ByWord 在可能的情況下，以字為單位匹配文字進行動畫。
ByChar 在可能的情況下，以字元為單位匹配文字進行動畫。

在存取getValue 之前，先使用setType選取 Morph。取得的值會提供一個MorphTransition 物件，透過其setMorphType 方法選擇匹配模式。

此範例開啟前一節建立的簡報，並將第二張投影片設定為以字為單位的 Morph 動畫。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionMorphType;
use aspose\slides\TransitionType;

$presentation = new Presentation("morph-transition.pptx");
try {
    if (java_values($presentation->getSlides()->size()) >= 2) {
        $transition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
        $transition->setType(TransitionType::Morph);
        $morphTransition = $transition->getValue();

        if (!java_is_null($morphTransition)) {
            $morphTransition->setMorphType(TransitionMorphType::ByWord);
            $presentation->save("morph-by-word.pptx", SaveFormat::Pptx);
        } else {
            echo "Morph transition options are unavailable." . PHP_EOL;
        }
    } else {
        echo "The input presentation must contain at least two slides." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

設定轉場效果

某些轉場提供額外選項，例如方向或是否從黑畫面開始。可用的選項取決於使用setType 所選的轉場。先設定類型，然後從getValue 取得相應的轉場物件。

以下範例對 input.pptx 的第一張投影片套用 Cut 轉場，並透過OptionalBlackTransition 的setFromBlack 使轉場從黑畫面開始。

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

$presentation = new Presentation("input.pptx");
try {
    $transition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
    $transition->setType(TransitionType::Cut);
    $cutTransition = $transition->getValue();

    if (!java_is_null($cutTransition)) {
        $cutTransition->setFromBlack(true);
        $presentation->save("cut-from-black.pptx", SaveFormat::Pptx);
    } else {
        echo "Cut transition options are unavailable." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

常見問題

我可以控制投影片轉場的播放速度嗎？

可以。當您需要毫秒級的精確效果持續時間時，請優先使用setDuration。若僅需使用預定義的TransitionSpeed（Slow、Medium、Fast）類別且不設定明確持續時間，則使用setSpeed。這些設定僅影響轉場效果本身，與自動前進的延遲時間無關。

我可以為轉場附加音訊並讓其循環播放嗎？

可以。使用setSound指派嵌入式音訊，將TransitionSoundMode 列舉中的StartSound傳給setSoundMode，並將setSoundLoop 設為true。音訊會持續循環，直至投影片放映中的下一個音效事件。

將相同轉場套用到每張投影片的最快方法是什麼？

遍歷簡報的getSlides集合，對每張投影片的轉場呼叫setType 並傳入相同的值。於同一迴圈中設定任何時機或效果選項，即可保持所有投影片的行為一致。

我如何檢查投影片目前設定的轉場是什麼？

對投影片的getSlideShowTransition 結果呼叫getType。它會回傳TransitionType 列舉中的值；None 表示未套用任何轉場效果。

在 PHP 中管理簡報投影片母片在 PHP 中管理簡報的繪圖指引