功能介绍

• 可定制各式各样的扫描框
• 可定制全屏扫描或只识别扫描框区域内码
• 可定制要识别的码的格式（详细用法查看 TestScanActivity 中的 onClick 方法）
• 可以控制闪光灯，方便夜间使用
• 可以设置用前置摄像头扫描
• 可以二指缩放预览
• 可以监听环境亮度，提示用户打开、关闭闪光灯
• 识别到比较小的码时自动放大

---

• ZXing 生成可自定义颜色、带 logo 的二维码
• ZXing 生成一维码
• ZXing 扫描条码、二维码
• ZXing 识别图库中的条码、二维码图片

---

• ZBar 扫描条码、二维码「已解决中文乱码问题」
• ZBar 识别图库中的条码、二维码图片

常见问题

1.部分手机无法扫描出结果，扫描预览界面二维码被压缩

使用的时候将 Toolbar 或者其他 View 盖在 ZBarView 或者 ZXingView 的上面，让 ZBarView 或者 ZXingView 填充屏幕宽高。ZXing 布局文件参考 ZBar 布局文件参考

2.出现黑屏

在自己项目里集成时记得在 onDestroy 方法中调用 mQRCodeView.onDestroy()，在 onStop 方法中调用 mQRCodeView.stopCamera()，否则会出现黑屏。如果没执行前面提到的这两个方法出现黑屏的话，那你就只能加上前面提到的两个方法后，重启手机后重新运行了

效果图

自定义属性说明

属性名	说明	默认值
qrcv_topOffset	扫描框距离 toolbar 底部的距离	90dp
qrcv_cornerSize	扫描框边角线的宽度	3dp
qrcv_cornerLength	扫描框边角线的长度	20dp
qrcv_cornerColor	扫描框边角线的颜色	@android:color/white
qrcv_cornerDisplayType	扫描框边角线显示位置(相对于边框)，默认值为中间	center
qrcv_rectWidth	扫描框的宽度	200dp
qrcv_barcodeRectHeight	条码扫样式描框的高度	140dp
qrcv_maskColor	除去扫描框，其余部分阴影颜色	#33FFFFFF
qrcv_scanLineSize	扫描线的宽度	1dp
qrcv_scanLineColor	扫描线的颜色「扫描线和默认的扫描线图片的颜色」	@android:color/white
qrcv_scanLineMargin	扫描线距离上下或者左右边框的间距	0dp
qrcv_isShowDefaultScanLineDrawable	是否显示默认的图片扫描线「设置该属性后 qrcv_scanLineSize 将失效，可以通过 qrcv_scanLineColor 设置扫描线的颜色，避免让你公司的UI单独给你出特定颜色的扫描线图片」	false
qrcv_customScanLineDrawable	扫描线的图片资源「默认的扫描线图片样式不能满足你的需求时使用，设置该属性后 qrcv_isShowDefaultScanLineDrawable、qrcv_scanLineSize、qrcv_scanLineColor 将失效」	null
qrcv_borderSize	扫描边框的宽度	1dp
qrcv_borderColor	扫描边框的颜色	@android:color/white
qrcv_animTime	扫描线从顶部移动到底部的动画时间「单位为毫秒」	1000
qrcv_isCenterVertical（已废弃，如果要垂直居中用 qrcv_verticalBias="0.5"来代替）	扫描框是否垂直居中，该属性为true时会忽略 qrcv_topOffset 属性	false
qrcv_verticalBias	扫描框中心点在屏幕垂直方向的比例，当设置此值时，会忽略 qrcv_topOffset 属性	-1
qrcv_toolbarHeight	Toolbar 的高度，通过该属性来修正由 Toolbar 导致扫描框在垂直方向上的偏差	0dp
qrcv_isBarcode	扫描框的样式是否为扫条形码样式	false
qrcv_tipText	提示文案	null
qrcv_tipTextSize	提示文案字体大小	14sp
qrcv_tipTextColor	提示文案颜色	@android:color/white
qrcv_isTipTextBelowRect	提示文案是否在扫描框的底部	false
qrcv_tipTextMargin	提示文案与扫描框之间的间距	20dp
qrcv_isShowTipTextAsSingleLine	是否把提示文案作为单行显示	false
qrcv_isShowTipBackground	是否显示提示文案的背景	false
qrcv_tipBackgroundColor	提示文案的背景色	#22000000
qrcv_isScanLineReverse	扫描线是否来回移动	true
qrcv_isShowDefaultGridScanLineDrawable	是否显示默认的网格图片扫描线	false
qrcv_customGridScanLineDrawable	扫描线的网格图片资源	nulll
qrcv_isOnlyDecodeScanBoxArea	是否只识别扫描框中的码	false
qrcv_isShowLocationPoint	是否显示定位点	false
qrcv_isAutoZoom	码太小时是否自动缩放	false

接口说明

QRCodeView

