接上一篇
来看“3.1.1”处新建线程都做了什么，DecodeThread构造方法的代码如下
DecodeThread(CaptureActivity activity, Collection<BarcodeFormat> decodeFormats, Map<DecodeHintType,?> baseHints, String characterSet, ResultPointCallback resultPointCallback) { this.activity = activity; handlerInitLatch = new CountDownLatch(1); hints = new EnumMap<>(DecodeHintType.class); if (baseHints != null) { hints.putAll(baseHints); } // The prefs can't change while the thread is running, so pick them up once here. if (decodeFormats == null || decodeFormats.isEmpty()) { SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(activity); decodeFormats = EnumSet.noneOf(BarcodeFormat.class); if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_1D_PRODUCT, true)) { decodeFormats.addAll(DecodeFormatManager.PRODUCT_FORMATS); } if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_1D_INDUSTRIAL, true)) { decodeFormats.addAll(DecodeFormatManager.INDUSTRIAL_FORMATS); } if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_QR, true)) { decodeFormats.addAll(DecodeFormatManager.QR_CODE_FORMATS); } if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_DATA_MATRIX, true)) { decodeFormats.addAll(DecodeFormatManager.DATA_MATRIX_FORMATS); } if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_AZTEC, false)) { decodeFormats.addAll(DecodeFormatManager.AZTEC_FORMATS); } if (prefs.getBoolean(PreferencesActivity.KEY_DECODE_PDF417, false)) { decodeFormats.addAll(DecodeFormatManager.PDF417_FORMATS); } } hints.put(DecodeHintType.POSSIBLE_FORMATS, decodeFormats); if (characterSet != null) { hints.put(DecodeHintType.CHARACTER_SET, characterSet); } hints.put(DecodeHintType.NEED_RESULT_POINT_CALLBACK, resultPointCallback); }
上面的代码可以发现，在线程的构造方法中主要是设置解码的格式。
如果想提升扫码速度，这里是一个可以优化的点，可以不用设置这么多格式，只设置与自己业务有关的解码格式。
都知道线程运行，会调用run方法，看下run方法中的代码，如下
public void run() { Looper.prepare(); handler = new DecodeHandler(activity, hints); handlerInitLatch.countDown(); Looper.loop(); }
这段代码的作用是在子线程中实例化了一个Handler与当前线程绑定。继续跟进代码，看下DecodeHandler的构造方法都做了什么，代码如下
DecodeHandler(CaptureActivity activity, Map<DecodeHintType,Object> hints) { multiFormatReader = new MultiFormatReader(); multiFormatReader.setHints(hints); this.activity = activity; }
这段代码的作用就是将线程构造方法中设置的hints设置给实例化的MultiFormatReader,同时注入CaptureActivity的实例。
MultiFormatReader类的作用是一个便利类，是大多数用途的库的主要入口点。
分析到这里，可以画出如下的序列图
接着来分析“3.1.2”处的代码，调用的方法代码如下
private void restartPreviewAndDecode() { if (state == State.SUCCESS) { state = State.PREVIEW; cameraManager.requestPreviewFrame(decodeThread.getHandler(), R.id.decode); activity.drawViewfinder(); } }
重点看下
cameraManager.requestPreviewFrame(decodeThread.getHandler(), R.id.decode);
这句代码，看下CameraManager中的requestPreviewFrame方法做了什么，代码如下
/** * A single preview frame will be returned to the handler supplied. The data will arrive as byte[] * in the message.obj field, with width and height encoded as message.arg1 and message.arg2, * respectively. * * @param handler The handler to send the message to. * @param message The what field of the message to be sent. */ public synchronized void requestPreviewFrame(Handler handler, int message) { OpenCamera theCamera = camera; if (theCamera != null && previewing) { previewCallback.setHandler(handler, message); theCamera.getCamera().setOneShotPreviewCallback(previewCallback); } }
看下这个方法的介绍，意思是解析一个预览帧，解析的数据是一个字节数组，放进了message.obj中，宽和高放到了message.arg1和message.arg2中，然后将message返回给传进来的handler，由前文可只，这个handler是DecodeHandler的实例。 好了，跟到这个方法，就不继续网下跟了，这里可以猜测一下，一帧图像解析后会回调PreviewCallback类中的onPreviewFrame方法，这个方法的代码如下
public void onPreviewFrame(byte[] data, Camera camera) { Point cameraResolution = configManager.getCameraResolution(); Handler thePreviewHandler = previewHandler; if (cameraResolution != null && thePreviewHandler != null) { Message message = thePreviewHandler.obtainMessage(previewMessage, cameraResolution.x, cameraResolution.y, data); message.sendToTarget(); previewHandler = null; } else { Log.d(TAG, "Got preview callback, but no handler or resolution available"); } }
不难看出，这里是把解析后的数据发送给了DecodeHandler,最终会调用DecodeHandler类中的handleMessage方法，代码如下
public void handleMessage(Message message) { if (message == null || !running) { return; } switch (message.what) { case R.id.decode: decode((byte[]) message.obj, message.arg1, message.arg2); break; case R.id.quit: running = false; Looper.myLooper().quit(); break; } }
而上面代码中的message.what的值刚好是R.id.decode，自然就进入了decode方法。 分析到这里，在来看下现在的时序图，如下
根据这个序列图和前文，可以知道以下内容
- 进入扫码界面会先实例化
CameraManager和PreviewCallback类。 - 在
surface回调方法中，初始化相机设置相机的配置参数。 - 新建一个
DecodeThread线程并启动。为此线程绑定一个DecodeHandler。 - 获取相机帧数据转换程
byte数组传回DecodeHandler进行解码。
上文已经完成相机获取图像到进行解码的源码分析，从前面的分析可以知道，解码的方法是在子线程中执行的，那么子线程解码成功，怎么通知主线程能，其实非常简单，可以从DecodeHandler中的decode方法中知道答案，decode方法的代码如下
private void decode(byte[] data, int width, int height) { long start = System.nanoTime(); Result rawResult = null; PlanarYUVLuminanceSource source = activity.getCameraManager().buildLuminanceSource(data, width, height); if (source != null) { BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source)); try { //获取解码的结果 rawResult = multiFormatReader.decodeWithState(bitmap); } catch (ReaderException re) { // continue } finally { multiFormatReader.reset(); } } //获取了CaptureActivity中的handler Handler handler = activity.getHandler(); if (rawResult != null) { // Don't log the barcode contents for security. long end = System.nanoTime(); Log.d(TAG, "Found barcode in " + TimeUnit.NANOSECONDS.toMillis(end - start) + " ms"); if (handler != null) { Message message = Message.obtain(handler, R.id.decode_succeeded, rawResult); Bundle bundle = new Bundle(); bundleThumbnail(source, bundle); message.setData(bundle); //将message发送给CaptureActivity中的handler message.sendToTarget(); } } else { if (handler != null) { Message message = Message.obtain(handler, R.id.decode_failed); message.sendToTarget(); } } }
从上面的代码中可以发现将解码的结果发送给主线程是利用Android的Handler机制。
结束语
因为本文的目标是掌握解码的步骤，所以一些细节性的代码并没有进行分析，如配置相机的参数，扫码后的图像是竖屏还是横屏，怎样获取最佳的图像数据进行解析等。细节性的东西将会放到后面的文章进行讲解，后面的文章还会分析具体是怎么获取图像上的二维码并进行解码的。
