全景播放(App 专用入口)
App 内专用的全景播放页:只做播放、不含任何界面元素,打开后黑屏加载并直接进入全景,可由 App 侧控制陀螺仪模式与自动运镜。
1. 页面信息
- 网页地址:https://9kvr.cn/tour/app
- 所属模块:全景作品与工具
- 页面用途:在 App 内点击全景作品或由 App 侧跳转到这个地址时进入本页。页面是纯播放实现:首屏是一个带 VR 图标的「全景加载中...」加载层,背景全黑;作品数据就绪后加载层移除、全景铺满整个屏幕。页面本身不提供菜单、按钮或退出入口,所有交互都交给 App 侧与手势完成。
- 适用用户:在芊云全景 App 内打开全景作品的访客
- 访问条件:公开访问(进入时按小程序参数写入身份信息)
2. 功能说明
- 纯播放页面,画面固定铺满全屏,背景为黑色,没有任何界面控件
- 首屏独立加载层:三层旋转圆环 + VR 标识 + 文案「全景加载中...」
- 加载层样式内置在独立入口首屏里,无需等待页面资源加载即可看到
- 全景内容加载完成后自动关闭首屏加载层,进入可交互浏览
- 加载失败时展示作品错误提示层,可关闭后重试
- 支持 App 侧切换陀螺仪模式与启动全景自动运镜
- 进入时会读取上次会话的场景配置并恢复,进入后仍停留在上次的场景视角
- 页面标题取作品名称,简介取作品描述
3. 业务说明
界面结构
| 区块 / 控件 | 类型 | 取值来源 | 限制 / 说明 |
|---|---|---|---|
| 全景加载中... | 首屏加载层 | 固定文案 | 仅在全景内容加载完成前显示 |
| VR 标识 + 三层旋转圆环 | 加载动画 | 固定样式 | 仅首屏可见,加载完成后移除 |
| 全景播放画面 | 播放器区域 | 当前作品的全景场景 | 铺满全屏,无任何叠加控件 |
| 作品错误提示层 | 错误提示 | 全景加载失败时 | 可关闭提示层后重新加载 |
| 陀螺仪模式 | App 侧控制能力 | 由 App 侧下发 | 模式切换失败时记录失败信息,不影响播放 |
| 全景自动运镜 | App 侧控制能力 | 由 App 侧下发 | 自动运镜启动失败时记录失败信息,不影响播放 |
| 场景配置恢复 | 会话状态 | 上次会话保存的场景配置 | 进入时恢复,录制会话失效时会提示 |
| 页面标题 / 简介 | 页面元信息 | 作品名称与作品描述 | 取不到时按默认文案处理 |
与普通全景播放页的区别
这个地址是 App 内的专用播放入口,只保留播放能力,界面元素全部由 App 侧承担;对外分享的作品链接走的是另一个全景播放地址,两者不要混用。
错误处理
全景加载出错时展示错误提示层,用户可以关闭提示层;页面在离开时会清理播放引擎,避免残留场景影响下一次播放。
4. 使用说明
- 在 App 内打开全景作品,进入本播放页
- 首屏展示「全景加载中...」加载层,等待全景资源就绪
- 全景加载完成后加载层自动消失,画面铺满全屏
- 用手势缩放、旋转或切换场景浏览;陀螺仪模式与自动运镜由 App 侧控制
- 如遇加载失败,关闭错误提示层后重新加载作品
5. 规则与限制
- 页面只做播放,不提供任何界面控件、菜单或退出入口
- 作品数据需要先获取到作品标识与切片信息才能开始加载
- 陀螺仪模式切换失败与自动运镜启动失败只影响对应能力,不中断全景播放
- 录制会话失效时会提示「录制会话已失效」
- 进入页面会恢复上次会话保存的场景配置,因此初次进入可能直接落在上次的场景视角
6. 状态与异常
- 首屏加载中:显示「全景加载中...」加载层
- 加载完成:加载层移除,全景可交互
- 加载失败:展示作品错误提示层,可关闭
- App 侧切换模式中:陀螺仪模式切换或自动运镜启动失败时记录失败信息
- 全景加载失败时展示作品错误提示层
- 录制会话失效时提示「录制会话已失效」
- 全景运镜状态恢复失败时记录恢复失败信息
7. 相关文档
目录导航
- 所属目录索引:全景作品播放页
- 下一篇:芊云编辑器(作品编辑主界面)
同目录文档(6)
相关主题
8. 文档信息
- 事实来源:芊云全景官网页面核验
- 文档构建时间:2026-10-21 00:05:20
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验