统一扫码服务(Scan Kit)提供便捷的条形码和二维码扫描、解析、生成能力,帮助您快速构建应用内的扫码功能。
得益于华为在计算机视觉领域能力的积累,Scan Kit可以实现远距离码或小型码的检测和自动放大,同时针对常见复杂扫码场景(如反光、暗光、污损、模糊、柱面)做了针对性识别优化,提升扫码成功率与用户体验。
在本篇codelab中,你将创建一个使用Bitmap Mode的扫码App。
若您需要正式发布集成Scan Kit的应用,请参见HUAWEI HMS Core 集成准备中详细说明来完成接入准备。
针对Android Studio开发环境,华为提供了Maven仓集成方式的HMS Core SDK包。在开始开发前,您需要将HMS Core SDK集成到您的Android Studio开发环境中。
如果在AppGallery Connect中开通了相关服务则需要将"agconnect-services.json"文件添加到您的App中。
Android Studio的代码库配置在Gradle 插件7.0以下版本、7.0版本和7.1及以上版本有所不同。请根据您当前的Gradle 插件版本,选择对应的配置过程。
7.0以下版本 | 7.0版本 | 7.1及以上版本 |
7.0以下版本
a. 打开Android Studio项目级"build.gradle"文件。
b. 添加HUAWEI agcp插件以及Maven代码库。
buildscript {
repositories {
google()
jcenter()
// 配置HMS Core SDK的Maven仓地址。
maven {url 'https://developer.huawei.com/repo/'}
}
dependencies {
...
// 增加agcp插件配置,推荐您使用最新版本的agcp插件。
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}
allprojects {
repositories {
google()
jcenter()
// 配置HMS Core SDK的Maven仓地址。
maven {url 'https://developer.huawei.com/repo/'}
}
}
7.0版本
a. 打开Android Studio项目级"build.gradle"文件。
b. 添加HUAWEI agcp插件以及Maven代码库。
buildscript {
repositories {
google()
jcenter()
// 配置HMS Core SDK的Maven仓地址。
maven {url 'https://developer.huawei.com/repo/'}
}
dependencies {
...
// 增加agcp插件配置,推荐您使用最新版本的agcp插件。
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}
c. 打开项目级"settings.gradle"文件,配置HMS Core SDK的Maven仓地址。
dependencyResolutionManagement {
...
repositories {
google()
jcenter()
// 配置HMS Core SDK的Maven仓地址。
maven {url 'https://developer.huawei.com/repo/'}
}
}
7.1及以上版本
a. 打开Android Studio项目级"build.gradle"文件。
b. 如果App中添加了"agconnect-services.json"文件则需要在"buildscript > dependencies"中增加agcp插件配置。
buildscript {
dependencies {
...
// 增加agcp插件配置,推荐您使用最新版本的agcp插件。
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}
c. 打开项目级"settings.gradle"文件,配置HMS Core SDK的Maven仓地址。
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
// 配置HMS Core SDK的Maven仓地址。
maven { url 'https://developer.huawei.com/repo/' }
}
}
dependencyResolutionManagement {
...
repositories {
google()
mavenCentral()
// 配置HMS Core SDK的Maven仓地址。
maven { url 'https://developer.huawei.com/repo/' }
}
}
dependencies {
implementation 'com.huawei.hms:scan:{version}'
}
apply plugin: 'com.huawei.agconnect'
plugins {
id 'com.android.application'
// 添加如下配置
id 'com.huawei.agconnect'
}
<!--读文件权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
public static final int BITMAP = 0x22;
public static final int REQUEST_CODE_PHOTO = 0x33;
public void newViewBtnClick(View view) {
// BITMAP为用户自定义用于接收权限校验结果。
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
this.requestPermissions(
new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
BITMAP);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
if (permissions == null || grantResults == null || grantResults[0] != PackageManager.PERMISSION_GRANTED) {
return;
}
if (requestCode == BITMAP) {
// 调用系统相册。
Intent pickIntent = new Intent(Intent.ACTION_PICK,
MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
pickIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
MainActivity.this.startActivityForResult(pickIntent, REQUEST_CODE_PHOTO);
}
}
Kotlin示例代码:
val BITMAP = 0x22;
val REQUEST_CODE_PHOTO = 0x33;
fun newViewBtnClick(view: View?) {
// BITMAP为用户自定义用于接收权限校验结果。
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
this.requestPermissions(
arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE),
BITMAP)
}
}
override fun onRequestPermissionsResult(requestCode:Int, permissions:Array<out String>, grantResults:IntArray) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
if (permissions == null || grantResults == null || grantResults[0] != PackageManager.PERMISSION_GRANTED) {
return
}
if (requestCode == MainActivity.BITMAP) {
// 调用系统相册。
val pickIntent = Intent(Intent.ACTION_PICK,
MediaStore.Images.Media.EXTERNAL_CONTENT_URI)
pickIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*")
this@MainActivity.startActivityForResult(pickIntent, REQUEST_CODE_PHOTO)
}
}
Scan Kit提供四种不同的调用模式,具体的差别请参见开发指南。本codelab选择了Bitmap Mode进行开发,实现扫码功能。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// 扫描页面关闭,接收到扫描结果。
super.onActivityResult(requestCode, resultCode, data);
if (resultCode != RESULT_OK || data == null) {
return;
}
if (requestCode == REQUEST_CODE_PHOTO) {
// 获取图片路径。
final String path = getImagePath(MainActivity.this, data);
if (TextUtils.isEmpty(path)) {
return;
}
// 从图片路径获取Bitmap。
Bitmap bitmap = ScanUtil.compressBitmap(MainActivity.this, path);
// 调用decodeWithBitmap方法,传入Bitmap。
HmsScan[] result1 = ScanUtil.decodeWithBitmap(MainActivity.this, bitmap, new HmsScanAnalyzerOptions.Creator().setHmsScanTypes(0).setPhotoMode(false).create());
// 获取具体扫码结果。
if (result1 != null && result1.length > 0) {
if (!TextUtils.isEmpty(result1[0].getOriginalValue())) {
Toast.makeText(this, result1[0].getOriginalValue(), Toast.LENGTH_SHORT).show();
}
}
}
}
Kotlin示例代码:
override fun onActivityResult(requestCode:Int, resultCode:Int, data: Intent?) {
// 扫描页面关闭,接收到扫描结果。
super.onActivityResult(requestCode, resultCode, data)
if (resultCode != RESULT_OK || data == null) {
return
}
if (requestCode == REQUEST_CODE_PHOTO) {
// 获取图片路径。
val path = getImagePath(this@MainActivity, data)
if (TextUtils.isEmpty(path)) {
return
}
// 从图片路径获取Bitmap。
val bitmap = ScanUtil.compressBitmap(this@MainActivity, path)
// 调用decodeWithBitmap方法,传入Bitmap。
val result1 = ScanUtil.decodeWithBitmap(this@MainActivity, bitmap, HmsScanAnalyzerOptions.Creator().setHmsScanTypes(0).setPhotoMode(false).create())
// 获取具体扫码结果。
if (result1 != null && result1.size > 0) {
if (!TextUtils.isEmpty(result1[0].getOriginalValue())) {
Toast.makeText(this, result1[0].getOriginalValue(), Toast.LENGTH_SHORT).show()
}
}
}
}
完成开发后,点击开发界面上的运行图标,运行Android Studio工程打包生成APK,并安装在测试手机上。
1.首次进入应用时的界面: | 2.点击Bitmap Mode | 3.扫码后返回结果: |
![]() | ![]() | ![]() |
干得好,您已经成功完成了codelab并学到了:
您可以阅读下面链接,了解更多相关的信息。
点击下载源码。