在 JavaScript 中建立與修改自訂動畫行為

本頁內容簡介

使用 Aspose.Slides for Node.js（透過 Java）在 PowerPoint 簡報中建立、檢查並修改自訂動畫行為與可編輯的移動路徑。

概觀

自訂動畫行為讓您能控制動畫效果內的個別操作，例如變更顏色、旋轉形狀或遵循可編輯的移動路徑。本指南說明如何建立與組合行為、設定其時間、檢查與修改現有動畫，並驗證其屬性在儲存與重新開啟簡報後仍能保留。

對於預定義效果與點擊觸發，請參考形狀動畫。

了解動畫模型

動畫的組織結構為 Timeline → Sequence → Effect → Behaviors：

getTimeline 方法會傳回投影片的時間軸，該時間軸包含主要序列與互動序列。
Sequence 包含效果，可能針對不同的形狀。
Effect 識別目標形狀、預設、子類型與效果時間。
由Effect.getBehaviors返回的集合包含實作效果的操作：變更顏色、移動、旋轉、設定屬性等。

建立單一行為

呼叫[Sequence.addEffect]以建立效果並存取[getBehaviors]集合。預設可以自動填入此集合。擴充預設時保留其操作，或在有意取代時使用[clear]。

[BehaviorFactory]建立下列說明的八種行為類型。移動路徑請參考建立移動路徑。每個程式碼片段包含其模組匯入，且可在已安裝 aspose.slides.via.java 與 java 套件的 Node.js 環境中執行。請先執行產生檔案的範例，再執行讀取其輸出的範例。稍後的編輯範例會說明使用哪個輸出檔案。

旋轉

使用[createRotationEffect]建立旋轉。[getBy]指定相對角度（度），[getFrom]與[getTo]指定端點。

