访客登记

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

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. 使用说明

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

5. 规则与限制

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

6. 状态与异常

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

访客登记

1. 页面信息

2. 功能说明

3. 业务说明

界面结构

校验规则

登记结果

界面可选值

4. 使用说明

5. 规则与限制

6. 状态与异常

7. 相关文档

目录导航

同目录文档（9）

相关主题

8. 文档信息