# App 专用全景播放
> 供 App 内嵌的纯播放页，无业务界面，只负责加载并播放指定全景作品。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/app
- 所属模块：全景播放
- 页面用途：用于在原生 App 内直接打开某个全景作品的播放页。页面不展示浏览、分享等操作界面，仅负责按 App 传入的作品加载全景，并配合 App 完成首屏就绪、陀螺仪开关与自动录制运镜等能力，适合作为客户端的纯播放容器使用。
- 适用用户：在原生 App（客户端）内打开全景作品的用户
- 访问条件：公开访问

## 2. 功能说明

- 纯播放，无业务操作界面，进入时先展示黑色加载动画
- 加载完成后通知 App 首屏已就绪，并关闭启动加载
- 支持由 App 触发陀螺仪开关与自动录制运镜（录屏时自动转动视角）
- 播放失败时展示错误提示，可由外部关闭

## 3. 业务说明

### 适用场景

供原生 App 内嵌使用：App 传入作品标识后，页面渲染全景并驱动播放。首屏、陀螺仪与录制运镜等环节均与 App 通信，用户看不到额外界面。

- 首屏使用独立的静态加载入口，先显示加载动画，再接管为可交互播放
- 面向 App 运行时设计，不适合作为普通网页分享链接直接传播

## 4. 使用说明

1. 由 App 打开该页面并传入作品标识
2. 页面加载作品并渲染全景
3. 首屏加载完成后自动关闭加载动画，进入可交互播放
4. 根据需要由 App 控制陀螺仪或开始/结束自动运镜

## 5. 规则与限制

- 页面不提供浏览、分享等业务入口，仅作播放用途
- 首屏就绪只在一个场景与前置任务都完成后才通知 App
- 录制运镜按会话隔离，异常退出时会恢复原有视角状态

## 6. 状态与异常

- 进入时显示黑色“全景加载中...”动画
- 加载完成后进入可交互播放（拖动、陀螺仪等）
- 未传入作品时不加载播放器
- 播放失败时展示错误提示，可关闭后重新进入

## 7. 相关文档

- [全景作品播放页](https://9kvr.cn/site/tour.md)
- [全景主页](https://9kvr.cn/site/tour/index.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验