在 Java 中创建和修改自定义动画行为

本页内容简介

使用 Aspose.Slides for Java 在 PowerPoint 演示文稿中创建、检查和修改自定义动画行为以及可编辑的运动路径。

概览

自定义动画行为让您能够控制动画效果中的各个操作，例如更改颜色、旋转形状或沿可编辑的运动路径移动。本指南展示如何创建和组合行为、配置它们的时间、检查和修改现有动画，并验证它们的属性在保存并重新打开演示文稿后仍然保持。

有关预定义效果和点击触发器，请参阅形状动画。

了解动画模型

动画的组织结构为 Timeline → Sequence → Effect → Behaviors：

The getTimeline 方法返回幻灯片时间线，其中包含主序列和交互序列。
An ISequence 包含效果，可能针对不同的形状。
An IEffect 标识目标形状、预设、子类型以及效果时间。
The collection returned by IEffect.getBehaviors 包含实现该效果的操作：更改颜色、移动、旋转、设置属性等。

创建单个行为

Call ISequence.addEffect 创建效果并访问 getBehaviors 集合。预设可以自动填充此集合。扩展预设时保留其操作，或在有意替换时使用 clear。

IBehaviorFactory 创建下文所示的八种行为类型。运动路径在构建运动路径中介绍。每个代码片段都包含导入语句；将可执行语句放在方法内部。后续编辑示例会说明使用的输出文件。

旋转

使用 createRotationEffect 创建旋转。getBy 指定相对角度（度）；getFrom 和 getTo 指定端点。

示例从 Spin 效果开始，用一个旋转行为替换其预设操作，并为该操作设置两秒持续时间。相对角度 90 度表示形状起始方向的四分之一转弯，因此不需要显式的起始角度。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

    IBehaviorFactory factory = new BehaviorFactory();
    IRotationEffect rotation = factory.createRotationEffect();
    rotation.setBy(90f);
    rotation.getTiming().setDuration(2f);

    effect.getBehaviors().add(rotation);

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

rotation.pptx 包含一个形状和一个旋转行为。下面的集合、时间和旋转编辑示例均使用此文件。

缩放

使用 createScaleEffect 并提供 X/Y 百分比：getFrom 和 getTo 描述起始和结束大小，而 getBy 描述相对变化。这里的 100 表示原始大小。

示例在两秒内将两个维度从 100% 增长到 125%。使用相同的水平和垂直百分比可以保持形状比例；不同的百分比会拉伸某一维度。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

    IBehaviorFactory factory = new BehaviorFactory();
    IScaleEffect scale = factory.createScaleEffect();
    scale.setFrom(new Point2D.Float(100, 100));
    scale.setTo(new Point2D.Float(125, 125));
    scale.getTiming().setDuration(2f);

    effect.getBehaviors().add(scale);

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

颜色

使用 createColorEffect 将填充从蓝色改为橙色。getFrom 和 getTo 是颜色；getBy 是颜色偏移。IBehavior.getProperties 标识被动画化的属性。

形状的实心填充初始化为蓝色，与动画的起始颜色匹配。选择填充颜色属性告诉行为要更改形状的哪一部分；仅有颜色端点并不能确定该属性。保存的效果描述了两秒的过渡到橙色。

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.BLUE);

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

    IBehaviorFactory factory = new BehaviorFactory();
    IColorEffect color = factory.createColorEffect();
    color.getProperties().add(BehaviorProperty.getFillColor().getValue());
    color.getFrom().setColor(Color.BLUE);
    Color orange = new Color(255, 165, 0);
    color.getTo().setColor(orange);
    color.getTiming().setDuration(2f);

    effect.getBehaviors().add(color);

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

滤镜

使用 createFilterEffect 选择擦除。getType、getSubtype 和 getReveal 指定滤镜、方向以及是显现还是隐藏形状。

