# 遮罩热点
> 遮罩热点在场景中圈出一块区域，让访问者只能看到该区域内的画面，其余部分被遮住。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当需要突出场景中的某个局部、隐藏其余画面时使用。在「热点设置」中选择遮罩热点，在预览区绘制遮罩区域，再点击「保存到热点」保存，重新发布作品后对访问者生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 在预览区绘制/调整遮罩区域，划定可见范围
- 遮罩区域支持以点坐标方式记录与微调

## 3. 业务说明

### 配置区域

面板的「热点基本配置」中包含遮罩热点专属的区域绘制与坐标设置；遮罩热点默认隐藏「图标样式」与「文字提示」等展示相关配置。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 遮罩区域 | 在预览区绘制/调整要保留可见的区域 | 区域绘制（以点坐标记录） | 必填，未绘制时不能保存 |

### 保存与生效

绘制好遮罩区域后点击「保存到热点」保存到当前场景，预览中立即生效；重新发布作品后对访问者生效。

## 4. 使用说明

1. 在编辑器「热点设置」中选择遮罩热点
2. 在预览区绘制遮罩区域
3. 点击「保存到热点」保存
4. 重新发布作品查看效果

## 5. 规则与限制

- 未绘制遮罩区域时不能保存热点

## 6. 状态与异常

- 未绘制区域：保存按钮不可用

## 7. 相关文档

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

## 8. 文档信息

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