使用 Python 在簡報中套用形狀動畫

本頁內容簡介

了解如何使用 Aspose.Slides for Python via .NET 添加、檢視和自訂形狀動畫、時序、音效、後動畫行為，以及動態文字。

概觀

若要在效果內操作各種行為或編輯運動路徑段落，請參閱 Custom Animation。

Aspose.Slides for Python via .NET 將投影片動畫表示為投影片時間軸中的效果。每個效果具有目標形狀、動畫類型與子類型、觸發器、時序設定，以及可選的屬性（例如音效或後動畫行為）。

時間軸包含兩種序列：

主序列 在投影片前進時播放。
互動序列 在其觸發形狀被點擊時開始。

因為文字方塊、圖片、圖表、表格與其他投影片物件皆實作 IShape，您對大多數投影片內容皆使用相同的 Sequence.add_effect 方法。可用的效果列於 EffectType 列舉中。

新增形狀動畫

要新增動畫，取得投影片的主序列，並以目標形狀、效果類型、子類型與觸發器呼叫 Sequence.add_effect。若要在點擊另一個形狀時啟動效果，請建立觸發器為該形狀的互動序列。

以下範例同時建立兩種動畫，並將結果儲存為 shape-animations.pptx。

import aspose.slides as slides


with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    target_shape = slide.shapes.add_auto_shape(slides.ShapeType.ROUND_CORNER_RECTANGLE, 120, 100, 320, 80)
    target_shape.text_frame.text = "Click to animate this shape"

    main_sequence = slide.timeline.main_sequence
    entrance_effect = main_sequence.add_effect(target_shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)
    entrance_effect.timing.duration = 1.5

    trigger_shape = slide.shapes.add_auto_shape(slides.ShapeType.BEVEL, 20, 20, 100, 40)
    trigger_shape.text_frame.text = "Move"

    interactive_sequence = slide.timeline.interactive_sequences.add(trigger_shape)
    interactive_sequence.add_effect(target_shape, slides.animation.EffectType.PATH_FOOTBALL, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)

    presentation.save("shape-animations.pptx", slides.export.SaveFormat.PPTX)

觸發器控制效果何時開始：

EffectTriggerType.ON_CLICK 在主序列中等待點擊，或在互動序列中等待對觸發形狀的點擊。
EffectTriggerType.WITH_PREVIOUS 與前一個效果同時開始。
EffectTriggerType.AFTER_PREVIOUS 在前一個效果結束後開始。

若要為圖片、圖表或其他形狀類型加入動畫，請將該物件傳遞給 Sequence.add_effect（而非 target_shape）。圖表專屬的群組選項請參閱 Animated Charts。

閱讀形狀動畫

當您知道目標形狀時，使用 Sequence.get_effects_by_shape 。若要檢查每個效果，請遍歷主序列與所有互動序列。遍歷可避免假設序列在索引 0 處一定有效果。

以下範例建立具有主序列與互動效果的形狀，取得針對該形狀的效果，然後遍歷投影片上的每個序列。

import aspose.slides as slides


def print_sequence(label, sequence):
    print(f"  {label}: {sequence.count} effect(s)")

    for effect in sequence:
        target_name = "unknown" if effect.target_shape is None else effect.target_shape.name
        effect_description = f"{effect.type.name} {effect.subtype.name}; target: {target_name}; trigger: {effect.timing.trigger_type.name}"
        print(f"    {effect_description}")


with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    target_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 120, 100, 320, 80)
    target_shape.text_frame.text = "Animated shape"

    main_sequence = slide.timeline.main_sequence
    main_sequence.add_effect(target_shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)

    trigger_shape = slide.shapes.add_auto_shape(slides.ShapeType.BEVEL, 20, 20, 100, 40)
    trigger_shape.text_frame.text = "Move"

    interactive_sequence = slide.timeline.interactive_sequences.add(trigger_shape)
    interactive_sequence.add_effect(target_shape, slides.animation.EffectType.PATH_FOOTBALL, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)

    target_effects = main_sequence.get_effects_by_shape(target_shape)
    print(f"The main sequence contains {len(target_effects)} effect(s) for {target_shape.name}.")

    print_sequence("Main sequence", main_sequence)

    for interactive_index, sequence in enumerate(slide.timeline.interactive_sequences, start=1):
        trigger_name = "unknown" if sequence.trigger_shape is None else sequence.trigger_shape.name
        sequence_label = f"Interactive sequence {interactive_index}, trigger: {trigger_name}"
        print_sequence(sequence_label, sequence)

