二维码距离远、反光、遮挡,怎么办?不用担心,华为HMS Scan kit 统统帮您搞定

3,684

前言

  前几天,小编外出shopping完,美滋滋的准备开车回家,结果被车库的支付二维码拦住了,距离太远,一直无法识别,后面的车主还使劲催促,搞得我很烦躁啊。回家后和朋友吐槽,没得到安慰不说,还强行加入了一个关于二维码反光、遮挡的大型吐槽现场。

  扫码功能不是已经使用很久了吗?怎么还有这么多问题?

  后来无意中在外网上看到一篇关于华为 HMS Scan kit的介绍,小编顺着文章发现在华为开发者联盟网站上可以下载APK体验,赶紧试了试效果。华为 HMS Scan kit功能果然强大,轻松解决远距离、反光、损坏、遮挡等复杂扫码场景。

效果展示

远距离扫码 在这里插入图片描述 反光扫码 在这里插入图片描述 损坏、遮挡扫码 在这里插入图片描述

  小编发现,华为HMS Scan kit还可以实现任意角度扫码、曲面扫码、同时识别多个码等,支持13种全球主流码,完全可以满足生活、工作等各类场景使用需求。

  大家可以戳下方链接,亲身感受下:developer.huawei.com/consumer/cn…

  重点来了,这么好用、强大的扫码服务功能,怎么获得呢?

  不要着急,小编已经帮大家把开发流程搬过来了,快来集成吧!

开发实战

1 配置AppGallery Connect

  在开发应用前,需要在AppGallery Connect中配置相关信息。包括:

  • 注册成为开发者。

  • 创建应用。

  这里就不多介绍了,大家可以参考官网操作: developer.huawei.com/consumer/cn…

2 集成HMS Core SDK

2.1 添加当前应用的AppGallery Connect配置文件

  如果在AppGallery Connect中开通了相关服务则需要将“agconnect-services.json”文件添加到您的App中。

  1、登录AppGallery Connect网站,点击“我的项目”。

  2、在项目列表中找到您的项目,在项目中点击需要集成HMS Core SDK的应用。

  3、在“项目设置 > 常规”页面的“应用”区域,点击“agconnect-services.json”下载配置文件。

  4、将“agconnect-services.json”文件拷贝到应用级根目录下。 在这里插入图片描述

2.2 配置HMS Core SDK的Maven仓地址   1、打开Android Studio项目级“build.gradle”文件。 在这里插入图片描述

  2、添加HUAWEI agcp插件以及Maven代码库。

  • 在“allprojects > repositories”中配置HMS Core SDK的Maven仓地址。
  • 在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
  • 如果App中添加了“agconnect-services.json”文件则需要在“buildscript > dependencies”中增加agcp配置。
buildscript {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        classpath 'com.huawei.agconnect:agcp:1.3.1.300'
    }
}
  
allprojects {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
}

说明:Maven仓地址无法直接在浏览器中打开访问,只能在IDE中配置。如需添加多个Maven代码库,请将华为公司的Maven仓地址配置在最后。 2.3 添加编译依赖 1、打开Android Studio项目级“build.gradle”文件。 在这里插入图片描述

2、引用SDK。 华为Scan Kit提供两种SDK,普通版和plus版。plus版在非华为手机上效果好点儿但SDK略大。大家可以根据需求选择合适的SDK,版本填写实际的SDK版本号就可以了。

例如,使用Scan Kit SDK,在“dependencies”中添加如下编译依赖,{version}需要替换为SDK当前版本:implementation 'com.huawei.hms:scan:1.2.2.300'。

dependencies{
  implementation 'com.huawei.hms:scan:1.2.2.300'
 }

3、在文件头apply plugin: 'com.android.application'下一行添加如下配置。 2.4 同步工程   在完成以上的配置后,点击工具栏中的gradle同步图标,完成“build.gradle”文件的同步,将相关依赖下载到本地。 在这里插入图片描述

3 添加权限

1、在调用Scan kit 时,开发者需要先在Manifest中指定相应的权限。   构建相机扫码功能,需要申请“CAMERA”(相机权限);构建导入图片扫码功能,需要申请“READ_EXTERNAL_STORAGE”(读文件权限)。

<!--相机权限-->
<uses-permission android:name="android.permission.CAMERA" />
<!--读文件权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!--使用特性-->
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

