跳到主要内容

控制护照扫描预订查询和 ID Scan

快速设置

如果希望住客先扫描护照或身份证，请保持 Passport Scan Booking Lookup 开启。 如果希望 Room List 支持护照/身份证上传和人脸验证，请保持 ID Scan 开启。

本指南介绍如何在 Settings → Security → Identity Verification 中控制预订查询和证件扫描。 这两个开关相互独立，因此可以保持查询开启，同时更改 Room List 中证件上传的行为。 你还可以在同一部分配置 Innovatrics 摄像头阈值。

了解扫描器选择​

AVA 根据部署配置为你的物业选择证件扫描器。 你不能在 Identity Verification 中选择扫描器。

物业状态使用的扫描器如果扫描器无法启动或处理扫描
已加入自定义扫描器神经自定义扫描器AVA 将当前扫描器切换为 Innovatrics
未加入Innovatrics继续执行 Innovatrics 故障排查步骤

神经自定义扫描器会结合文档形状和文字证据。 这有助于减少纹理背景导致的误捕获。 神经扫描器仅适用于获准加入的物业。

扫描器回退

如果神经扫描器在设置、模型加载或扫描期间失败，AVA 会自动使用 Innovatrics。 回退状态会持续到你重新加载入住应用为止。

将物业回退到 Innovatrics​

请 Vouch 管理员或支持联系人将你的物业移出神经扫描器加入范围。 然后在每个自助终端或员工设备上重新加载入住应用。

✓ 新的扫描器会话将使用 Innovatrics。

不要通过更改摄像头阈值来控制神经扫描器加入状态。 这些阈值仅适用于 Innovatrics ID Scan。

快速参考​

设置控制内容对住客或员工的影响
Passport Scan Booking Lookup允许住客通过扫描护照或身份证开始 Self Check-In开启时，住客会直接进入查询
ID Scan启用查询后的 Room List 护照/身份证上传开启时，住客可以使用人脸验证和批量上传
Bulk Document Upload在 Room List 中显示 Upload All Documents员工可以在一次会话中扫描团队护照
Quick Lookup with Confirmation Number Suffix允许住客使用已配置的后缀搜索关闭 ID Scan 时会自动关闭
Facial Verification将自拍与证件文档进行比对关闭 ID Scan 时不可用
Innovatrics camera thresholds按设备类型调整眩光和亮度检查ID Scan 开启时可用

查找位置​

Settings → Security → Identity Verification

开启 Passport Scan Booking Lookup​

  1. 前往 Settings → Security → Identity Verification。

  2. 找到 Passport Scan Booking Lookup。

  3. 开启 Passport Scan Booking Lookup。

  4. 点击 Save Identity Verification。

    ✓ 住客可以通过扫描护照或身份证开始入住。

关闭 Passport Scan Booking Lookup​

  1. 前往 Settings → Security → Identity Verification。

  2. 找到 Passport Scan Booking Lookup。

  3. 关闭 Passport Scan Booking Lookup。

  4. 点击 Save Identity Verification。

    ✓ 住客会从 Reservation Lookup 开始，并输入确认号。

独立的查询设置

你可以关闭 Passport Scan Booking Lookup，而不关闭 ID Scan。 关闭 ID Scan 也会关闭护照扫描预订查询。 Room List 的护照/身份证上传仍由 ID Scan 控制。

开启 ID Scan​

  1. 前往 Settings → Security → Identity Verification。

  2. 找到 ID Scan。

  3. 开启 ID Scan。

  4. 点击 Save Identity Verification。

    ✓ 当各自的开关开启时，批量上传和人脸验证仍可用。

开启 Bulk Document Upload​

  1. 前往 Settings → Security → Identity Verification。

  2. 找到 Bulk Document Upload。

  3. 开启 Bulk Document Upload。

  4. 点击 Save Identity Verification。

    ✓ 当 ID Scan 也开启时，Room List 中会出现 Upload All Documents 横幅和弹窗。

默认行为

Bulk Document Upload 默认开启。 如果 ID Scan 关闭，AVA 仍会隐藏 Upload All Documents。