此示例配置了一个两秒的擦除，将形状从右侧方向显现。滤镜设置属于效果内部的行为，因此在移除预设的原始操作后进行配置。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

    IBehaviorFactory factory = new BehaviorFactory();
    IFilterEffect filter = factory.createFilterEffect();
    filter.setType(FilterEffectType.Wipe);
    filter.setSubtype(FilterEffectSubtype.Right);
    filter.setReveal(FilterEffectRevealType.In);
    filter.getTiming().setDuration(2f);

    effect.getBehaviors().add(filter);

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

属性

使用 createPropertyEffect 为不透明度添加动画。getFrom、getTo 和 getBy 是字符串，需通过 getValueType 和 getCalcMode 进行解释。请选择端点或相对偏移，而不是同时设置全部三个。

这里选择的属性是不透明度，数值字符串表示从 25% 不透明度变为完全不透明。线性插值描述了这些值之间的渐变。当将此示例应用于其他属性时，需为该属性选择合适的值类型和端点值。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

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

    effect.getBehaviors().add(property);

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

设置

使用 createSetEffect 通过 getTo 赋予可见性。设置行为不在端点之间进行插值。

示例选择可见性属性，并在行为运行时将字符串 visible 赋给它。矩形在此最小演示中已经可见，因此单独的赋值可能看不出明显的视觉变化。此类操作在更大的效果中很有用，例如控制何时隐藏或显示形状。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

    IBehaviorFactory factory = new BehaviorFactory();
    ISetEffect set = factory.createSetEffect();
    set.getProperties().add(BehaviorProperty.getStyleVisibility().getValue());
    set.setTo("visible");

    effect.getBehaviors().add(set);

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

命令

使用 createCommandEffect 并配置 getType、getCommandString 和 getShapeTarget。在工作目录中放置名为 sample.wav 的 WAV 录音文件。此示例使用 addAudioFrameEmbedded 将其嵌入，并为音频帧附加播放命令。

音频帧既是效果的目标，也是命令的目标。这将播放请求链接到嵌入的录音；仅有命令字符串并不能确定要控制的媒体对象。该效果配置为在幻灯片放映期间点击时启动。

import com.aspose.slides.*;
import java.io.FileInputStream;
import java.io.IOException;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    try (FileInputStream audioStream = new FileInputStream("sample.wav")) {
        IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(100, 100, 40, 40, audioStream);

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

        IBehaviorFactory factory = new BehaviorFactory();
        ICommandEffect command = factory.createCommandEffect();
        command.setType(CommandEffectType.Call);
        command.setCommandString("play");
        command.setShapeTarget(audioFrame);

        effect.getBehaviors().add(command);

        presentation.save("command.pptx", SaveFormat.Pptx);
    } catch (IOException exception) {
        System.out.println("Unable to read sample.wav: " + exception.getMessage());
    }
} finally {
    presentation.dispose();
}

保存后会在 command.pptx 中存储该命令；它不会自动播放录音。播放需要支持该命令及其媒体目标的幻灯片播放器。

管理行为集合

IBehaviorCollection 支持 add、insert、remove、removeAt。本示例打开 rotation.pptx，添加缩放行为、在旋转之前移动它，并删除旋转。删除后重新插入同一对象会改变其在集合中的位置，而不会产生副本。

编辑顺序将集合从 rotation–scale 变为 scale–rotation，随后仅保留 scale。索引始终指向当前集合，所以删除时使用的是重新排序后旋转的新索引。最终枚举确认了将被保存的行为。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

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

    IBehaviorFactory factory = new BehaviorFactory();
    IScaleEffect scale = factory.createScaleEffect();
    scale.setTo(new Point2D.Float(125, 125));
    scale.getTiming().setDuration(2f);

    behaviors.add(scale);

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

    for (IBehavior behavior : behaviors)
        System.out.println(behavior.getClass().getSimpleName());

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

输出是 ScaleEffect：仅剩缩放。集合顺序本身并不会安排行为依次执行。仅在全部替换时才清空集合。

配置行为时间

