动画配置
OrionBase平台支持配置豹小秘、豹花瓶、豹大屏的脸部动画。您可以使用自己设计的图片或动画资源对豹小秘的脸部动画进行个性化配置，配置项目包括资源、动画大小、动作、播放长度等等，满足您不同的使用场景需求。
Step 1 上传资源
点击“上传资源”可上传Action配置中使用的资源
资源目前只支持上传PNG，Particle，ZIP格式文件。注：ZIP文件即为Spine文件打成ZIP包上传。ZIP包中必须含有以下基础配置文件：skel文件，atlas文件，json文件，png文件。
资源命名格式必须为英文字母、下划线和数字，上传后自动读取文件名。
同时支持先上传文件，后修改文件名。修改后，此资源即以修改后的名称为准。
SVG格式文件暂不支持上传，可使用默认SVG文件进行配置。
Step2 创建动画项目
首次进入请先点击创建动画 ，创建一个新的动画文件，并为他命名及填写备注。动画名称限制在30个字以内。动画描述限制在100个字以内。点击“确定”动画即创建完成。
Step 3 配置Action
动画创建成功后，请点击编辑进入Task列表页。在此页您可以自由创建并编辑Task。点击创建Task，即可为Task命名并填写备注，创建一个Task。Task名称只支持英文字母、数字、小数点及下划线，首位必须是字母。
Task创建成功后，点击编辑进入Action配置页。此时就可以添加并配置Action了。进入Action配置页，首先此页面有一个默认的基础配置。此配置针对此Task下的所有Action生效。注：基础配置本身不是动画，需要在Task下创建并配置至少一个Action才能预览。
动画配置案例：小豹初始状态为初始状态，在第1秒出现皇冠，在1.8秒向右上方看岛皇冠。在第3.7秒出现红脸蛋，并且眼睛变为闪光动画。
实现案例所需配置Action：
| Action | 配置项目 | 配置内容 |
|---|---|---|
| 基础配置 | 循环配置 | 是否循环：是循环起始：1-FaceAction |
| 眨眼动作配置 | 眨眼动作：开启时间段：500 - 1000ms时间序列：【100,200,500,600】【1000,1200,2000,2200】 | |
| 眼睛动效 | 动一动：开启四处看：关闭 | |
| FaceAction（初始的表情） | 出现时机 | 延迟时间：0ms |
| 动画效果 | 过度动画：开启 | |
| 表情配置 | 表情选择：初始化 | |
| ShapeSpeedAction（调整眼睛形变，包括眨眼等动作的性变速率） | 出现时机 | 延迟时间：0 |
| 表情配置 | 表情部位：眼部配置类型：眼睛形状形变速率：0.5 | |
| EyeTargetAction（眼睛移动到右上方） | 出现时机 | 延迟时间：1800 |
| 眼球动画 | 左右移动：0.6上下移动：0.8 | |
| SpineAction（小皇冠动画） | 出现时机 | 延迟时间：1000ms |
| 资源选择 | Spine文件：default.zip | |
| 动画组配置 | 动画速率：1缩放比例：1动画x轴：0动画y轴：800 | |
| Animation【注意animation顺序，animation为顺序播放，前一个播放完成后面一个才会开始播放。每组必须有start,loop,end】 | crown_start:延迟时间：1000 是否循环：否 最长循环：crown_loop:延迟时间：1000 是否循环：是 最长循环：6000crown_end:延迟时间：0 是否循环：否 | |
| ImageAction（左边红脸蛋效果） | 出现时机 | 延迟时间：3700 |
| 资源选择 | 选择图片：img_shy.png | |
| 图片位置 | 图片x轴：350图片y轴：-250 | |
| 图片大小 | 图片宽度：300图片高度：300 | |
| 动画效果 | 渐变动画：Alpha | |
| ImageAction（右边红脸蛋效果） | 出现时机 | 延迟时间：3700 |
| 资源选择 | 选择图片：img_shy.png | |
| 图片位置 | 图片x轴：-350图片y轴：-250 | |
| 图片大小 | 图片宽度：300图片高度：300 | |
| 动画效果 | 渐变动画：Alpha | |
| EyeFlashAction（萌萌的眼球闪光效果） | 出现时机 | 延迟时间：3700 |
| 动画效果 | 眼睛闪光：开启 | |
| ResumeEyeTargetAction（与EyeTargetAction联动，将眼球恢复到中间位置） | 出现时机 | 延迟时间：3700 |
所有Action配置列表：
| 配置类型 | 配置内容 | 配置项 | 配置效果 |
|---|---|---|---|
| 通用配置项 | 通用配置 | 延迟时间 | 此Action的延迟播放时间，以毫秒（ms）为单位。如将FaceAction的延迟时间设置为2000ms，则此Action会从开始播放此Task开始计时，到第2000ms时开始播放。 |
| 过渡动画 | 此Action在播放过程中是否有过渡。如从睁眼到闭眼的这个动作中，若过渡动画配置为开启，则从睁眼到闭眼的过程中有一个眼部形变的过渡。若此配置为关闭，则可理解为从睁眼状态直接变为闭眼状态，中间无形变的过渡。 | ||
| 缩放比例 | 只支持填写正数，为选定表情部位的缩小或者放大倍数 | ||
| 图片位置 | 配置图片在机器人脸部的位置，以像素为单位。中间点坐标为（0,0）右上为正数，左下为负数。 | ||
| 基础配置（基础配置在每一次循环中所有的Action播放完成后播放。） | 是否循环 | 是：此Task循环播放；选择循环起始：配置此Task从哪一个Action开始循环。用户可拖动Action改变排列顺序。否：此Task只播放一次即停止。注：特殊情况：若当前task下的所有Action延迟时间均为0，且未配置IdleAction（即给整个Task预留的播放时间为0，此时不支持使用基础配置中的循环。需至少配置一个IdleAction，保证此Task下的所有Action能完整播放完成，才可使用基础配置中的循环功能） | |
| 眨眼动作配置 | 眨眼动作若关闭，则对应的AutoBlinkAction也不会生效；眨眼动作开启，AutoBlinkAction才会生效；若开启，需要配置眨眼时间段和眨眼时间序列。眨眼时间段：第二项必须大于第一项。配置后，会在眨眼时间段内随机取值，加在眨眼时间序列上，作为最终的眨眼时间点。眨眼时间序列：每个序列中的数值个数必须为偶数。序列中奇数位为闭眼时间点，偶数位为睁眼时间点。睁眼时间点与闭眼时间点以逗号隔开。例：眨眼时间段：200ms-3000ms眨眼时间序列：[200,300,400,500] [100,200]此序列中，若在一次循环内从眨眼时间段中随机取的值为500ms，随机取的序列为第一个序列，则第一次闭眼在200ms+500ms，第一次睁眼在300ms+500ms。第二次闭眼在400ms+500ms，第二次睁眼在500ms+500ms处。以此类推 | ||
| 动一动 | 眼睛微动效果。若开启，则按顺序执行。执行完眨眼动作之后立即执行 | ||
| 四处看 | 眼球大幅度四处查看效果。若开启，则按顺序执行。执行完动一动效果之后立即执行 | ||
| FaceAction | 配置脸部表情 | 表情选择 | 可选8个默认表情，只支持针对这个表情做 |
| ImageAction | 配置图片资源位置及大小 | 资源选择 | 只支持选择PNG格式图片资源。可自行上传PNG格式图片并选择 |
| 图片位置 | 配置图片在机器人脸部的位置，以像素为单位。中间点坐标为（0,0）右上为正数，左下为负数。 | ||
| 图片大小 | 配置已选图片的大小，已像素为单位 | ||
| 渐变动画 | 开启后图片有淡入淡出效果 | ||
| ShapeAction | 配置表情的形变（表情的情绪表达） | 表情部位 | 选择此Action对应的表情部位，目前只支持选择：眼部（双眼）、左眼、右眼、嘴部 |
| 表情动画 | 选择此Action所要使用的动画。目前只支持选择svg格式资源，且svg资源不支持自行上传。只能使用默认资源。如有使用新资源需求，请联系OrionBase方，在充分测试svg资源可正常运行后方可上传。 | ||
| ShapeSpeedAction注：此Action与ShapeAction绑定，若未配置ShapeAction，则此Action失效 | 配置动画表情的形变或位移速度 | 表情部位 | 选择此Action对应的表情部位，目前支持选择11个表情部位 |
| 配置类型 | 可选择眼睛形状或眼睛位移 | ||
| 速率 | 若配置类型为眼睛形状，则此处配置的就是眼睛形变的速度。若配置类型为眼睛位置，则此处配置的就是眼睛位移的速度。速率只支持填写0~1之间的数值，数值越小，形变或移动速度越慢 | ||
| ShapeScaleAction注：此Action与ShapeAction绑定，若未配置ShapeAction，则此Action失效 | 配置动画表情部位的缩放比例 | 表情部位 | 支持选择11个表情部位 |
| 缩放比例 | 只支持填写正数，为选定表情部位的缩小或者放大倍数 | ||
| ShapeRotationAction | 配置动画表情（整个脸部）的旋转角度 | 旋转角度 | 支持配置x、y、z轴的旋转角度。角度支持范围为-90~90度。配置后脸部即按照配置角度旋转。 |
| ParticleAction | 配置particle格式动画效果 | 资源选择 | 选择particle动画资源（可自行上传） |
| 重复执行 | 若开启重复执行，则此动画在整个Task执行结束前会一直重复播放。参考示例：撒花 | ||
| EyeFlashAction | 配置眼睛闪光动画效果 | 眼睛闪光 | 开启后眼睛出现闪光的动效，类似卖萌 |
| IdleAction | 设置第一个Task播放与第二个Task之间的间隔 | 延迟时间 | 整个Task动画播放完成之后，如需要与下一个Task之间有一段时间间隔，则可将此Task的延迟时间延长。如：整个动画效果5000ms播放完成，但是需要与下一个动画之间隔2000ms，则可将此IdleAction的延迟时间设置为7000ms |
| SpeakAction | 配置说话时嘴巴动的速度 | 说话模式 | 开启后可配置说话速率 |
| 说话速率 | 可配置嘴巴形变的速度，只能配置正整数，数值越小形变速度越快，数值越大形变速度越慢 | ||
| AutoBlinkAction | 配置眨眼动画 | 眨眼动画 | 若需要眨眼动画生效，需在基础配置中将“眨眼动作”开启，并配置时间段和时间序列。 |
| EyeTargetAction | 配置眼睛四处看的幅度 | 左右移动 | 控制眼球左右移动的幅度，只能填写-1~1之间的值。中间点为0，最左边为-1，最右边为1。 |
| 上下移动 | 控制眼球上下移动的幅度，只能填写-1~1之间的值。中间点为0，最下边为-1，最上边为1。 | ||
| ResumeEyeTargetAction | 恢复眼睛原始动画设置 | 延迟时间 | 配置延迟时间后，在设定时间恢复眼睛原始动画 |
| EyeCloseAction | 设置合眼动画 | 合眼动画 | 开启后，在设定的延迟时间合上眼睛 |
| SpineAction | 配置Spine动画 | 动画ID | 同个Task内，根据添加时间顺序从0开始分配。目前一个task内只支持添加一个SpineAction。 |
| Spine文件 | 选择Spine文件后，若文件内容完整（注：Spine文件内必须包含skel文件，atlas文件，json文件以及一个png文件），则路径及是否是json字段自动填写，无需用户手动填写。若选择后此处未填写，请检查Spine文件内容是否完整，格式是否正确 | ||
| Animation | 若animation中的start,loop,end文件打包在同一个animation中，则只需配置此animation的延迟时间、是否循环和最长循环。拖animation中的start,loop,end文件为分开打包，那么在添加animation的时候必须同时添加start,loop,end，缺一不可。若没有start，动画不会开始，若取消end，动画不会结束。另外，是否循环和最长循环只对loop起效。animation的延迟时间含义与Action不同，animation是按照顺序播放的，即播放完第一个才会继续播放下一个。例：设置一个start，延迟时间为0，一个loop，延迟时间为0，最长循环时间为4000ms，一个end，延迟时间为2000ms。则此SpineAction播放的完成时间为4000+2000。 | ||
| VisibleAction | 设置动画部位是否可见 | 表情部位 | 可选择表情部位，共11个部位可选 |
| 是否可见 | 选择否之后，选中的表情部位即在设定时间不可见 |
Step 4 预览Task
在配置完Action后，可预览一个Task内的所有Action
首先安装一个apk，下载地址：https://drive.google.com/file/d/1to6xCQFkEA7B9Sguo4PjqLlA4PluPidH/view?usp=sharing
在手机上打开APK，在屏幕下发找到4~6位预览码
在Action配置页面，将预览码填入预览框后点击预览。若平台弹出“预览成功”弹窗，且APP界面弹出“Task更新成功”提示，则此Task即开始播放。
