在演示文稿中使用 Java 应用形状动画

本页内容简介

了解如何使用 Aspose.Slides for Java 添加、检查和自定义形状动画、时间设置、声音、动画后行为以及动画文本。

概述

Aspose.Slides for Java 将幻灯片动画表示为幻灯片时间轴上的效果。每个效果都有目标形状、动画类型和子类型、触发器、时间设置以及可选属性（例如声音或动画结束后的行为）。

时间轴包含两种序列：

主序列 在幻灯片前进时播放。
交互序列 在其触发形状被单击时启动。

由于文本框、图片、图表、表格和其他幻灯片对象实现了IShape，因此对大多数幻灯片内容使用相同的ISequence.addEffect方法。可用的效果列在EffectType类中。

添加形状动画

要添加动画，获取幻灯片的主序列并调用ISequence.addEffect并传入目标形状、效果类型、子类型和触发器。若要创建在单击另一个形状时启动的效果，请创建触发器为该形状的交互序列。

下面的示例创建了两种类型的动画并将结果保存为shape-animations.pptx。

import com.aspose.slides.*;

public class AddShapeAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);

            IAutoShape targetShape = slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 120, 100, 320, 80);
            targetShape.addTextFrame("Click to animate this shape");

            ISequence mainSequence = slide.getTimeline().getMainSequence();
            IEffect entranceEffect = mainSequence.addEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            entranceEffect.getTiming().setDuration(1.5f);

            IAutoShape triggerShape = slide.getShapes().addAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
            triggerShape.addTextFrame("Move");

            ISequence interactiveSequence = slide.getTimeline().getInteractiveSequences().add(triggerShape);
            interactiveSequence.addEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

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

触发器决定效果何时开始：

EffectTriggerType.OnClick 在主序列中等待点击，或在交互序列中等待对触发形状的点击。
EffectTriggerType.WithPrevious 与前一个效果同时开始。
EffectTriggerType.AfterPrevious 在前一个效果完成后开始。

要为图片、图表或其他形状类型设置动画，请将相应对象传递给ISequence.addEffect，而不是targetShape。有关特定于图表的分组选项，请参阅Animated Charts。

读取形状动画

当已知目标形状时，使用ISequence.getEffectsByShape。若要检查每个效果，请遍历主序列和所有交互序列。遍历可以避免假设序列在索引0处一定有效果。

下面的示例创建了带有主序列和交互序列效果的形状，获取针对该形状的效果，然后遍历幻灯片上的每个序列。

import com.aspose.slides.*;

public class ReadShapeAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape targetShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            targetShape.addTextFrame("Animated shape");

            ISequence mainSequence = slide.getTimeline().getMainSequence();
            mainSequence.addEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

            IAutoShape triggerShape = slide.getShapes().addAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
            triggerShape.addTextFrame("Move");

            ISequence interactiveSequence = slide.getTimeline().getInteractiveSequences().add(triggerShape);
            interactiveSequence.addEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

            IEffect[] targetEffects = mainSequence.getEffectsByShape(targetShape);
            System.out.println("The main sequence contains " + targetEffects.length + " effect(s) for " + targetShape.getName() + ".");

            printSequence("Main sequence", mainSequence);

            int interactiveIndex = 1;
            for (ISequence sequence : slide.getTimeline().getInteractiveSequences()) {
                String triggerName = sequence.getTriggerShape() == null ? "unknown" : sequence.getTriggerShape().getName();
                String sequenceLabel = "Interactive sequence " + interactiveIndex + ", trigger: " + triggerName;
                printSequence(sequenceLabel, sequence);
                interactiveIndex++;
            }
        } finally {
            presentation.dispose();
        }
    }

    private static void printSequence(String label, ISequence sequence) {
        System.out.println("  " + label + ": " + sequence.getCount() + " effect(s)");

        for (IEffect effect : sequence) {
            String targetName = effect.getTargetShape() == null ? "unknown" : effect.getTargetShape().getName();
            String typeName = EffectType.getName(EffectType.class, effect.getType());
            String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());
            String triggerName = EffectTriggerType.getName(EffectTriggerType.class, effect.getTiming().getTriggerType());
            String effectDescription = typeName + " " + subtypeName + "; target: " + targetName + "; trigger: " + triggerName;
            System.out.println("    " + effectDescription);
        }
    }
}

