首屏全景查看器
极简全屏全景查看器：通过链接参数传入一张全景图地址，直接在全屏球面中展示该图，不加载任何操作界面。
1. 页面信息
- 网页地址：https://9kvr.cn/tour/fast/first-viewer
- 所属模块：家乡全景与卫星地图
- 页面用途：一个刻意做减法的查看器：在链接里带上全景图地址打开本页，页面在黑色背景的全屏球面中直接渲染这张图，不出现任何按钮、菜单或说明文字。适合用作分享卡片首屏，或嵌入到需要"只有画面"的外部页面里。
- 适用用户：需要极简、快速查看单张全景图的用户
- 访问条件：公开访问
2. 功能说明
- 全屏球面展示单张全景图，进入时显示加载动画
- 通过链接参数传入全景图地址即可查看，无需登录
- 不提供任何浏览、分享或关闭入口
- 图片加载完成后对外发出「已加载完成」标记，便于外部页面衔接
- 背景为纯黑，画面铺满整个视口
3. 业务说明
界面结构
| 元素 | 取值 / 行为 |
|---|---|
| 加载层 | 黑色背景加载动画，等待全景图就绪 |
| 全景球面 | 按传入的地址渲染单张全景图 |
| 加载完成标记 | 图片就绪后对外发出已加载标记，外部页面可据此衔接 |
| 操作控件 | 无 |
| 关闭入口 | 无 |
适用场景
当只需要快速展示一张全景图、不需要任何操作界面时使用，例如分享卡片的封面图、外部页面的首屏预览。本页刻意不做交互，保证打开即看到画面。
与全景播放页的差别
全景播放页是完整的浏览体验（有控件、可分享、可统计访问）；本页是纯展示，代价是没有交互，也不计入作品的访问统计（未核验）。
4. 使用说明
- 在链接中带上全景图地址打开本页
- 页面在黑色背景上渲染该全景图
- 图片就绪后等待外部页面的后续动作
- 需要换一张图时，改用新的图片地址重新打开链接
5. 规则与限制
- 必须通过链接参数提供全景图地址，未提供时不渲染任何画面
- 页面不提供浏览、分享等任何操作入口
- 参数中的地址会被解码后使用
6. 状态与异常
- 加载中：黑色背景加载动画
- 就绪：全屏球面展示该全景图
- 未提供图片：只显示加载背景，不渲染画面
- 图片地址无效或加载失败时按查看器自身表现处理，可刷新重试（未核验）
7. 相关文档
目录导航
- 所属目录索引：/tour/fast
- 下一篇：家乡回忆（拍摄引导）
同目录文档（6）
相关主题
8. 文档信息
- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-21 00:05:20
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验