# 场景遮罩
> 原场景遮罩能力已升级为「遮罩热点」，本入口只保留引导说明，实际绘制裁剪统一在遮罩热点中完成。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：在编辑器「场景设置」中打开「场景遮罩」时，页面会提示该能力已升级为遮罩热点，并引导前往绘制遮罩热点。需要绘制遮罩区域、实现区域交互或事件穿透时，直接按页面提示进入遮罩热点编辑。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 页面提示「场景遮罩已升级为遮罩热点」并说明升级原因
- 列出遮罩热点优势：支持多边形、圆形、线条多种遮罩形态
- 遮罩随热点整体保存，可复制、可复用
- 支持事件穿透开关，纯展示更顺滑
- 可配置点击、跳转等热点交互行为
- 提供「前往绘制遮罩热点」入口

## 3. 业务说明

### 配置区域

本页面不再提供遮罩参数配置，仅显示一条升级说明卡片，包含标题、说明文字、「遮罩热点优势」列表和「前往绘制遮罩热点」按钮。底部保留「返回」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 升级说明 | 告知遮罩能力已统一到遮罩热点 | 只读展示 | 不可配置 |
| 前往绘制遮罩热点 | 跳转到遮罩热点编辑 | 按钮 | 非必填 |

### 保存与生效

本页面不保存配置。遮罩的实际配置与保存在遮罩热点中完成，随热点保存，发布后对访问者生效。

## 4. 使用说明

1. 在场景列表选中场景
2. 选择「场景遮罩」配置
3. 阅读升级说明
4. 点击「前往绘制遮罩热点」进入遮罩热点编辑
5. 保存后重新发布

## 5. 规则与限制

- 原场景遮罩能力已统一到遮罩热点，本入口不再提供独立配置
- 遮罩随热点整体保存，可复制、可复用

## 6. 状态与异常

- 引导态：仅展示升级说明与跳转入口
- 暂无明确的报错提示，遇到异常请以页面实际提示为准

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [场景设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/scene.md)
- [场景修补](https://9kvr.cn/site/tour/editor/config/scene/sceneRepair.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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