如果只需获取单个形状的效果，先通过名称、占位符类型或其他稳定属性识别该形状；然后调用ISequence.getEffectsByShape。不要假设IShapeCollection.get_Item在索引0处始终是目标对象。

使用继承的占位符效果

普通幻灯片上的占位符可以继承其版式幻灯片和母版幻灯片上对应占位符的动画行为。IShape.getBasePlaceholder返回该父占位符，若不存在父占位符则返回null。

在以下示例演示文稿中，页脚在普通幻灯片上使用 Random Bars，在版式幻灯片上使用 Split，在母版幻灯片上使用 Fly In。

普通幻灯片上的页脚动画效果

版式幻灯片上的页脚占位符动画效果

母版幻灯片上的页脚占位符动画效果

下面的示例使用新演示文稿中的占位符层次结构。它向母版占位符、版式占位符以及普通幻灯片上的相应占位符添加效果。每次调用IShape.getBasePlaceholder前都进行检查，以确保返回的形状可安全使用。

import com.aspose.slides.*;

public class InheritedPlaceholderAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject);
            IShape layoutPlaceholder = findPlaceholderWithBase(layoutSlide);

            if (layoutPlaceholder == null) {
                throw new IllegalStateException("The layout slide does not contain a placeholder linked to its master slide.");
            }

            IShape masterPlaceholder = layoutPlaceholder.getBasePlaceholder();
            layoutSlide.getMasterSlide().getTimeline().getMainSequence().addEffect(masterPlaceholder, EffectType.Fly, EffectSubtype.Bottom, EffectTriggerType.OnClick);
            layoutSlide.getTimeline().getMainSequence().addEffect(layoutPlaceholder, EffectType.Split, EffectSubtype.VerticalIn, EffectTriggerType.OnClick);

            ISlide slide = presentation.getSlides().addEmptySlide(layoutSlide);
            IShape slidePlaceholder = findPlaceholderWithBase(slide, layoutPlaceholder);

            if (slidePlaceholder == null) {
                throw new IllegalStateException("The slide does not contain a placeholder linked to its layout slide.");
            }

            slide.getTimeline().getMainSequence().addEffect(slidePlaceholder, EffectType.RandomBars, EffectSubtype.Horizontal, EffectTriggerType.OnClick);
            printEffects("Normal slide", slide.getTimeline().getMainSequence().getEffectsByShape(slidePlaceholder));

            IShape baseLayoutPlaceholder = slidePlaceholder.getBasePlaceholder();
            if (baseLayoutPlaceholder != null) {
                printEffects("Layout slide", layoutSlide.getTimeline().getMainSequence().getEffectsByShape(baseLayoutPlaceholder));

                IShape baseMasterPlaceholder = baseLayoutPlaceholder.getBasePlaceholder();
                if (baseMasterPlaceholder != null) {
                    printEffects("Master slide", layoutSlide.getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(baseMasterPlaceholder));
                }
            }

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

    private static IShape findPlaceholderWithBase(ILayoutSlide layoutSlide) {
        for (IShape shape : layoutSlide.getShapes()) {
            if (shape.getBasePlaceholder() != null) {
                return shape;
            }
        }

        return null;
    }

    private static IShape findPlaceholderWithBase(ISlide slide, IShape expectedBase) {
        for (IShape shape : slide.getShapes()) {
            if (shape.getBasePlaceholder() == expectedBase) {
                return shape;
            }
        }

        return null;
    }

    private static void printEffects(String source, IEffect[] effects) {
        System.out.println(source + ": " + effects.length + " effect(s)");

        for (IEffect effect : effects) {
            String typeName = EffectType.getName(EffectType.class, effect.getType());
            String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());
            System.out.println("  " + typeName + " " + subtypeName);
        }
    }
}

更改动画计时

PowerPoint Timing 对话框映射到ITiming的属性。

动画效果的 PowerPoint 计时对话框

