在 .NET 中为演示文稿应用形状动画

本页内容简介

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

概述

要在效果内部处理各个行为或编辑运动路径段，请参阅自定义动画。

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

时间轴包含两类序列：

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

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

添加形状动画

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

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

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var targetShape = slide.Shapes.AddAutoShape(ShapeType.RoundCornerRectangle, 120, 100, 320, 80);
targetShape.TextFrame.Text = "Click to animate this shape";

var mainSequence = slide.Timeline.MainSequence;
var entranceEffect = mainSequence.AddEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
entranceEffect.Timing.Duration = 1.5f;

var triggerShape = slide.Shapes.AddAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
triggerShape.TextFrame.Text = "Move";

var interactiveSequence = slide.Timeline.InteractiveSequences.Add(triggerShape);
interactiveSequence.AddEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

presentation.Save("shape-animations.pptx", SaveFormat.Pptx);

触发器控制效果何时开始：

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

要为图片、图表或其他形状类型添加动画，请将该对象传递给ISequence.AddEffect 而不是 targetShape。有关图表特定的分组选项，请参阅动画图表。

读取形状动画

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

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

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var targetShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
targetShape.TextFrame.Text = "Animated shape";

var mainSequence = slide.Timeline.MainSequence;
mainSequence.AddEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

var triggerShape = slide.Shapes.AddAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
triggerShape.TextFrame.Text = "Move";

var interactiveSequence = slide.Timeline.InteractiveSequences.Add(triggerShape);
interactiveSequence.AddEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

var targetEffects = mainSequence.GetEffectsByShape(targetShape);
Console.WriteLine($"The main sequence contains {targetEffects.Length} effect(s) for {targetShape.Name}.");

PrintSequence("Main sequence", mainSequence);

var interactiveIndex = 1;
foreach (var sequence in slide.Timeline.InteractiveSequences)
{
    var triggerName = sequence.TriggerShape == null ? "unknown" : sequence.TriggerShape.Name;
    var sequenceLabel = $"Interactive sequence {interactiveIndex}, trigger: {triggerName}";
    PrintSequence(sequenceLabel, sequence);
    interactiveIndex++;
}

static void PrintSequence(string label, ISequence sequence)
{
    Console.WriteLine($"  {label}: {sequence.Count} effect(s)");

    foreach (var effect in sequence)
    {
        var targetName = effect.TargetShape == null ? "unknown" : effect.TargetShape.Name;
        var effectDescription = $"{effect.Type} {effect.Subtype}; target: {targetName}; trigger: {effect.Timing.TriggerType}";
        Console.WriteLine($"    {effectDescription}");
    }
}

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

处理继承的占位符效果

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

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

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

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

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

下一个示例自行构建占位符层级。它向母版占位符、版式占位符以及普通幻灯片上的对应占位符添加效果。在使用返回的形状之前，会检查每次调用IShape.GetBasePlaceholder 的结果。

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var layoutSlide = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);
var layoutPlaceholder = layoutSlide.PlaceholderManager.AddTextPlaceholder(100, 100, 400, 80);
layoutSlide.Timeline.MainSequence.AddEffect(layoutPlaceholder, EffectType.Split, EffectSubtype.VerticalIn, EffectTriggerType.OnClick);

var masterPlaceholder = layoutPlaceholder.GetBasePlaceholder();
if (masterPlaceholder != null)
{
    var masterSequence = layoutSlide.MasterSlide.Timeline.MainSequence;
    masterSequence.AddEffect(masterPlaceholder, EffectType.Fly, EffectSubtype.Bottom, EffectTriggerType.OnClick);
}

var slide = presentation.Slides.AddEmptySlide(layoutSlide);
var slidePlaceholder = FindPlaceholderWithBase(slide);

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

slide.Timeline.MainSequence.AddEffect(slidePlaceholder, EffectType.RandomBars, EffectSubtype.Horizontal, EffectTriggerType.OnClick);
PrintEffects("Normal slide", slide.Timeline.MainSequence.GetEffectsByShape(slidePlaceholder));

var baseLayoutPlaceholder = slidePlaceholder.GetBasePlaceholder();
if (baseLayoutPlaceholder != null)
{
    PrintEffects("Layout slide", layoutSlide.Timeline.MainSequence.GetEffectsByShape(baseLayoutPlaceholder));

    var baseMasterPlaceholder = baseLayoutPlaceholder.GetBasePlaceholder();
    if (baseMasterPlaceholder != null)
    {
        PrintEffects("Master slide", layoutSlide.MasterSlide.Timeline.MainSequence.GetEffectsByShape(baseMasterPlaceholder));
    }
}

presentation.Save("placeholder-animations.pptx", SaveFormat.Pptx);

static IShape FindPlaceholderWithBase(ISlide slide)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape.GetBasePlaceholder() != null)
        {
            return shape;
        }
    }

    return null;
}

static void PrintEffects(string source, IEffect[] effects)
{
    Console.WriteLine($"{source}: {effects.Length} effect(s)");

    foreach (var effect in effects)
    {
        Console.WriteLine($"  {effect.Type} {effect.Subtype}");
    }
}

更改动画时间设置

PowerPoint Timing 对话框对应ITiming 的属性。

动画效果的 PowerPoint Timing 对话框

