一个JAVA开源的识别库，可以对常用的二维码，身份证，银行卡等识别

2019-10-10

Scanner

识别库，识别器可选择，这里有你常用的二维码/条码识别，还有你可能用到的身份证、银行卡识别，如果没有你想要的，可以自定义识别器。

该库只识别扫描框内的图像，识别速率上大大提高，而且这个库比起其它的库就是解决了摄像头预览变形，预览页面高度自定义，你可以像常规一样整个页面都是预览，或者你可以选择在任何位置定义任何尺寸的预览，扫描框也高度自定义，你可以像常规一样居中，或者你也可以在预览的任何位置定义任何尺寸的扫描框（实际识别的扫描框和画上去的扫描框不一定是一样的，由你自己决定）。

效果图

依赖

implementation 'com.shouzhong:Scanner:1.0.1'

以下选择自己需要的

// zxing
implementation 'com.google.zxing:core:3.3.3'
// zbar
implementation 'com.shouzhong:ScannerZBarLib:1.0.0'
// 银行卡识别
implementation 'com.shouzhong:ScannerBankCardLib:1.0.0'
// 身份证识别
implementation 'com.shouzhong:ScannerIdCardLib:1.0.1'

代码

基本使用

<RelativeLayout xmlns:Android="http://schemas.android.com/apk/res/android"
 android:layout_width="match_parent"
 android:layout_height="match_parent">
 <com.shouzhong.scanner.ScannerView
 android:id="@+id/sv"
 android:layout_width="match_parent"
 android:layout_height="1080px"
 android:background="#000000"/>
</RelativeLayout>
@Override
protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_scanner);
 scannerView = findViewById(R.id.sv);
 scannerView.setViewFinder(new ViewFinder(this));
 scannerView.setSaveBmp(true);
 scannerView.setEnableZXing(true);
 scannerView.setEnableZBar(true);
 scannerView.setEnableBankCard(true);
 scannerView.setEnableIdCard(true);
 scannerView.setCallback(new Callback() {
 @Override
 public void result(Result result) {
 tvResult.setText("识别结果：n" + result.toString());
 scannerView.restartPreviewAfterDelay(2000);
 }
 });
}
@Override
protected void onResume() {
 super.onResume();
 scannerView.onResume();
}
@Override
protected void onPause() {
 super.onPause();
 scannerView.onPause();
}

开启或者关闭某个识别器

// 启用zxing识别器
scannerView.setEnableZXing(true);
// 启用zbar识别器
scannerView.setEnableZBar(true);
// 启用银行卡识别器
scannerView.setEnableBankCard(true);
// 启用身份证识别器（这里只支持2代身份证）
scannerView.setEnableIdCard(true);

如果你想自定义识别器

scannerView.setScanner(new IScanner() {
 /**
 * 这里实现自己的识别器，并把识别结果返回
 *
 * @param data 矩形框内nv21图像数据
 * @param width 图像宽度
 * @param height 图像高度
 * @return
 * @throws Exception
 */
 @Override
 public Result scan(byte[] data, int width, int height) throws Exception {
 // 如果你想转为Bitmap，请使用NV21.nv21ToBitmap(byte[] nv21, int width, int height)
 return null;
 }
});

这里没给默认的预览页面，需要自己自定义，下面给个例子