开始映射到ITiming.getTriggerType。
持续时间 映射到ITiming.getDuration（秒）。
延迟映射到ITiming.getTriggerDelayTime（秒）。
重复映射到ITiming.getRepeatCount、ITiming.getRepeatUntilNextClick或ITiming.getRepeatUntilEndSlide。
播放完成后倒退 映射到ITiming.getRewind。

此独立示例添加一个效果，通过ISequence.addEffect返回的对象更改其计时，并保存结果。保留返回的IEffect引用可避免不必要的集合索引。

import com.aspose.slides.*;

public class ChangeAnimationTiming {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            shape.addTextFrame("Timed animation");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.getTiming().setTriggerType(EffectTriggerType.OnClick);
            effect.getTiming().setDuration(2.0f);
            effect.getTiming().setTriggerDelayTime(0.5f);
            effect.getTiming().setRepeatUntilNextClick(false);
            effect.getTiming().setRepeatUntilEndSlide(false);
            effect.getTiming().setRepeatCount(2.0f);
            effect.getTiming().setRewind(true);

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

请仅有意使用一种重复模式。将重复计数与“直到”标志组合可能在不同的查看器中产生混乱的结果。更改重复模式时，请先调用ITiming.setRepeatUntilNextClick和ITiming.setRepeatUntilEndSlide，再调用ITiming.setRepeatCount，因为设置任一标志都会同时更改活动的重复模式。

添加和提取动画声音

动画效果可以通过IEffect.getSound引用嵌入的音频。IEffect.setStopPreviousSound可指示效果停止先前效果启动的音频。

向效果添加声音

下面的示例需要本地音频文件animation-sound.wav。它创建两个效果，将该文件嵌入为第一个效果的声音，并配置第二个效果停止该声音。示例使用ISequence.addEffect返回的对象，因此不需要序列索引。

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;

public class AddAnimationSound {
    public static void main(String[] args) throws IOException {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape firstShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 100, 240, 80);
            IAutoShape secondShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 400, 100, 240, 80);
            firstShape.addTextFrame("Starts sound");
            secondShape.addTextFrame("Stops sound");

