华为HMS Scan Kit扫码功能：二、Default View Mode

最新推荐文章于 2024-09-09 11:33:13 发布

置顶飞哥来了

最新推荐文章于 2024-09-09 11:33:13 发布

阅读量2.4k

点赞数 5

分类专栏： Android开发

本文链接：https://blog.csdn.net/qianfeifeio/article/details/104903977

版权

Android开发专栏收录该内容

10 篇文章 1 订阅

订阅专栏

二、本篇主要实现Default View Mode模式扫码功能

Default View Mode提供相机扫码和导入图片扫码两个功能，提供完整的Activity，不需要开发者开发扫码界面的UI。（最快捷好用）

运行效果图：

Default View Mode模式下，Scan Kit直接控制相机实现最优的相机Zoom控制、自适应的曝光调节、自适应对焦调节等操作，保障最佳的扫码体验，减少开发者的工作量。

1. 业务流程

使用Default View Mode的主要业务流程如下：

1. 用户打开应用发起扫码申请。

2. 校验是否有相机权限和文件读取权限。

3. 权限验证通过后，调用HMS SDK的“startScan”扫码接口，启动扫码界面。

4. 判断扫码页面启动状态。

5. HMS SDK回调应用的“onActivityResult”接口，根据扫码状态获取扫码结果。

6. 应用封装扫码结果返回给用户。

2. 开发步骤

1. 在调用模块的AndroidManifest.xml清单文件中对扫码页面进行声明。（实测，不加也没事）

<activity android:name="com.huawei.hms.hmsscankit.ScanKitActivity" />

2. （可选）根据实际需求创建扫码选项参数。

Scan Kit默认支持13种码制式，开发者也可以指定Scan Kit只扫描特定的码制式以提高扫码速度。例如，当仅需要检测QR码和Data Matrix码时，请按照以下示例构建“HmsScanAnalyzerOptions”对象。如果不限制检测码格式，开发者可以不创建“HmsScanAnalyzerOptions”对象。


//“QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE”表示只扫描QR和Data Matrix的码 
HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator()
.setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE , HmsScan.DATAMATRIX_SCAN_TYPE).create();

//setHmsScanTypes(int ...)支持传多种类型的码

3. 调用“ScanUtil”的静态方法“startScan”启动Default View扫码页面。用户可以使用相机扫码，也可以通过该页面的“导入图片”按钮检测图片中的码。

“REQUEST_CODE_SCAN_ONE”为开发者设置的请求码参数，对应“onActivityResult”方法中的“requestCode”参数，用于判断“onActivityResult”调用是否来自Scan Kit扫码结果回调。若requestCode参数等于开发者设置的请求码参数，则表示本次”onActivityResult”是Scan Kit的扫码结果回调。
如果开发者没有指定只检测特定的码制式，此处的“options”可以置为“null”，表示默认检测Scan Kit支持的码制式。

ScanUtil.startScan(this, REQUEST_CODE_SCAN_ONE, options);

4. 实现回调接口接收扫码结果，相机扫码和导入图片扫码均通过该接口返回。

调用Activity的“onActivityResult”方法获取Intent参数，扫码结果对象HmsScan封装在其中。
若“requestCode”等于第3步中定义的“REQUEST_CODE_SCAN_ONE”请求码参数，则表示本次接收的Intent是Scan Kit返回的结果。
通过Intent中的“ScanUtil.RESULT”获取扫码结果HmsScan，其中包含的信息参见码值解析。

@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_SCAN_ONE) { 
        HmsScan obj = data.getParcelableExtra(ScanUtil.RESULT); 
        if (obj != null) { 
            //展示解码结果 
            showResult(obj); 
         } 
    } 
}

3、Android Studio环境开发流程：

3.1 相关库引用及文件配置同第一篇开始部分（超链接）：

华为Scan Kit扫码服务功能：一、Customized View Mode

代码整体流程同（华为Scan Kit扫码服务功能：一、Customized View Mode），只是按钮点击时调用默认扫码界面