/**
 * ZBarView 设置识别的格式。详细用法请看 zbardemo 的 TestScanActivity 中的 onClick 方法
 *
 * @param barcodeType 识别的格式
 * @param formatList  barcodeType 为 BarcdeType.CUSTOM 时，必须指定该值
 */
public void setType(BarcodeType barcodeType, List<BarcodeFormat> formatList)

/**
 * ZXingView 设置识别的格式。详细用法请看 zxingdemo TestScanActivity 中的 onClick 方法
 *
 * @param barcodeType 识别的格式
 * @param hintMap     barcodeType 为 BarcodeType.CUSTOM 时，必须指定该值
 */
public void setType(BarcodeType barcodeType, Map<DecodeHintType, Object> hintMap)

/**
 * 设置扫描二维码的代理
 *
 * @param delegate 扫描二维码的代理
 */
public void setDelegate(Delegate delegate)

/**
 * 显示扫描框
 */
public void showScanRect()

/**
 * 隐藏扫描框
 */
public void hiddenScanRect()

/**
 * 打开后置摄像头开始预览，但是并未开始识别
 */
public void startCamera()

/**
 * 打开指定摄像头开始预览，但是并未开始识别
 *
 * @param cameraFacing  Camera.CameraInfo.CAMERA_FACING_BACK or Camera.CameraInfo.CAMERA_FACING_FRONT
 */
public void startCamera(int cameraFacing)

/**
 * 关闭摄像头预览，并且隐藏扫描框
 */
public void stopCamera()

/**
 * 开始识别
 */
public void startSpot()

/**
 * 停止识别
 */
public void stopSpot()

/**
 * 停止识别，并且隐藏扫描框
 */
public void stopSpotAndHiddenRect()

/**
 * 显示扫描框，并开始识别
 */
public void startSpotAndShowRect()

/**
 * 打开闪光灯
 */
public void openFlashlight()

/**
 * 关闭散光灯
 */
public void closeFlashlight()

/**
 * 解析本地图片二维码。返回二维码图片里的内容 或 null
 *
 * @param picturePath 要解析的二维码图片本地路径
 */
public void decodeQRCode(String picturePath)

/**
 * 解析 Bitmap 二维码。返回二维码图片里的内容 或 null
 *
 * @param bitmap 要解析的二维码图片
 */
public void decodeQRCode(Bitmap bitmap)

QRCodeView.Delegate 扫描二维码的代理

/**
 * 处理扫描结果
 *
 * @param result 摄像头扫码时只要回调了该方法 result 就一定有值，不会为 null。解析本地图片或 Bitmap 时 result 可能为 null
 */
void onScanQRCodeSuccess(String result)

/**
 * 摄像头环境亮度发生变化
 *
 * @param isDark 是否变暗
 */
void onCameraAmbientBrightnessChanged(boolean isDark);

/**
 * 处理打开相机出错
 */
void onScanQRCodeOpenCameraError()

QRCodeEncoder 创建二维码图片。几个重载方法都是耗时操作，请在子线程中调用。

/**
 * 同步创建黑色前景色、白色背景色的二维码图片。该方法是耗时操作，请在子线程中调用。
 *
 * @param content 要生成的二维码图片内容
 * @param size    图片宽高，单位为px
 */
public static Bitmap syncEncodeQRCode(String content, int size)

/**
 * 同步创建指定前景色、白色背景色的二维码图片。该方法是耗时操作，请在子线程中调用。
 *
 * @param content         要生成的二维码图片内容
 * @param size            图片宽高，单位为px
 * @param foregroundColor 二维码图片的前景色
 */
public static Bitmap syncEncodeQRCode(String content, int size, int foregroundColor)

/**
 * 同步创建指定前景色、白色背景色、带logo的二维码图片。该方法是耗时操作，请在子线程中调用。
 *
 * @param content         要生成的二维码图片内容
 * @param size            图片宽高，单位为px
 * @param foregroundColor 二维码图片的前景色
 * @param logo            二维码图片的logo
 */
public static Bitmap syncEncodeQRCode(String content, int size, int foregroundColor, Bitmap logo)

/**
 * 同步创建指定前景色、指定背景色、带logo的二维码图片。该方法是耗时操作，请在子线程中调用。
 *
 * @param content         要生成的二维码图片内容
 * @param size            图片宽高，单位为px
 * @param foregroundColor 二维码图片的前景色
 * @param backgroundColor 二维码图片的背景色
 * @param logo            二维码图片的logo
 */
public static Bitmap syncEncodeQRCode(String content, int size, int foregroundColor, int backgroundColor, Bitmap logo)

/**
 * 同步创建条形码图片
 *
 * @param content  要生成条形码包含的内容
 * @param width    条形码的宽度，单位px
 * @param height   条形码的高度，单位px
 * @param textSize 字体大小，单位px，如果等于0则不在底部绘制文字
 */
public static Bitmap syncEncodeBarcode(String content, int width, int height, int textSize)