超简单集成华为 HMS MLKit 机器学习服务：银行卡识别 SDK，一键实现银行卡绑定

前言

小编前面几期文章分别给大家介绍了使用 HMS ML Kit SDK 实现微笑抓拍、证件照 DIY、拍照翻译的功能开发（链接见文章末尾），本次小编给大家带来的是使用 HMS 机器学习服务（ML Kit）银行卡识别 SDK，一键实现银行卡识别与绑定功能。

银行卡识别的应用场景

介绍开发步骤前，我们先来谈谈银行卡识别的具体应用场景，银行 APP、移动支付、缴费类 APP、电商类 APP 或者其它带支付功能的 APP 在使用过程中往往会遇到如下常见的几个应用场景：

绑卡支付
常用于支付类APP，或者带支付功能的APP，用来绑定信用卡、银联借记卡，提供在线支付功能
转账汇款
常用于银行或者支付类APP，用来给本行或者他行用户进行转账。
实名认证、身份审核
比如社交类APP，通过银行卡关联的身份信息完成快速的实名认证、身份审核等操作。

不管是绑卡、转账汇款还是身份审核，涉及到银行卡操作的都会遇到一个关键的步骤，录入银行卡信息，如银行卡号、有效期等；由于银行卡号码往往较长，手工录入很容易出错，而且手工录入卡号信息，操作繁琐，使用体验不佳；借助 HMS ML Kit 银行卡专用识别能力，则可以轻松应对以上场景，快速、精准的录入银行卡信息，改善用户使用体验。

如何使用华为银行卡识别服务

银行卡识别服务可以将银行卡信息通过视频流方式输入，得到图像中银行卡的卡号、有效期等重要文本信息。该服务配合身份证识别，可以为用户提供实名认证、身份审核、卡号录入等实用功能，降低输入成本，为用户提供更加友好的操作体验。

银行卡识别提供处理插件。开发者可以集成银行卡识别插件，无需实现相机视频流数据的处理，从而实现银行卡识别能力的快速集成。

集成银行卡识别服务关键流程

由于华为提供了银行卡识别插件，开发者可以直接调用银行卡插件，因此开发步骤更加简单了，仅仅需要拉起界面获取结果就可以完成卡号的识别。

开发实战

1 开发准备

1.1 在项目级 gradle 里添加华为 maven 仓

打开 AndroidStudio 项目级 build.gradle 文件，增量添加如下 maven 地址：

buildscript {
    repositories {
        maven {url 'http://developer.huawei.com/repo/'}
    }
}
allprojects {
    repositories {
        maven { url 'http://developer.huawei.com/repo/'}
    }
}

1.2 在应用级的 build.gradle 里面加上 SDK 依赖

dependencies {
    // 引入基础SDK
    implementation 'com.huawei.hms:ml-computer-vision-bcr:1.0.3.303'
    // 引入银行卡识别plugin包
    implementation 'com.huawei.hms:ml-computer-card-bcr-plugin:1.0.3.300'
    // 引入银行卡识别模型包
    implementation 'com.huawei.hms:ml-computer-card-bcr-model:1.0.3.300'
}

1.3 在 AndroidManifest.xml 文件里面增量添加模型自动下载

要使应用程序能够在用户从华为应用市场安装您的应用程序后，自动将最新的机器学习模型更新到用户设备，请将以下语句添加到该应用程序的 AndroidManifest.xml 文件中：

<manifest>
    ...
    <meta-data android:name="com.huawei.hms.ml.DEPENDENCY" android:value= "bcr"/>
    <!--If multiple models are required,set the parameter as follows:
       android:value="object,ocr,face,label,icr,bcr,imgseg"-->
   ...
</manifest>

1.4 在 AndroidManifest.xml 文件里面申请相机和存储权限

<!--相机权限-->
<uses-permission android:name="android.permission.CAMERA" />
<!--使用存储权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

2 代码开发关键步骤

2.1 创建识别结果回调函数

重载 onSuccess， onCanceled， onFailure， onDenied 四个方法；onSuccess 表示识别成功，MLBcrCaptureResult 为识别返回结果，onCanceled 表示用户取消，onFailure 表示识别失败，onDenied 表示相机不可用等场景。

private MLBcrCapture.Callback callback = new MLBcrCapture.Callback() {
    @Override
    public void onSuccess(MLBcrCaptureResult bankCardResult){
        // 识别成功处理。
    }
    @Override
    public void onCanceled(){
        // 用户取消处理。
    }
    // 识别不到任何文字信息或识别过程发生系统异常的回调方法。
    // retCode：错误码。
    // bitmap：检测失败的卡证图片。
    @Override
    public void onFailure(int retCode, Bitmap bitmap){
        // 识别异常处理。
    }
    @Override
    public void onDenied(){
        // 相机不支持等场景处理。
    }
};

2.2 设置识别参数，调用识别器 captureFrame 接口进行识别，识别结果会通过步骤2.1的回调函数返回。

private void startCaptureActivity(MLBcrCapture.Callback callback) {
    MLBcrCaptureConfig config = new MLBcrCaptureConfig.Factory()
         // 设置识别界面横竖屏，支持三种模式：
        // MLBcrCaptureConfig.ORIENTATION_AUTO: 自适应模式，由物理感应器决定显示方向。
        // MLBcrCaptureConfig.ORIENTATION_LANDSCAPE: 横屏模式。
        // MLBcrCaptureConfig.ORIENTATION_PORTRAIT: 竖屏模式。
        .setOrientation(MLBcrCaptureConfig.ORIENTATION_AUTO)
        .create();
    MLBcrCapture bankCapture = MLBcrCaptureFactory.getInstance().getBcrCapture(config);
    bankCapture.captureFrame(this, callback);
}

2.3 在检测按钮的回调中，调用步骤2.2中定义的方法，实现银行卡识别。

@Override
public void onClick(View v) {
    switch (v.getId()) {
        // 检测按钮。
        case R.id.detect:
            startCaptureActivity(callback);
            break;
        default:
            break;
    }
}

Demo效果

给大家看下 Demo 效果：

github源码

源码已经上传 github，大家也可以在 github 上一起完善该功能。

github 源码地址：https://github.com/HMS-MLKit/HUAWEI-HMS-MLKit-Sample

银行卡识别 demo 代码路径：MLKit-Sample\module-text\src\main\java\com\mlkit\sample\activity\BankCardRecognitionActivity.java

更详细的开发指南参考华为开发者联盟官网

华为开发者联盟机器学习服务开发指南

往期链接：

第一期：用华为 HMS MLKit SDK 三十分钟在安卓上开发一个微笑抓拍神器

https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201198419687680377&fid=18

第二期：安卓开发实战，用华为 HMS MLKit 图像分割 SDK 开发一个证件照 DIY 小程序

https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201203408959360433&fid=18

第三期：安卓开发实战，用 HMS MLKit 华为机器学习服务开发一个拍照翻译小程序

https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201209905778120045&fid=18

下期预告

基于华为机器学习服务，后面还会有一系列的实战经验分享，大家可以持续关注~