3.2 添加所需权限

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" />

3.3 创建修改扫码页面的操作

在默认的 MainActivity.java文件中修改对应的布局文件（activity_main.xml）：上面一个按钮，点击后跳转到扫码界面，识别成功返回在button按钮下面显示扫码的码内容。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn_sacning"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="华为Sacn kit扫码"
        android:textSize="18sp" />

    <TextView
        android:id="@+id/tv_result"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:text="Hello World!"
        android:textSize="18sp" />

</LinearLayout>

动态获取权限：

 btn_sacning.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //DEFINED_CODE为用户自定义用于接收权限校验结果
                ActivityCompat.requestPermissions(MainActivity.this,
                        new String[]{Manifest.permission.CAMERA, Manifest.permission.READ_EXTERNAL_STORAGE},
                        DEFINED_CODE);
            }
        });

处理动态获取的权限结果：

    /**
     * 权限返回的结果处理
     * @param requestCode
     * @param permissions
     * @param grantResults
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (permissions == null || grantResults == null || grantResults.length < 2 || grantResults[0] != PackageManager.PERMISSION_GRANTED || grantResults[1] != PackageManager.PERMISSION_GRANTED) {
            return;
        }
        if (requestCode == DEFINED_CODE) {
            //默认扫码功能，支持选择相册识别
//setHmsScanTypes(int ...)支持传多种类型的码
//此处选择支持识别全部类型码（HmsScan.ALL_SCAN_TYPE）或不创建HmsScanAnalyzerOptions对象，设置具体码种可提高识别速度
           ScanUtil.startScan(this, REQUEST_CODE_SCAN, new HmsScanAnalyzerOptions.Creator()
.setHmsScanTypes(HmsScan.ALL_SCAN_TYPE).create());
        }
    }

onActivityResult(...)对扫码返回的结果进行处理：

  @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_SCAN) {
                HmsScan obj = data.getParcelableExtra(ScanUtil.RESULT);
                if (obj != null) {
                    this.tv_result.setText(obj.originalValue);
                }
            }

    }

完整的MainActivity 代码如下：

public class MainActivity extends AppCompatActivity {
    public static final int DEFINED_CODE = 222;//请求权限的code值
    private static final int REQUEST_CODE_SCAN = 0X01;//请求带返回结果的跳转code值
     Button btn_sacning;
    TextView tv_result;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        btn_sacning = (Button) findViewById(R.id.btn_sacning);
        tv_result = (TextView) findViewById(R.id.tv_result);
        btn_sacning.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //DEFINED_CODE为用户自定义用于接收权限校验结果
                ActivityCompat.requestPermissions(MainActivity.this,
                        new String[]{Manifest.permission.CAMERA, Manifest.permission.READ_EXTERNAL_STORAGE},
                        DEFINED_CODE);
            }
        });
    }

    /**
     * 权限返回的结果处理
     * @param requestCode
     * @param permissions
     * @param grantResults
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (permissions == null || grantResults == null || grantResults.length < 2 || grantResults[0] != PackageManager.PERMISSION_GRANTED || grantResults[1] != PackageManager.PERMISSION_GRANTED) {
            return;
        }
        if (requestCode == DEFINED_CODE) {
             //默认扫码功能，支持选择相册识别
//setHmsScanTypes(int ...)方法支持传多种类型的码
//此处选择支持识别全部类型码（HmsScan.ALL_SCAN_TYPE），设置具体码种可提高识别速度
           ScanUtil.startScan(this, REQUEST_CODE_SCAN, new HmsScanAnalyzerOptions.Creator()
.setHmsScanTypes(HmsScan.ALL_SCAN_TYPE).create());
        }
    }

    @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_SCAN) {
                HmsScan obj = data.getParcelableExtra(ScanUtil.RESULT);
                if (obj != null) {
                    this.tv_result.setText(obj.originalValue);
                }
            }

    }
}