二维码功能实现

一、应用场景

用户A从契约锁WEB端分享合同二维码给合同相关的人员B，用户B使用契约锁手机客户端进行扫码签署。

二、技术选型

这里选择Zxing有如下原因：
- 开源
- 文档完善，用户量大
- google出品

三、Zxing接入步骤

3.1 基本概念

Zxing的二维码功能有两部分组成：图片获取+图片解析

3.2 图片获取-扫描

核心思路：通过重写Camera的预览回调类：Camera.PreviewCallback，当存在预览帧(preview frame)时调用onPreviewFrame方法获取图片。

3.2.1 自定义的预览回调方法：

public final class PreviewCallback implements Camera.PreviewCallback {

    ...

    @Override
    public void onPreviewFrame(byte[] data, Camera camera) {
        //得到当前图像像素的字节数组data，进行扫描框大小的裁剪，将裁剪后的图片（二维码）调用图片解析库，获取解析结果
    }

}

3.2.2 为Camera添加上面的预览回调：

Camera camera;
PreviewCallback previewCallback;

...

if (Build.VERSION.SDK_INT > 3) {
    //考虑到我们app最低兼容版本为API15，使用setOneShotPreviewCallback方法
    camera.setOneShotPreviewCallback(previewCallback);
} else {
    camera.setPreviewCallback(previewCallback);
}

3.3 图片解析

Zxing图片解析功能在core文件夹中，去除掉里面的测试代码模块，生成jar包。

3.3.1 根据图片，调用图片解析方法：

/**
 * 图片解析
 *
 * @param data 图像像素的字节数组data
 * @param width 图像宽
 * @param height 图像高
 */
private void decode(byte[] data, int width, int height) {
    Result rawResult = null;

    ...

    PlanarYUVLuminanceSource source = CameraManager.get().buildLuminanceSource(rotatedData, width, height);
    BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source));
    rawResult = multiFormatReader.decodeWithState(bitmap);

    //rawResult.getText()便是获得的解析结果
}

四、周边技术点

在主要技术点周边还有预览图片的裁剪功能，解析失败后的Camera重试，图片的旋转都需要完成，本地图片的获取。

五、示例代码下载

https://github.com/zhufeng1222/QRCodeScan