XQRCode 一个非常方便实用的二维码扫描、解析、生成库

偏执的太偏执、 2022-05-25 02:46 202阅读 0赞

# XQRCode #

[![XQRCode.svg][]][XQRCode.svg 1] [![api][]][api 1] [![I][]][I 1] [![Star][]][Star 1]  
一个非常方便实用的二维码扫描、解析、生成库

## 关于我 ##

[![github][]][github 1] [![csdn][]][csdn 1]

## 特点 ##

*  支持快速集成条形码、二维码扫描功能。
 *  支持自定义扫描界面。
 *  支持生成带图标的二维码。
 *  支持生成带背景图片的复杂二维码。
 *  支持二维码解析功能

## 1、演示（请star支持） ##

![XQRCode][]

### Demo下载 ###

[![downloads][]][downloads 1]  
![扫码体验][70]

## 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`。详情见如下布局代码：

（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`方法，传入二维码的绝对路径即可。

## 特别感谢 ##

[https://github.com/yipianfengye/android-zxingLibrary][https_github.com_yipianfengye_android-zxingLibrary]

## 联系方式 ##

[![E7_82_B9_E5_87_BB_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E4_BA_A4_E6_B5_81_E7_BE_A4-602082750-blue.svg][]][E7_82_B9_E5_87_BB_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E4_BA_A4_E6_B5_81_E7_BE_A4-602082750-blue.svg 1]  
![这里写图片描述][70 1]

## 微信公众号 ##

![在这里插入图片描述][20190104152244834.jpg]

## 向我提问 ##

![这里写图片描述][70 2]

[XQRCode.svg]: https://jitpack.io/v/xuexiangjys/XQRCode.svg
[XQRCode.svg 1]: https://jitpack.io/#xuexiangjys/XQRCode
[api]: https://img.shields.io/badge/API-19+-brightgreen.svg
[api 1]: https://android-arsenal.com/api?level=19
[I]: https://img.shields.io/github/issues/xuexiangjys/XQRCode.svg
[I 1]: https://github.com/xuexiangjys/XQRCode/issues
[Star]: https://img.shields.io/github/stars/xuexiangjys/XQRCode.svg
[Star 1]: https://github.com/xuexiangjys/XQRCode
[github]: https://img.shields.io/badge/GitHub-xuexiangjys-blue.svg
[github 1]: https://github.com/xuexiangjys
[csdn]: https://img.shields.io/badge/CSDN-xuexiangjys-green.svg
[csdn 1]: http://blog.csdn.net/xuexiangjys
[XQRCode]: /images/20220525/b45ac7a97f2e4058aa0929639f84ed57.png
[downloads]: https://img.shields.io/badge/downloads-1.7M-blue.svg
[downloads 1]: https://github.com/xuexiangjys/XQRCode/blob/master/apk/xqrcodedemo.apk?raw=true
[70]: /images/20220525/b34c22a2e04440f285744eeb6fb4c341.png
[https_github.com_yipianfengye_android-zxingLibrary]: https://github.com/yipianfengye/android-zxingLibrary
[E7_82_B9_E5_87_BB_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E4_BA_A4_E6_B5_81_E7_BE_A4-602082750-blue.svg]: https://img.shields.io/badge/%E7%82%B9%E5%87%BB%E4%B8%80%E9%94%AE%E5%8A%A0%E5%85%A5QQ%E4%BA%A4%E6%B5%81%E7%BE%A4-602082750-blue.svg
[E7_82_B9_E5_87_BB_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E4_BA_A4_E6_B5_81_E7_BE_A4-602082750-blue.svg 1]: http://shang.qq.com/wpa/qunwpa?idkey=9922861ef85c19f1575aecea0e8680f60d9386080a97ed310c971ae074998887
[70 1]: /images/20220525/dfcac5c51e644488832498e74ac0645b.png
[20190104152244834.jpg]: /images/20220525/d58aebd6b80949fc8a19a4a37f03f81d.png
[70 2]: /images/20220525/63e43b9a31414c37a07a6aba7a8cbe4c.png