# 3D 视频
> 3D 视频把本地上传的视频贴合到场景三维空间中，可设置扭曲、缩放、音量与播放方式。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当需要在全景中嵌入可贴合三维空间的视频时使用。在「热点设置」中选择 3D 视频，上传本地视频并设置宽高、缩放、播放等参数，再上传视频封面，保存后重新发布作品。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 仅支持本地上传的视频，抖音外链等无法显示
- 自带视频封面设置，并可开启 3D 扭曲微调空间形变
- 可设置缩放比例、播放音量、循环与跟随场景缩放
- 可控制是否接受事件、自动播放、逆向旋转与显示控制台

## 3. 业务说明

### 配置区域

面板为 3D 视频专属配置：视频地址（选择/删除视频）、视频宽度/高度、缩放比例、播放音量、开启 3D 扭曲及其扭曲深度参数、循环播放、跟随场景缩放、接受事件、自动播放、逆向旋转、显示控制台，以及视频封面。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 视频地址 | 显示已选择的本地视频，通过「选择视频」按钮上传 | 只读，占位提示「请选择视频地址」 | 必填 |
| 视频宽度 | 设置视频展示宽度 | 滑块，1-1024 | 随视频原始宽度 |
| 视频高度 | 设置视频展示高度 | 滑块，1-768 | 随视频原始高度 |
| 缩放比例 | 控制整体缩放，默认 10 表示显示效果为 1/10，设为 5 则显示效果为 0.5 | 滑块，1-10 | 默认 10 |
| 播放音量 | 设置视频播放音量 | 滑块，1-10 | 默认 10 |
| 开启3D扭曲 | 开启后可微调视频在 3D 空间的扭曲 | 开关 | 默认关闭 |
| x轴/y轴/z轴扭曲 | 开启 3D 扭曲后微调扭曲 | 滑块，-360 至 360 | 默认 0 |
| x轴/y轴/z轴深度 | 开启 3D 扭曲后微调深度 | 滑块，-360 至 360 | 默认 0 |
| 循环播放 | 控制视频是否循环播放 | 开关 | 默认开启 |
| 跟随场景缩放 | 控制视频是否随场景一起缩放 | 开关 | 默认关闭 |
| 接受事件 | 关闭后点击此热点将忽略所有事件（可无视热点拖拽全景），但视频等热点可能无法点击播放 | 开关 | 默认关闭 |
| 自动播放 | 开启后触摸屏幕即开始自动播放 | 开关 | 默认开启 |
| 逆向旋转 | 控制视频是否逆向旋转 | 开关 | 默认关闭 |
| 显示控制台 | 控制是否显示视频播放控制条 | 开关 | 默认关闭 |
| 视频封面 | 设置视频封面图 | 图片上传 | 必填 |

### 保存与生效

上传视频并调好参数、设置封面后点击保存，预览中立即生效；重新发布作品后对访问者生效。

## 4. 使用说明

1. 在编辑器「热点设置」中选择 3D 视频
2. 点击「选择视频」上传本地视频
3. 设置宽高、缩放、音量、播放方式等参数
4. 上传视频封面
5. 保存配置并在预览确认后重新发布

## 5. 规则与限制

- 3D 视频仅支持本地上传的视频，抖音外链等均无法显示
- 建议不要直接调整视频宽高，需要调整大小时优先调整缩放比例
- 大多数情况下浏览器无法自动播放音视频，开启「自动播放」后触摸屏幕开始播放

## 6. 状态与异常

- 已选择视频：展开宽高、缩放、播放等参数与封面设置
- 使用抖音等外链视频时无法显示

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [热点设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/hotspot.md)
- [3D 图片](https://9kvr.cn/site/tour/editor/config/hotspot/3DImages.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验