class ViewFinder extends View implements IViewFinder {
 private Rect framingRect;//扫码框所占区域
 private float widthRatio = 0.8f;//扫码框宽度占view总宽度的比例
 private float heightWidthRatio = 1f;//扫码框的高宽比
 private int leftOffset = -1;//扫码框相对于左边的偏移量，若为负值，则扫码框会水平居中
 private int topOffset = -1;//扫码框相对于顶部的偏移量，若为负值，则扫码框会竖直居中
 private int laserColor = 0xff008577;// 扫描线颜色
 private int maskColor = 0x60000000;// 阴影颜色
 private int borderColor = 0xff008577;// 边框颜色
 private int borderStrokeWidth = 12;// 边框宽度
 private int borderLineLength = 72;// 边框长度
 private Paint laserPaint;// 扫描线
 private Paint maskPaint;// 阴影遮盖画笔
 private Paint borderPaint;// 边框画笔
 private int position;
 public ViewFinder(Context context) {
 super(context);
 setWillNotDraw(false);//需要进行绘制
 laserPaint = new Paint();
 laserPaint.setColor(laserColor);
 laserPaint.setStyle(Paint.Style.FILL);
 maskPaint = new Paint();
 maskPaint.setColor(maskColor);
 borderPaint = new Paint();
 borderPaint.setColor(borderColor);
 borderPaint.setStyle(Paint.Style.STROKE);
 borderPaint.setStrokeWidth(borderStrokeWidth);
 borderPaint.setAntiAlias(true);
 }
 @Override
 protected void onSizeChanged(int xNew, int yNew, int xOld, int yOld) {
 updateFramingRect();
 }
 @Override
 public void onDraw(Canvas canvas) {
 if (getFramingRect() == null) {
 return;
 }
 drawViewFinderMask(canvas);
 drawViewFinderBorder(canvas);
 drawLaser(canvas);
 }
 private void drawLaser(Canvas canvas) {
 Rect framingRect = getFramingRect();
 int top = framingRect.top + 10 + position;
 canvas.drawRect(framingRect.left + 10, top, framingRect.right - 10, top + 5, laserPaint);
 position = framingRect.bottom - framingRect.top - 25 < position ? 0 : position + 2;
 //区域刷新
 postInvalidateDelayed(20, framingRect.left + 10, framingRect.top + 10, framingRect.right - 10, framingRect.bottom - 10);
 }
 /**
 * 绘制扫码框四周的阴影遮罩
 */
 private void drawViewFinderMask(Canvas canvas) {
 int width = canvas.getWidth();
 int height = canvas.getHeight();
 Rect framingRect = getFramingRect();
 canvas.drawRect(0, 0, width, framingRect.top, maskPaint);//扫码框顶部阴影
 canvas.drawRect(0, framingRect.top, framingRect.left, framingRect.bottom, maskPaint);//扫码框左边阴影
 canvas.drawRect(framingRect.right, framingRect.top, width, framingRect.bottom, maskPaint);//扫码框右边阴影
 canvas.drawRect(0, framingRect.bottom, width, height, maskPaint);//扫码框底部阴影
 }
 /**
 * 绘制扫码框的边框
 */
 private void drawViewFinderBorder(Canvas canvas) {
 Rect framingRect = getFramingRect();
 // Top-left corner
 Path path = new Path();
 path.moveTo(framingRect.left, framingRect.top + borderLineLength);
 path.lineTo(framingRect.left, framingRect.top);
 path.lineTo(framingRect.left + borderLineLength, framingRect.top);
 canvas.drawPath(path, borderPaint);
 // Top-right corner
 path.moveTo(framingRect.right, framingRect.top + borderLineLength);
 path.lineTo(framingRect.right, framingRect.top);
 path.lineTo(framingRect.right - borderLineLength, framingRect.top);
 canvas.drawPath(path, borderPaint);
 // Bottom-right corner
 path.moveTo(framingRect.right, framingRect.bottom - borderLineLength);
 path.lineTo(framingRect.right, framingRect.bottom);
 path.lineTo(framingRect.right - borderLineLength, framingRect.bottom);
 canvas.drawPath(path, borderPaint);
 // Bottom-left corner
 path.moveTo(framingRect.left, framingRect.bottom - borderLineLength);
 path.lineTo(framingRect.left, framingRect.bottom);
 path.lineTo(framingRect.left + borderLineLength, framingRect.bottom);
 canvas.drawPath(path, borderPaint);
 }
 /**
 * 设置framingRect的值（扫码框所占的区域）
 */
 private synchronized void updateFramingRect() {
 Point viewSize = new Point(getWidth(), getHeight());
 int width, height;
 width = (int) (getWidth() * widthRatio);
 height = (int) (heightWidthRatio * width);
 int left, top;
 if (leftOffset < 0) {
 left = (viewSize.x - width) / 2;//水平居中
 } else {
 left = leftOffset;
 }
 if (topOffset < 0) {
 top = (viewSize.y - height) / 2;//竖直居中
 } else {
 top = topOffset;
 }
 framingRect = new Rect(left, top, left + width, top + height);
 }
 @Override
 public Rect getFramingRect() {
 return framingRect;
 }
}

回调说明

方法说明

代码混淆

-dontwarn com.shouzhong.**
-keep class com.shouzhong.** {*;}
-dontwarn com.google.zxing.**
-keep class com.google.zxing.**
-dontwarn net.sourceforge.zbar.**
-keep class net.sourceforge.zbar.** {*;}
-keep class com.wintone.bankcard.** {*;}
-dontwarn com.wintone.bankcard.**
-keep class exocr.exocrengine.** {*;}
-dontwarn exocr.exocrengine.**

更多使用方法可以查看官方文档

开源地址：

https://github.com/shouzhong/Scanner

更多更优质的资讯，请关注我，你的支持会鼓励我不断分享更多更好的优质文章。