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. 使用说明
- 在编辑器「热点设置」中选择 3D 视频
- 点击「选择视频」上传本地视频
- 设置宽高、缩放、音量、播放方式等参数
- 上传视频封面
- 保存配置并在预览确认后重新发布
5. 规则与限制
- 3D 视频仅支持本地上传的视频,抖音外链等均无法显示
- 建议不要直接调整视频宽高,需要调整大小时优先调整缩放比例
- 大多数情况下浏览器无法自动播放音视频,开启「自动播放」后触摸屏幕开始播放
6. 状态与异常
- 已选择视频:展开宽高、缩放、播放等参数与封面设置
- 使用抖音等外链视频时无法显示
7. 相关文档
- 芊云编辑器配置项总览
- 热点设置(一级菜单)
- 3D 图片
- 全景作品播放页
- 上级目录索引:/tour
8. 文档信息
- 事实来源:芊云编辑器公开版本配置与真实界面
- 文档构建时间:2026-10-20 19:04:23
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验