关闭 ID Scan​

  1. 前往 Settings → Security → Identity Verification。

  2. 找到 ID Scan。

  3. 关闭 ID Scan。

  4. 点击 Save Identity Verification。

    ✓ Quick Lookup with Confirmation Number Suffix 已禁用。 ✓ Facial Verification 控件为只读。 ✓ Upload All Documents 已隐藏。 ✓ 住客会从 Reservation Lookup 开始，并输入确认号。

依赖关系变化

当 ID Scan 关闭时，Passport Scan Booking Lookup 也会关闭。 当 ID Scan 关闭时，Quick Lookup with Confirmation Number Suffix 会被强制关闭。 Facial Verification 保持不可用，Upload All Documents 会被隐藏。 如果 Passport Scan Booking Lookup 也关闭，住客必须输入完整确认号。

调整文档扫描器的拍摄质量​

快速检查

如果住客漏扫，请先从眩光和亮度开始调整。

当 Innovatrics 对某个物业的扫描要求过严或过松时，可以使用此部分进行调整。 AVA 会将已保存的值限制在安全的拍摄规则范围内。 这些阈值分别应用于手机和较大屏幕的设备。 它们仅适用于 Innovatrics ID Scan，不影响自定义扫描器的行为。 扫描器现在会将拍摄裁剪区域与预览中显示的文档区域对齐。

自定义扫描器拒绝纹理背景​

使用自定义扫描器的物业无需新增设置即可获得这项保护。 扫描器会拒绝类似花岗岩、瓷砖或其他看起来像文档文字的纹理背景。 对于连续的安全样式图案，它会保留较短的打印字段。 它会将稀疏、细小的文字边缘排除在背景样本之外，因此仍能检测到短字段。 在支持的情况下，它仍接受细小、浅淡且略微倾斜的文档文字。 对于只有图案的区域，它会拒绝该区域，而不会将背景当作文档文字。

在拍摄完成前，请让文档保持完整可见且稳定不动。 如果清晰的照片比实时拍摄更方便，请使用 Upload Document。

扫描期间的预期表现​

即使文档与背景的亮度相近，AVA 也可以通过颜色对比检测文档边缘。 只要文档仍在视野中，即使短暂检测不到，轮廓也可以继续保持选中状态。 在保存图像前的保持过程中，AVA 会选择已验证的最清晰时刻。

请将文档保持在引导框内，并保持设备稳定，直到拍摄完成。

遵循摄像头指引​

在 Check-In 和 Pre-arrival 中，AVA 会短暂显示当前摄像头和文档方向。 提示包含手机或平板电脑图标，并与已打开的摄像头相匹配。 在 AVA 识别摄像头方向时，提示可能会在预览开始后稍晚出现。 提示会在约三秒后淡出，也会在你点击后淡出。 继续扫描不需要额外点击。

在 Upload All Documents 过程中，每个批量上传会话只显示一次提示。 同一会话中的其他文档或重新拍摄不会再次显示提示。 打开新的批量上传弹窗会开始新会话，并再次显示提示。 Assisted Check-In 不会显示动画提示。 自定义扫描器和 Innovatrics 扫描器遵循相同的提示策略。

扫描期间，预览角落会显示 Back camera 或 Front camera 徽标。 每种入住模式都可以看到该徽标。 如果你在批量提示期间切换摄像头，AVA 会在应用会话抑制前清除旧提示。 这样可以防止切换摄像头重新启动可见提示。 未检测到摄像头朝向的桌面摄像头不会显示摄像头提示。

临时提示消失后，请遵循徽标和文档引导框的指示。 如果提示稍晚出现，请将文档保持在引导框内，并遵循匹配的徽标。

清晰度如何决定是否拍摄​

AVA 使用两项清晰度检查：绝对下限和相对标准。 下限可防止过于模糊的图像进入提取流程。 相对标准会检查当前画面对这台摄像头是否足够清晰。 AVA 根据最近清晰度样本的中位数计算该标准。 一次短暂的自动对焦峰值不会再为整个扫描设置无法达到的标准。 AVA 锁定文档后，会在保持过程中冻结该参考值。

保持设备稳定

扫描器显示的清晰度值可能会短暂低于更早画面的值。 只要该画面对摄像头而言仍然足够清晰，仍可通过检查。

只扫描住客可看到的内容​

在平板电脑上，AVA 会检查屏幕引导框内显示的摄像头区域。 它不会选择可见预览上方或下方的文档。

