ZXing是Google提供的条形码、二维码等的生成、解析的库。最近工作需求去研究了一下,主要是研究怎么扫描二维码(QRCode)。网上教程也不少,但大多看了不明所以,甚至看了半天都不知道解码到底从哪儿下手。这篇文章仅作为一个补充,大体讲一下使用ZXing的流程,并不涉及具体代码。其实解码很简单的,只要知道大体的步骤,参照Google提供的Android上ZXing使用源码,很容易就明白。总之,明白关键节点后,我只用了几个类就实现了扫码器的基本功能。
官方代码托管在GitHub上https://github.com/zxing/zxing/。
-
我习惯用IDEA+Gradle来开发,所以不喜欢网上那种把jar下载下来导入的方法(而且GitHub里也没提供jar包,你得自己下载几百兆的源码编译,或者下载前辈们精简好的jar包)。查Maven仓库(jcenter的),果然有现成的库。那么第一步,在build.gradle中添加下面两句依赖:
compile 'com.google.zxing:core:3.2.1' compile 'com.google.zxing:android-core:3.2.1'
第一句是导入ZXing核心库core.jar,第二句导入了一个Android的工具类。是的只有一个类,CameraConfigurationUtils,用于相机的配置。编译gradle,ok。
接下来是使用咯,GitHub源码很多,随便翻翻,大致写几个关键的地方,方便供以后自己以及他人查询。
-
PlanarYUVLuminanceSource,在core.jar里,加工相机预览传回的byte[] data,得到要解析的source。为了得到它,可以参考官方GitHub源码中的Android部分的一个叫做CameraManager的类:https://github.com/zxing/zxing/blob/master/android/src/com/google/zxing/client/android/camera/CameraManager.java,里面有一个很关键的方法
public PlanarYUVLuminanceSource buildLuminanceSource(byte[] data);
我是直接照搬了这个方法(以及它要用到的几个方法)。 -
CameraConfigurationUtils,在android-core.jar里,之前提到过的。里面有很多配置相机的工具方法。比如这个:
public static Point findBestPreviewSizeValue(Camera.Parameters parameters, Point screenResolution);
用于把screenResolution转化成cameraResolution。至于这俩Point类的实例干嘛的,随便翻翻基于ZXing的Android扫码器源码就知道了。
-
MultiFormatReader,在core.jar里,解码器的主要入口,解读二维码的关键步骤就是这个类的decode();、decodeWithState();方法。第二个需要事先用setHints();方法提供要解析的条码类型(格式)。俩方法的参数是一张二进制位图(BinaryBitmap),由PlanarYUVLuminanceSource的实例构建而来(
BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(planarYUVLuminanceSource);
)。 -
Result,也在core.jar里,com.google.zxing。作为MultiFormatReader的decode的返回结果容器。简单的使用result.getText();就可以获取到二维码内的信息。这里啰嗦几句,其实二维码就是数据的一种载体,用一定算法装载了一些信息,比如一条URL字符串。
OK,就这样。总结一下解码过程:
-
每隔500ms获取一次相机预览传回的帧图。
-
开个线程,模仿或照搬Google的CameraManager里buildLuminanceSource();方法,把得到的帧图加工成PlanarYUVLuminanceSource。参数中会用到CameraConfigurationUtils的findBestPreviewSizeValue方法。
-
把(2)中得到的source转换成二进制位图,用MultiFormatReader解析它,得到Result结果容器。解码完成。
这次不放自己的源码了,GitHub里已经有很多了,官方的Android工程实例就很好。https://github.com/zxing/zxing/tree/master/android