此範例以 Spin 效果開始，將其預設操作取代為一個旋轉行為，並將該操作設為兩秒持續時間。90 度的相對角度表示形狀起始方向的四分之一旋轉，因而不需要明確的起始角度。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.Spin, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const rotation = factory.createRotationEffect();
    rotation.setBy(90);
    rotation.getTiming().setDuration(2);

    effect.getBehaviors().add(rotation);

    presentation.save("rotation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

rotation.pptx 包含一個形狀與一個旋轉行為。以下的集合、時間與旋轉編輯範例皆使用此檔案。

縮放

使用[createScaleEffect]搭配 X/Y 百分比： [getFrom] 與 [getTo] 描述起始與結束大小，而 [getBy] 描述相對變化。此處的 100 代表原始大小。

此範例在兩秒內將兩個維度由 100% 成長至 125%。使用相同的水平與垂直百分比可維持形狀比例；若使用不同百分比則會使某一維度較另一維度拉伸。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.GrowShrink, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const scale = factory.createScaleEffect();
    scale.setFrom(java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(100), java.newFloat(100)));
    scale.setTo(java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(125), java.newFloat(125)));
    scale.getTiming().setDuration(2);

    effect.getBehaviors().add(scale);

    presentation.save("scale.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

顏色

使用[createColorEffect]將填色從藍色變為橙色。[getFrom] 與 [getTo] 為顏色；[getBy] 為顏色偏移。[Behavior.getProperties] 識別被動畫化的屬性。

形狀的實心填色預設為藍色，與動畫起始顏色相符。選取填色屬性告訴行為要變更形狀的哪一部份；僅有顏色端點並不會識別該屬性。已儲存的效果描述了兩秒的過渡至橙色。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.ChangeFillColor, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const color = factory.createColorEffect();
    color.getProperties().add(aspose.slides.BehaviorProperty.getFillColor().getValue());
    color.getFrom().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    const orange = java.newInstanceSync("java.awt.Color", 255, 165, 0);
    color.getTo().setColor(orange);
    color.getTiming().setDuration(2);

    effect.getBehaviors().add(color);

    presentation.save("color.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

濾鏡

使用[createFilterEffect]選取抹除。[getType]、[getSubtype]與[getReveal]指示濾鏡、方向以及是顯示或隱藏形狀。

此範例設定一個兩秒的抹除，以右方向子類別顯示形狀。濾鏡設定屬於效果內的行為，因此在移除預設的原始操作後再進行設定。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.Wipe, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const filter = factory.createFilterEffect();
    filter.setType(aspose.slides.FilterEffectType.Wipe);
    filter.setSubtype(aspose.slides.FilterEffectSubtype.Right);
    filter.setReveal(aspose.slides.FilterEffectRevealType.In);
    filter.getTiming().setDuration(2);

    effect.getBehaviors().add(filter);

    presentation.save("filter.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

屬性

使用[createPropertyEffect]讓不透明度產生動畫。[getFrom]、[getTo]與[getBy]為字串，會透過[getValueType]與[getCalcMode]解析。請選擇端點或相對偏移，而不是隨意同時設定三者。

此處選取的屬性是 opacity（不透明度），數值字串表示從 25% 不透明度變為完整不透明度。線性插值描述了這些值之間的漸變。若將此範例套用至其他屬性，請選擇該屬性相應的值類型與端點值。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.Fade, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const property = factory.createPropertyEffect();
    property.getProperties().add(aspose.slides.BehaviorProperty.getStyleOpacity().getValue());
    property.setValueType(aspose.slides.PropertyValueType.Number);
    property.setCalcMode(aspose.slides.PropertyCalcModeType.Linear);
    property.setFrom("0.25");
    property.setTo("1");
    property.getTiming().setDuration(2);

    effect.getBehaviors().add(property);

    presentation.save("property.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

設定

使用[createSetEffect]透過[getTo]指定可見性。設定行為不會在端點之間插值。

此範例選取可見性屬性，並在行為執行時指派字串 visible。在此簡易簡報中，矩形已經是可見的，因此單獨指派可能不會產生明顯的視覺變化。此類操作在結合其他控制形狀隱藏或顯示的較大效果時相當有用。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.Appear, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const set = factory.createSetEffect();
    set.getProperties().add(aspose.slides.BehaviorProperty.getStyleVisibility().getValue());
    set.setTo("visible");

    effect.getBehaviors().add(set);

    presentation.save("set.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

指令

使用[createCommandEffect]並設定[getType]、[getCommandString]與[getShapeTarget]。請將名為 sample.wav 的 WAV 錄音放置於工作目錄。本範例使用[addAudioFrameEmbedded]將其嵌入，並將播放指令附加至音訊框。

音訊框同時是效果的目標與指令的目標。這樣會將播放請求連結至嵌入的錄音檔；僅有指令字串無法識別要控制的媒體物件。此效果被設定為在簡報播放時點擊後開始。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const audioStream = java.newInstanceSync("java.io.FileInputStream", "sample.wav");
    try {
        const audioFrame = slide.getShapes().addAudioFrameEmbedded(100, 100, 40, 40, audioStream);

        const effect = slide.getTimeline().getMainSequence().addEffect(audioFrame, aspose.slides.EffectType.MediaPlay, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
        effect.getBehaviors().clear();

        const factory = new aspose.slides.BehaviorFactory();
        const command = factory.createCommandEffect();
        command.setType(java.newByte(aspose.slides.CommandEffectType.Call));
        command.setCommandString("play");
        command.setShapeTarget(audioFrame);

        effect.getBehaviors().add(command);

        presentation.save("command.pptx", aspose.slides.SaveFormat.Pptx);
    } finally {
        audioStream.close();
    }
} finally {
    presentation.dispose();
}

儲存會把指令存入 command.pptx；不會自動播放錄音。播放需要支援此指令與其媒體目標的簡報播放器。

管理行為集合

[BehaviorCollection] 支援[add]、[insert]、[remove]與[removeAt]。此範例開啟 rotation.pptx，加入縮放，將其移至旋轉之前，然後移除旋轉。移除後重新插入相同物件會變更其儲存位置，而不會產生副本。

編輯順序會將集合從 rotation–scale 變為 scale–rotation，最終變為僅 scale。索引指向當前集合，因此移除時使用旋轉在重新排序後的新索引。最後的列舉確認了將被儲存的行為。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("rotation.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    const behaviors = effect.getBehaviors();

    const factory = new aspose.slides.BehaviorFactory();
    const scale = factory.createScaleEffect();
    scale.setTo(java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(125), java.newFloat(125)));
    scale.getTiming().setDuration(2);

    behaviors.add(scale);

    behaviors.remove(scale);
    behaviors.insert(0, scale);
    behaviors.removeAt(1);

    for (let i = 0; i < behaviors.getCount(); i++) {
        const behavior = behaviors.get_Item(i);
        console.log(behavior.getClass().getSimpleName());
    }

    presentation.save("collection-edited.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

輸出為 ScaleEffect：僅保留縮放。僅憑集合順序不會使行為依次排程。僅在全部取代其操作時才清除集合。

設定行為時間

[Behavior.getTiming] 會揭露[Timing]，且獨立於[Effect.getTiming]。效果時間排程外層效果；行為時間則描述其中的操作。

設定持續時間、延遲、重複與加速

開啟 rotation.pptx，以秒為單位設定持續時間（[getDuration]）與觸發延遲（[getTriggerDelayTime]），接著透過[setRepeatCount]設定重複次數。[getAccelerate]與[getDecelerate]為持續時間的比例；兩者總和請勿超過 1。

輸入檔為旋轉範例所產生的檔案，第一個行為已知為旋轉。本範例僅變更該行為的時間；其 90 度角度保持不變。將角度與時間分開設定，可更方便地調整節奏而無需重建動畫。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("rotation.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    const rotation = effect.getBehaviors().get_Item(0);
    rotation.getTiming().setDuration(2);
    rotation.getTiming().setTriggerDelayTime(java.newFloat(0.5));
    rotation.getTiming().setRepeatCount(3);
    rotation.getTiming().setAccelerate(java.newFloat(0.2));
    rotation.getTiming().setDecelerate(java.newFloat(0.2));

    presentation.save("timing.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

此行為使用兩秒持續時間、半秒延遲，並設定重複次數為 3。持續時間的前 20% 與後 20% 用於加速與減速。

其他重複策略包含[getRepeatDuration]、[getRepeatUntilEndSlide]與[getRepeatUntilNextClick]；請選擇其中一種策略，而非同時啟用全部。[getAutoReverse] 會在正向播放後倒轉動畫。加速與減速適用於連續變化，而非離散的指派或指令。

建立移動路徑

使用[createMotionEffect]建立移動。[getFrom]、[getTo]與[getBy]描述基於百分比的座標或偏移。若要建立可編輯的路徑，請建立[MotionPath]並以[MotionEffect.setPath]指派。[MotionPath]會儲存路徑指令。

Command	Points	Meaning
MoveTo	One	設定起始位置。
LineTo	One	沿直線段移動至其端點。
CurveTo	Three	依由兩個控制點與端點定義的三次曲線移動。
CloseLoop	None	返回起始位置。
End	None	完成路徑。

[MotionPathPointsType] 描述點編輯的特性，例如角點或平滑點。它不會取代指令類型。對於下面的曲線範例使用曲線點類型，對於直線段使用角點類型。

路徑座標以投影片尺寸正規化：X 位移 0.25 代表投影片寬度的四分之一，而非 0.25 點。正向 Y 向下。絕對指令在路徑座標系統中指定位置；相對指令則指定相對於目前位置的偏移。這與[getOrigin]（選取路徑的參考框架）以及[getPathEditMode]（控制形狀移動時路徑的移動方式）是分開的。

建立直線路徑

建立具有起始點、一條直線段與結束指令的移動行為。[MotionPath.add]接受指令類型、其點、點的類型與相對座標旗標。

起始指令設定 (0, 0)，直線在 (0.25, 0) 結束，為路徑提供投影片寬度四分之一的水平位移。結束指令沒有座標點。路徑指派後，將移動行為加入效果即會把此路徑連結至矩形。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 160, 80);

    const effect = slide.getTimeline().getMainSequence().addEffect(shape, aspose.slides.EffectType.PathRight, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    const factory = new aspose.slides.BehaviorFactory();
    const motion = factory.createMotionEffect();
    motion.setOrigin(aspose.slides.MotionOriginType.Layout);
    motion.getTiming().setDuration(2);

    const path = new aspose.slides.MotionPath();
    path.add(aspose.slides.MotionCommandPathType.MoveTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0), java.newFloat(0))]), aspose.slides.MotionPathPointsType.Auto, false);
    path.add(aspose.slides.MotionCommandPathType.LineTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.25), java.newFloat(0))]), aspose.slides.MotionPathPointsType.Corner, false);
    path.add(aspose.slides.MotionCommandPathType.End, java.newArray("java.awt.geom.Point2D$Float", []), aspose.slides.MotionPathPointsType.None, false);

    motion.setPath(path);
    effect.getBehaviors().add(motion);

    presentation.save("motion.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

motion.pptx 包含一個具有三個路徑指令的移動行為。以下的檔案編輯範例均使用此已知結構。

比較絕對座標與相對座標

這兩個路徑物件描述相同的路徑。絕對指令的終點為 (0.3, 0.1)；相對指令則在目前位置 (0.2, 0) 上加上 (0.1, 0.1)。

兩條路徑皆從相同位置開始。對於相對直線，將其 X、Y 偏移加至目前位置即得終點；對於絕對直線，直接讀取終點。若未轉換座標就切換旗標，會產生不同的路徑。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const absolutePath = new aspose.slides.MotionPath();
absolutePath.add(aspose.slides.MotionCommandPathType.MoveTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.2), java.newFloat(0))]), aspose.slides.MotionPathPointsType.Auto, false);
absolutePath.add(aspose.slides.MotionCommandPathType.LineTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.3), java.newFloat(0.1))]), aspose.slides.MotionPathPointsType.Corner, false);

