Zxing流程梳理

这是个人对Zxing的一些流程上的梳理，后续继续完善

CaptureActivity主流程梳理：

onResume中会对来源做判断，如果想要修改扫描框的大小可以做如下操作：

//在action里添加"com.google.zxing.client.android.SCAN"
//传递对应的大小、decodeFormats、decodeHints等

取出对应的decodeFormats

Intents.Scan.FORMATS — 支持的格式，使用英文 “, ” 分隔，包括以下的格式：

    AZTEC,
    CODABAR,
    CODE_39,
    CODE_93,
    CODE_128,
    DATA_MATRIX,
    EAN_8,
    EAN_13,
    ITF,
    MAXICODE,
    PDF_417,
    QR_CODE,
    RSS_14,
    RSS_EXPANDED,
    UPC_A,
    UPC_E,
    UPC_EAN_EXTENSION;

这些格式会在 DecodeFormatManager 中去解析，具体可以看 parseDecodeFormats 和 parseDecodeFormats 方法，这里有一个比较好用的解析技巧：

Arrays.asList(COMMA_PATTERN.split(scanFormatsString));  //通过","把所有的数据格式化成list
Set formats = EnumSet.noneOf(BarcodeFormat.class); //创建一个空的枚举类
for (String format : scanFormats) {
       formats.add(BarcodeFormat.valueOf(format));    //valueOf方法会把一个String类型的名称转变成枚举项
}

解析对应的decodeHints

如果想要定制的自定义的decodeHints，也可以包到 intent里面传进来。可以通过intent.putExtra(hintType, type) 来传输，具体详情可以看：DecodeHintType 这个类
，不过 DecodeHintType.CHARACTER_SET DecodeHintType.NEED_RESULT_POINT_CALLBACK DecodeHintType.POSSIBLE_FORMATS 不在这里进行解析

解析扫描的宽度和高度等

通过 Intents.Scan.WIDTH 和 Intents.Scan.HEIGHT 来获取对应宽长
通过 Intents.Scan.CAMERA_ID 来获取前置摄像头扫描还是后置摄像头扫描
通过 Intents.Scan.PROMPT_MESSAGE 来设置界面上的提示信息

设置对应的Intents.Scan.CHARACTER_SET

通过 Intents.Scan.CHARACTER_SET 来设置

初始化SurfaceView和camera

注册surface 回调函数，在surfaceCreated中使用SurfaceHolder（可以了解下surfaceholder） 来调用 initCamera

initCamera

1. 通过CameraManager的openDriver函数来初始化摄像头参数等，OpenCamera 是用来抽象一个逻辑的摄像头；
   1.1 通过OpenCameraInterface 打开了一个摄像头
   1.2 configManager:initFromCameraParameters 来根据surceView的displayRotation旋转角度来匹配摄像头的参数，findBestPreviewSizeValue 来确定最佳的预览分辨率
   1.3 setManualFramingRect 设置扫描框的宽高
   1.4 configManager:setDesiredCameraParameters 真正把配置设置到Camera中
   1.5 通过camera 的 setPreviewDisplay(holder) 来对接摄像头和surfaceview

2. 初始化CaptureActivityHandler来启动摄像头预览
   2.1 启动解码的线程 ，这个线程里面会启动一个DecodeHandler，activity可以通过这个handler和线程通信
   2.2 restartPreviewAndDecode -> cameraManager的requestPreviewFrame 此时持有decode的handler，可以和decodeThread通信 -> 在camera的PreviewCallback回调函数onPreviewFrame 中 会向decodeThread 发送解码的data和resolution，这样decodeThread就会去解码
   2.3 ViewfinderView 通过 drawViewfinder 绘制取景框和扫描线

3. 开始实时扫描并解码
   其中说到cameraManager中会将实时的图像发送到解码的handler中去，DecodeHandler会调用 decode 来解码
   3.1 通过cameraManager中buildLuminanceSource 来获取到取景框中的数据
   3.2 通过new BinaryBitmap(new HybridBinarizer(source)) 把数据转换成bitmap
   3.3 通过multiFormatReader中的decodeWithState函数就能解码图片（以后如果想直接解码图片可以直接使用这个函数，对应的，也有multiFormatWriter可以直接生成二维码）
   3.4 扫描成功，压缩扫码成功后的预览图片并发送相应消息到CaptureActivityHandler中

4. CaptureActivityHandler 处理扫描成功或者失败消息
   4.1 收到R.id.decode_succeeded，回调到activity中处理，可以跳转到相应的地方等
   4.2 收到R.id.decode_failed，直接调用 requestPreviewFrame 重启扫描

绘制可能出现的点

在看到扫描的时候对可能是二维码地方会有一个黄点出现，这是怎么实现的呢？
这是在解码的时候会在hint加一个参数叫做ResultPointCallback， 而 reader在解码的时候就会回调这个Callback的foundPossibleResultPoint函数，而viewfinderView就会在界面上画出对应的点

OnPause

1. OnPause首先会调用 quitSynchronously 这将中止摄像头的预览stopPreview 并退出decodeThread
2. 然后会暂停一些传感器的响应，release摄像头的持有
3. 最后remove掉surfaceView的callback