            ISequence sequence = slide.getTimeline().getMainSequence();
            IEffect firstEffect = sequence.addEffect(firstShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            IEffect secondEffect = sequence.addEffect(secondShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

            byte[] audioData = Files.readAllBytes(Paths.get("animation-sound.wav"));
            IAudio effectSound = presentation.getAudios().addAudio(audioData);
            firstEffect.setSound(effectSound);
            secondEffect.setStopPreviousSound(true);

            presentation.save("shape-animation-sound.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

提取嵌入的效果声音

下面的示例需要本地演示文稿presentation-with-animation-sounds.pptx。它扫描主序列和交互序列，并将每个嵌入的效果声音写入extracted-animation-sounds目录。文件扩展名根据IAudio.getContentType返回的音频 MIME 类型自动选择。

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Locale;

public class ExtractAnimationSounds {
    public static void main(String[] args) throws IOException {
        Path inputPath = Paths.get("presentation-with-animation-sounds.pptx");
        Path outputDirectory = Paths.get("extracted-animation-sounds");

        Files.createDirectories(outputDirectory);

        Presentation presentation = new Presentation(inputPath.toString());
        try {
            int soundIndex = 1;

            for (ISlide slide : presentation.getSlides()) {
                soundIndex = saveSounds(slide.getTimeline().getMainSequence(), outputDirectory, soundIndex);

                for (ISequence sequence : slide.getTimeline().getInteractiveSequences()) {
                    soundIndex = saveSounds(sequence, outputDirectory, soundIndex);
                }
            }

            System.out.println("Extracted " + (soundIndex - 1) + " sound file(s) to " + outputDirectory.toAbsolutePath() + ".");
        } finally {
            presentation.dispose();
        }
    }

    private static int saveSounds(ISequence sequence, Path outputDirectory, int soundIndex) throws IOException {
        for (IEffect effect : sequence) {
            if (effect.getSound() == null) {
                continue;
            }

            String extension = getAudioExtension(effect.getSound().getContentType());
            Path outputPath = outputDirectory.resolve("effect-sound-" + soundIndex + extension);
            Files.write(outputPath, effect.getSound().getBinaryData());
            soundIndex++;
        }

        return soundIndex;
    }

    private static String getAudioExtension(String contentType) {
        String normalizedType = contentType == null ? "" : contentType.toLowerCase(Locale.ROOT);

        if (normalizedType.equals("audio/mpeg")) {
            return ".mp3";
        }

        if (normalizedType.equals("audio/mp4")) {
            return ".m4a";
        }

        if (normalizedType.equals("audio/ogg")) {
            return ".ogg";
        }

        if (normalizedType.equals("audio/wav") || normalizedType.equals("audio/x-wav")) {
            return ".wav";
        }

        return ".bin";
    }
}

对于大型音频对象，请使用IAudio.getStream并将流复制到文件，而不是将整个对象加载到字节数组中。

设置动画后行为

After animation 选项控制形状在其效果完成后会发生什么。

PowerPoint 效果选项对话框显示 “After animation” 设置

AfterAnimationType 类支持保持形状不变、改变其颜色、在动画后隐藏或在下次点击时隐藏。当类型为AfterAnimationType.Color时，还需设置IEffect.getAfterAnimationColor。

此独立示例创建一个效果，通过返回的效果对象设置其动画后行为，并保存结果。

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

public class SetAfterAnimationBehavior {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            shape.addTextFrame("Dim after animation");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.setAfterAnimationType(AfterAnimationType.Color);
            effect.getAfterAnimationColor().setColor(Color.LIGHT_GRAY);

            presentation.save("shape-animation-after-effect.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

将类型从AfterAnimationType.Color改为其他值时，会清除动画后颜色设置。

动画文本

文本动画有两个相关控制：

ITextAnimation.getBuildType 控制段落是整体出现还是逐段出现。
IEffect.getAnimateTextType 控制文本是一次性出现、逐词出现还是逐字出现。IEffect.getDelayBetweenTextParts 设置词或字之间的延迟。正值表示效果持续时间的百分比，负值表示以秒为单位的延迟。

下面的独立示例为文本框中的单词添加动画。BuildType.AsOneObject 会关闭逐段构建，使词级设置应用于整个文本框。

import com.aspose.slides.*;

public class AnimateTextByWord {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 560, 100);
            textBox.addTextFrame("Aspose.Slides animates this sentence word by word.");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(textBox, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.getTextAnimation().setBuildType(BuildType.AsOneObject);
            effect.setAnimateTextType(AnimateTextType.ByWord);
            effect.setDelayBetweenTextParts(20.0f);

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

若要按段落构建文本框，请设置BuildType.ByLevelParagraphs1（或其他段落级别）。若要为单个段落单独指定效果，请使用接受IParagraph的ISequence.addEffect重载。有关段落级示例，请参阅Animated Text。

导出和兼容性说明

保存为 PPT 或 PPTX 会保留动画模型，但最终的播放由演示文稿查看器决定。
PDF 和静态图像不播放动画。需要显示运动时请使用HTML5 导出、动画 GIF 或视频转换。
对于 HTML5，启用Html5Options.setAnimateShapes；在需要时，还可启用Html5Options.setAnimateTransitions。
视频渲染支持多数常见的进入、强调、退出和运动路径效果，但并非所有 PowerPoint 效果都受支持。请查看当前受支持的动画和效果并在目标 Aspose.Slides 版本下对关键演示文稿进行测试。
高级自定义效果以及从其他演示文稿格式导入的效果可能会保存在文件中，但在 PowerPoint、HTML5 或视频中渲染方式不同。请验证导出结果，而不仅仅依赖效果名称。

常见问题

为什么动画在 PowerPoint 中可见，但在 PDF 中不可见？

PDF 是静态格式，动画和幻灯片切换不会播放。需要保留运动时请导出为 HTML5、动画 GIF 或视频。

为什么同一效果在视频中播放效果不同？

视频导出会渲染动画，而不是存储原始 PowerPoint 行为。某些高级效果不受支持或会被近似。请查阅受支持的效果表并在投产前对实际演示文稿进行测试。

移动形状的前置或后置会改变其动画顺序吗？

不会。形状的 Z 顺序控制叠放，序列顺序和触发器控制动画播放。如果需要不同的播放顺序，请修改时间轴。

获取 Java 中演示文稿的形状实际属性在 Java 中创建演示文稿形状的缩略图