更新 XML 配置
当作品出现编辑器与显示内容不同步、黑屏异常、热点错位等问题时,强制刷新配置以恢复正常显示。
1. 页面信息
- 网页地址:https://9kvr.cn/tour/editor
- 所属模块:全景编辑器
- 页面用途:进入编辑器后,在「发布作品」中打开更新 XML 配置。面板先说明适用的问题场景,并展示本次更新的配置详情;确认无误后点击「立即更新」,等待几秒即可。更新完成后作品会自动恢复正常显示。
- 适用用户:需要在线编辑全景作品的登录用户(作者本人)
- 访问条件:需登录后访问
2. 功能说明
- 列出适用该功能的问题场景
- 展示本次更新的作品与更新方式
- 一键强制刷新配置
- 更新过程显示进度状态
3. 业务说明
配置区域
面板依次为「功能说明」(列出建议使用此功能的问题)、「配置详情」(作品 ID、更新模式、缓存处理、编辑状态)、「操作提示」以及更新中的状态区。底部为「返回」「立即更新」。
字段说明
| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
|---|---|---|---|
| 功能说明 | 说明何时使用:编辑器内容与显示内容不同步、作品自动黑屏或显示异常、热点配置丢失或错位、场景切换出现问题 | 说明文字 | — |
| 作品ID | 当前要更新的作品,未识别时显示「--」 | 只读展示 | — |
| 更新模式 | 本次更新采用的方式 | 只读:强制刷新配置 | — |
| 缓存处理 | 本次更新对缓存的处理方式 | 只读:清空重建 | — |
| 编辑状态 | 更新后是否保持编辑模式 | 只读:保持编辑模式 | — |
| 立即更新 / 更新中... | 执行配置更新 | 按钮 | 必点 |
| 返回 | 关闭页面,更新中不可返回 | 按钮 | — |
保存与生效
点击「立即更新」后开始处理,约几秒完成;更新期间会显示「正在更新配置... 请稍候,系统正在同步最新配置」,更新成功后延迟片刻自动关闭页面。更新会清空并重建缓存、强制刷新配置,用于让作品恢复正常显示。
4. 使用说明
- 在编辑器左侧点击「发布作品」,打开更新 XML 配置
- 阅读「功能说明」,确认当前问题在适用范围内
- 核对「配置详情」中的作品信息
- 点击「立即更新」,等待处理完成
- 更新完成后确认作品显示是否恢复正常
5. 规则与限制
- 更新过程大约需要几秒钟
- 更新会清空重建缓存并强制刷新配置
6. 状态与异常
- 更新中显示「正在更新配置... 请稍候,系统正在同步最新配置」
- 更新中「返回」按钮不可用
- 缺少作品 ID:提示「缺少作品ID,无法更新配置」
- 网络异常:提示「网络错误,请检查网络连接后重试」
7. 相关文档
- 芊云编辑器配置项总览
- 发布作品(一级菜单)
- 发布作品
- 全景作品播放页
- 上级目录索引:/tour
8. 文档信息
- 事实来源:芊云编辑器公开版本配置与真实界面
- 文档构建时间:2026-10-20 19:04:23
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验