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

本頁內容簡介

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

概述

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

新增投影片轉場

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    if (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 {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

新增進階投影片轉場

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

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

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

此範例為前三張投影片分配不同的效果，並分別在 3、5、7 秒後啟用自動前進。滑鼠點擊亦可前進這些投影片。請使用至少包含三張投影片的 input.pptx 檔案。

import com.aspose.slides.*;

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

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Comb);
        secondTransition.setAdvanceOnClick(true);
        secondTransition.setAdvanceAfter(true);
        secondTransition.setAdvanceAfterTime(5000);

        ISlideShowTransition 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 {
        System.out.println("The input presentation must contain at least three slides.");
    }
} finally {
    presentation.dispose();
}

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("advanced-transitions.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();

        if (transition.getAdvanceAfter()) {
            System.out.println("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");

            if (transition.getAdvanceAfterTime() > 2000) {
                transition.setAdvanceAfter(false);
                transition.setAdvanceOnClick(true);
            }
        }
    }

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

精確控制轉場計時

使用 setDuration 指定轉場效果的精確長度（以毫秒為單位）。投影片的 getSlideShowTransition 方法透過 ISlideShowTransition 透露這些設定：

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

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

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition 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 檔案。

import com.aspose.slides.*;

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

        ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(TransitionType.Push);
        secondTransition.setDuration(1200);

        presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

與動畫輸出協調轉場

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

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

讀取現有轉場持續時間

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        ISlideShowTransition transition = slide.getSlideShowTransition();
        int duration = transition.getDuration();

        if (duration >= 0) {
            System.out.println("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
        } else {
            System.out.println("Slide " + slide.getSlideNumber() + ": no explicit duration; timing depends on transition type " + transition.getType() + " and speed " + transition.getSpeed() + ".");
        }
    }
} finally {
    presentation.dispose();
}

Morph 轉場

Morph 轉場會在連續投影片之間為物件的變化製作動畫。若要建立簡易的 Morph 效果，請複製投影片、在複製本上移動或調整物件大小，然後將 Morph 轉場套用至第二張投影片。這樣可讓對應的物件在原始與修改後的狀態之間進行動畫。

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

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IAutoShape rectangle = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100);
    rectangle.getTextFrame().setText("Morph transition");

    ISlide secondSlide = presentation.getSlides().addClone(firstSlide);
    IShape movedRectangle = secondSlide.getShapes().get_Item(0);
    movedRectangle.setX(movedRectangle.getX() + 100);
    movedRectangle.setY(movedRectangle.getY() + 50);
    movedRectangle.setWidth(movedRectangle.getWidth() - 200);
    movedRectangle.setHeight(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。取得的值會提供 IMorphTransition 介面，其 setMorphType 方法可選擇匹配模式。

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("morph-transition.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        ISlideShowTransition transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        transition.setType(TransitionType.Morph);
        ITransitionValueBase transitionValue = transition.getValue();

        if (transitionValue instanceof IMorphTransition) {
            IMorphTransition morphTransition = (IMorphTransition) transitionValue;
            morphTransition.setMorphType(TransitionMorphType.ByWord);
            presentation.save("morph-by-word.pptx", SaveFormat.Pptx);
        } else {
            System.out.println("Morph transition options are unavailable.");
        }
    } else {
        System.out.println("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

設定轉場效果

某些轉場會公開額外選項，例如方向或效果是否從黑屏開始。可用的選項取決於使用 setType 所選擇的轉場。請先設定類型，然後從 getValue 取得相應的介面。

以下範例將 Cut 轉場套用於 input.pptx 的第一張投影片。它透過 IOptionalBlackTransition 呼叫 setFromBlack，使轉場從黑屏開始。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlideShowTransition transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
    transition.setType(TransitionType.Cut);
    ITransitionValueBase transitionValue = transition.getValue();

    if (transitionValue instanceof IOptionalBlackTransition) {
        IOptionalBlackTransition cutTransition = (IOptionalBlackTransition) transitionValue;
        cutTransition.setFromBlack(true);
        presentation.save("cut-from-black.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("Cut transition options are unavailable.");
    }
} finally {
    presentation.dispose();
}

常見問題

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

可以。當您需要以毫秒為單位的精確效果持續時間時，請優先使用 setDuration。當預定義的 TransitionSpeed 類別（Slow、Medium 或 Fast）足以且未設定明確持續時間時，請使用 setSpeed。這些設定會獨立於自動前進延遲，控制轉場效果。

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

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

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

遍歷簡報的 getSlides 集合，對每張投影片的轉場呼叫相同的 setType 值。在同一迴圈中設定所有計時與效果選項，以確保投影片之間的行為一致。

我要如何檢查投影片上目前設定的轉場類型？

對投影片的 getSlideShowTransition 結果呼叫 getType。它會返回來自 TransitionType 列舉的值；若為 None 則表示未套用任何轉場效果。

在 Java 中管理簡報投影片母版在 Java 中管理簡報的繪圖參考線