App 专用全景播放
供 App 内嵌的纯播放页，无业务界面，只负责加载并播放指定全景作品。
1. 页面信息
- 网页地址：https://9kvr.cn/tour/app
- 所属模块：全景播放
- 页面用途：用于在原生 App 内直接打开某个全景作品的播放页。页面不展示浏览、分享等操作界面，仅负责按 App 传入的作品加载全景，并配合 App 完成首屏就绪、陀螺仪开关与自动录制运镜等能力，适合作为客户端的纯播放容器使用。
- 适用用户：在原生 App（客户端）内打开全景作品的用户
- 访问条件：公开访问
2. 功能说明
- 纯播放，无业务操作界面，进入时先展示黑色加载动画
- 加载完成后通知 App 首屏已就绪，并关闭启动加载
- 支持由 App 触发陀螺仪开关与自动录制运镜（录屏时自动转动视角）
- 播放失败时展示错误提示，可由外部关闭
3. 业务说明
适用场景
供原生 App 内嵌使用：App 传入作品标识后，页面渲染全景并驱动播放。首屏、陀螺仪与录制运镜等环节均与 App 通信，用户看不到额外界面。
- 首屏使用独立的静态加载入口，先显示加载动画，再接管为可交互播放
- 面向 App 运行时设计，不适合作为普通网页分享链接直接传播
4. 使用说明
- 由 App 打开该页面并传入作品标识
- 页面加载作品并渲染全景
- 首屏加载完成后自动关闭加载动画，进入可交互播放
- 根据需要由 App 控制陀螺仪或开始/结束自动运镜
5. 规则与限制
- 页面不提供浏览、分享等业务入口，仅作播放用途
- 首屏就绪只在一个场景与前置任务都完成后才通知 App
- 录制运镜按会话隔离，异常退出时会恢复原有视角状态
6. 状态与异常
- 进入时显示黑色“全景加载中...”动画
- 加载完成后进入可交互播放（拖动、陀螺仪等）
- 未传入作品时不加载播放器
- 播放失败时展示错误提示，可关闭后重新进入
7. 相关文档
8. 文档信息
- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验