效果动作参考
所有可用的效果动作类型及参数详解
效果动作是事件触发后执行的具体操作。每个效果指定一个目标组件（或标签），并对其执行特定的操作。一个事件可以包含多个效果，按顺序依次执行。
本页列出所有可用的效果动作类型及其参数。
显示 / 隐藏
控制组件的可见性。
- 显示：将隐藏的组件设为可见
- 隐藏：将可见的组件设为隐藏
| 参数 | 说明 |
|---|---|
| 目标组件 | 要控制的组件或标签 |
典型用途：切换元素的显示状态、实现弹窗的打开关闭、控制提示信息的显示时机。
播放 / 暂停
控制媒体和动画组件的播放状态。
- 播放：开始播放视频、音频或关键帧动画组件
- 暂停：暂停正在播放的组件
| 参数 | 说明 |
|---|---|
| 目标组件 | 要控制的视频/音频/序列帧组件（支持标签） |
| 音量 | 播放音量，范围 0 - 100 |
| 重复模式 | 循环播放 或 播放指定次数 |
动画效果
创建补间动画，为组件添加丰富的运动效果。共支持 10 种动画类型。
动画类型一览
| 动画类型 | 说明 | 可配参数 |
|---|---|---|
| 透明动画 | 渐入渐出效果 | 目标透明度、时长、缓动 |
| 相对位移 | 相对当前位置移动 | X/Y 偏移量、时长、缓动 |
| 绝对位移 | 移动到指定坐标 | 目标 X/Y、时长、缓动 |
| 旋转动画 | 旋转到指定角度 | 目标角度、时长、缓动 |
| 缩放动画 | 放大或缩小 | 目标缩放值、时长、缓动 |
| 心跳效果 | 有节奏的脉动 | 强度、时长、缓动 |
| 抖动效果 | 振动/摇晃 | 幅度、时长 |
| 水平果冻 | 水平方向弹性变形 | 幅度、时长 |
| 垂直果冻 | 垂直方向弹性变形 | 幅度、时长 |
| 路径动画 | 沿自定义路径移动 | 路径点、时长、缓动 |
通用参数
所有动画类型均支持以下通用参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
| 时长 | 动画持续时间（毫秒） | — |
| 缓动函数 | 动画速度曲线（线性、缓入、缓出、缓入缓出等） | 线性 |
| 循环 | 循环次数，0 或 false 表示不循环 | 不循环 |
| 方向 | 正向、反向、交替 | 正向 |
缓动函数说明
- 线性 — 匀速运动，无加速减速
- 缓入 — 从慢到快，适合元素进入
- 缓出 — 从快到慢，适合元素停止
- 缓入缓出 — 先加速后减速，最自然的运动曲线
路径动画不支持标签目标，只能针对单个组件使用。其他 9 种动画类型均支持标签。
播放序列帧
控制序列帧（关键帧）动画的播放。
| 参数 | 说明 |
|---|---|
| 目标组件 | 序列帧组件（支持标签） |
| 重复模式 | 循环播放 或 播放指定次数 |
| 结束效果 | 播放结束后执行的效果列表 |
结束效果允许您在序列帧播放完毕后自动触发后续操作，例如隐藏组件、播放音效或跳转页面。
播放 Spine 动画
播放 Spine 骨骼动画中的指定动画片段。
| 参数 | 说明 |
|---|---|
| 目标组件 | Spine 组件（支持标签） |
| 动画名称 | 从 Spine 文件中选择的动画片段名称 |
| 重复模式 | 循环播放 或 播放指定次数 |
| 结束效果 | 播放结束后执行的效果列表 |
动画名称列表由 Spine 文件自动提供。如果下拉列表为空，请检查 Spine 资源是否正确导入。
更新属性
在运行时修改组件的任意可变属性。这是最强大、最灵活的效果类型。
| 参数 | 说明 |
|---|---|
| 目标组件 | 要修改属性的组件（支持标签） |
| 属性名 | 要修改的属性 |
| 运算符 | = 赋值、+= 加、-= 减、*= 乘、/= 除 |
| 目标值 | 新的属性值，支持常量、组件属性引用、变量引用 |
可修改的属性
| 属性 | 说明 |
|---|---|
| alpha | 透明度（0 - 1） |
| x | X 坐标 |
| y | Y 坐标 |
| rotation | 旋转角度 |
| scaleX | 水平缩放 |
| scaleY | 垂直缩放 |
| skewX | 水平倾斜 |
| skewY | 垂直倾斜 |
| visible | 可见性（true/false） |
| width | 宽度 |
| height | 高度 |
表达式支持
目标值不仅支持常量，还支持引用其他组件的属性和全局变量。例如：
- 将组件 A 的 x 坐标赋值为组件 B 的 x 坐标
- 将文本组件的显示内容设为变量"score"的值
- 使用
+=运算符实现累加效果
更新变量
修改全局变量的值。配合变量事件触发器可实现计分、计数等动态逻辑。
| 参数 | 说明 |
|---|---|
| 目标变量 | 要修改的全局变量 |
| 运算符 | = 赋值、+= 加、-= 减、*= 乘、/= 除 |
| 新值 | 常量值、其他变量引用、组件属性引用 |
详细的变量用法请参阅 全局变量。
更新锚点
通过锚点系统重新定位组件。锚点提供 9 个预设位置，可快速将组件对齐到画布的指定区域。
| 参数 | 说明 |
|---|---|
| 目标组件 | 要重新定位的组件 |
| 锚点位置 | 9 个预设位置（左上、上中、右上、左中、居中、右中、左下、下中、右下） |
| 边距 | 距离锚点的偏移量 |
更新锚点不支持标签目标，只能针对单个组件使用。
延时
在效果序列中插入等待时间。延时本身不执行任何操作，仅控制后续效果的执行时机。
| 参数 | 说明 |
|---|---|
| 延时时长 | 等待时间（毫秒） |
常用预设值：100ms、500ms、1s、2s、3s。
使用延时可以创建分步动画序列。例如：效果 1（淡入标题）→ 延时 500ms → 效果 2（淡入内容）→ 延时 300ms → 效果 3（淡入按钮），实现依次出现的入场效果。
克隆
在运行时复制一个已有组件，生成一个新的副本。
| 参数 | 说明 |
|---|---|
| 模板组件 | 要复制的源组件（支持标签） |
| 定位模式 | 绝对定位 或 相对定位 |
| 位置 | X/Y 坐标（绝对坐标或相对偏移量） |
| 属性覆盖 | 可修改克隆体的初始属性（透明度、缩放等） |
克隆体是独立的组件实例，拥有自己的状态。克隆后可以通过标签或 __self 引用来控制。
生成组件
从组件模板创建一个全新的组件实例。与克隆不同，生成组件基于预定义的模板，而非舞台上已有的组件。
| 参数 | 说明 |
|---|---|
| 模板 | 要实例化的组件模板 |
| 定位模式 | 绝对定位 或 相对定位 |
| 位置 | X/Y 坐标 |
| 初始属性 | 设置生成实例的初始属性值 |
| 标签 | 为生成的实例分配标签 |
适用于动态创建游戏元素（敌人、子弹、特效）、弹窗、动态内容等场景。生成的实例如果分配了标签，会自动参与该标签相关的所有事件。
销毁
从舞台上永久移除一个组件。
| 参数 | 说明 |
|---|---|
| 目标组件 | 要移除的组件或标签 |
销毁操作不可逆。被销毁的组件无法通过事件恢复，只能通过克隆或生成组件重新创建。请谨慎使用。
销毁组件实例
移除一个通过"生成组件"创建的组件模板实例。
| 参数 | 说明 |
|---|---|
| 组件实例 | 要移除的组件实例 |
此效果不支持标签目标，只能针对单个组件实例使用。
跳转商店
打开应用商店链接，引导用户下载应用。
| 参数 | 说明 |
|---|---|
| iOS 链接 | App Store 下载地址 |
| Android 链接 | Google Play 下载地址 |
系统会自动检测用户设备类型，打开对应平台的商店链接。支持完整的 URL 格式和平台特定的 scheme 格式。
跳转页面
导航到作品中的其他页面。
| 参数 | 说明 |
|---|---|
| 目标页面 | 上一页 / 下一页 / 指定页面编号 |
| 过渡效果 | 无 或 淡入淡出 |
跳转页面是创建多页互动作品的基础操作。配合延时效果，可以实现自动翻页功能。
手指跟随
控制组件是否跟随用户的触摸/鼠标指针移动。
- 启用手指跟随：组件开始跟随指针移动
- 禁用手指跟随：组件停止跟随并保持在当前位置
| 参数 | 说明 |
|---|---|
| 目标组件 | 要控制的组件（支持标签） |
| 操作 | 启用 或 禁用 |
支持手指跟随的组件类型
| 组件类型 | 支持 |
|---|---|
| 图片 | 支持 |
| 序列帧 | 支持 |
| 组件实例 | 支持 |
| 容器 | 支持 |
| Spine | 支持 |
| 文本 | 支持 |
适用于拖拽交互、跟手元素、手指画效果等场景。
效果执行顺序
一个事件中的多个效果按照添加顺序从上到下依次执行。您可以通过拖拽调整效果的顺序。
需要注意的特殊情况：
- 延时效果会暂停执行队列，等待指定时间后再继续执行后续效果
- 动画效果是异步执行的，不会阻塞后续效果 — 即动画开始后立即执行下一个效果
- 如需等待动画完成后再执行操作，请在播放序列帧或播放 Spine 中使用"结束效果"功能
这个页面有帮助吗？