IBehavior.getTiming 暴露了 ITiming，独立于 IEffect.getTiming。效果时间安排外层效果；行为时间描述内部操作。

设置持续时间、延迟、重复次数和加速

打开 rotation.pptx，以秒为单位设置持续时间 (getDuration) 和触发延迟 (getTriggerDelayTime)，随后通过 setRepeatCount 配置重复次数。getAccelerate 和 getDecelerate 为持续时间的分数；其和最多为 1。

输入文件为旋转示例中创建的文件，已知第一个行为是旋转。本示例仅修改该行为的时间，90 度角保持不变。将角度和时间分离，使得在不重新构建动画的情况下更容易调节节奏。

import com.aspose.slides.*;

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

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

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

该行为使用两秒持续时间、半秒延迟，重复次数为 3。其前后各 20% 的时间用于加速和减速。

其他重复策略包括 getRepeatDuration、getRepeatUntilEndSlide、getRepeatUntilNextClick；请选择其中一种，而不是全部同时启用。getAutoReverse 在正向播放结束后逆向播放动画。加速和减速仅适用于连续变化，不适用于离散赋值或命令。

构建运动路径

使用 createMotionEffect 创建运动。其 getFrom、getTo、getBy 描述基于百分比的坐标或偏移。若需可编辑的路线，请创建 MotionPath 并使用 IMotionEffect.setPath 进行赋值。IMotionPath 保存路径命令。

MotionCommandPathType 选择操作：

命令	点数	含义
MoveTo	一个	设置起始位置。
LineTo	一个	沿直线段移动到其终点。
CurveTo	三个	沿由两个控制点和一个终点定义的三次曲线移动。
CloseLoop	无	返回起始位置。
End	无	结束路径。

MotionPathPointsType 描述点的编辑特性，如拐角点或平滑点。它不取代命令类型。曲线示例使用曲线点类型，直线段使用拐角点类型。

路径坐标归一化为幻灯片尺寸：X 位移 0.25 表示幻灯片宽度的四分之一，而不是 0.25 点。正 Y 向下。绝对命令在路径坐标系中指定位置；相对命令指定相对于当前位置信息的偏移。这与 getOrigin（选择路径的参考框架）以及 getPathEditMode（控制形状移动时路径如何移动）是分开的。

创建直线路径

创建一个起始点、一个直线段和一个结束命令的运动行为。IMotionPath.add 接受命令类型、其点、点类型以及相对坐标标志。

起始命令设为 (0, 0)，直线结束于 (0.25, 0)，使路径在水平方向上位移幻灯片宽度的四分之一。结束命令没有坐标点。路径赋值后，将运动行为添加到效果中即可将该路线关联到矩形。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

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

    IBehaviorFactory factory = new BehaviorFactory();
    IMotionEffect motion = factory.createMotionEffect();
    motion.setOrigin(MotionOriginType.Layout);
    motion.getTiming().setDuration(2f);

    IMotionPath path = new MotionPath();
    path.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0, 0) }, MotionPathPointsType.Auto, false);
    path.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.25f, 0) }, MotionPathPointsType.Corner, false);
    path.add(MotionCommandPathType.End, new Point2D.Float[0], MotionPathPointsType.None, false);

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

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

motion.pptx 包含一个包含三条路径命令的运动行为。下面的文件编辑示例均基于此结构。

比较绝对坐标和相对坐标

这两个路径对象描述相同的路线。绝对命令以 (0.3, 0.1) 结束；相对命令在当前位置信息上添加 (0.1, 0.1)，得到 (0.2, 0)。

两条路径均从相同位置开始。对于相对直线，将其 X、Y 偏移加到当前位置信息即可得到终点；对于绝对直线，则直接读取终点坐标。若不转换坐标直接切换标志，将会得到不同的路线。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

MotionPath absolutePath = new MotionPath();
absolutePath.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0) }, MotionPathPointsType.Auto, false);
absolutePath.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.3f, 0.1f) }, MotionPathPointsType.Corner, false);

