IdCardOCR

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Android 开发环境（Android Studio + JDK），可编译运行仓库中的 Java 工程
• 一台带摄像头的 Android 设备或模拟器，用于调用内置扫描界面
• 识别过程离线运行，不需要网络权限

安装与启动步骤

1. 1获取项目源码

   将仓库克隆到本地，作为 Android 工程用 Android Studio 打开；README 未给出 Maven/Gradle 依赖坐标，需以仓库实际模块配置为准。

   git clone https://github.com/XieZhiFa/IdCardOCR.git

   复制

2. 2初始化识别引擎

   在 Application 中调用 initOCR 完成初始化，传入 Context，保证扫描前引擎已就绪。

   OcrDecodeFactory.initOCR(context);

   复制

3. 3启动扫描界面

   用 Builder 设置请求码、证件类型与结果广播，再调用 startOcrActivity 打开内置扫描界面。

   OcrDecodeFactory.newBuilder(context)
     .requestCode(REQUEST_CODE)
     .ocrType(binding.type.getSelectedItemPosition())    //0身份证, 1驾驶证, 2护照
     .broadcastAction(broadcastAction)
     .startOcrActivity();

   复制

4. 4接收识别结果

   在 onActivityResult 中按 requestCode 与 resultCode 判断，从 Intent 取出 OCRResult 字符串。

   @Override
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
       super.onActivityResult(requestCode, resultCode, data);
       if(requestCode == REQUEST_CODE && resultCode == RESULT_OK){
           String result = data.getStringExtra("OCRResult");
       }
   }

   复制

5. 5解析结构化字段

   把 OCRResult 当作 JSON 解析，按 type、name、sex、folk、birt、num、addr、issue 等键取值展示或入库。

   JSONObject jo = new JSONObject(result);
   String name = (String) jo.opt("name");
   String num = (String) jo.opt("num");
   String addr = (String) jo.opt("addr");

   复制

关键配置

如何确认成功

调用内置扫描界面扫描一张身份证，在 onActivityResult 中能取到 OCRResult 并解析出姓名、号码、住址等字段即成功。

常见问题

注意事项

• 结果字段名以 README 示例为准（type、name、sex、folk、birt、num、addr、issue 等），解析时注意类型判断
• README 只提供调用示例，未给出 Gradle/Maven 坐标与权限声明，集成时需自行核对工程配置
• 项目为 Android/Java 实现，需在 Android 应用中使用，不是独立可执行程序