ZXingLite for Android 是ZXing的精简版,基于ZXing库优化扫码和生成二维码/条形码功能,扫码界面完全支持自定义,也可一行代码使用默认实现的扫码功能。总之你想要的都在这里。
简单如斯,你不试试? Come on~
属性 | 值类型 | 默认值 | 说明 |
---|---|---|---|
maskColor | color | #60000000 | 扫描区外遮罩的颜色 |
frameColor | color | #7F1FB3E2 | 扫描区边框的颜色 |
cornerColor | color | #FF1FB3E2 | 扫描区边角的颜色 |
laserColor | color | #FF1FB3E2 | 扫描区激光线的颜色 |
resultPointColor | color | #C0EFBD21 | 扫描区结果点的颜色 |
labelText | string | 扫描提示文本信息 | |
labelTextColor | color | #FFC0C0C0 | 提示文本字体颜色 |
labelTextSize | dimension | 14sp | 提示文本字体大小 |
labelTextPadding | dimension | 24dp | 提示文本距离扫描区的间距 |
labelTextLocation | enum | bottom | 提示文本显示位置 |
showResultPoint | boolean | false | 是否显示合适的扫码结果点 |
frameWidth | dimension | 扫码框宽度 | |
frameHeight | dimension | 扫码框高度 | |
laserStyle | enum | line | 扫描激光的样式 |
gridColumn | integer | 20 | 网格扫描激光列数 |
gridHeight | integer | 40dp | 网格扫描激光高度,为0dp时,表示动态铺满 |
<dependency>
<groupId>com.king.zxing</groupId>
<artifactId>zxing-lite</artifactId>
<version>1.1.2</version>
<type>pom</type>
</dependency>
//AndroidX 版本
implementation 'com.king.zxing:zxing-lite:1.1.2-androidx'
//Android 版本
implementation 'com.king.zxing:zxing-lite:1.1.2'
<dependency org='com.king.zxing' name='zxing-lite' rev='1.1.2'>
<artifact name='$AID' ext='pom'></artifact>
</dependency>
allprojects {
repositories {
maven { url 'https://dl.bintray.com/jenly/maven' }
}
}
//AndroidX
compileOnly 'androidx.appcompat:appcompat:1.0.0+'
api 'com.google.zxing:core:3.3.3'
//Android
compileOnly 'com.android.support:appcompat-v7:28.0.0'
api 'com.google.zxing:core:3.3.3'
布局示例 (可自定义布局,布局内至少要保证有SurfaceView和ViewfinderView,控件id可根据重写CaptureActivity 的 getPreviewViewId 和 getViewFinderViewId方法自定义)
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<SurfaceView
android:id="@+id/surfaceView"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
<com.king.zxing.ViewfinderView
android:id="@+id/viewfinderView"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</FrameLayout>
代码示例 (二维码/条形码)
//跳转的默认扫码界面
startActivityForResult(new Intent(context,CaptureActivity.class),requestCode);
//生成二维码
CodeUtils.createQRCode(content,600,logo);
//生成条形码
CodeUtils.createBarCode(content, BarcodeFormat.CODE_128,800,200);
如果直接使用CaptureActivity需在您项目的AndroidManifest中添加如下配置
<activity
android:name="com.king.zxing.CaptureActivity"
android:screenOrientation="portrait"/>
1、直接使用CaptureActivity或者CaptureFragment。(纯洁的扫码,无任何添加剂)
2、通过继承CaptureActivity或者CaptureFragment并自定义布局。(适用于大多场景,并无需关心扫码相关逻辑)
3、在你项目的Activity或者Fragment中创建创建一个CaptureHelper并在相应的生命周期中调用CaptureHelper的周期。(适用于想在扫码界面写交互逻辑,又因为项目架构或其它原因,无法直接或间接继承CaptureActivity或CaptureFragment时使用)
4、参照CaptureHelper写一个自定义的扫码帮助类,其它步骤同方式3。(扩展高级用法,谨慎使用)
更多使用详情,请查看app中的源码使用示例或直接查看API帮助文档
- 优化部分细节,为迁移至AndroidX做准备
- 支持AndroidX对应版本
- 支持扫二维码过小时,自动缩放
- 支持垂直条形码识别(增强条形码识别,默认不支持,需CaptureHelper.supportVerticalCode(true)开启)
- 将扫码相关逻辑与界面分离,ZXingLite使用更容易扩展
- 新增CaptureFragment
- 新增网格样式的扫描激光(类似支付宝扫码样式)
- 升级Gradle至v4.6
- 支持连续扫码
- 支持横屏扫码(主要为了支持Pad)
- 支持自定义扫码框宽高
- 修改text相关自定义属性,如:text->labelText
- 支持触摸缩放变焦
- 支持条形码下方显示显示code
- 优化相机预览尺寸遍历策略,从而降低预览变形的可能性
- 优化扫码识别速度
- ZXingLite初始版本
如果您喜欢ZXingLite,或感觉ZXingLite帮助到了您,可以点右上角“Star”支持一下,您的支持就是我的动力,谢谢 😃
您也可以扫描下面的二维码,请作者喝杯咖啡 ☕
Name: Jenly
Email: jenly1314#gmail.com / jenly1314#vip.qq.com
CSDN: jenly121
Github: jenly1314
加入QQ群: 20867961