在 Android 上管理演示文稿的幻灯片切换
概述
幻灯片切换控制幻灯片在放映过程中如何出现。使用 Aspose.Slides for Android via Java,您可以为每张幻灯片选择切换效果,配置通过鼠标点击或计时器推进,以及调整特定效果的选项。本文使用 Java 示例演示如何应用切换、设置确切的切换时长、管理幻灯片计时,并在两张幻灯片之间创建 Morph(变形)切换。示例还展示了如何将设置保存为 PPTX 文件。
添加幻灯片切换
要应用切换,请使用 Presentation 类加载演示文稿,并通过 getSlideShowTransition 访问幻灯片的切换设置。使用来自 TransitionType 枚举的值通过 setType 设置切换类型,然后保存演示文稿。
以下示例对第一张幻灯片应用 Circle(圆形)切换,对第二张幻灯片应用 Comb(梳形)切换。请使用至少包含两张幻灯片的 input.pptx 文件。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 2) {
presentation.getSlides().get_Item(0).getSlideShowTransition().setType(TransitionType.Circle);
presentation.getSlides().get_Item(1).getSlideShowTransition().setType(TransitionType.Comb);
presentation.save("slide-transitions.pptx", SaveFormat.Pptx);
} else {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
轮盘切换
IWheelTransition 的 setSpokes 方法控制揭示目标幻灯片的径向扇区数量。在访问 IWheelTransition 之前,先使用 setType 将幻灯片的切换类型设为来自 TransitionType 的 Wheel,然后通过 getValue 获取。
此示例创建两对相同的幻灯片:黑色幻灯片后跟一个带金色矩形的幻灯片。目标幻灯片的扇区计数分别为 1 和 8,速度通过 setSpeed 设置相同,并通过 setDuration 明确设为 8,000 毫秒,以便轻松观察差异。
import android.graphics.Color;
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
float slideWidth = (float) presentation.getSlideSize().getSize().getWidth();
float slideHeight = (float) presentation.getSlideSize().getSize().getHeight();
ISlide blackSlide = presentation.getSlides().get_Item(0);
blackSlide.getShapes().clear();
blackSlide.getBackground().setType(BackgroundType.OwnBackground);
blackSlide.getBackground().getFillFormat().setFillType(FillType.Solid);
blackSlide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
ISlide destinationSlide = presentation.getSlides().addClone(blackSlide);
IAutoShape rectangle = destinationSlide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, slideWidth, slideHeight);
rectangle.getFillFormat().setFillType(FillType.Solid);
int gold = Color.rgb(255, 215, 0);
rectangle.getFillFormat().getSolidFillColor().setColor(gold);
rectangle.getTextFrame().setText("Wheel transition");
presentation.getSlides().addClone(blackSlide);
presentation.getSlides().addClone(destinationSlide);
long[] spokeCounts = { 1, 8 };
for (int i = 0; i < spokeCounts.length; i++) {
ISlideShowTransition transition = presentation.getSlides().get_Item(i * 2 + 1).getSlideShowTransition();
transition.setType(TransitionType.Wheel);
IWheelTransition wheelTransition = (IWheelTransition) transition.getValue();
wheelTransition.setSpokes(spokeCounts[i]);
transition.setSpeed(TransitionSpeed.Slow);
transition.setDuration(8000);
}
presentation.save("wheel-transitions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
在 PowerPoint 中打开输出演示文稿并运行放映。从幻灯片 1 前进到幻灯片 2,然后从幻灯片 3 前进到幻灯片 4。在 PowerPoint 播放时,验证过的扇区计数 1 通过一次顺时针扫掠显示幻灯片;验证过的计数 8 则通过八个径向扇区同时显示。目标内容和切换时机相同,唯一的区别是揭示扇区的数量。
添加高级幻灯片切换
您可以配置幻灯片在屏幕上保持的时间以及是否通过鼠标点击推进放映。以下方法控制此行为:
- setAdvanceOnClick 允许观众通过点击鼠标前进。
- setAdvanceAfter 启用自动前进。
- setAdvanceAfterTime 指定自动前进前的延迟(毫秒)。
同时启用点击和计时前进,让观众可以点击继续或等待计时器。若仅使用计时器,请将 false 传递给 setAdvanceOnClick。延迟控制放映何时前进;它不设置视觉切换效果的持续时间。
此示例为前三张幻灯片分配不同的效果,并分别在 3、5、7 秒后启用自动前进。鼠标点击也可以前进这些幻灯片。请使用至少包含三张幻灯片的 input.pptx 文件。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 3) {
ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(TransitionType.Circle);
firstTransition.setAdvanceOnClick(true);
firstTransition.setAdvanceAfter(true);
firstTransition.setAdvanceAfterTime(3000);
ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(TransitionType.Comb);
secondTransition.setAdvanceOnClick(true);
secondTransition.setAdvanceAfter(true);
secondTransition.setAdvanceAfterTime(5000);
ISlideShowTransition thirdTransition = presentation.getSlides().get_Item(2).getSlideShowTransition();
thirdTransition.setType(TransitionType.Zoom);
thirdTransition.setAdvanceOnClick(true);
thirdTransition.setAdvanceAfter(true);
thirdTransition.setAdvanceAfterTime(7000);
presentation.save("advanced-transitions.pptx", SaveFormat.Pptx);
} else {
System.out.println("The input presentation must contain at least three slides.");
}
} finally {
presentation.dispose();
}
要检查是否启用了计时前进,请调用 getAdvanceAfter。仅存储的延迟并不表示计时器已激活。
下一个示例打开上述保存的文件,报告每个已启用的计时器,并对延迟大于两秒的幻灯片禁用自动前进。它为这些幻灯片启用鼠标点击并保存更新后的设置。
import com.aspose.slides.*;
Presentation presentation = new Presentation("advanced-transitions.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
if (transition.getAdvanceAfter()) {
System.out.println("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");
if (transition.getAdvanceAfterTime() > 2000) {
transition.setAdvanceAfter(false);
transition.setAdvanceOnClick(true);
}
}
}
presentation.save("adjusted-transitions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
精确控制切换时机
使用 setDuration 可在毫秒级指定切换效果的精确长度。幻灯片的 getSlideShowTransition 方法通过 ISlideShowTransition 曝露这些设置:
| 方法 | 目的 |
|---|---|
| setDuration | 设置切换效果本身的持续时间(毫秒)。 |
| setAdvanceAfterTime | 设置幻灯片自动前进前的延迟(毫秒)。将 true 传递给 setAdvanceAfter 可激活此计时器。 |
| setSpeed | 从 TransitionSpeed 中选择预定义的速度类别:Slow(慢)、Medium(中)或 Fast(快)。当未指定确切时长时使用。 |
setDuration 仅控制切换效果;它不决定幻灯片可见的时长。请单独配置自动前进延迟。当未设置显式时长时,Aspose.Slides 会根据切换类型和 getSpeed 的值确定效果时长。
共享示例为每张幻灯片设置 750 ms 的淡入淡出切换,并单独在 5,000 ms 后启用自动前进。切换时长控制效果;前进时机控制何时离开幻灯片。这些条形是示意设置,而非测量得到的合并时间轴。
为每张幻灯片应用相同的时长
为保持节奏一致,向每张幻灯片应用相同的效果和确切时长。此示例加载 input.pptx,从 TransitionType 中选择 Fade(淡入),并为每个切换设置 750 毫秒的时长。它单独在 5,000 毫秒后启用自动前进,并禁用鼠标点击前进,然后将结果保存为 PPTX。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
transition.setType(TransitionType.Fade);
transition.setDuration(750);
// 配置自动前进,独立于效果持续时间。
transition.setAdvanceAfter(true);
transition.setAdvanceAfterTime(5000);
transition.setAdvanceOnClick(false);
}
presentation.save("precise-transitions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
为各幻灯片设置不同的时长
不同幻灯片可以使用不同的效果时长。例如,对标题页使用短切换,对章节介绍使用更长的切换。此示例为第一张幻灯片设为 500 毫秒,为第二张设为 1,200 毫秒。请使用至少包含两张幻灯片的 input.pptx 文件。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 2) {
ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(TransitionType.Fade);
firstTransition.setDuration(500);
ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(TransitionType.Push);
secondTransition.setDuration(1200);
presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx);
} else {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
与动画输出协同切换
在准备 animated GIF、HTML5 演示 或 视频 时,请在导出前设置精确的切换时长,以匹配预期的节奏。例如,在场景之间使用 600 毫秒的淡入,并分别调整每张幻灯片的前进延迟,以便留出旁白或内容的时间。
对于 GIF 与视频,需要将输出帧率与效果时长对应:600 毫秒对应 30 fps 时的 18 帧。对于 HTML5,在导出设置中启用动画切换。检查所选导出格式支持的效果和时机选项,并预览输出以确认同步。
读取现有切换时长
在修改切换之前调用 getDuration 以确定是否存储了显式值。-1 表示未设置显式时长;非负值表示以毫秒为单位的存储时长。未设置的值并非计算得到的播放时长:Aspose.Slides 使用切换类型和 getSpeed 的值来确定该时长。设置切换类型可能会初始化时长,因此请先检查原始设置。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
int duration = transition.getDuration();
if (duration >= 0) {
System.out.println("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
} else {
System.out.println("Slide " + slide.getSlideNumber() + ": no explicit duration; timing depends on transition type " + transition.getType() + " and speed " + transition.getSpeed() + ".");
}
}
} finally {
presentation.dispose();
}
Morph(变形)切换
Morph(变形)切换在连续幻灯片之间为对象的变化添加动画。要创建简易的 Morph 效果,克隆一张幻灯片,在克隆上移动或调整对象大小,然后对第二张幻灯片应用 Morph 切换。这会让对应的对象在原始状态和修改后状态之间完成动画。
下面的示例创建一张带文本矩形的幻灯片,克隆该幻灯片,并在克隆上更改矩形的位置和大小。随后为第二张幻灯片从 TransitionType 枚举中选择 Morph。将保存的文件在支持 Morph 的演示文稿查看器中打开,即可在放映时看到效果。
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide firstSlide = presentation.getSlides().get_Item(0);
IAutoShape rectangle = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100);
rectangle.getTextFrame().setText("Morph transition");
ISlide secondSlide = presentation.getSlides().addClone(firstSlide);
IShape movedRectangle = secondSlide.getShapes().get_Item(0);
movedRectangle.setX(movedRectangle.getX() + 100);
movedRectangle.setY(movedRectangle.getY() + 50);
movedRectangle.setWidth(movedRectangle.getWidth() - 200);
movedRectangle.setHeight(movedRectangle.getHeight() - 10);
secondSlide.getSlideShowTransition().setType(TransitionType.Morph);
presentation.save("morph-transition.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Morph 切换类型
TransitionMorphType 枚举决定 Morph 如何匹配并动画化内容:
使用 setType 选择 Morph,然后访问 getValue 获取 IMorphTransition 接口,该接口的 setMorphType 方法用于选择匹配模式。
此示例打开前一节创建的演示文稿,并将第二张幻灯片配置为基于单词的 Morph 动画。
import com.aspose.slides.*;
Presentation presentation = new Presentation("morph-transition.pptx");
try {
if (presentation.getSlides().size() >= 2) {
ISlideShowTransition transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
transition.setType(TransitionType.Morph);
ITransitionValueBase transitionValue = transition.getValue();
if (transitionValue instanceof IMorphTransition) {
IMorphTransition morphTransition = (IMorphTransition) transitionValue;
morphTransition.setMorphType(TransitionMorphType.ByWord);
presentation.save("morph-by-word.pptx", SaveFormat.Pptx);
} else {
System.out.println("Morph transition options are unavailable.");
}
} else {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
设置切换效果
某些切换会公开额外选项,例如方向或是否从黑屏开始。可用选项取决于使用 setType 所选的切换。先设置类型,然后通过 getValue 获取相应的接口并使用。
下面的示例对 input.pptx 的第一张幻灯片应用 Cut(剪切)切换。它通过 IOptionalBlackTransition 调用 setFromBlack,使切换从黑屏开始。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
ISlideShowTransition transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
transition.setType(TransitionType.Cut);
ITransitionValueBase transitionValue = transition.getValue();
if (transitionValue instanceof IOptionalBlackTransition) {
IOptionalBlackTransition cutTransition = (IOptionalBlackTransition) transitionValue;
cutTransition.setFromBlack(true);
presentation.save("cut-from-black.pptx", SaveFormat.Pptx);
} else {
System.out.println("Cut transition options are unavailable.");
}
} finally {
presentation.dispose();
}
常见问题
我可以控制幻灯片切换的播放速度吗?
可以。当需要以毫秒为单位的精确效果时长时,请优先使用 setDuration。如果预定义的 TransitionSpeed(Slow、Medium、Fast)类别已足够且未设置显式时长,则使用 setSpeed。这些设置独立于自动前进延迟,单独控制切换效果。
我可以为切换附加音频并使其循环吗?
可以。使用 setSound 分配嵌入音频,将 TransitionSoundMode 枚举中的 StartSound 传递给 setSoundMode,并将 setSoundLoop 设置为 true。音频将在下一次幻灯片放映中的声音事件之前循环播放。
将相同切换应用于每张幻灯片的最快方法是什么?
遍历演示文稿的 getSlides 集合,对每张幻灯片的切换调用相同的 setType。在同一循环中设置所有计时和效果选项,以保持各幻灯片行为一致。
我如何检查幻灯片当前设置了哪种切换?
对幻灯片的 getSlideShowTransition 结果调用 getType。它返回来自 TransitionType 枚举的值;None 表示未应用任何切换效果。