文档后方的门框或架子不应使有效扫描失效。 但 AVA 仍需要文档边缘与背景形成清晰对比。

已移除的可见性控制

Min on-screen document fraction 控件已不再提供。 保存其他 Identity Verification 设置时，系统仍会接受已保存的旧值。 你不需要删除之前保存的值。

查找位置​

Settings → Security → Identity Verification

调整 Innovatrics 阈值​

  1. 打开 Settings → Security → Identity Verification。

  2. 在 ID Scan 下方找到 Advanced ID Scan camera thresholds。

  3. 分别调整手机和较大屏幕设备的 Innovatrics 阈值。

  4. 保存更改。

  5. 重新打开该部分，确认已保存的值。

    ✓ 新阈值会在下一次配置获取时生效。

安全组合

请输入 0 到 1 之间的值。 保持 Brightness low threshold 低于 Brightness high threshold。 如果字段留空，Innovatrics 会为该设备类别使用默认值。

字段控制内容空值时的行为
Glare threshold文档允许出现的眩光程度使用 Innovatrics 默认值
Brightness low threshold可接受的文档最低亮度使用 Innovatrics 默认值
Brightness high threshold可接受的文档最高亮度使用 Innovatrics 默认值
一次测试一种设备类别

手机和较大屏幕设备的值分别生效。 保存后，请在每种受影响的设备类别上进行一次新的入住测试。

将文档保持在引导框内​

扫描器不再通过可配置的可见比例标准阻止拍摄。 请将文档的每条边都保持在引导框内，以获得最清晰的拍摄结果。 保存的裁剪区域仍会限制在可见预览范围内。

如果文档较宽

即使文档占据引导框的大部分区域，也请保持文档平整且完整可见。 AVA 会将保存的裁剪区域保持在住客能够看到的范围内。

调试叠加层已不再提供​

扫描器诊断已更新

文档扫描器不再提供调试叠加层。 请使用屏幕引导和下方的故障排查步骤。

使用临时扫描器资源分析​

Vouch 可以为一个获准物业临时启用 Scanner diagnostics 面板。 此面板仅适用于使用神经自定义扫描器的物业。

临时支持功能

使用此功能前，请咨询 Vouch 管理员。 它不是 Identity Verification 中的设置，测试后应将其移除。

启用后，该面板允许你启动新的扫描器会话并下载本地 JSON 报告。 报告包含有关扫描器性能的有限数值和类别测量结果。 它不包含摄像头像素、文档裁剪图、张量、热图、OCR 内容、商户 ID 或入住 ID。 报告不会上传、记录或添加到分析数据中。

  1. 在获准物业上打开自定义文档扫描器。

  2. 打开 Scanner diagnostics。

  3. 选择 Start resource profile。

  4. 完成要求的测试扫描，然后下载 JSON 报告。

    ✓ 资源分析开始或停止时摄像头会重新启动，因此每份报告都涵盖一个干净的扫描器会话。

测试后，请 Vouch 管理员禁用资源分析。 禁用后会移除该面板，但不会更改神经扫描器的加入状态。

