@ capgo/ 电容- document- scanner

用本地扫描仪扫描纸文档 UI: VisionKit 在iOS上和Google ML Kit 在Android上查找页面边缘,修复视角并返回干净的图像. 在您的应用程序中添加收件, ID 或合同抓取, 不建立相机屏幕 .

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-document-scanner 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/capor-document-scanner到我的Capacitor应用上,并把它接上 代理设置指南 • 妇女 主机磁共振

主要特点

• 原生扫描仪 UI数字 : scanDocument() 打开iOS上的VisionKit文档相机和Android上的ML Kit文档扫描器,并自动进行边缘检测和视角校正.
• 多页扫描: 在一个会话中获取最多24页,或通过 maxNumDocuments: 1 用于单页模式。 Android在那页之后就停了 在iOS上,相机只在 iosVisionKitSwizzle 启用;默认的二进制在保存后将额外页面放下.
• 作物和审查:Android总是提供收成和旋转. 在iOS上,VisionKit在"保存"前显示其审查屏幕. 每次捕捉后强迫编辑器都是选入的 swizzle. 见 iOS App Store 审查。 。 。 .
• 图像清理: 调奏 brightness 财务报告和审定财务报表 contrast 在两个平台上。 关于Android, scannerMode 添加过滤器和ML清洗可以去除污点和手指.
• 灵活产出: 获取文件路径或基数64字符串 responseType外加一个 success 或者说 cancel 状态.
• 平台: iOS和Android. 互联网档案馆的存檔,存档日期2013-12-21. 不支持网络 : scanDocument() 拒绝为未执行.

文档

这里有最完整的医生: https://capgo.app/docs/plugins/文档-扫描器/

兼容性

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-document-scanner` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-document-scanner
npx cap sync

重要说明

Android 模拟器限制

ML Kit 文档扫描器 对Android模拟器不起作用这是Google Play Services和ML Kit对模拟设备的限制。 当测试您的应用程序时 :

• 使用一个 物理和机器人设备 用于测试文档扫描
• QQ Android 仿真器将显示错误 : “ Android 仿真器上不支持文档扫描器 ”

这一限制是由于:

• Google Play 服务与模拟环境的相容性问题
• ML Kit 文件扫描器需要实际的硬件相机能力
• 缺乏必要 ML Kit 运行时组件的模拟器

用于开发和测试,始终使用真正的Android设备.

iOS App Store 评论和 VisionKit swizzle

默认的iOS 二进制不包含私人的VisionKit swizzle. 这些呼叫载荷 VNDocumentCameraViewController_InProcess 与 NSClassFromString 交换 documentCameraController:canAddImages: 结束 method_exchangeImplementations。同一代码读取了私有的 UIKit 手势状态,以便打开裁剪编辑器。 iPhoneOS 27.1 SDK 仍然没有公开的页面限制或每封回调 VNDocumentCameraViewController。 。 。 .

接下来 @capgo/capacitor-social-login: swizzle 留在建筑外,除非应用选择进入.

默认构建 :

• 使用公众扫描 VNDocumentCameraViewController API (英语).
• maxNumDocuments 修剪保存后返回的页面。 相机仍然可以捕捉到到VisionKit的24页系统限制.
• letUserAdjustCrop 财务报告和审定财务报表 reviewCapturedDocument 每次抓取后不要强迫编辑器。 愿景 Kit自己在Save之前的审查屏幕没有变化.
• Android的行为没有改变.

在您需要iOS行为时启用 swizzle :

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    DocumentScanner: {
      iosVisionKitSwizzle: true,
    },
  },
};

export default config;

然后运行 bunx cap sync。命令将旗帜写入 Package.swift 财务报告和审定财务报表 CapgoCapacitorDocumentScanner.podspec 在已安装的插件中,下一个 iOS 构建汇编 CAPGO_DOCUMENT_SCANNER_VISIONKIT_SWIZZLE。去掉旗帜并运行 bunx cap sync 来运送默认的二进制.

兹编成:

• maxNumDocuments 达到极限时停止相机。 愿景 Kit自己的帽子还是24个.
• letUserAdjustCrop 每次抓取后打开 VisionKit 编辑器.
• reviewCapturedDocument 在下次抓取前显示当前页面,在达到限制时编辑器仍然打开.
• 二进制包含 method_exchangeImplementations私人班级的检查 和私人手势读取。 Android没有改变.

这会让App Store审查更加困难. 静态分析可能命名 method_exchangeImplementations,您仍然可以解释评论注释中的用法: swizzle只将页数盖上并打开Apple文档扫描器内的编辑器. 它不会读取私人用户数据,也不会改变屏幕外的任何内容. 一些提交材料受到质疑,并在解释后获得批准。 其他人则没有提及这个符号。 批准是每份呈文,所以之前的通行证不会决定下一个二进制.

演示

扫描一个音符

iOS系统	机器人

API 密码

• scanDocument(...)
• 接口
• 类型异名
• 数字

扫描文档(...)

scanDocument(options?: ScanDocumentOptions | undefined) => Promise<ScanDocumentResponse>

打开设备相机并开始文档扫描体验.

回返情况: Promise<ScanDocumentResponse>

接口

扫描文件回复

扫描文档选项

类型异名

响应类型

'basic' | 'cors' | 'default' | 'error' | 'opaque' | 'opaqueredirect'

数字

扫描文件响应状态

响应类型

扫描机模式

贷方

此插件是原版的重执行 https://document-scanner.js.org (中文(简体) ) 谢谢你的原作 我们用更现代的SDK重新编码了它 但爆炸了相同的API