2、在Manifest中指定权限后,还需要在代码中动态申请一下权限。

//CAMERA_REQ_CODE为用户自定义,用于接收权限校验结果 
ActivityCompat.requestPermissions(this,new String[]{Manifest.permission.CAMERA, Manifest.permission.READ_EXTERNAL_STORAGE}, CAMERA_REQ_CODE);

3、校验是否开启相应的权限,决定是否继续扫码。

//实现“onRequestPermissionsResult”函数接收校验权限结果
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    //判断“requestCode”是否为申请权限时设置请求码CAMERA_REQ_CODE,然后校验权限开启状态
    if (requestCode == CAMERA_REQ_CODE && grantResults.length == 2 && grantResults[0] == PackageManager.PERMISSION_GRANTED && grantResults[1] == PackageManager.PERMISSION_GRANTED) {
        //调用扫码接口,构建扫码能力,需开发者实现
        ...
    }
}

4 应用开发

  华为HMS Scan kit提供Default view mode、Customized view mode、Bitmap mode 、Multi Processor mode 4种调用方式,开发者可以根据需求构建扫码功能。

  小编这里介绍下customized view mode开发过程。 1、自定义扫码页面元素。 (1)自定义标题 定义文本信息为“title”变量。

<TextView 
    android:layout_marginStart="10sp" 
    android:layout_toEndOf="@+id/back_img" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:gravity="center_vertical" 
    android:text="@string/title" 
    android:textAllCaps="false" 
    android:textColor="#FFFFFF" 
    android:textSize="20sp" 
    android:textStyle="bold" />

(2)自定义返回按钮

定义id为“back_img”的页面视图,并绑定点击返回操作。

(3)自定义闪光灯按钮

定义闪光灯按钮的页面视图,并绑定开启关闭操作。

(4)自定义扫码界面

绘制扫码框。

<RelativeLayout 
    android:layout_width="match_parent" 
    android:layout_height="match_parent"> 
    <ImageView 
        android:layout_width="match_parent" 
        android:layout_height="match_parent" 
        android:layout_centerInParent="true" 
        android:layout_centerHorizontal="true" 
        android:background="#FF000000" 
        android:alpha="0.1" /> 
    <TextView 
        android:layout_marginTop="225dp" 
        android:layout_centerHorizontal="true" 
        android:text="@string/scan_tip" 
        android:textAllCaps="false" 
        android:textColor="#FFFFFF" 
        android:textSize="15sp" 
        android:textStyle="bold" 
        android:layout_height="20dp" 
        android:layout_width="220dp" /> 
    <!-- 设置扫码框--> 
    <ImageView 
        android:layout_width="300dp" 
        android:layout_height="300dp" 
        android:layout_centerInParent="true" 
        android:layout_centerHorizontal="true" 
        android:background="@drawable/cloors" /> 
</RelativeLayout>

2、通过Customized view实现相机扫码功能。 (1)创建Remote View,并加载到Activity布局。 (2)对Remote View设置结果回调监听,获取扫码结果对象HMS Scan。

@Override
protected void onCreate(Bundle savedInstanceState) {
    …
    //识别结果回调事件订阅 
    remoteView.setOnResultCallback(new OnResultCallback() { 
        @Override 
        public void onResult(HmsScan[] result) { 
            //获取到扫码结果HmsScan
            showResult(result); 
        } 
    });
}

结束语

  华为Scan kit依托华为计算机视觉领域强大能力,支持远距离码、小型码的检测和自动放大,有效处理反光、遮挡、污损、模糊等复杂扫码场景,支持Android和iOS系统集成,帮助开发者快速构建关联服务,提升用户扫码体验和成功率。

  Scan Kit的示例代码已在Github开源:github.com/HMS-Core/hm…

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

developer.huawei.com/consumer/cn… 欲了解更多详情,请参阅:

华为开发者联盟官网:developer.huawei.com/consumer/cn…

获取开发指导文档:developer.huawei.com/consumer/cn…

参与开发者讨论请到Reddit社区:www.reddit.com/r/HMSCore/

下载demo和示例代码请到Github:github.com/HMS-Core

解决集成问题请到Stack Overflow:stackoverflow.com/questions/t…


原文链接:developer.huawei.com/consumer/cn… 作者:say hi