# 上传自定义 CDN 素材
> 把外部的全景视频、CDN 全景切片纳入管理，或在浏览器内完成全景图片切图。

## 1. 页面信息

- 网页地址：https://9kvr.cn/user/team/auto-cdn
- 所属模块：企业协作
- 页面用途：自定义 CDN 素材管理页，用于把外部自有的全景视频、CDN 全景切片纳入管理。页面提供三种方式：「添加全景视频」（填写视频与封面地址后登记）、「添加全景图片」（先准备并上传切片目录，再读取配置解析并登记）、「自定义切图」（选择本地全景图在浏览器内切图并下载切片包）。需要注意的是，加载规则配置错误可能导致全景打开后黑屏，配置前建议先了解加载原理与目录结构。
- 适用用户：开发版及以上会员，需要接入自有 CDN 素材的创作者
- 访问条件：需登录后访问，面向开发版及以上会员

## 2. 功能说明

- 添加全景视频：填写素材名称、链接、封面与宽高后登记
- 添加全景图片：两步完成（上传切片目录 → 读取配置并登记）
- 自定义切图：在浏览器内对本地全景图切图并下载切片包
- 配置读取结果展示目录、模型、立方体、适配等参数
- 提供切片目录结构示例与推荐 CDN 服务商说明

## 3. 业务说明

### 自定义 CDN

自定义 CDN 素材用于把外部自有的全景视频、CDN 全景切片纳入平台管理。加载规则配置错误可能导致全景打开后黑屏，配置前建议先了解加载原理与目录结构。

### 三种方式

页面提供「添加全景视频」「添加全景图片（上传切片后解析登记）」「自定义切图（浏览器内切图并下载切片包）」三种方式，可按素材类型选择。

### 使用前提

自定义 CDN 能力面向开发版及以上会员；切片目录需完整上传到自有 CDN 或对象存储，并确保跨域配置允许浏览器直接读取。

### 表单字段

| 字段 | 类型 | 是否必填 | 取值来源 | 默认值 | 限制与说明 | 影响费用 |
| --- | --- | --- | --- | --- | --- | --- |
| 素材名称 | 文本 | 必填 | 用户输入 |  | 视频名称最多 12 个字符；图片名称仅限中文 | 未核实（视实际规则） |
| 素材链接 | 文本 | 必填 | 用户输入 |  | 完整且可直接访问的全景视频地址 | 未核实（视实际规则） |
| 素材封面 | 文本 | 必填 | 用户输入 |  | 可直接访问的标准全景图片 | 未核实（视实际规则） |
| 素材宽度 / 高度 | 数字 | 必填 | 用户输入 |  | 按素材实际尺寸填写 | 未核实（视实际规则） |
| 切图类型 | 单选 | 选填 | 平台设置 | 手动切图 | 当前使用手动切图方式 | 未核实（视实际规则） |
| 目录地址 | 文本 | 必填 | 用户输入 |  | 可直接访问的 XML 配置文件地址，如切片目录中的配置文件 | 未核实（视实际规则） |
| 加载规则 | 文本 | 必填 | 读取后自动解析，可手动调整 |  | 直接影响全景加载，不了解含义时请勿随意修改 | 未核实（视实际规则） |

## 4. 使用说明

1. 选择添加全景视频或全景图片
2. 视频：填写素材名称、链接、封面与宽高后确认新增
3. 图片：先准备并上传切片目录，再填目录配置文件地址读取配置，确认加载规则后新增
4. 或使用自定义切图：选择本地 JPG / JPEG 全景图，切图后下载切片包自行部署
5. 在列表中查看与管理已登记的 CDN 素材

## 5. 规则与限制

- 自定义 CDN 能力面向开发版及以上会员用户
- 素材链接与目录地址必须能被浏览器直接访问
- 切片目录需完整上传，注意跨域与访问来源限制
- 切图文件仅支持 JPG / JPEG 且不超过 20M，图片过大可能导致切图失败
- 配置文件地址需为可直接访问的 XML 配置文件

## 6. 状态与异常

- 添加视频：填写表单并确认
- 添加图片：步骤一准备并上传切片 → 步骤二读取配置并登记素材
- 自定义切图：选中素材 → 切图中 → 切图完成可下载 → 下载完成可重新下载
- 配置读取结果：逐项展示目录、模型、立方体、适配等参数
- 必填项未填时「确认新增」按钮保持禁用
- 配置读取失败或跨域受限时无法读取素材
- 切图失败（如文件过大）时需重新选择素材

## 7. 相关文档

- [开发者工作台](https://9kvr.cn/site/user/develop/workbench.md)
- [我的全景素材](https://9kvr.cn/site/tour/media/media-list.md)
- [芊云全景企业工作台](https://9kvr.cn/site/user/team/list.md)
- 上级目录索引：[/user](https://9kvr.cn/site/user/llms.txt)

## 8. 文档信息

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