保存后会发生的变化​

  • Passport Scan Booking Lookup 开启：
    • 住客从护照或身份证扫描开始 Self Check-In。
  • Passport Scan Booking Lookup 关闭：
    • 住客从 Reservation Lookup 开始，并使用确认号。
  • ID Scan 开启：
    • 当 Bulk Document Upload 也开启时，Room List 可以显示 Upload All Documents。
    • 可以使用 Quick Lookup with Confirmation Number Suffix，并将其后缀长度设置为 4–10 个字符。
    • 可以启用 Facial Verification。
  • Bulk Document Upload 开启：
    • 员工可以在 Room List 中扫描多本护照。
    • Upload All Documents 横幅和弹窗会出现。
  • Bulk Document Upload 关闭：
    • 员工一次上传一份文档。
    • Room List 会隐藏批量上传横幅和弹窗。
  • ID Scan 关闭：
    • Passport Scan Booking Lookup 也会关闭。
    • Quick Lookup with Confirmation Number Suffix 已禁用。
    • Facial Verification 控件为只读。
    • Upload All Documents 已隐藏。
    • 住客从 Reservation Lookup 开始，并使用确认号。
  • 文档扫描器调整已启用：
    • 当 ID Scan 开启时，可以从同一安全设置部分调整 Innovatrics 摄像头阈值。
    • 手机和较大屏幕设备可以使用不同的阈值。
    • 获准物业可以使用神经自定义扫描器。
    • 未加入的物业使用 Innovatrics。
    • 神经运行时失败时，当前扫描器会自动切换为 Innovatrics。
    • 自定义扫描器会拒绝类似文档文字的纹理背景。
    • 这项自定义扫描器保护不需要更改设置。
    • 更改会在下一次配置刷新后生效。
  • 临时扫描器资源分析：
    • 获准物业可能会在支持主导的研究期间显示 Scanner diagnostics。
    • 此功能仅适用于神经自定义扫描器。
    • 报告在本地下载，不包含摄像头图像或文档内容。
    • 移除临时资源分析后会隐藏面板，但不会更改扫描器加入状态。
  • 文档裁剪：
    • 保存的图像会保持在可见预览区域内。
    • 即使宽文档填满引导框，也仍受支持。
  • 摄像头指引：
    • Check-In 和 Pre-arrival 会短暂标识实时摄像头和持文档方向。
    • 首次打开时，提示可能会在预览激活后稍晚出现。
    • Assisted Check-In 不会显示动画摄像头提示。
    • 批量上传每个弹窗会话显示一次提示，包括重新拍摄。
    • 打开新的批量上传弹窗会重置提示次数。
    • 扫描期间会持续显示 Back camera 或 Front camera 徽标。
    • 摄像头徽标在所有模式下都会显示。

故障排查​

缺少批量上传按钮​

你看到的情况： 在 Room List 中看不到 Upload All Documents。

解决方法：

  1. 开启 ID Scan。

  2. 开启 Bulk Document Upload。

  3. 点击 Save Identity Verification。

  4. 刷新 Room List，然后重试。

    ✓ 批量上传横幅会出现在房间卡片上方。

住客从确认号查询开始​

你看到的情况： Self Check-In 打开的是 Reservation Lookup，而不是护照扫描。

解决方法：

  1. 开启 ID Scan。

  2. 开启 Passport Scan Booking Lookup。

  3. 点击 Save Identity Verification。

  4. 开始新的 Self Check-In 会话，然后重试。

    ✓ 住客可以再次通过扫描护照或身份证开始。

独立的房间列表上传设置

如果你只需要 Room List 的护照/身份证上传，请保持 ID Scan 开启，并关闭 Passport Scan Booking Lookup。

末四位查询开关被禁用​

你看到的情况： 无法编辑 Quick Lookup with Confirmation Number Suffix。

解决方法：

  1. 开启 ID Scan。
  2. 点击 Save Identity Verification。
  3. 重新打开该部分，然后编辑 Quick Lookup with Confirmation Number Suffix。

人脸验证控件为只读​

你看到的情况： 人脸验证模式和阈值已禁用。

解决方法：

  1. 开启 ID Scan。
  2. 点击 Save Identity Verification。
  3. 重新打开 Identity Verification，如有需要再次启用 Facial Verification。

住客仍从完整确认号开始​

你看到的情况： Self Check-In 从完整确认号查询开始。

解决方法：

  1. 确认 ID Scan 已开启。
  2. 点击 Save Identity Verification。
  3. 开始新的 Self Check-In 会话并再次测试。

缺少摄像头阈值​

你看到的情况： 看不到 Advanced ID Scan camera thresholds。

解决方法：

  1. 开启 ID Scan。
  2. 点击 Save Identity Verification。
  3. 重新加载 Settings → Security → Identity Verification。
  4. 如果该部分仍缺失，请联系支持人员。

扫描器已切换为 Innovatrics​

你看到的情况： 你的物业原本使用自定义扫描器，随后扫描器切换为 Innovatrics。

原因： AVA 检测到神经扫描器启动、模型、推理或文字处理失败。

解决方法：

  1. 使用 Innovatrics 继续扫描。

  2. 再次测试自定义扫描器前，重新加载入住应用。

  3. 如果反复发生，请联系 Vouch 管理员。

    ✓ 在支持人员调查自定义扫描器期间，AVA 会保持当前入住流程可用。

阈值无法保存​

