图文解说ChinaCock的百度OCR

今天，拿到作者集成最新的百度OCR的控件，因为以前的版本一直存在这个问题：BaiduOCR本地模型加载失败，所以迫不及待的想用到app中，看有没有解决题。

这个版本总体来说改动不大，但关键集成最新的百度OCR android SDK，改动相对来说还是不小的。有关最新的百度OCR Android SDK的内容，可以看官方发布的 Android SDK部分的资料，作为复习的内容，建议还是先做做功课，这里我就不重复了。

官方现在发布到2.0.0版本，2022年2月17日发布，最重的就是增强了安全性，也因此需要我们去他的应用管理页面去生成一个安全文件aip-ocr.license，然后要同app一起发布出去。

如何生成并下载这个aip-ocr.license文件？

1.我现在已经在百度平台建立了应用，所以我直接来到应用列表，在这个页面中，选择一个应用，然后点“管理”，进入对应的应用详情页面：：

下图为进入的应用详情页面，点编辑，将进入修改应用信息页面： 

进入修改应用信息页面，这里要输入应用的包名及签名的MD5，如下图：

对于Delphi开发者来说，取得签名的MD5，可以直接在项目的签名管理界面得到，当然你也可以用签名工具在命令行得到。

如下图，是Delphi项目的应用设置窗口，点击标识的按钮 Alias Info，在弹出窗口中就可以看到签名信息，其中就有MD5.

拿到应用签名的MD5， 填好MD5,点“保存修改“，返回到应用详情，然后点下图中标识的按钮，就下载到了这个aip-ocr.license

如果以前你没用过百度的开发接口，这块确实是个麻烦事。当然了，这是我编辑一个已经存在的应用。如果是新建一个应用的话，可以直接填写包名及MD5的。如下图：

准备工作做好了，接下来，我们回到Delphi，看看如何使用ChinaCock的BaiduOCR控件。

1.建立一个新的测试项目，然后拖一个CCBaiduOCR控件上来

2.获取Token，直接上代码，这里AK与SK是你在百度平台建立一个应用时得到的值:

procedure TMainForm.InitBaiduOCR;
begin
{$IFDEF ANDROID}
      // 这是2.0以前版本的方式.获取AccessToken
      //Self.CCBaiduOCR1.initAccessTokenWithAkSk('你的AK', '你的SK');

       // 2.0.0版本：授权文件（安全模式）获取AccessToken
       self.CCBaiduOCR1.initAccessTokenLicenseFile;
{$ENDIF}
end;

3.处理CCBaiduOCR1事件nitAccessTokenWithAkSkResult

当第二步取得Token后，会触发这个事件，直接代码了,对于2.0版本的SDK，要调用IDcardQualityProcessInit，这很重要，可以理解为初始化扫描身份证的模型，保证这个方法只调用一次是官方的建议。：

procedure TMainForm.CCBaiduOCR1InitAccessTokenWithAkSkResult(Sender: TObject; AErrorCode: Integer; AErrorMsg, AToken: string);
begin
  if AErrorCode = 0 then
  begin
    FBaiduOCRToken := AToken;

    //2022.04.21版本  token获取成功后 调用
    self.CCBaiduOCR1.IDcardQualityProcessInit;

    // showmessage('获取token成功!' + #13#10 + AToken);
  end
  else
  begin
    FBaiduOCRToken := '';
    // showmessage('获取token失败!' + #13#10 + AErrorMsg);
  end;
end;

3.启动扫描：

 CCBaiduOCR1.TagString := 'OCR_id_card_front_native';//扫身份证正面
 CCBaiduOCR1.OCR_id_card_front_native;//开始扫描身份证正面

 当扫描成功后，会触发CCBaiduOCR1的事件OnRecognizeResult，在这里事件，我们处理扫描的结果，下面是这个事件的原型：

procedure TMainForm.CCBaiduOCR1RecognizeResult(Sender: TObject; AOCRType: TCCBaiduOCRType;
  AErrorCode: Integer; AErrorMsg, AFilePath, AJosonResult: string;
  AIDCardInfo: TCCIDCardInfo; ABankCardInfo: TCCBankCardInfo);
begin
  ShowMessage(AFilePath);
end;

4.最后，当BaiduOCR控件所在的窗口销毁时，我们要调用IDcardQualityProcessReleaseModel方法，来释放模型，保证IDcardQualityProcessInit与这个方法配对使用是必须的。

procedure TMainForm.FormDestroy(Sender: TObject);
begin
  //2022.04.221 2.0.0版本 窗口destory的时候 释放模型
  self.CCBaiduOCR1.IDcardQualityProcessReleaseModel;
end;

关于代码部分就介绍完了。接下来，我们要修改AndroidManifest.template.xml，这部分简单，抄就行了。

处理AndroidManifest.template.xml文件：

1.增加权限：

 <!-- 百度OCR begin -->
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.CAMERA"/>
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
   <uses-feature android:name="android.hardware.camera2.full"/>
   <uses-feature android:name="android.hardware.camera"/>
   <uses-feature android:name="android.hardware.camera.autofocus" />
   <!-- 百度OCR end -->

2.增加Activity：

        <!-- 百度ocr begin -->
        <activity
            android:name="com.chinacock.ccfmx.baidu.ocr.ui.camera.CameraActivity"
            android:configChanges="screenSize|orientation"
            android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>
        <!-- 百度ocr end -->

再接下来，我们要发布百度Android SDK相关的文件：

1.在项目中加入jar文件，这里有两个文件要加入：

在项目如何加入jar文件，这里我以为你加过了，如果没加过，可以看我以前的文章。

2.发布资源文件及so文件，这里，我强烈建议你使用DeployMan来发布，利用这个工具，直接选择ChinaCock带的发布目录Android，再选择包含子目录就OK了，不要使用Delphi的发布功能，一个文件一个文件发布，这样会让人生不如死。

关于DeployMan的使用方法，我也有写过，可以去看看：

DeployMan,发布文件的利器

这里还有一点注意，利用发布工具会把上图中选择的目录中的所有文件发布出去，这会包括64位的SO，需要手工删除掉，不然会造成闪退，切记！

最后，我们还要发布最开始下载到的aip-ocr.license：

这里有两点要注意：
1.文件名不能变，必须用aip-ocr.license

2.发布目录要对：asset\baidu_ocr

不然的话，在获取token会产生错误，不能正确取得token，那就无法再继续执行其他的动作了。

 最后，贴张我实作的界面：