如果只需要單一形狀的效果，請先依名稱、占位符類型或其他穩定屬性識別該形狀；然後呼叫 Sequence.get_effects_by_shape。不要假設索引 0 的形狀一定是目標物件。

處理繼承的占位符效果

普通投影片上的占位符可以從其版面配置投影片與母片上的相應占位符繼承動畫行為。Shape.get_base_placeholder 會返回該父占位符，若無父占位符則回傳 None。

在下列範例投影片中，頁腳在普通投影片上為 Random Bars，在版面配置投影片上為 Split，在母片上則為 Fly In。

普通投影片頁腳的動畫效果

版面配置投影片頁腳占位符的動畫效果

母片投影片頁腳占位符的動畫效果

下一個範例自行建立占位符階層。它向母片占位符、版面配置占位符以及普通投影片上的相應占位符加入效果。每次呼叫 Shape.get_base_placeholder 前都會檢查回傳的形狀是否為空。

import aspose.slides as slides


def find_placeholder_with_base(slide):
    for shape in slide.shapes:
        if shape.get_base_placeholder() is not None:
            return shape

    return None


def print_effects(source, effects):
    print(f"{source}: {len(effects)} effect(s)")

    for effect in effects:
        print(f"  {effect.type.name} {effect.subtype.name}")


with slides.Presentation() as presentation:
    layout_slide = presentation.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
    layout_placeholder = layout_slide.placeholder_manager.add_text_placeholder(100, 100, 400, 80)
    layout_slide.timeline.main_sequence.add_effect(layout_placeholder, slides.animation.EffectType.SPLIT, slides.animation.EffectSubtype.VERTICAL_IN, slides.animation.EffectTriggerType.ON_CLICK)

    master_placeholder = layout_placeholder.get_base_placeholder()
    if master_placeholder is not None:
        master_sequence = layout_slide.master_slide.timeline.main_sequence
        master_sequence.add_effect(master_placeholder, slides.animation.EffectType.FLY, slides.animation.EffectSubtype.BOTTOM, slides.animation.EffectTriggerType.ON_CLICK)

    slide = presentation.slides.add_empty_slide(layout_slide)
    slide_placeholder = find_placeholder_with_base(slide)

    if slide_placeholder is None:
        raise RuntimeError("The slide does not contain a placeholder linked to its layout slide.")

    slide.timeline.main_sequence.add_effect(slide_placeholder, slides.animation.EffectType.RANDOM_BARS, slides.animation.EffectSubtype.HORIZONTAL, slides.animation.EffectTriggerType.ON_CLICK)
    print_effects("Normal slide", slide.timeline.main_sequence.get_effects_by_shape(slide_placeholder))

    base_layout_placeholder = slide_placeholder.get_base_placeholder()
    if base_layout_placeholder is not None:
        print_effects("Layout slide", layout_slide.timeline.main_sequence.get_effects_by_shape(base_layout_placeholder))

        base_master_placeholder = base_layout_placeholder.get_base_placeholder()
        if base_master_placeholder is not None:
            print_effects("Master slide", layout_slide.master_slide.timeline.main_sequence.get_effects_by_shape(base_master_placeholder))

    presentation.save("placeholder-animations.pptx", slides.export.SaveFormat.PPTX)

變更動畫時序

PowerPoint Timing 對話方塊對應到 Timing 的屬性。

PowerPoint 時序對話方塊（動畫效果）

開始對應到 Timing.trigger_type。
持續時間 對應到以秒為單位的 Timing.duration。
延遲對應到以秒為單位的 Timing.trigger_delay_time。
重複對應到 Timing.repeat_count、Timing.repeat_until_next_click 或 Timing.repeat_until_end_slide。
完成播放後倒帶 對應到 Timing.rewind。

