169 lines
2.7 KiB
Markdown
169 lines
2.7 KiB
Markdown
# 动画接入规格模板
|
||
> 文档版本：v1.0
|
||
> 最后更新：2026-04-02
|
||
|
||
|
||
## 1. 用途
|
||
|
||
这份模板用于：
|
||
|
||
- 设计公司交付动画时填写
|
||
- 开发接入前确认规格
|
||
- 作为动画实现与验收依据
|
||
|
||
建议：一个动画一条记录。
|
||
|
||
---
|
||
|
||
## 2. 基础信息模板
|
||
|
||
```md
|
||
动画 ID：
|
||
动画名称：
|
||
所属页面/模块：
|
||
所属层级：地图空间 / HUD / UI反馈 / 过场
|
||
优先级：高 / 中 / 低
|
||
|
||
触发事件：
|
||
触发条件：
|
||
是否高频：
|
||
|
||
作用对象：
|
||
起始状态：
|
||
结束状态：
|
||
|
||
动画形式：程序动画 / Lottie / 序列帧 / 视频 / 其他
|
||
资源文件：
|
||
|
||
时长：
|
||
延迟：
|
||
缓动：
|
||
是否循环：
|
||
是否可中断：
|
||
重复触发策略：覆盖 / 忽略 / 重启 / 排队
|
||
|
||
standard 表现：
|
||
lite 表现：
|
||
是否允许关闭：
|
||
|
||
设计说明：
|
||
开发备注：
|
||
验收标准：
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 字段说明
|
||
|
||
### 动画 ID
|
||
|
||
要求：
|
||
|
||
- 全局唯一
|
||
- 使用英文或稳定标识
|
||
|
||
例如：
|
||
|
||
- `control_complete_flash`
|
||
- `target_ready_pulse`
|
||
- `session_intro_banner`
|
||
|
||
### 所属层级
|
||
|
||
建议四选一：
|
||
|
||
- 地图空间
|
||
- HUD
|
||
- UI反馈
|
||
- 过场
|
||
|
||
### 触发事件
|
||
|
||
必须明确写出触发它的事件。
|
||
|
||
例如：
|
||
|
||
- `control_completed:control`
|
||
- `control_skipped`
|
||
- `session_started`
|
||
- `heart_rate_zone_changed:red`
|
||
|
||
### 重复触发策略
|
||
|
||
必须提前约定：
|
||
|
||
- `覆盖`
|
||
- `忽略`
|
||
- `重启`
|
||
- `排队`
|
||
|
||
否则高频触发时容易行为不一致。
|
||
|
||
### standard / lite
|
||
|
||
每个动画都必须给出两档建议。
|
||
|
||
例如：
|
||
|
||
- `standard`：完整 pulse + 外环
|
||
- `lite`：保留单层 pulse，去掉外环
|
||
|
||
---
|
||
|
||
## 4. 推荐填写示例
|
||
|
||
```md
|
||
动画 ID：control_complete_flash
|
||
动画名称：打点成功轻闪光
|
||
所属页面/模块：地图页
|
||
所属层级：UI反馈
|
||
优先级：高
|
||
|
||
触发事件：control_completed:control
|
||
触发条件：普通检查点打点成功
|
||
是否高频：是
|
||
|
||
作用对象：地图主舞台
|
||
起始状态：正常地图状态
|
||
结束状态：恢复正常地图状态
|
||
|
||
动画形式：程序动画
|
||
资源文件：无
|
||
|
||
时长：320ms
|
||
延迟：0ms
|
||
缓动：ease-out
|
||
是否循环：否
|
||
是否可中断：是
|
||
重复触发策略：重启
|
||
|
||
standard 表现：淡白色局部 flash，透明度较明显
|
||
lite 表现：透明度降低 50%，时长缩短到 220ms
|
||
是否允许关闭：是
|
||
|
||
设计说明：突出“完成打点”的即时成功感
|
||
开发备注：通过 UiEffectDirector 下发 stageFx
|
||
验收标准：普通打点时稳定触发，连续打点不拖尾
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 对设计公司的要求
|
||
|
||
建议以后明确告诉设计公司：
|
||
|
||
- 不只要演示稿
|
||
- 必须提供参数规格
|
||
- 必须提供资源清单
|
||
- 必须说明低配降级方案
|
||
|
||
---
|
||
|
||
## 6. 结论
|
||
|
||
这份模板的目的是把动画从“视觉稿”变成“工程规格”。
|
||
只有规格明确，程序才能稳定接入。
|
||
|
||
|
||
|