# 启动动画设置
> 为作品录制一段多标记点的开场动画，让访问者进入时按设定顺序平滑移动视角，营造沉浸式开场效果。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「视角设置」中打开启动动画设置。面板分为「我的动画」和「系统推荐」两个标签：在「我的动画」中完成录制并保存自己的动画；在「系统推荐」中可一键使用其他用户投稿并被收录的动画。录制与调整完成后点击「保存配置」，重新发布作品后访问者才会看到启动动画。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 录制并编辑由多个标记点组成的启动动画
- 为每个标记点设置持续时长、延迟、水平角、垂直角与视野
- 设置动画结束后是否回到初始视角
- 在「系统推荐」中一键使用他人投稿的动画
- 把满意的动画投稿到系统推荐列表

## 3. 业务说明

### 配置区域

面板顶部为「我的动画」「系统推荐」标签，下方为说明条「启动动画可以让您的全景作品更具视觉冲击力，支持多个标记点的平滑过渡，让访客获得更好的沉浸式体验！」。「我的动画」包含动画列表（每个标记点一张卡片）、动画配置选项与操作按钮；「系统推荐」为推荐动画列表。底部为「关闭页面」「修改动画/录制动画」「保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 标记点 | 动画中的一个关键帧，记录该位置的视角参数 | 列表项，按顺序执行 | 至少录制一个标记点 |
| 类型 | 当前标记点使用的视角类型 | 只读展示 | 随录制时的视角 |
| 持续 | 动画移动到该标记点所用的时间 | 数值，单位秒 | 默认 3 秒 |
| 延迟 | 到达该标记点前等待的时间 | 数值，单位秒 | 默认 1 秒 |
| 水平角 | 该标记点的水平朝向角度 | 数值 | 随录制时视角 |
| 垂直角 | 该标记点的垂直朝向角度 | 数值 | 随录制时视角 |
| 视野 | 该标记点的视野范围 | 数值 | 随录制时视角 |
| 动画执行的持续时间(s) | 调整当前标记点的持续时间 | 滑块，1 到 9 秒 | 默认 3 秒 |
| 动画上下执行延迟(s) | 调整当前标记点的延迟时间 | 滑块，1 到 9 秒 | 默认 1 秒 |
| 回到初始视角 | 动画结束后是否回到初始视角；关闭则设定的初始视角将失效，开启则动画执行结束后回到初始视角 | 开关 | 默认开启 |
| 小行星开场 | 是否以小行星视角开场（当前不可用） | 开关，置灰不可操作 | 默认关闭（暂不开启） |
| 设置标记 | 在预览中新增一个标记点 | 按钮，录制状态下可用 | — |
| 切换视角 | 在正常视角、鱼眼视角、立体视角、小行星视角之间切换 | 按钮，弹出选项 | 默认正常视角 |
| 保存录制 | 结束本次录制并保留已录制的标记点 | 按钮 | — |
| 预览 | 预览当前动画效果 | 按钮 | — |
| 删除 | 删除当前标记点 | 按钮，修改状态下可用 | — |
| 投稿动画 | 把当前动画投稿到系统推荐列表（审核通过后他人可使用） | 按钮 | 动画过简单时不允许投稿 |
| 使用 | 在「系统推荐」中一键套用推荐动画 | 按钮 | — |

### 保存与生效

点击「保存配置」后动画写入作品配置，提示保存成功；重新发布作品后，访问者进入时才会按动画播放。删除全部标记点后保存，会清空作品原有的启动动画。投稿需先通过审核才会出现在系统推荐列表。

## 4. 使用说明

1. 在编辑器左侧点击「视角设置」，打开启动动画设置
2. 点击「录制动画」进入录制状态，用「设置标记」逐个添加标记点，或先在预览区调好视角再添加
3. 用「切换视角」选择需要的视角类型，按需调整每个标记点的持续时间与延迟
4. 按需设置「回到初始视角」开关
5. 点击「保存录制」结束录制，可先「预览」确认效果
6. 如需投稿，点击「投稿动画」并填写标题提交审核
7. 点击「保存配置」，再回到编辑器发布入口重新发布作品

## 5. 规则与限制

- 小行星开场当前置灰不可用
- 标记点过少（过于简单）时不允许投稿
- 关闭「回到初始视角」后，单独设置的初始视角在动画结束后将失效
- 删除全部标记点后保存会清空原有启动动画

## 6. 状态与异常

- 未录制时列表为空，显示「暂无动画配置」
- 系统推荐为空时显示「暂无推荐动画」
- 录制/修改状态下才显示「设置标记」「切换视角」「保存录制」等浮动按钮
- 预览失败：提示「预览失败,暂无动作」，需先新增动画动作
- 投稿时未填写标题：提示「请输入标题后再试」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [视角设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/view.md)
- [初始视角设置](https://9kvr.cn/site/tour/editor/config/view/eyes.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验