Start 对应ITiming.TriggerType。
Duration 对应ITiming.Duration，单位为秒。
Delay 对应ITiming.TriggerDelayTime，单位为秒。
Repeat 对应ITiming.RepeatCount、ITiming.RepeatUntilNextClick 或ITiming.RepeatUntilEndSlide。
Rewind when done playing 对应ITiming.Rewind。

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

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
shape.TextFrame.Text = "Timed animation";

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Timing.TriggerType = EffectTriggerType.OnClick;
effect.Timing.Duration = 2.0f;
effect.Timing.TriggerDelayTime = 0.5f;
effect.Timing.RepeatUntilNextClick = false;
effect.Timing.RepeatUntilEndSlide = false;
effect.Timing.RepeatCount = 2.0f;
effect.Timing.Rewind = true;

presentation.Save("shape-animation-timing.pptx", SaveFormat.Pptx);

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

添加和提取动画声音

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

向效果添加声音

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

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var firstShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 80, 100, 240, 80);
var secondShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 400, 100, 240, 80);
firstShape.TextFrame.Text = "Starts sound";
secondShape.TextFrame.Text = "Stops sound";

var sequence = slide.Timeline.MainSequence;
var firstEffect = sequence.AddEffect(firstShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
var secondEffect = sequence.AddEffect(secondShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

var audioData = File.ReadAllBytes("animation-sound.wav");
var effectSound = presentation.Audios.AddAudio(audioData);
firstEffect.Sound = effectSound;
secondEffect.StopPreviousSound = true;

presentation.Save("shape-animation-sound.pptx", SaveFormat.Pptx);

提取嵌入的效果声音

下面的示例假设本地存在名为 presentation-with-animation-sounds.pptx 的演示文稿。它扫描主序列和交互序列，并将每个嵌入的效果声音写入 extracted-animation-sounds 目录。文件扩展名根据IAudio.ContentType 暴露的音频 MIME 类型选择。

using System;
using System.IO;
using Aspose.Slides;
using Aspose.Slides.Animation;

var inputPath = "presentation-with-animation-sounds.pptx";
var outputDirectory = "extracted-animation-sounds";

Directory.CreateDirectory(outputDirectory);

using var presentation = new Presentation(inputPath);
var soundIndex = 1;

foreach (var slide in presentation.Slides)
{
    SaveSounds(slide.Timeline.MainSequence, outputDirectory, ref soundIndex);

    foreach (var sequence in slide.Timeline.InteractiveSequences)
    {
        SaveSounds(sequence, outputDirectory, ref soundIndex);
    }
}

Console.WriteLine($"Extracted {soundIndex - 1} sound file(s) to {Path.GetFullPath(outputDirectory)}.");

static void SaveSounds(ISequence sequence, string outputDirectory, ref int soundIndex)
{
    foreach (var effect in sequence)
    {
        if (effect.Sound == null)
            continue;

        var extension = GetAudioExtension(effect.Sound.ContentType);
        var outputPath = Path.Combine(outputDirectory, $"effect-sound-{soundIndex}{extension}");
        File.WriteAllBytes(outputPath, effect.Sound.BinaryData);
        soundIndex++;
    }
}

static string GetAudioExtension(string contentType)
{
    var normalizedType = contentType == null ? string.Empty : contentType.ToLowerInvariant();

    if (normalizedType == "audio/mpeg")
        return ".mp3";

    if (normalizedType == "audio/mp4")
        return ".m4a";

    if (normalizedType == "audio/ogg")
        return ".ogg";

    if (normalizedType == "audio/wav" || normalizedType == "audio/x-wav")
        return ".wav";

    return ".bin";
}

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

设置动画结束后的行为

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

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

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

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

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
shape.TextFrame.Text = "Dim after animation";

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
effect.AfterAnimationType = AfterAnimationType.Color;
effect.AfterAnimationColor.Color = Color.LightGray;

presentation.Save("shape-animation-after-effect.pptx", SaveFormat.Pptx);

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

文本动画

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

ITextAnimation.BuildType 控制段落是一次性出现还是按段落层级出现。
IEffect.AnimateTextType 控制文本是一次性出现、按单词还是按字母出现。IEffect.DelayBetweenTextParts 设置单词或字母之间的延迟。正值表示效果时长的百分比，负值表示秒数延迟。

下面的独立示例为文本框中的单词添加动画。BuildType.AsOneObject 禁用按段落构建，使单词设置适用于整个文本框。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 80, 80, 560, 100);
textBox.TextFrame.Text = "Aspose.Slides animates this sentence word by word.";

var effect = slide.Timeline.MainSequence.AddEffect(textBox, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
effect.TextAnimation.BuildType = BuildType.AsOneObject;
effect.AnimateTextType = AnimateTextType.ByWord;
effect.DelayBetweenTextParts = 20.0f;

presentation.Save("animated-text.pptx", SaveFormat.Pptx);

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

导出和兼容性说明

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

常见问题

为什么动画在 PowerPoint 中显示，但在 PDF 中不显示？

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

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

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

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

不会。形状的 Z 顺序控制覆盖关系，序列顺序和触发器控制动画播放顺序。如需更改播放顺序，请修改时间轴。

从 .NET 演示文稿获取形状的有效属性在 .NET 中创建演示文稿形状的缩略图