Android二维码的基础使用（三）：二维码扫描Demo实现

前言

在前两篇文章中，我们讲述了二维码的生成、保存和分享的内容，本次我们对于二维码的扫描的内容进行说明，实现一个简易的Android扫一扫功能。

系列文章：

Android二维码的基础使用（一）：利用Zxing生成自定义二维码
Android二维码的基础使用（二）：保存和分享
Android二维码的基础使用（三）：二维码扫描Demo实现

一、lib库说明

扫描二维码同样需要引入zxing库，但是由于原生的zxing库使用在自定义特性上支持一般，于是在此我选择引入了辅助库：

implementation 'com.king.zxing:zxing-lite:1.1.9-androidx'

zxing-lite库实际上是一个Zxing的精简辅助库，对于扫码功能进行了优化，同时内置了闪光灯等功能，对于代码集成上也是更加简单。

其GitHub地址如下：
zxing-lite Github地址

一、布局实现

首先我们先添加一个布局activity_q_r_scanner.xml，包括有扫码框，打开闪光灯的开关，代码如下：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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">

    <SurfaceView
        android:id="@+id/sv_preview"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <com.king.zxing.ViewfinderView
        android:id="@+id/vfv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:cornerColor="@color/color_4E5BCD"
        app:cornerRectHeight="54dp"
        app:cornerRectWidth="4dp"
        app:frameColor="@color/color_4E5BCD"
        app:frameHeight="242dp"
        app:frameWidth="242dp"
        app:labelText="请扫描智慧码"
        app:labelTextColor="@color/color_ffffff"
        app:labelTextLocation="bottom"
        app:labelTextPadding="18dp"
        app:labelTextSize="16sp"
        app:laserColor="@color/color_4E5BCD"
        app:maskColor="@color/color_80000000"
        app:scannerLineHeight="4dp" />

    <TextView
        android:id="@+id/tv_torch"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="32dp"
        android:drawableTop="@drawable/selector_torch"
        android:drawablePadding="12dp"
        android:gravity="center"
        android:text="打开照明"
        android:textColor="@color/color_ffffff"
        android:textSize="26sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        tools:ignore="HardCodedText" />

</androidx.constraintlayout.widget.ConstraintLayout>

其中com.king.zxing.ViewfinderView为扫描框，有着众多的属性，如设置提示文本的labelText等，大家可以在zxing-lite的GitHub地址上进行属性查询及运用。

二、activity代码

添加一个和布局对应的activity——QRScannerActivity.kt，首先我们需要判断权限问题，如下：

    /**
     * 权限检查
     */
    private fun checkPermission() {
        if (!checkPermissions(arrayOf(Manifest.permission.CAMERA))) {
            //弹起授权弹窗
            baseRequestPermissions(
                arrayOf(Manifest.permission.CAMERA),
                object : PermissionCallback() {
                    override fun onPermissionGranted(permissions: Array<String?>?) {}
                    override fun onPermissionDenied(permissions: Array<String?>?) {
                        Toast.makeText(mActivity,"权限被拒绝",Toast.LENGTH_SHORT).show()
                        finish()
                    }
                })
        }
    }

然后需要配置扫码框的属性，代码如下：

    /**
     * 初始化QRScanner配置
     */
    private fun initQRConfig(){
        captureHelper = CaptureHelper(this, viewBinding.svPreview, viewBinding.vfv, null)
        captureHelper.setOnCaptureCallback(this)
        captureHelper.decodeFormats(DecodeFormatManager.QR_CODE_FORMATS)
            .supportAutoZoom(true) // 自动缩放
            .fullScreenScan(true) // 全屏扫码识别
            .supportLuminanceInvert(true) // 是否支持识别反色码，黑白颜色反转，开启提高识别效率
            .continuousScan(true) // 开启连续扫描
            .autoRestartPreviewAndDecode(false) // 连续扫描开启情况下，取消自动继续扫描，自己处理完后调用restartPreviewAndDecode()
            .playBeep(true) // 播放beep声音
            .supportZoom(true) // 支持双指缩放
            .frontLightMode(FrontLightMode.OFF) // 默认关闭闪光灯
            .setOnCaptureCallback(this) // 设置回调
            .onCreate()
        val cameraManager: CameraManager = captureHelper.cameraManager
        cameraManager.setOnTorchListener { torch: Boolean ->
            viewBinding.tvTorch.isSelected = torch
            viewBinding.tvTorch.text = if (torch) "关闭照明" else "打开照明"
        }
        viewBinding.tvTorch.setOnClickListener(View.OnClickListener {
            cameraManager.setTorch(
                !viewBinding.tvTorch.isSelected
            )
        })
        viewBinding.tvTorch.post(Runnable { this.updateScanFrameLocation() })
    }

    /**
     * 更新扫描框位置
     */
    private fun updateScanFrameLocation() {
        //(327+184)/2-184
        viewBinding.vfv.setPadding(0, 0, 0, Utils.dp2px(this, 71))
        viewBinding.vfv.scannerStart = 0 // 动态改变padding时，需要设置该值为0，以触发在onDraw中对其的重新赋值
    }

除此之外，我们需要在Activity的生命周期中进行处理,同时继承OnCaptureCallback接口，在onCreate()中初始化配置及权限处理，在onResume(),onPause(),onDestory()进行处理，代码如下：

@Route(path = ConstUtil.QRCodeActivityPath)
class QRScannerActivity : BaseActivity(),OnCaptureCallback {
    private lateinit var viewBinding: ActivityQRScannerBinding
    private lateinit var captureHelper: CaptureHelper

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        viewBinding = ActivityQRScannerBinding.inflate(layoutInflater)
        setContentView(viewBinding.root)
        initQRConfig()
        checkPermission()
    }

    override fun onResultCallback(result: String?): Boolean {
        //todo 处理结果
        Toast.makeText(mActivity,result,Toast.LENGTH_SHORT).show()
        return true
    }

    override fun onResume() {
        //注意在生命周期的captureHelper设置，否则可能出现无法扫描的问题
        captureHelper.onResume()
        super.onResume()
    }

    override fun onPause() {
        captureHelper.onPause()
        super.onPause()
    }

    override fun onDestroy() {
        captureHelper.onDestroy()
        super.onDestroy()
    }
    ...
}

添加如上代码，我们就能够实现最终的结果：

二维码扫描.png

这样，我们就实现了一个二维码的扫描功能。

总结

zxing-lite是一个实现二维码相关内容的精简库，能够很方便的实现二维码的扫描功能。