# 访客登记
> 访客登记页：作者开启了访客留资后，访客必须按要求填写姓名、手机号等字段并同意《预约登记服务协议》，才能进入全景作品。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/error/leaveInform
- 所属模块：全景作品与工具
- 页面用途：访客打开一个开启了访客登记的作品时会被拦到这个页面。页面顶部写明「访客登记 / Visitor Registration」，下方是一条提示「根据作者设置, 此作品必须登记才可浏览!」，然后按作者配置的字段逐项渲染输入框（姓名、手机号等）。表单底部是「阅读并同意《预约登记服务协议》」复选框，点协议名可展开协议全文；最下方是「开启全景体验」按钮与「暂不浏览，返回」链接。
- 适用用户：打开需要登记才能浏览的全景作品的访客
- 访问条件：公开访问

## 2. 功能说明

- 顶部标题：主标题「访客登记」+ 英文副标题「Visitor Registration」
- 顶部提示条：默认文案「根据作者设置, 此作品必须登记才可浏览!」
- 表单字段按作者配置动态渲染：文本、电话、数字、多行文本等类型
- 字段可配置为必填（带红色星号）、最小长度与最大长度
- 默认字段：姓名（请输入您的姓名，1-20 字符）、手机号（请输入您的手机号，11 位）
- 「阅读并同意《预约登记服务协议》」复选框，点击协议名可展开协议全文
- 「开启全景体验」主按钮，未勾选协议时按钮不可点击
- 「暂不浏览，返回」链接，可放弃登记离开

## 3. 业务说明

### 界面结构

| 控件 / 入口 | 类型 | 取值来源 | 限制 / 说明 |
| --- | --- | --- | --- |
| 根据作者设置, 此作品必须登记才可浏览! | 提示条 | 作者填写的登记提示 | 作者未填写时使用默认文案 |
| 姓名 | 文本输入框 | 作者配置的字段 | 默认必填，最短 1 字符、最长 20 字符，占位文案「请输入您的姓名」 |
| 手机号 | 电话输入框 | 作者配置的字段 | 默认必填，长度固定 11 位，格式需为 1 开头第二位 3-9，占位文案「请输入您的手机号」 |
| 其它自定义字段 | 输入框（文本 / 数字 / 多行文本） | 作者配置的字段 | 可设为必填、可设最小与最大长度；不启用则不显示 |
| 阅读并同意 | 复选框 | 用户勾选 | 未勾选时「开启全景体验」按钮不可点击 |
| 《预约登记服务协议》 | 协议浮层 | 内置协议正文 | 点击后展开协议全文浮层 |
| 开启全景体验 | 提交按钮 | 用户填写的内容 | 逐项校验通过后提交登记并跳转作品播放页 |
| 暂不浏览，返回 | 文字链接 | 固定行为 | 放弃登记并返回上一页 |

### 校验规则

提交时按字段逐项校验：必填字段为空提示「{字段名}不能为空」；长度不足提示「{字段名}长度不能少于{N}个字符」；超出最大长度提示「{字段名}长度不能超过{N}个字符」；手机号格式不正确提示「请输入正确的手机号」；邮箱格式不正确提示「请输入正确的邮箱格式」。校验不通过时停留在当前页并给出第一条错误提示。

### 登记结果

校验通过后提交登记信息，成功后给出提示并自动进入该全景作品的播放页；失败时展示服务端返回的错误信息。

### 界面可选值

| 可选值 | 取值 | 说明 |
| --- | --- | --- |
| 姓名 | — | — |
| 手机号 | — | — |

## 4. 使用说明

1. 打开需要登记的作品，自动进入访客登记页
2. 阅读顶部提示，确认作者要求登记的原因
3. 按作者配置的字段填写内容（如姓名、手机号）
4. 点击《预约登记服务协议》查看协议全文，回到表单勾选「阅读并同意」
5. 点击「开启全景体验」提交登记
6. 登记成功后自动进入全景作品播放页；不想登记可点「暂不浏览，返回」离开

## 5. 规则与限制

- 未勾选《预约登记服务协议》时「开启全景体验」按钮保持禁用
- 必填字段为空无法提交，提示「{字段名}不能为空」
- 手机号必须为 11 位、1 开头且第二位为 3-9 的号码，否则提示「请输入正确的手机号」
- 邮箱字段必须符合常见邮箱格式，否则提示「请输入正确的邮箱格式」
- 字段长度受作者配置限制，默认姓名最长 20 字符
- 作者可以关闭某个字段，关闭后该字段不会出现在表单里

## 6. 状态与异常

- 加载配置：页面先按作品标识读取作者的登记配置与字段
- 待填写：按作者配置渲染出的字段为空，「开启全景体验」按钮为禁用态
- 校验失败：给出第一条错误提示，停留在表单页
- 提交中：按钮显示「请稍等...」的加载态
- 登记成功：提示成功后自动跳转全景播放页
- 必填校验失败：提示「{字段名}不能为空」
- 长度校验失败：提示「{字段名}长度不能少于{N}个字符」或「{字段名}长度不能超过{N}个字符」
- 格式校验失败：提示「请输入正确的手机号」或「请输入正确的邮箱格式」
- 提交失败：展示服务端返回的错误信息

## 7. 相关文档

### 目录导航

- 所属目录索引：[/tour/error](https://9kvr.cn/site/tour/error/llms.txt)
- 上一篇：[作品冻结提醒](https://9kvr.cn/site/tour/error/frozenPanorama.md)
- 下一篇：[全景制作进度](https://9kvr.cn/site/tour/error/makeLoading.md)

### 同目录文档（9）

- [作品审核状态提醒](https://9kvr.cn/site/tour/error/audit.md)
- [作品访问受限](https://9kvr.cn/site/tour/error/delError.md)
- [作品冻结提醒](https://9kvr.cn/site/tour/error/frozenPanorama.md)
- [全景制作进度](https://9kvr.cn/site/tour/error/makeLoading.md)
- [作品不支持编辑](https://9kvr.cn/site/tour/error/noEditor.md)
- [无权限提示](https://9kvr.cn/site/tour/error/permissionDeni.md)
- [权限错误提示](https://9kvr.cn/site/tour/error/privilegeError.md)
- [浏览密码验证](https://9kvr.cn/site/tour/error/pwdError.md)
- [作品异常提示](https://9kvr.cn/site/tour/error/tourError.md)

### 相关主题

- [全景主页（历史链接地址）](https://9kvr.cn/site/tour/index.md)
- [作品异常提示](https://9kvr.cn/site/tour/error/tourError.md)
- [访客留资配置](https://9kvr.cn/site/tour/editor/config/basic/getGuestInfo.md)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-21 00:05:20
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验