const relativePath = new aspose.slides.MotionPath();
relativePath.add(aspose.slides.MotionCommandPathType.MoveTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.2), java.newFloat(0))]), aspose.slides.MotionPathPointsType.Auto, false);
relativePath.add(aspose.slides.MotionCommandPathType.LineTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.1), java.newFloat(0.1))]), aspose.slides.MotionPathPointsType.Corner, true);

將任一路徑指派給移動行為，即可在簡報中使用。最後的布林參數會為該指令選擇相對座標。

以曲線取代直線

開啟 motion.pptx，將其直線指令取代為三次曲線。先提供兩個控制點，然後再提供端點。

起始位置由前一指令提供。前兩個點構成曲線形狀，第三個點為目的地；它們不是三個連續的目的地。同步更新指令類型、點編輯類型與點陣列，可確保片段與新幾何保持一致。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("motion.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    const motion = effect.getBehaviors().get_Item(0);

    const path = motion.getPath();
    path.get_Item(1).setCommandType(aspose.slides.MotionCommandPathType.CurveTo);
    path.get_Item(1).setPointsType(aspose.slides.MotionPathPointsType.CurveSmooth);
    path.get_Item(1).setPoints(java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.1), java.newFloat(0)), java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.2), java.newFloat(0.1)), java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.3), java.newFloat(0.1))]));

    presentation.save("curve.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

curve.pptx 中的路徑仍有三個指令；其中間的指令現在定義為曲線。

檢查與編輯已儲存的路徑

每個[MotionCmdPath]會公開[getPoints]、[getCommandType]、[getPointsType]與[isRelative]。以下範例使用motion.pptx中已知的三指令路徑。對於任意輸入，先定位目標效果，並在依索引編輯前檢查指令類型與點數量。

讀取指令與座標

在不變更路徑的情況下讀取。結束與閉合迴路指令不需要點，因此要允許點陣列為 null。

輸出會先將每個數值指令類型與其相對座標旗標配對，然後列出其點。這讓您在修改路徑前能分辨端點與偏移。曲線會列出三個點，而此檔案中的直線僅列出一個點。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("motion.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    const motion = effect.getBehaviors().get_Item(0);

    const path = motion.getPath();
    for (let i = 0; i < path.getCount(); i++) {
        const segment = path.get_Item(i);
        console.log(segment.getCommandType() + ", relative: " + segment.isRelative());
        const points = segment.getPoints();
        if (points != null) {
            for (const point of points) {
                console.log("X=" + point.getX() + ", Y=" + point.getY());
            }
        }
    }
} finally {
    presentation.dispose();
}

此清單包含起始點、一條結束於 (0.25, 0) 的絕對直線，以及結束指令。

變更端點

開啟 motion.pptx，並取代直線的點陣列以移動其端點。

在輸入檔中，索引 0 為起始指令，索引 1 為直線。取代直線的單一點會更改其目的地，而不會改變指令類型、時間或在集合中的位置。因為此指令使用絕對座標，新點對表示位置而非新增偏移。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("motion.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    const motion = effect.getBehaviors().get_Item(0);
    motion.getPath().get_Item(1).setPoints(java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.4), java.newFloat(0.1))]));

    presentation.save("motion-endpoint.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

motion-endpoint.pptx 中的直線結束於 (0.4, 0.1)；原始檔未變更。

取代線段

使用[insert]與[removeAt]取代 motion.pptx 中的直線。插入會將舊的直線移至索引 2。

這示範了取代指令物件而非編輯其現有座標。插入後，集合暫時包含起始指令、新直線、舊直線與結束指令。移除索引 2 後，舊直線被捨棄，新的路徑保留。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("motion.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    const motion = effect.getBehaviors().get_Item(0);

    const path = motion.getPath();
    path.insert(1, aspose.slides.MotionCommandPathType.LineTo, java.newArray("java.awt.geom.Point2D$Float", [java.newInstanceSync("java.awt.geom.Point2D$Float", java.newFloat(0.2), java.newFloat(0.1))]), aspose.slides.MotionPathPointsType.Corner, false);
    path.removeAt(2);

    presentation.save("motion-edited.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

儲存的路徑仍有三個指令，新的直線結束於 (0.2, 0.1)，結束指令位於最後。

修改與驗證現有行為

當行為的索引未知時，請依類型選取。本範例開啟 rotation.pptx，尋找其[RotationEffect]，變更角度，並在重新開啟後檢查儲存的值。

類型檢查讓迴圈跳過非旋轉的行為。第二次載入會將已儲存的檔案讀入另一個簡報物件，因此比較的是持久化資料而非仍在記憶體中的值。本範例仍假設已知效果位於主要序列的第一個；依類型選取行為無法在任意簡報中定位正確的效果。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("rotation.pptx");
try {
    const effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    for (let i = 0; i < effect.getBehaviors().getCount(); i++) {
        const behavior = effect.getBehaviors().get_Item(i);
        if (java.instanceOf(behavior, "com.aspose.slides.IRotationEffect")) {
            const rotation = behavior;
            rotation.setBy(180);
        }
    }

    presentation.save("rotation-edited.pptx", aspose.slides.SaveFormat.Pptx);

    const reopened = new aspose.slides.Presentation("rotation-edited.pptx");
    try {
        const savedEffect = reopened.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

        for (let i = 0; i < savedEffect.getBehaviors().getCount(); i++) {
            const behavior = savedEffect.getBehaviors().get_Item(i);
            if (java.instanceOf(behavior, "com.aspose.slides.IRotationEffect")) {
                const rotation = behavior;
                console.log("Rotation preserved: " + (Math.abs(rotation.getBy() - 180) < 0.001));
            }
        }
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

輸出為 Rotation preserved: true。對其他行為亦可套用相同的類型檢查模式。要進行完整的保存檢查，請比較目標形狀、效果、行為類型與順序、時間與路徑指令。對浮點數使用數值容差。若簡報的動畫布局未知，請參考讀取形狀動畫以遍歷主要與互動序列。

行為順序、預設與播放

[BehaviorCollection] 中的順序是效果操作的儲存順序。它不是每個行為自動等待前一個的播放清單。時間與外層效果決定排程。行為可以重疊，同一屬性的操作可能透過[getAdditive]與[getAccumulate]互相影響。不要僅靠重新排序集合來排程「移動，然後旋轉」；請使用明確的時間設定或如[形狀動畫]中所述的分離效果。

效果的[getType]與[getSubtype]描述其預設。它們並非編輯後行為樹的完整說明。請在自訂行為之前先選擇預設與子類型：變更預設可能會重新建立集合，並捨棄您的自訂操作。例如，將已自訂的 Spin 效果變更為 Fade，會以 set 與 filter 行為取代其旋轉行為。變更預設或子類型後請再次檢查集合。清除預設行為也可能移除預設所需的可見性或初始化操作。範例故意使用可見形狀並取代行為；未重新建構每個預設的實作。

格式相容性

即使行為樹已保存，也無法保證在所有檢視器或匯出渲染器中播放完全相同。請分別檢查已儲存的資料與渲染輸出。

格式或輸出	需驗證項目
PPTX	PPTX：作為這些範例的主要格式。重新開啟以驗證可編輯的行為樹，然後在目標 PowerPoint 版本中檢查播放情況。
PPT	PPT：舊版的二進位表示可能與 PPTX 不同。測試單獨的儲存與重新開啟循環以及播放；不要僅根據 PPTX 成功輸出就推斷支援所有自訂組合。
PDF、PNG、JPEG 以及其他靜態投影片影像	僅包含靜態投影片表示，並非可播放的行為時間軸或保證的最終動畫框格。
HTML5	可在匯出選項中啟用形狀動畫時播放支援的動畫。於瀏覽器中測試自訂組合。
Animated GIF	儲存已渲染的影格，而非可編輯的行為或點擊觸發的互動。檢查實際渲染的動作。
Video	將動畫影格渲染並編碼為影片。支援僅限於渲染器的支援動畫與效果；指令與互動事件不會變成可編輯的時間軸。

常見問題

為什麼我的效果在我加入任何行為之前就已包含行為？

建立預定義效果時可能會產生其底層操作。請先檢查它們，再決定是擴充預設還是取代其行為。

將行為移至開頭會使它先播放嗎？

未必。集合順序並非時間的替代品。請檢查延遲、持續時間，以及同屬性操作之間的交互。

為什麼結束指令沒有點？

它標示路徑結束，無需座標。檢查從檔案讀取的路徑時，要留意點陣列是否為 null。

成功的往返是否足以確認播放？

不會。重新開啟僅驗證屬性的保存。須另行測試簡報播放程式或動畫匯出，以確認其視覺行為。

在 JavaScript 中使用動畫增強 PowerPoint 簡報使用 Node.js 建立簡報的 3D 效果