发布作品(一级菜单)
编辑器「发布作品」一级菜单下 8 个配置项的总索引:发布、发布记录回溯与还原、作品评分、配置强制更新、离线资源下载、客户端打包、意见反馈与版本更新记录。
1. 页面信息
- 网页地址:https://9kvr.cn/tour/editor
- 所属模块:全景编辑器
- 页面用途:进入编辑器后点击左侧图标栏的「发布作品」,右侧面板标题为「发布作品」,说明文字为「发布作品和查看编辑记录」;面板内列出本组 8 个配置项。真正发起发布的动作在编辑器顶部导航条的「发布作品」主按钮,发布面板负责发布记录回溯、交付与反馈等辅助能力。
- 适用用户:需要在线编辑全景作品的登录用户(作者本人)
- 访问条件:需登录后访问
2. 功能说明
- 发布作品:把当前保存的场景与配置对外发布,带二次确认与发布进度
- 发布记录:查看最近 30 条发布记录,可查看配置详情、对比并整体还原或按项还原
- 作品评分:管理作品的评分页,可关闭评分或隐藏评分页面
- 更新 XML 配置:强制刷新作品配置缓存,处理编辑器内容不同步、作品黑屏、热点丢失等问题
- 全景离线下载:把作品资源打包成离线资源包下载到本地
- 打包软件:把作品打包成可在固定设备离线播放的客户端
- 意见反馈与版本记录:提交问题反馈、查看产品版本更新历史
3. 业务说明
本组配置项(8 项)
| 配置项 | 作用 | 界面入口或控件 | 对应文档 |
|---|---|---|---|
| 发布作品 | 把编辑器内保存好的场景与全部配置发布出去 | 编辑器顶部导航条的主按钮「发布作品」;弹出的发布确认框标题为「发布全景作品」,按钮「我再看看」「确定发布」 | /tour/editor/config/publish/send |
| 发布记录 | 查看最近的发布记录并把配置还原回历史版本 | 「发布记录」面板:正在使用的配置 / 历史记录,按钮「整体还原」「还原此项」「恢复备份」 | /tour/editor/config/publish/releaseRecord |
| 作品评分 | 管理作品的评分页与评分任务 | 「作品评分」面板:评分信息 / 评分管理,可「关闭评分」或「隐藏评分页面」 | /tour/editor/config/publish/tourScore |
| 更新 XML 配置 | 强制刷新线上作品的配置缓存,修复配置不同步问题 | 「更新XML配置」面板:说明「编辑器内容不同步」「作品黑屏」「热点配置丢失」等现象,提供「立即更新」与强制刷新 / 清空重建选项 | /tour/editor/config/publish/updateXmlConfig |
| 全景离线下载 | 把作品资源下载为离线资源包,用于自主部署与长期备份 | 「全景离线下载」面板:Offline Asset Pack 分区,按钮「我知道了」「去下载当前作品」 | /tour/editor/config/publish/offlineDownload |
| 打包软件 | 把作品打包为可离线浏览的客户端软件 | 「打包软件」面板:Client Preview 分区,按钮「稍后再看」「去下载离线资源」 | /tour/editor/config/publish/packageSoftware |
| 意见反馈 | 向平台提交功能异常、功能建议或其它反馈 | 「意见反馈」面板:反馈类型(功能异常 / 功能建议 / 其他反馈)、详细描述、联系方式 | /tour/editor/config/publish/suggestion |
| 版本记录 | 查看产品的版本更新历史与更新说明 | 「版本记录」面板:历史版本 / 版本时间线,含版本号、更新项列表、更新类型(新增功能 / 功能优化 / 问题修复)与版本分享链接 | /tour/editor/config/publish/versionRecord |
保存与生效
本组以「发布」而不是「保存」为主:编辑器内的配置保存只是写入作品,只有执行「发布作品」并发布成功后,外部访问者才能看到最新内容。发布确认框会依次给出「发布全景作品」「正在发布中」「发布成功」三个状态,发布中会显示进度百分比与「正在全网CDN发布中...」文案,发布成功后提供「继续编辑」与「预览作品」。发布记录面板中的还原动作会把配置回滚到历史版本,回滚同样需要重新发布才会对外生效。离线下载与打包软件属于交付动作,不改变线上作品内容。
发布后出问题时怎么排查
先看发布记录:面板会列出「正在使用的配置」与历史记录,可展开查看配置详情、对比当前值与历史值,并选择「整体还原」「还原此项」或「恢复备份」。若线上表现与编辑器内不一致(例如作品黑屏、热点配置丢失或错位、场景切换异常),可用「更新 XML 配置」强制刷新线上配置缓存。
4. 使用说明
- 完成编辑并逐项保存各配置(保存只是写入作品,此时线上还是旧内容)
- 点击左侧图标栏的「发布作品」查看本组入口,或直接点击顶部导航条的「发布作品」主按钮
- 在发布确认框中确认「确定发布当前全景作品吗?」,点击「确定发布」
- 等待发布完成,期间不要关闭窗口;进度条会显示当前阶段与百分比
- 发布成功后点击「预览作品」核对线上效果(可新窗口打开、浏览电脑版、浏览手机版或当前页打开)
- 如线上表现异常,进入「发布记录」定位是哪一次发布引入的问题,并按需整体还原或按项还原
- 还原后重新执行一次「发布作品」,让线上内容与编辑器内保持一致
5. 规则与限制
- 发布是把编辑器改动对外生效的必要步骤:仅保存配置不会对外可见
- 发布过程中不能关闭页面或退出发布流程,否则本次发布可能不完整
- 发布记录只保留最近的记录条目,定位历史问题时要注意可回溯的条数有限
- 还原动作会覆盖当前配置,操作前建议先「恢复备份」保留一份可回退的配置
- 全景离线下载与打包软件属于开发者交付能力,需要开发版 VIP 才能使用
- 更新 XML 配置会强制刷新线上缓存,属于故障兜底手段,不应当作为日常发布流程
- 作品评分、意见反馈、版本记录属于辅助能力,不影响作品对外呈现的内容
6. 状态与异常
- 待发布:顶部主按钮「发布作品」处于可点击状态
- 发布确认:弹出确认框,标题「发布全景作品」,提示「确定发布当前全景作品吗?发布后,当前保存的场景和配置将同步生效。」
- 发布中:标题变为「正在发布中」,提示「正在处理全景场景数据,请耐心等待,发布过程中请勿关闭窗口」,并显示进度百分比
- 发布成功:标题「发布成功」,提示「全景作品已发布成功,你可以预览线上效果,也可以返回继续编辑」
- 发布记录还原中:还原面板会显示还原状态,完成后当前配置被替换为历史配置
- 发布失败:弹窗提示「发布失败,请重试」,需要重新发起发布
- 发布未生效:可刷新页面或稍候再看,仍不一致时用「更新 XML 配置」强制刷新缓存
- 离线资源未下载:全景离线下载与打包软件会提示先下载离线资源再打开客户端
- 反馈提交失败:意见反馈面板会给出提交失败提示并保留表单内容,可重新提交
7. 相关文档
目录导航
- 所属目录索引:芊云编辑器配置项总览
- 上一篇:热点设置(一级菜单)
- 下一篇:场景设置(一级菜单)
下级页面(8)
同目录文档(4)
相关主题
8. 文档信息
- 事实来源:芊云编辑器公开版本配置与真实界面
- 文档构建时间:2026-10-21 00:05:20
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验