OCR Android SDK 接入

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

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 errorCode 返回码，识别成功返回 0，result非空。识别失败返回非0，result为空。
 * @param errorMsg  返回信息
 * @param result 识别结果类
 */
void onFinish(String errorCode, String errorMsg, 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; //签名信息

public String ocrId;//识别的唯一标识
public String bankcardNo;//识别的银行卡号
public String bankcardValidDate;//识别的银行卡的有效期
public String orderNo;//每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
public String warningMsg;   //识别的警告信息
public String warningCode;  //识别的警告码
public Bitmap bankcardNoPhoto;//识别的银行卡的卡号图片
public String ocrId;  //识别的唯一标识
public String bankcardNo; //银行卡号
public String bankcardValidDate; //银行卡的有效期
public String orderNo; // 每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
public String warningMsg;
public String warningCode;
public String bankcardNoPhoto;
public String bankcardNoPhotoSrc; //银行卡的卡号切边图的路径
public String bankcardFullPhotoSrc;//银行卡图片存放路径
public String retry;
public String sign;
//新增
public String multiWarningCode;//多重告警码
public String multiWarningMsg;//多重告警信息
public String clarity;//清晰度得分
//新版本新增字段
public String bankcardName;//银行卡名称
public String bankcardType;//银行卡类型
public String bankcardInfo;//银行卡信息

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

/**
  * 退出 SDK,返回第三方的回调,同时返回ocr识别结果
  */
public interface IDCardScanResultListener{
/**
 * 退出SDK,返回第三方的回调,同时返回ocr识别结果
 * @param errorCode 返回码，识别成功返回 0
 * @param errorMsg  返回信息
 * @param result 识别结果类
 */        
void onFinish(String errorCode, String errorMsg, Parcelable result);
}

public String ocrId;//识别的唯一标识
public String bankcardNo;//识别的银行卡号
public String bankcardValidDate;//识别的银行卡的有效期
public String orderNo;// 每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
public String warningMsg;   //识别的警告信息
public String warningCode;  //识别的警告码
public Bitmap bankcardNoPhoto;//识别的银行卡的卡号图片
public String ocrId;  //识别的唯一标识
 public String bankcardNo; //银行卡号
 public String bankcardValidDate; //银行卡的有效期
 public String orderNo; // 每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
 public String warningMsg;
 public String warningCode;
 public String bankcardNoPhoto;
 public String bankcardNoPhotoSrc; //银行卡的卡号切边图的路径
 public String bankcardFullPhotoSrc;//银行卡图片存放路径
public String retry;
 public String sign;
//新增
public String multiWarningCode;//多重告警码
public String multiWarningMsg;//多重告警信息
public String clarity;//清晰度得分
 //新版本新增字段
public String bankcardName;//银行卡名称
 public String bankcardType;//银行卡类型
 public String bankcardInfo;//银行卡信息

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

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

# 在 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.WBOCRSDKTypeBankSide, 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
) {
         // 登录成功  第三方应用对扫描的结果进行操作
// resultCode如果为0，则parcelableResult对象不为空。
// resultCode如果不为0，则parcelableResult对象为空。
runOnUiThread(new Runnable() {
    @Override
    public void run() {
        if (!“0”.equals(resultCode)){
            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();
        }

    }
});
               

// 登录成功  第三方应用对ocr结果进行展示等操作
// TODO: 客户自己处理结果，下面代码仅供参考
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);
}
});
}
@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();
}
}
});