# 开发者热点
> 点击后触发自定义行为（小程序跳转、全局事件、网页嵌入式通信或调用开发者接口）的热点类型。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：需要让热点对接小程序、网页或自有接口时使用。先选择点击类型，再按该类型填写对应信息，放到预览区保存。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 点击类型可选：小程序类型、事件类型、网页嵌入式通信、API接口、其他
- 小程序类型可配置小程序路径与跳转 API
- 事件类型可配置全局事件名称并携带热点参数
- API接口类型可配置接口地址与口令，由平台调用开发者接口返回内容

## 3. 业务说明

### 配置区域

公共热点配置中的基本配置区含「点击类型」及随类型变化的字段。选择不同类型时下方字段随之切换；「其他」类型目前提示暂未确定。底部按钮为「插入场景」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 点击类型 | 热点被点击时触发的行为类型 | 单选：小程序类型 / 事件类型 / 网页嵌入式通信 / API接口 / 其他 | 必填 |
| 小程序路径 | 小程序类型下要打开的小程序全路径 | 文本 | 小程序类型必填 |
| 跳转API | 小程序类型下使用的跳转方式 | 文本，提示「请输入小程序跳转API」 | 小程序类型必填；默认值未确认 |
| 通讯域名 | 网页嵌入式通信类型下要通信的父级网页域名 | 文本 | 网页嵌入式通信类型必填；默认值未确认 |
| 事件名称 | 事件类型、网页嵌入式通信、其他类型下的全局事件名称，目前只支持英文字母 | 文本 | 上述类型必填 |
| API地址 | API接口类型下平台请求的完整地址 | 文本 | API接口类型必填 |
| API口令 | API接口类型下随请求携带的口令 | 文本 | API接口类型必填 |

### 保存与生效

点击「插入场景」保存；保存后立即作用于编辑器预览，外部访问者需重新发布作品后点击才会触发对应行为。

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

## 8. 文档信息

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