跳到主要内容

文档扫描器预览画面卡住

快速修复

大多数问题可在 5 分钟内解决。 在 iPhone 和 iPad 上，正常的预览应保持打开状态且无需刷新。 如果扫描器停留在“Initializing camera…”，请等待最多 15 秒。 出现 Retry 后，请选择它。

当办理入住期间 Document Upload 中的摄像头画面停止移动时，请使用本指南。 AVA 会自动恢复常见的摄像头暂停情况。 在摄像头启动期间，如果你离开 Document Upload，AVA 会在你重新打开它之前释放摄像头。 在 iPhone 和 iPad 上，AVA 不会根据帧数检查刷新正常的预览。 这也包括使用桌面模式浏览的 iPad。

快速参考​

你看到的情况原因处理方法
iPhone 或 iPad 的预览保持打开，同时证件在移动预览正常继续扫描，无需刷新
屏幕锁定后预览卡住扫描器仍保持打开时，设备暂停了摄像头解锁设备并等待 AVA 恢复预览
预览停留在同一张图像上摄像头停止提供新帧等待恢复，然后在显示时使用 Retry
摄像头在离开扫描器后仍不可用扫描器关闭后摄像头才完成启动重新打开 Document Upload，然后再次扫描
扫描器停留在“Initializing camera…”摄像头启动未完成等待最多 15 秒，然后选择 Retry
扫描期间出现摄像头错误摄像头暂时不可用、正忙或受到干扰等待自动恢复，然后使用仅限扫描器的 Retry
摄像头权限被拒绝设备未授予摄像头访问权限在设备设置中允许摄像头访问，然后重新打开扫描器
预览在同一台设备上再次卡住摄像头仍不稳定重启设备并联系支持人员
Android 自助机在 "Hold steady" 上一直显示绿色画面捕获需要恢复，或自助机使用的是较旧的应用会话重新加载自助机应用，然后再次扫描
自定义扫描器停留在“Hold very still”扫描器切换到了另一种证件轮廓重启 Document Upload，然后再次扫描
Android 显示空白取景器或摄像头启动消息摄像头权限、其他应用或摄像头初始化阻止了启动按照 Android 摄像头启动修复方法 操作

Android 摄像头无法启动​

你看到的情况： Android 取景器为空白，或 AVA 显示摄像头启动消息。

摄像头无法启动时，AVA 可能会显示摄像头指导，而不是证件上传错误。 摄像头成功启动前，不会上传证件。 自动恢复会重试临时故障，而不会重新加载客人的办理入住流程。

解决方法：

  1. 如果 AVA 请求摄像头访问权限，请选择 Allow。

  2. 关闭其他摄像头应用和重复打开的 AVA 标签页。

  3. 等待 AVA 重试摄像头。

  4. 如果出现 Retry，选择一次。

  5. 如果消息显示摄像头正在使用中，请关闭其他摄像头应用。

  6. 仅当扫描器仍不可用时，重新打开 Document Upload。

  7. 如果摄像头仍然无法启动，请使用另一台自助机或平板。

    ✓ 扫描前，取景器应显示实时摄像头画面。

Android 自助机停留在“Hold steady”​

你看到的情况： Android 自助机显示绿色的 Hold steady 消息，持续 10–20 秒。

解决方法：

  1. 将证件放在指引框内并保持稳定。

  2. 如果自助机最近收到应用更新，请重新加载自助机应用。

  3. 等待摄像头自动恢复。

  4. 如果 AVA 显示 Retry，请选择它。

  5. 再次扫描证件。

    ✓ 扫描器应正常捕获，不再长时间显示绿色画面。

更新后的扫描器会自动恢复失败的捕获并重启摄像头。 自动恢复会保留当前客人的办理入住流程和未保存的字段。 你无需更改扫描器阈值或安全设置。

如果重新加载应用后扫描器仍一直显示绿色画面，请按照预览一直显示同一帧操作。

自定义扫描器停留在“Hold very still”​

你看到的情况： 自定义扫描器在证件轮廓发生变化后仍不断显示“Hold very still”。

AVA 现在会在选择其他证件轮廓时清除较早的清晰度样本。 这样可以避免较早的清晰区域阻止捕获完整证件。

解决方法：

  1. 将完整证件放在指引框内。

  2. 在均匀光线下保持设备稳定。

  3. 如果消息仍然显示，请关闭并重新打开 Document Upload。

  4. 再次扫描证件。

  5. 如果重启扫描后清晰的证件仍无法捕获，请联系支持人员。

    ✓ 扫描器应在不更改安全设置或阈值的情况下完成捕获。

