# 首屏全景查看器
> 通过链接参数直接在全屏球面查看单张全景图，适合首屏展示。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/fast/first-viewer
- 所属模块：家乡全景与卫星地图
- 页面用途：一个极简的全屏全景查看器：通过链接参数传入一张全景图地址，页面直接在全屏球面中展示该图，不加载其他界面。常用于分享或嵌入场景时的首屏展示。
- 适用用户：需要极简、快速查看单张全景图的用户
- 访问条件：公开访问

## 2. 功能说明

- 全屏展示单张全景图，进入时显示加载动画
- 通过链接参数传入全景图地址即可查看
- 加载完成后对外发出“已加载完成”标记，便于外部页面衔接

## 3. 业务说明

### 适用场景

当只需要快速展示一张全景图、无需任何操作界面时使用，例如分享卡片首屏、嵌入外部页面时的预览。

## 4. 使用说明

1. 在链接中带上全景图地址打开本页
2. 页面自动在全屏球面中渲染该图

## 5. 规则与限制

- 必须通过链接参数提供全景图地址，未提供时不渲染画面
- 页面不提供浏览、分享等操作入口

## 6. 状态与异常

- 未提供图片时仅显示加载背景
- 图片加载失败时按查看器自身表现提示，可刷新重试

## 7. 相关文档

- [瓦片地图全景](https://9kvr.cn/site/tour/fast/tour.md)
- [素材播放](https://9kvr.cn/site/tour/media/play.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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