OCR Android SDK 接入

defaultConfig {
    ndk {
          //设置支持的 so 库框架
          abiFilters 'armeabi-v7a', 'armeabi', 'arm64-v8a'
     }
}

android{
     //...
     repositories {
        flatDir {
            dirs 'libs' //this way we can find the .aar file in libs folder
        }
    }
}
//添加依赖
dependencies {
     //0. appcompat-v4
 compile 'com.android.support:appcompat-v4:23.1.1'
    //1. 云OCR SDK
      compile(name: 'WbCloudOcrSdk', ext: 'aar')
  //2.云公共组件
        compile(name: 'WbCloudNormal', ext: 'aar')    }


public class WbCloudOcrSDK{

/**
* 该类为一个单例，需要先获得单例对象再进行后续操作
   */
       public static synchronized WbCloudOcrSDK getInstance() {
       //    ...
       }
 /**
  * 初始化云Ocr SDK，完成登录
  * @param context        拉起SDK的context
  * @param wbocrtypemode  识别证件的模式，参数是枚举类型
  * @param data           第三方需要传入的参数
  * @param loginListener  登录SDK回调
  */
public void init(Context context,WBOCRTYPEMODE wbocrtypemode,Bundle data,OcrLoginListener loginListerner){
//    ...
}
   /**
     * 登录成功后，调用此函数拉起sdk页面
     * @param context                  拉起SDK的上下文
     * @param idCardScanResultListener 返回到第三方的接口
     */
    Public void startActivityForOcr(Context context,IDCardScanResultListener){
    // ...
 }
/**
  * 登录回调接口
  */
public interface OcrLoginListener {
        void onLoginSuccess();
        void onLoginFailed(String errorCode, String errorMsg);
    }

/**
 * 退出SDK,返回第三方的回调,同时返回ocr识别结果
 * @param resultCode 返回码， resultCode如果为0，则parcelableResult对象非空,有人像面结果或者国徽面的识别成功结果。resultCode如果不为0，则parcelableResult对象为空，无任何识别成功的结果。
 * @param errorMsg  返回信息
 * @param result 识别结果类
 */
        
void onFinish(String resultCode, String resultMsg, Parcelable result);

}


//这些都是WbCloudOcrSdk.InputData对象里的字段，是需要传入的数据信息
String orderNo;  //每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
String openApiAppId;  //APP_ID 
String openApiAppVersion;  //openapi  Version
String openApiNonce; //32位随机字符串
String openApiUserId; //user id
String openApiSign; //签名信息


/**
  * 调OCR 的模式
  */
public enum WBOCRTYPEMODE {
WBOCRSDKTypeFrontSide,//人像面模式，直接进入身份证人像面识别
WBOCRSDKTypeBackSide,//国徽面模式，直接进入身份证国徽面识别
WBOCRSDKTypeContinus,//连续识别模式，识别完身份证人像面后，接着识别身份证国徽面，而不是退出相机页面
}


/**
  * 登录回调接口
  */
public interface OcrLoginListener {
        void onLoginSuccess();//登录成功
          /**
           * @PARAM errorCode 登录失败错误码
           * @PARAM errorMsg  登录失败错误信息
           */        
         void onLoginFailed(String errorCode, String errorMsg);
    }


/**
  * 退出SDK,返回第三方的回调,同时返回ocr识别结果
  */
public interface IDCardScanResultListener{
        
/**
 * 退出SDK,返回第三方的回调,同时返回ocr识别结果
 * @param resultCode 返回码，识别成功返回 0，result不为空。识别失败返回非0，result为空。
 * @param resultMsg  返回信息
 * @param result 识别结果类
 */
        
void onFinish(String resultCode, String resultMsg, Parcelable result);
}


    // 识别人像面返回的信息
    public String cardNum;  //身份证号码
    public String name;//姓名
    public String sex;//性别
    public String address;//住址
    public String nation;//民族
    public String birth;//出生年月日
    public String frontFullImageSrc;// 身份证人像面预览完整图片文件路径
    public String frontWarning;//人像面告警码

    //识别国徽面返回的信息
    public String office;//签发机关
    public String validDate;//有效期限
    public String backFullImageSrc;//身份证国徽面预览完整图片文件路径
    public String backWarning;//国徽面告警码
    public String sign;//签名
    public  String orderNo; //每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
    public String ocrId;//识别的唯一标识

    //新版本新增的返回字段
    public String frontMultiWarning;//人像面多重告警码
    public String backMultiWarning;//国徽面多重告警码
    public String frontClarity;//人像面清晰度得分
    public String backClarity;//国徽面清晰度得分

    public String frontCropSrc;//身份证人像面切边照文件路径，需要调用方在调用初始化接口init()前配置WbCloudOcrConfig.getInstance().setRetCrop(true)，frontCropSrc才有返回值;默认空。

    public String backCropSrc;//身份证国徽面切边照文件路径，，需要调用方在调用初始化接口init()前配置WbCloudOcrConfig.getInstance().setRetCrop(true)，backCropSrc才有返回值;默认空。

    public String frontCode;//人像面code,code为0，说明人像面识别成功。不为0，说明人像面识别失败。
    public String frontMsg; //人像面msg
    public String backCode; //国徽面code,code为0，说明国徽面识别成功。不为0，说明国徽面识别失败。
    public String backMsg; //国徽面msg


