# 全景素材下载
> 为有权限的素材发起原图下载任务，并跟踪进度与结果。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/total/download
- 所属模块：作品数据与下载
- 页面用途：对于会员或已开通单素材升级权限的素材，提供原素材下载能力。页面展示素材基础信息与下载权限，点击下载后进入异步下载队列，实时显示进度与预计剩余时间，完成后给出结果链接（图片可直接预览，视频可播放）。
- 适用用户：有原素材下载权限的会员用户
- 访问条件：公开访问

## 2. 功能说明

- 素材基础信息：名称、尺寸、文件大小、描述
- 下载权限检查，显示是否满足下载权限，无权限时引导前往开通
- 发起下载后进入异步任务队列
- 任务状态：排队中 / 处理中 / 已完成 / 已失败 / 已取消 / 产物已清理
- 进度与预计剩余时间实时更新
- 结果预览：图片预览、视频播放、再次下载
- 支持续查已有下载任务

## 3. 业务说明

### 权限与任务

仅会员用户或已开通单素材升级的素材可发起下载。同一素材已有进行中任务时会直接续接该任务，避免重复排队。

### 任务状态

| 状态 | 含义 |
| --- | --- |
| 排队中 | 任务已提交，等待处理 |
| 处理中 | 正在生成下载产物 |
| 已完成 | 可预览或下载结果 |
| 已失败 / 已取消 | 任务未成功，需重新发起 |
| 产物已清理 | 下载产物已过期清理，需重新发起 |

## 4. 使用说明

1. 登录后以带素材标识的方式进入本页
2. 系统获取素材信息并检查下载权限
3. 点“立即下载”发起任务并加入队列
4. 等待进度完成后预览或下载结果

## 5. 规则与限制

- 仅会员或已开通单素材升级的素材可发起下载
- 同一素材已有进行中任务时续接该任务
- 进行中任务进度不足满额时最多显示到 99%

## 6. 状态与异常

- 权限检查中显示提示
- 下载中显示进度条与预计剩余时间
- 结果区按素材类型展示图片或视频预览
- 无下载权限时引导前往开通会员
- 任务失败时展示失败原因；产物过期时提示下载产物已清理

## 7. 相关文档

- [我的素材收藏](https://9kvr.cn/site/tour/media/media-collection.md)
- [作品管理](https://9kvr.cn/site/tour/total/commit.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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