你看到的情况： 阈值字段恢复为之前的值。

解决方法：

  1. 输入 0 到 1 之间的值。

  2. 保持 Brightness low threshold 低于 Brightness high threshold。

  3. 点击 Save Identity Verification。

  4. 重新打开 Advanced ID Scan camera thresholds 并检查值。

    ✓ 有效值会在下一次配置刷新后保留。

调试叠加层不显示​

你看到的情况： 你期待看到实时扫描器值或裁剪诊断信息。

解决方法：

  1. 使用屏幕引导定位文档。
  2. 遵循下方的扫描器故障排查步骤。
  3. 如果清晰文档在多个设备上仍失败，请联系支持人员。

扫描器诊断不显示​

你看到的情况： 你期待看到 Scanner diagnostics，但面板缺失。

原因： 资源分析是临时功能，且只为一个获准物业启用。

解决方法：

  1. 确认物业使用神经自定义扫描器。

  2. Vouch 管理员启用资源分析后，刷新自助终端或员工设备。

  3. 如果面板仍缺失，请联系 Vouch 管理员。

    ✓ 普通扫描器会话会继续运行，不受资源分析影响。

扫描器要求将已在引导框内的文档居中​

你看到的情况： 文档已在引导框内，但扫描器持续显示定位指引，或没有检测反馈。

原因： 扫描器仍会检查文档清晰度、大小、稳定性和图像质量。 在平板电脑上，它只检查预览中显示的区域。 它不再仅因为背景存在明显的垂直边缘而拒绝拍摄。

解决方法：

  1. 确认文档的每条边都在引导框内可见。

  2. 在光线均匀的环境中将文档平放。

  3. 让文档保持在可见预览内，尤其是在平板电脑上。

  4. 保持设备稳定，直到扫描器确认文档。

  5. 如果文档边缘仍清晰，可以让门框或架子留在文档后方。

  6. 如果消息持续显示，请选择 Upload Document 并选择清晰照片。

  7. 如果多个设备都持续出现问题，请联系支持人员。

    ✓ 扫描器应选择预览中显示的文档。

扫描器持续显示保持稳定并改善对焦​

你看到的情况： 扫描器持续显示“保持稳定并改善对焦”。 下限行通过了，但相对清晰度行失败。

解决方法：

  1. 将文档的每条边都保持在引导框内。

  2. 在光线均匀的环境中保持设备稳定。

  3. 避免文档上出现眩光、阴影和移动。

  4. 如果消息持续显示，请关闭 Document Upload 并重新开始扫描。

  5. 如果重新开始扫描后扫描器仍拒绝清晰文档，请联系支持人员。

    ✓ 文档保持清晰稳定后，扫描器应完成拍摄。

打印文字位于图案背景上​

你看到的情况： 护照或身份证上的短打印字段位于重复的安全图案上方。

解决方法：

  1. 将完整文档保持在屏幕引导框内。

  2. 在光线均匀的环境中将其平放。

  3. 保持设备稳定，直到扫描器确认文档。

  4. 如果实时摄像头无法拍摄清晰图像，请尝试 Upload Document。

    ✓ 自定义扫描器会保留真实打印文字，而不会接受只有图案的区域。

批量上传提示不再出现​

你看到的情况： 其他文档或重新拍摄时，动画摄像头提示没有再次出现。

原因： AVA 每个 Upload All Documents 会话只显示一次提示。

解决方法：

  1. 遵循持续显示的 Back camera 或 Front camera 徽标。

  2. 将文档保持在屏幕引导框内。

  3. 如果需要再次显示提示，请关闭批量上传弹窗。

  4. 打开 Upload All Documents 以开始新会话。

    ✓ 新的批量上传会话开始时会出现动画提示。

仍然无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 保存后 ID Scan 更改未生效
  • ❌ 启用 ID Scan 后末四位查询仍被禁用
  • ❌ 开启 ID Scan 后人脸验证未重新启用
  • ❌ Innovatrics 摄像头阈值在下一次配置刷新后未生效
  • ❌ 扫描器反复拒绝引导框内完全可见的文档
  • ❌ 自定义扫描器在重复扫描期间切换为 Innovatrics

建议提供：

  • Identity Verification 的截图
  • 问题开始的时间
  • 商户 ID 或物业名称