VisionKit 文档扫描仪
让用户使用相机扫描纸质文档,并通过您 Web 应用的文件上传功能上传——由 Apple VisionKit 驱动。
文档扫描仪功能会在应用的标准文件上传选择器中添加扫描文稿选项。用户可以使用相机扫描一页或多页;应用生成文档扫描件,并通过您的 Web 应用使用的标准 <input type="file"> 流程上传。该功能由 Apple 的 VisionKit 框架(VNDocumentCameraViewController)驱动——支持自动边缘检测、裁剪和图像增强。
启用方法:
在 Config.swift 中开启此功能:
var kVisionKitEnable = true
设置为 false 可隐藏扫描文稿选项。
用户体验:
- 在您的网页上,用户点按
<input type="file">。 - 应用显示上传对话框,其中包含扫描文稿、相机和照片图库等选项。
- 点按扫描文稿会启动 VisionKit 扫描仪:它会检测边缘、裁剪并增强每一页,还允许添加更多页面。
- 生成的扫描件会被送回
<input type="file">——您的 Web 应用会像接收任何其他上传文件一样接收它。
注意:需要 iOS 18.4 或更高版本,以及支持 VisionKit 文档相机的设备。在不受支持的设备上,扫描文稿选项会自动隐藏。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 iOS 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for iOS 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 iOS 用户提供原生应用外壳。