原文链接:blog.csdn.net
XQRCode
xq api
一个非常方便实用的二维码扫描、解析、生成库
关于我
github csdn
特点
支持快速集成条形码、二维码扫描功能。
支持自定义扫描界面。
支持生成带图标的二维码。
支持生成带背景图片的复杂二维码。
支持二维码解析功能
1、演示(请star支持)
XQRCode
Demo下载
downloads
扫码体验
2、如何使用
目前支持主流开发工具AndroidStudio的使用,直接配置build.gradle,增加依赖即可.
2.1、Android Studio导入方法,添加Gradle依赖
1.先在项目根目录的 build.gradle 的 repositories 添加:
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
2.然后在dependencies添加:
dependencies {
...
implementation 'com.github.xuexiangjys:XQRCode:1.0.0'
}
2.2、二维码扫描
1.默认二维码扫描界面CaptureActivity
二维码的扫描结果通过Intent返回出来:
XQRCode.RESULT_TYPE:扫描结果类型,XQRCode.RESULT_SUCCESS代表扫描成功,XQRCode.RESULT_FAILED代表扫描失败。
XQRCode.RESULT_DATA:扫描二维码的数据内容。
/**
- 开启二维码扫描
*/
@Permission(CAMERA)
@IOThread(ThreadType.Single)
private void startScan(boolean isCustom) {
if (isCustom) {
openPageForResult(CustomCaptureFragment.class, null, REQUEST_CUSTOM_SCAN);
} else {
Intent intent = new Intent(getActivity(), CaptureActivity.class);
startActivityForResult(intent, REQUEST_CODE);
}
}
/**
- 处理二维码扫描结果
- @param data
*/
private void handleScanResult(Intent data) {
if (data != null) {
Bundle bundle = data.getExtras();
if (bundle != null) {
if (bundle.getInt(XQRCode.RESULT_TYPE) == XQRCode.RESULT_SUCCESS) {
String result = bundle.getString(XQRCode.RESULT_DATA);
ToastUtils.toast("解析结果:" + result, Toast.LENGTH_LONG);
} else if (bundle.getInt(XQRCode.RESULT_TYPE) == XQRCode.RESULT_FAILED) {
ToastUtils.toast("解析二维码失败", Toast.LENGTH_LONG);
}
}
}
}
2.自定义二维码扫描界面
(1)自定义一个扫码界面布局。自定义的扫码界面需要定义一个SurfaceView和一个ViewfinderView,且id必须是preview_view和viewfinder_view。详情见如下布局代码:
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<SurfaceView
android:id="@+id/preview_view"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
<com.xuexiang.xqrcode.view.ViewfinderView
android:id="@+id/viewfinder_view"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:inner_corner_color="@color/scan_corner_color"
app:inner_corner_length="30dp"
app:inner_corner_width="5dp"
app:inner_marginTop="120dp"
app:inner_scan_bitmap="@mipmap/ic_scan_image"
app:inner_scan_isCircle="false"
app:inner_scan_speed="10"
app:inner_height="300dp"
app:inner_width="300dp" />
</FrameLayout>
(2)调用XQRCode.getCaptureFragment的方法,传入自定义扫描界面的布局ID,可以获得带扫描功能的Fragment-CaptureFragment,将其填充到页面中。
// 为二维码扫描界面设置定制化界面
CaptureFragment captureFragment = XQRCode.getCaptureFragment(R.layout.layout_custom_camera);
captureFragment.setAnalyzeCallback(analyzeCallback);
getChildFragmentManager().beginTransaction().replace(R.id.fl_my_container, captureFragment).commit();
(3)最后为CaptureFragment设置二维码解析回调接口AnalyzeCallback即可。
2.3、二维码生成
1.简单的二维码生成
调用XQRCode.createQRCodeWithLogo,传入二维码携带的内容、尺寸、图标即可生成二维码Bitmap。
2.复杂的二维码生成
调用XQRCode.newQRCodeBuilder可以获得二维码生成构建者。可设置的参数如下:
setContents: 设置二维码携带的内容
setSize: 设置二维码的尺寸
setMargin: 设置二维码的边缘宽度
setDataDotScale: 设置二维码的数据点缩放比例
setColorDark: 设置深色点(true-dots)色值
setColorLight: 设置浅色点(false-dots)色值
setBackgroundImage: 设置背景图案
setWhiteMargin: 设置是否是白色的边缘
setAutoColor: 设置是否自动从背景图案中选取色值
setBinarize: 设置是否(二值化)灰度化背景图案
setBinarizeThreshold: 设置二值化中值
最后调用build方法即可生成二维码。
2.4、二维码解析
1.只需要解析二维码携带的数据内容,可直接调用XQRCode.analyzeQRCode方法,传入二维码的绝对路径即可。
2.如果需要完整的二维码解析结果,可调用XQRCode.getAnalyzeQRCodeResult方法,传入二维码的绝对路径即可。