# 在 MainActivity 中单击某个按钮的代码逻辑：
  //先将必填的 InputData 放入 Bundle 中
  data.putSerializable(WbCloudFaceVerifySdk.INPUT_DATA, inputData);
  //设置 SDK 扫描识别身份证的时间上限，如果不设置则默认 20 秒；设置了则以设置为准
  //此处设置 SDK 的扫描识别时间的上限为 20 秒
   data.putLong(WbCloudOcrSDK.SCAN_TIME, 20000);

WbCloudOcrConfig.getInstance().setRetCrop(retCrop);//设置是否返回切边图，true返回。默认false不返回

# 在 MainActivity 中单击某个按钮的代码逻辑：
//先填好数据 
  Bundle data = new Bundle();
        WbCloudOcrSDK.InputData inputData = new WbCloudOcrSDK.InputData(
                orderNo,
                appId,
                openApiAppVersion,
                nonce,
                userId,
                sign);
        data.putSerializable(WbCloudOcrSDK.INPUT_DATA, inputData);
  //个性化参数设置,可以不设置，不设置则为默认选项。
  
  //设置扫描识别的时间上限,默认 20 秒。用户有效设置范围是（0-60000）
  data.putLong(WbCloudOcrSDK.SCAN_TIME, 20000);
//初始化 SDK，得到是否登录 SDK 成功的结果 
        WbCloudOcrSDK.getInstance().init(MainActivity.this, WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeContinus,data, new WbCloudOcrSDK.OcrLoginListener() {
            @Override
            public void onLoginSuccess() {  //登录成功,拉起 SDK 页面                              
            WbCloudOcrSDK.getInstance().startActivityForOcr(MainActivity.this,new  WbCloudOcrSDK.IDCardScanResultListener() {  //返退出 SDK 回调接口
           
@Override
public void onFinish(final String resultCode, final String resultMsg, Parcelable parcelableResult) {
    // 登录成功  第三方应用对ocr结果进行展示等操作
    // TODO: 2023/5/18 客户自己处理结果，下面代码仅供参考
runOnUiThread(new Runnable() {
                            @Override
                            public void run() {
                                if (parcelableResult==null){
                                    Toast.makeText(MainActivity.this,"识别结果为空，code="+resultCode+" msg="+resultMsg,Toast.LENGTH_SHORT).show();
                                }else {
                                    Toast.makeText(MainActivity.this,"有识别结果，code="+resultCode+" msg="+resultMsg,Toast.LENGTH_SHORT).show();
                                }

                            }
                        });


    Intent i;
    if (type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeBankSide)) {
        //银行卡识别，跳转到银行卡结果展示页面
        i = new Intent(MainActivity.this, BankOcrResultActivity.class);
        i.putExtra("bankcardresult", parcelableResult);
        i.putExtra("appId", appId);
        i.putExtra("envUrl", envUrl);
    } else if (type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeNormal) ||
            type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeContinus) ||
            type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeFrontSide) ||
            type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeBackSide)) {
        //身份证识别，跳转到身份证结果展示页面
        i = new Intent(MainActivity.this, ResultActivity.class);
        i.putExtra("idcardresult",parcelableResult);
    } else if (type.equals(WbCloudOcrSDK.WBOCRTYPEMODE.WBOCRSDKTypeDriverLicenseSide)) {
        //驾驶证识别，跳转到驾驶证结果展示页面
        i = new Intent(MainActivity.this, DriverLicenseOcrResultActivity.class);
        i.putExtra("driverlicenseresult",parcelableResult);
    } else {
        //行驶证识别，跳转到行驶证结果展示页面
        i = new Intent(MainActivity.this, VehicleLicenseOcrResultActivity.class);
        i.putExtra("vehiclelicenseresult",parcelableResult);
    }
    startActivity(i);
}
});
}              
@Override
public void onLoginFailed(String errorCode, String errorMsg) {
if(errorCode.equals(ErrorCode.IDOCR_LOGIN_PARAMETER_ERROR)) {
Toast.makeText(MainActivity.this, "传入参数有误！" + errorMsg, Toast.LENGTH_SHORT).show();
} else {
Toast.makeText(MainActivity.this, "登录 OCR SDK 失败！" + "errorCode= " + errorCode + " ;errorMsg=" + errorMsg, Toast.LENGTH_SHORT).show();
}
}
})