这是个人对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<BarcodeFormat> 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
-
通过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 -
初始化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 绘制取景框和扫描线 -
开始实时扫描并解码
其中说到cameraManager中会将实时的图像发送到解码的handler中去,DecodeHandler会调用 decode 来解码
3.1 通过cameraManager中buildLuminanceSource 来获取到取景框中的数据
3.2 通过new BinaryBitmap(new HybridBinarizer(source)) 把数据转换成bitmap
3.3 通过multiFormatReader中的decodeWithState函数就能解码图片(以后如果想直接解码图片可以直接使用这个函数,对应的,也有multiFormatWriter可以直接生成二维码)
3.4 扫描成功,压缩扫码成功后的预览图片并发送相应消息到CaptureActivityHandler中 -
CaptureActivityHandler 处理扫描成功或者失败消息
4.1 收到R.id.decode_succeeded,回调到activity中处理,可以跳转到相应的地方等
4.2 收到R.id.decode_failed,直接调用 requestPreviewFrame 重启扫描
绘制可能出现的点
在看到扫描的时候对可能是二维码地方会有一个黄点出现,这是怎么实现的呢?
这是在解码的时候会在hint加一个参数叫做ResultPointCallback, 而 reader在解码的时候就会回调这个Callback的foundPossibleResultPoint函数,而viewfinderView就会在界面上画出对应的点
OnPause
- OnPause首先会调用 quitSynchronously 这将中止摄像头的预览stopPreview 并退出decodeThread
- 然后会暂停一些传感器的响应,release摄像头的持有
- 最后remove掉surfaceView的callback
网友评论