热点编辑器
热点编辑器的独立承载页:按热点类型动态加载对应的编辑面板,负责放置热点、填写内容与保存,是编辑器里所有热点能力的共用外壳。
1. 页面信息
- 网页地址:https://9kvr.cn/tour/editor/develop
- 所属模块:全景编辑器
- 页面用途:在编辑器里点击「热点设置」并选择一种热点后,热点面板就由本页承载:页面按热点类型动态加载对应的表单,先在预览画面上点击放置位置,再在表单中填写热点内容并保存。直接打开本页时默认加载场景跳转类型的面板;加载失败时页面提供重试与关闭两个操作。
- 适用用户:需要为全景场景添加交互热点的用户
- 访问条件:公开访问(实际使用需由编辑器打开热点面板并带入作品与场景上下文)
2. 功能说明
- 按热点类型动态加载对应的热点编辑面板,类型由外部传入
- 加载态与加载失败态都有专门提示,失败时提供「重试」与「关闭」
- 面板与编辑器共享场景列表与已保存的热点数据,切换场景时上下文同步
- 多步骤表单结构,可「返回上一步」,主按钮在「保存编辑」与「关闭编辑」之间切换
- 编辑态关闭且有未保存改动时,先弹窗确认,确认后回滚未保存内容
- 支持热点分组、热点复制等批量操作,并把结果回传给编辑器
3. 业务说明
热点编辑器的运行结构
| 阶段 | 界面表现 | 说明 |
|---|---|---|
| 加载中 | 整页展示加载态 | 按热点类型动态载入面板组件 |
| 加载失败 | 展示错误态,提供「重试」与「关闭」 | 组件缺失或加载异常时的兜底 |
| 编辑态 | 展示热点表单与底部操作条 | 可编辑热点名称、图标、文字、位置与类型专属字段 |
| 多步骤表单 | 主按钮变为「返回上一步」 | 部分热点类型需要分步完成,例如先选素材再填内容 |
| 保存 | 主按钮显示「保存编辑」 | 保存后热点写入作品并回传编辑器 |
| 关闭 | 主按钮显示「关闭编辑」 | 有未保存改动时先弹窗确认,确认后回滚改动 |
可承载的热点类型
本页是共用外壳,具体表单由热点类型决定:场景跳转、文本热点、文章热点、图片热点、视频热点、拨号热点、聚焦热点、遮罩热点、位置热点、红包热点、商品热点、3D 图片、3D 视频、3D 音效、3D 阳光、3D 绿幕视频、3D 模型、AI 效果热点、表单热点、联系我、全景互跳、链接跳转、开发者热点、互动热点、小商店热点。每一类的字段与保存要求见「热点设置」分组下的对应文档。
未保存保护
热点面板记录本次会话是否已保存,以及是否有未保存改动:没有改动时关闭不做额外处理;有改动且未保存时,关闭会先弹窗确认,确认后把内容回滚到进入面板时的状态;已经保存过的面板关闭时保持当前效果,不做回滚。
4. 使用说明
- 在编辑器中点击「热点设置」,选择要添加的热点类型
- 在预览画面上点击要放置热点的位置,热点进入编辑态
- 在热点面板中按步骤填写内容,遇到多步骤表单用「返回上一步」与主按钮切换
- 点击主按钮「保存编辑」保存热点
- 需要整理热点时到「热点管理」中查看、分组、复制或批量删除
- 回到编辑器确认效果后执行「发布作品」,发布完成访客才能看到新热点
5. 规则与限制
- 本页是热点能力的承载外壳,脱离编辑器单独访问时缺少场景与已保存数据,可用能力有限
- 热点属于当前场景,切换场景后需要重新添加
- 编辑态下有未保存改动时关闭会先确认,确认关闭后改动被回滚,不会写入作品
- 多步骤热点类型的表单在切换步骤时会卸载当前表单,跨步骤状态由外部会话保存
- 保存热点后仍需发布作品,热点才会对外可见
6. 状态与异常
- 加载中:动态载入热点面板时的整页加载态
- 加载失败:展示错误提示,可点「重试」重新加载或「关闭」退出
- 编辑态:面板展示热点表单与操作条
- 未保存关闭:弹窗标题「关闭确认」,正文「当前编辑内容尚未保存,确认关闭吗?」,按钮「继续编辑」「确认关闭」
- 回滚中:关闭过程中提示「正在关闭并恢复未保存内容...」
- 已保存:保存后回到编辑器,热点出现在预览与热点管理列表中
- 组件加载失败:热点面板组件缺失或加载异常时进入错误态,需要重试
- 未选中场景:没有当前场景时无法放置与保存热点
- 必填项缺失:各热点类型的必填字段为空时保存被拦截
- 未保存关闭:确认关闭后本次编辑内容被回滚丢弃
7. 相关文档
目录导航
- 所属目录索引:芊云编辑器(作品编辑主界面)
- 上一篇:芊云编辑器配置项总览
- 下一篇:芊云编辑器(编辑工作台)
同目录文档(9)
相关主题
8. 文档信息
- 事实来源:芊云编辑器公开版本配置与真实界面
- 文档构建时间:2026-10-21 00:05:20
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验