扫描器停留在“Initializing camera…”​

你看到的情况： 扫描器显示“Initializing camera…”的时间超出预期。

当权限可用时，AVA 现在会在约 15 秒后结束卡住的摄像头启动过程。 待处理的权限提示可能会让扫描器一直等待，直到你作出选择。

解决方法：

  1. 保持当前办理入住页面打开最多 15 秒。

  2. AVA 显示 Retry 后，请选择它。

  3. 如果设备或浏览器询问，请允许摄像头访问。

  4. 在自助机 iPad 上，将 AVA 网站的摄像头访问权限设为 Allow。

  5. 如果摄像头仍不可用，请关闭并重新打开 Document Upload。

  6. 如果同一问题再次出现，请重启设备。

    ✓ 扫描器应显示实时预览，无需重启整个办理入住流程。

如果扫描器仍无法启动，请使用另一台自助机或平板，并联系支持人员。

摄像头在离开扫描器后仍不可用​

你看到的情况： 你在摄像头启动期间离开 Document Upload，下一次扫描无法使用摄像头。

AVA 会取消之前的启动过程，并关闭在你离开后才打开的摄像头。 你不应需要重新加载整个办理入住页面。

解决方法：

  1. 离开 Document Upload 后等待几秒。

  2. 重新打开 Document Upload。

  3. 如果 AVA 显示 Retry，请选择它。

  4. 再次扫描证件。

  5. 如果摄像头仍不可用，请关闭其他摄像头应用或重复打开的 AVA 标签页。

    ✓ 扫描器应显示实时预览，无需重新加载整个页面。

如果摄像头仍无法启动，请重启设备并使用另一台自助机或平板。

iPhone 或 iPad 的预览保持打开​

你看到的情况： 客人移动证件时，预览保持打开。

解决方法：

  1. 继续将证件放在取景框内调整位置。

  2. 等待证件捕获完成。

    ✓ 扫描时，AVA 会让正常的 iPhone 或 iPad 预览保持打开。

屏幕锁定后预览卡住​

你看到的情况： 解锁设备后，扫描器显示最后一帧画面。

解决方法：

  1. 解锁设备。

  2. 最多等待 5 秒。

  3. 暂时不要切换界面。

  4. 如果预览看起来仍然卡住，请关闭 Document Upload。

  5. 重新打开 Document Upload 并再次扫描。

    ✓ 摄像头预览应在下一次扫描前恢复移动。

预览一直显示同一帧​

你看到的情况： 扫描器保持打开，但图像没有变化。

解决方法：

  1. 等待 AVA 检测到预览停滞。

  2. 出现仅限扫描器的 Retry 时，选择它。

  3. 再次尝试扫描。

  4. 如果 Retry 未能恢复预览，请关闭并重新打开扫描器。

  5. 如果问题重复出现，请重启设备。

  6. 如果有其他自助机或平板，请换用另一台设备。

    ✓ 正常的摄像头应再次显示实时预览。

为什么会发生这种情况

某些设备会在屏幕锁定时暂停摄像头。 摄像头停滞也可能在不关闭扫描器的情况下停止提供新帧。 AVA 会跨平台重试暂停视频的恢复。 Android 也会使用预览卡住恢复机制。 iPhone 和 iPad 不使用帧数检查，因为这些数值可能不可靠。

摄像头错误不断出现​

你看到的情况： AVA 无法自动恢复摄像头，或 Retry 没有帮助。

解决方法：

  1. 让客人停留在当前办理入住页面。
  2. 选择一次仅限扫描器的 Retry。
  3. 确认没有其他应用正在使用摄像头。
  4. 检查设备是否仍允许摄像头访问。
  5. 如果 AVA 仍显示错误，请关闭并重新打开扫描器。
  6. 如果有其他自助机或平板，请换用另一台设备。

✓ 客人已完成的步骤和当前流程仍然可用。

权限拒绝需要更改设置

AVA 不会反复重试被拒绝的摄像头权限。 请在设备或浏览器设置中允许摄像头访问，然后重新打开扫描器。

仍然卡住？​

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

  • ❌ 重新打开扫描器后预览仍然卡住
  • ❌ 同一台设备每次都会卡住
  • ❌ 重启后客人仍无法继续办理入住

建议提供以下详细信息：

  • 设备型号
  • 浏览器版本
  • 是否先锁定了屏幕
  • 问题开始的时间