此獨立範例加入效果、透過 Sequence.add_effect 回傳的物件變更其時序，並儲存結果。保留回傳的 Effect 參考可避免不必要的集合索引。

import aspose.slides as slides


with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 120, 100, 320, 80)
    shape.text_frame.text = "Timed animation"

    effect = slide.timeline.main_sequence.add_effect(shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)
    effect.timing.trigger_type = slides.animation.EffectTriggerType.ON_CLICK
    effect.timing.duration = 2.0
    effect.timing.trigger_delay_time = 0.5
    effect.timing.repeat_until_next_click = False
    effect.timing.repeat_until_end_slide = False
    effect.timing.repeat_count = 2.0
    effect.timing.rewind = True

    presentation.save("shape-animation-timing.pptx", slides.export.SaveFormat.PPTX)

請有意只使用一種重複模式。將重複次數與「直到」旗標同時使用可能在不同檢視器產生混亂結果。變更重複模式時，先設定 Timing.repeat_until_next_click 與 Timing.repeat_until_end_slide，再設定 Timing.repeat_count，因為設定任一旗標都會同時改變目前的重複模式。

新增與擷取動畫音效

動畫效果可以透過 Effect.sound 參照嵌入的音訊。Effect.stop_previous_sound 可指示效果停止先前效果啟動的音訊。

為效果新增音效

以下範例假設本機有一個名為 animation-sound.wav 的音訊檔案。它建立兩個效果，將該檔案嵌入為第一個效果的音效，並設定第二個效果停止音效。它使用 Sequence.add_effect 回傳的物件，因此不需要序列索引。

import aspose.slides as slides


with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    first_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 80, 100, 240, 80)
    second_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 400, 100, 240, 80)
    first_shape.text_frame.text = "Starts sound"
    second_shape.text_frame.text = "Stops sound"

    sequence = slide.timeline.main_sequence
    first_effect = sequence.add_effect(first_shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)
    second_effect = sequence.add_effect(second_shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)

    with open("animation-sound.wav", "rb") as audio_file:
        effect_sound = presentation.audios.add_audio(audio_file.read())

    first_effect.sound = effect_sound
    second_effect.stop_previous_sound = True

    presentation.save("shape-animation-sound.pptx", slides.export.SaveFormat.PPTX)

擷取嵌入式效果音效

以下範例假設本機有一個名為 presentation-with-animation-sounds.pptx 的投影片檔案。它掃描主序列與互動序列，將每個嵌入的效果音效寫入 extracted-animation-sounds 目錄。副檔名是根據 Audio.content_type 所提供的音訊 MIME 類型選取的。

import os

import aspose.slides as slides


def get_audio_extension(content_type):
    normalized_type = "" if content_type is None else content_type.lower()

    if normalized_type == "audio/mpeg":
        return ".mp3"
    if normalized_type == "audio/mp4":
        return ".m4a"
    if normalized_type == "audio/ogg":
        return ".ogg"
    if normalized_type in ("audio/wav", "audio/x-wav"):
        return ".wav"

    return ".bin"


def save_sounds(sequence, output_directory, sound_index):
    for effect in sequence:
        if effect.sound is None:
            continue

        extension = get_audio_extension(effect.sound.content_type)
        output_path = os.path.join(output_directory, f"effect-sound-{sound_index}{extension}")
        with open(output_path, "wb") as output_file:
            output_file.write(bytes(effect.sound.binary_data))
        sound_index += 1

    return sound_index


input_path = "presentation-with-animation-sounds.pptx"
output_directory = "extracted-animation-sounds"

os.makedirs(output_directory, exist_ok=True)

with slides.Presentation(input_path) as presentation:
    sound_index = 1

    for slide in presentation.slides:
        sound_index = save_sounds(slide.timeline.main_sequence, output_directory, sound_index)

        for sequence in slide.timeline.interactive_sequences:
            sound_index = save_sounds(sequence, output_directory, sound_index)

print(f"Extracted {sound_index - 1} sound file(s) to {os.path.abspath(output_directory)}.")