MotionPath relativePath = new MotionPath();
relativePath.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0) }, MotionPathPointsType.Auto, false);
relativePath.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.1f, 0.1f) }, MotionPathPointsType.Corner, true);

将任意路径赋给运动行为即可在演示中使用。最后的布尔参数用于为该命令选择相对坐标。

用曲线替代直线

打开 motion.pptx，将其直线命令替换为三次曲线。先提供两个控制点，再提供终点。

起始位置由前一命令提供。前两个点塑造曲线，第三个点是曲线的终点；它们不是三个连续的目的地。一起更新命令类型、点编辑类型以及点数组，可保持该段与新几何形状的一致性。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

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

    IMotionPath path = motion.getPath();
    path.get_Item(1).setCommandType(MotionCommandPathType.CurveTo);
    path.get_Item(1).setPointsType(MotionPathPointsType.CurveSmooth);
    path.get_Item(1).setPoints(new Point2D.Float[] { new Point2D.Float(0.1f, 0), new Point2D.Float(0.2f, 0.1f), new Point2D.Float(0.3f, 0.1f) });

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

curve.pptx 中的路径仍然有三条命令，只是中间的命令现在定义为曲线。

检查并编辑已保存的路径

每个 IMotionCmdPath 都暴露 getPoints、getCommandType、getPointsType 和 isRelative。以下示例使用 motion.pptx 中已知的三条命令路径。对于任意输入，请先定位目标效果，然后在编辑前检查命令类型和点数量。

读取命令和坐标

读取路径而不进行修改。结束和闭合命令不需要点，因此需要允许空的点数组。

输出在列出点之前，会先列出每个数值型命令类型及其相对坐标标志。这使您在修改路径之前能够区分端点与偏移。曲线会列出三个点，而本文件中的直线只列出一个点。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

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

    IMotionPath path = motion.getPath();
    for (IMotionCmdPath segment : path)
    {
        System.out.println(segment.getCommandType() + ", relative: " + segment.isRelative());
        if (segment.getPoints() != null)
            for (Point2D.Float point : segment.getPoints())
                System.out.println("X=" + point.x + ", Y=" + point.y);
    }
} finally {
    presentation.dispose();
}

列表包含起始点、一个绝对直线（终点为 (0.25, 0)）以及结束命令。

更改端点

打开 motion.pptx，替换直线的点数组以移动其终点。

在输入文件中，索引 0 为起始命令，索引 1 为直线。替换直线的单个点会改变其目的地，而不影响命令类型、时间或在集合中的位置。由于该命令使用绝对坐标，新坐标对表示位置而非增量偏移。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

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

    IMotionEffect motion = (IMotionEffect)effect.getBehaviors().get_Item(0);
    motion.getPath().get_Item(1).setPoints(new Point2D.Float[] { new Point2D.Float(0.4f, 0.1f) });

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

motion-endpoint.pptx 中的直线终点为 (0.4, 0.1)；原文件保持不变。

替换段落

使用 insert 和 removeAt 替换 motion.pptx 中的直线。插入操作会把旧直线移至索引 2。

此示例演示了替换命令对象，而不是编辑其已有坐标。插入后，集合暂时包含起始命令、新直线、旧直线以及结束命令。随后删除索引 2，即可丢弃旧直线，留下新路线。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

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

    IMotionPath path = motion.getPath();
    path.insert(1, MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0.1f) }, MotionPathPointsType.Corner, false);
    path.removeAt(2);

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

保存的路径仍然有三条命令，新直线终点为 (0.2, 0.1)，结束命令仍在最后。

修改并验证已有行为

当行为索引未知时，可按类型选择。此示例打开 rotation.pptx，查找其 IRotationEffect，更改角度，并在重新打开后检查保存的值。

