# 3D 绿幕视频
> 在场景中嵌入带绿幕抠像的视频，实现人物视频叠加到全景中的热点类型。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：需要把带绿幕的人像或视频叠加到场景里时使用。选择绿幕视频后先做抠像预览并确认抠像完成，再调整尺寸、缩放、播放与扭曲参数，最后插入场景。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 支持小于 10M 的 mp4 绿幕视频
- 提供抠像预览与抠像完成流程，抠像完成前不能插入场景
- 可设置视频宽度、高度与缩放比例
- 支持重复播放、静音播放、跟随场景缩放
- 可进行 3D 扭曲并调整 X/Y/Z 轴深度

## 3. 业务说明

### 配置区域

面板为单页配置，依次为：热点名称、视频文件（选择/删除视频）、抠像配置（抠像预览/抠像完成），以及视频画面与播放类参数（视频宽度、视频高度、视频缩放、重复播放、静音播放、跟随场景缩放、接受事件、进行 3D 扭曲及其轴向深度）。底部按钮为「插入场景」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 热点名称 | 热点文字名称，可不填 | 文本，最多 60 字 | 默认「绿幕视频」 |
| 视频文件 | 选择绿幕视频，仅支持小于 10M 的 mp4 | 素材库选择视频 | 必填 |
| 抠像配置 | 先「抠像预览」，确认效果后点「抠像完成」 | 按钮：抠像预览 / 抠像完成 | 必填，抠像完成后才可插入场景 |
| 视频宽度 | 视频显示宽度 | 滑块 1 ~ 2048 | 默认取自视频实际宽度 |
| 视频高度 | 视频显示高度 | 滑块 1 ~ 2048 | 默认取自视频实际高度 |
| 视频缩放 | 视频缩放比例（界面显示为 0.1 ~ 1） | 滑块 1 ~ 10 | 默认 3（约 0.3） |
| 重复播放 | 视频是否循环播放 | 开关 | 默认开启 |
| 静音播放 | 视频是否静音 | 开关 | 默认开启 |
| 跟随场景缩放 | 视频是否随场景缩放同步变化 | 开关 | 默认关闭 |
| 接受事件 | 关闭后点击此热点忽略所有事件，可能无法点击播放 | 开关 | 默认开启 |
| 进行3D扭曲 | 是否对视频做 3D 扭曲 | 开关 | 默认关闭 |
| x轴深度 / y轴深度 / z轴深度 | 开启 3D 扭曲后的轴向深度 | 滑块 -360 ~ 360 | 默认 0 |

### 保存与生效

抠像完成并点击「插入场景」后写入当前场景；保存后立即作用于编辑器预览，外部访问者需重新发布作品后可见。

## 4. 使用说明

1. 在编辑器「热点设置」中选择 3D 绿幕视频
2. 在预览区点击要放置的位置
3. 选择绿幕视频并完成抠像预览与抠像完成
4. 调整尺寸、缩放、播放与扭曲参数
5. 点击「插入场景」保存并重新发布作品

## 5. 规则与限制

- 仅支持小于 10M 的 mp4 绿幕视频
- 必须点击「抠像完成」后才能插入场景
- 绿幕视频暂不支持再次编辑，添加后若要删除请进入热点管理模块处理
- 该热点在编辑器热点菜单中可能带有会员或认证标识，具体可用性以编辑器实际提示为准

## 6. 状态与异常

- 已选择视频待抠像
- 抠像预览中
- 抠像完成（可插入场景）
- 未完成抠像时无法插入场景
- 视频超过 10M 或非 mp4 格式时无法选择

## 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/Interactive3DAudio.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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