對於大型音訊物件，請使用 Audio.get_stream 並將串流複製到檔案，而非將整個物件載入到位元組陣列。

設定後動畫行為

後動畫 選項控制形狀在效果結束後的處理方式。

PowerPoint 效果選項對話方塊（顯示後動畫設定）

AfterAnimationType 列舉支援保持形狀不變、更改其顏色、在動畫後隱藏，或在下一次點擊時隱藏。當類型為 AfterAnimationType.COLOR 時，同時設定 Effect.after_animation_color。

此獨立範例建立效果、透過回傳的效果物件設定後動畫行為，並儲存結果。

import aspose.pydrawing as draw
import aspose.slides as slides


with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 120, 100, 320, 80)
    shape.text_frame.text = "Dim after animation"

    effect = slide.timeline.main_sequence.add_effect(shape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)
    effect.after_animation_type = slides.animation.AfterAnimationType.COLOR
    effect.after_animation_color.color = draw.Color.light_gray

    presentation.save("shape-animation-after-effect.pptx", slides.export.SaveFormat.PPTX)

將類型改為非 AfterAnimationType.COLOR 會清除後動畫顏色設定。

文字動畫

文字動畫有兩個相關控制項：

TextAnimation.build_type 控制段落是一起顯示還是逐段顯示。
Effect.animate_text_type 控制文字是一次全部顯示、逐字或逐詞顯示。Effect.delay_between_text_parts 設定詞或字之間的延遲。正值為效果持續時間的百分比；負值為秒數延遲。

以下獨立範例會為文字方塊中的單字加上動畫。BuildType.AS_ONE_OBJECT 會停用逐段建構，使單字設定套用於整個文字框。

import aspose.slides as slides


with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    text_box = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 80, 80, 560, 100)
    text_box.text_frame.text = "Aspose.Slides animates this sentence word by word."

    effect = slide.timeline.main_sequence.add_effect(text_box, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)
    effect.text_animation.build_type = slides.animation.BuildType.AS_ONE_OBJECT
    effect.animate_text_type = slides.animation.AnimateTextType.BY_WORD
    effect.delay_between_text_parts = 20.0

    presentation.save("animated-text.pptx", slides.export.SaveFormat.PPTX)

若要逐段建構文字方塊，請設定 BuildType.BY_LEVEL_PARAGRAPHS1（或其他段落層級）。若要針對單一段落設定自己的效果，請使用接受 IParagraph 的 [Sequence.add_effect] 重載。請參閱 Animated Text 取得段落層級的範例。

匯出與相容性說明

儲存為 PPT 或 PPTX 會保留動畫模型，但最終播放方式取決於投影片檢視器。
PDF 與靜態影像不會播放動畫。若必須顯示動態，請使用 HTML5 export、動畫 GIF 或 video conversion。
對於 HTML5，請啟用 Html5Options.animate_shapes，若需要亦可啟用 Html5Options.animate_transitions。
影片轉換支援許多常見的進入、強調、退出與運動路徑效果，但不是所有 PowerPoint 效果皆受支援。請檢查目前的 supported animations and effects 並以目標 Aspose.Slides 版本測試關鍵投影片。
高階自訂效果以及從其他投影片格式匯入的效果可能會保留在檔案中，但在 PowerPoint、HTML5 或影片中呈現方式不同。請驗證匯出結果，而非僅依賴效果名稱。

常見問題

為何動畫在 PowerPoint 中可見，但在 PDF 中卻不顯示？
PDF 為靜態格式，動畫與投影片切換不會播放。若需保留動態，請匯出為 HTML5、動畫 GIF 或影片。

為何效果在影片中播放時會不同？
影片匯出會將動畫渲染為視訊，而非儲存原始 PowerPoint 行為。一些進階效果不受支援或會被近似。請檢查支援的效果表，並在正式使用前測試實際投影片。

將形狀向前或向後移動會改變其動畫順序嗎？
不會。形狀的 Z 軸順序控制重疊顯示，序列順序與觸發器才決定動畫播放順序。如需不同的播放順序，請調整時間軸。

取得 Python 中簡報的圖形有效屬性在 Python 中建立簡報形狀縮圖