类型检查使循环能够跳过非旋转行为。第二次加载将已保存的文件读取到单独的演示对象中，从而比较的是持久化的数据，而不是仍驻留在内存中的值。该示例仍假设已知的效果位于主序列的首位；按类型选择行为并不能在任意演示文稿中定位正确的效果。

import com.aspose.slides.*;

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

    for (IBehavior behavior : effect.getBehaviors())
    {
        if (behavior instanceof IRotationEffect) {
            IRotationEffect rotation = (IRotationEffect) behavior;
            rotation.setBy(180f);
        }
    }

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

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

        for (IBehavior behavior : savedEffect.getBehaviors())
        {
            if (behavior instanceof IRotationEffect) {
                IRotationEffect rotation = (IRotationEffect) behavior;
                System.out.println("Rotation preserved: " + (Math.abs(rotation.getBy() - 180f) < 0.001f));
            }
        }
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

输出为 Rotation preserved: true。对其他行为也可采用相同的类型检查模式。若要进行完整的保存检查，需要比较目标形状、效果、行为类型及顺序、时间以及路径命令。对浮点数使用数值容差。对于动画布局未知的演示文稿，请参阅读取形状动画以遍历主序列和交互序列。

行为顺序、预设与播放

IBehaviorCollection 中的顺序是效果操作的存储顺序。它不是播放列表，行为不会自动等待前一个行为完成。时间和外层效果决定调度。行为可以重叠，同一属性的操作可能通过 getAdditive 和 getAccumulate 交互。不要仅靠集合重新排序来实现“先移动后旋转”；请使用显式时间或如形状动画中描述的独立效果。

效果的 getType 和 getSubtype 描述其预设。它们并未完整描述已编辑的行为树。请在自定义行为之前先选择预设和子类型：更改预设可能会重新构建集合并丢弃自定义操作。例如，将自定义的 Spin 效果改为 Fade 会用设置和滤镜行为替代旋转行为。更改预设或子类型后请再次检查集合。清除预设行为也可能移除预设所需的可见性或初始化操作。示例特意使用可见形状并替换行为，而不重新构建每个预设的实现。

格式兼容性

已保存的行为树并不能保证在所有查看器或导出渲染器中出现完全相同的播放效果。请分别检查保存的数据和渲染输出。

格式或输出	需要验证的内容
PPTX	作为本示例的主要格式使用。重新打开以验证可编辑的行为树，然后在目标 PowerPoint 版本中检查播放效果。
PPT	传统的二进制表示可能与 PPTX 不同。请单独进行一次保存‑重新打开‑播放的完整周期测试；不要仅凭 PPTX 成功输出就推断所有自定义组合均受支持。
PDF、PNG、JPEG 以及其他静态幻灯片图像	仅包含静态幻灯片表示，既不是可播放的行为时间线，也不保证最终动画帧。
HTML5	在导出选项中启用形状动画后，可播放受支持的动画。请在浏览器中测试自定义组合。
Animated GIF	存储渲染后的帧，而非可编辑行为或点击触发的交互。请检查实际渲染的运动。
Video	将动画帧渲染并编码为视频。支持范围受渲染器的支持的动画和效果限制；命令和交互事件不会成为可编辑的时间线。

常见问题解答

为什么我的效果在添加任何行为之前就已经包含行为？

创建预定义效果时可能会生成其底层操作。请先检查这些操作，再决定是扩展预设还是替换其行为。

将行为移动到开头会让它先播放吗？

不一定。集合顺序并不是时间的替代品。请检查延迟、持续时间以及同一属性上操作之间的交互。

为什么结束命令没有点？

结束命令标记路径的结束，不需要坐标。检查从文件读取的路径时，需要处理可能为 null 的点数组。

仅成功的往返保存就足以确认播放吗？

不能。重新打开仅验证了您检查的属性是否被保存。仍需在幻灯片播放器或动画导出环境中单独测试，以确认其视觉行为。

在 Java 中通过动画增强 PowerPoint 演示文稿使用 Java 在演示文稿中创建 3D 效果