# 发布 3D 模型
> 完善模型名称、封面、介绍与背景，从素材库选择模型文件后发布为可在线浏览的 3D 作品。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/send/send-model
- 所属模块：全景发布
- 页面用途：发布 3D 模型作品的表单页。填写模型名称、封面、详细介绍，选择背景（纯色/素材/图片/默认），从素材库选择模型文件后发布为可在线浏览的 3D 作品页。
- 适用用户：发布 3D 模型作品的登录创作者
- 访问条件：需登录后访问

## 2. 功能说明

- 基础信息表单校验（名称、封面、介绍）
- 作品封面上传或 AI 生成
- 地理位置选择与地址名称编辑
- 背景音乐选择与播放
- 四种模型背景：纯色背景、素材背景、图片背景、默认背景
- 从素材库选择模型文件，支持排序、改封面、改标题与在线预览
- 模型在线预览（支持背景色与天空盒）
- 发布成功后立刻查看或去管理作品

## 3. 业务说明

### 基础信息

需依次补全模型名称、作品封面与详细介绍并通过校验，封面支持上传或 AI 生成，均可从素材库选择。地理位置与背景音乐为选填项：选择地理位置后可编辑地址名称，背景音乐可从素材库选择并试听。

### 背景类型

| 背景 | 说明 |
| --- | --- |
| 纯色背景 | 使用取色器设定单一颜色作为背景 |
| 素材背景 | 从素材库选择背景素材，适合产品渲染 |
| 图片背景 | 使用一张 2:1 全景图片作为背景 |
| 默认背景 | 使用系统默认背景 |

### 背景设置

选择「纯色背景」时用取色器设定背景颜色；选择其他背景时从素材库选择背景图，并可随时清理背景；「图片背景」要求宽高比例为 2:1。

### 模型文件

模型文件从素材库添加，添加后可在卡片列表中拖拽排序、改封面、改标题与在线预览，确认无误后点击发布。

### 表单字段

| 字段 | 类型 | 是否必填 | 取值来源 | 默认值 | 限制与说明 | 影响费用 |
| --- | --- | --- | --- | --- | --- | --- |
| 模型名称 | 文本输入 | 必填 | 用户手动输入 |  | 长度应在 2-50 个字符之间 | 未核实（视实际规则） |
| 作品封面 | 上传 / AI 生成（素材库） | 必填 | 封面上传或 AI 生成 |  | 支持 JPG、PNG 格式 | 未核实（视实际规则） |
| 地理位置 | 地图选点 | 选填 | 地图选点 |  | 选填；选定后可编辑地址名称 | 未核实（视实际规则） |
| 背景音乐 | 素材库选择 | 选填 | 音乐素材库 |  | 选填，选定后可播放试听 | 未核实（视实际规则） |
| 详细介绍 | 多行文本（textarea） | 必填 | 用户手动输入 |  | 长度应在 10-500 个字符之间 | 未核实（视实际规则） |
| 模型背景 | 单选（纯色 / 素材 / 图片 / 默认） | 选填 | 用户选择 | 纯色背景 | 图片背景需为 2:1 全景图 | 未核实（视实际规则） |
| 背景设置 | 取色器 / 素材库选择 | 选填 | 纯色背景用取色器；其他背景从素材库选择 | 背景色 #000000 | 可清理背景；图片背景要求 2:1 | 未核实（视实际规则） |
| 模型文件 | 素材库选择（可排序 / 改封面 / 改标题 / 预览） | 必填 | 素材库 | 空 | 未添加模型文件时不可发布 | 未核实（视实际规则） |

## 4. 使用说明

1. 填写模型名称、封面与详细介绍并通过校验
2. 选择背景样式并设置颜色或背景图
3. 按需选择地理位置与背景音乐
4. 从素材库添加模型文件，可排序、改封面、改标题与预览
5. 点击发布，成功后立刻查看或去管理作品

## 5. 规则与限制

- 名称 2–50 个字符，介绍 10–500 个字符，封面必填
- 图片背景需为 2:1 全景图
- 封面、背景图与背景音乐均从素材库选择
- 未添加模型文件时不可发布
- 待产品确认：发布页提示「支持 obj/fbx/glb/gltf 等多种格式模型文件」，但模型素材上传页仅接受 glb/gltf 格式，两者不一致，待产品确认实际支持哪些格式

## 6. 状态与异常

- 表单填写与校验状态
- 模型文件列表为空 / 已添加（可排序、改封面、改标题、预览）两种状态
- 发布提交中按钮不可重复点击
- 表单校验不通过时提示补全
- 未选择模型文件时报错
- 模型文件格式或大小不符素材库要求时无法添加

## 7. 相关文档

- [发布模型素材](https://9kvr.cn/site/tour/send/send-model-media.md)
- [我的全景素材](https://9kvr.cn/site/tour/media/media-list.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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