# WeChatQRCode **Repository Path**: sapuser2017/WeChatQRCode ## Basic Information - **Project Name**: WeChatQRCode - **Description**: ⛄ 基于OpenCV开源的微信二维码引擎移植的Android扫码识别库 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 24 - **Created**: 2021-08-20 - **Last Updated**: 2022-08-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # WeChatQRCode [![Download](https://img.shields.io/badge/download-App-blue.svg)](https://raw.githubusercontent.com/jenly1314/WeChatQRCode/master/app/release/app-release.apk) [![MavenCentral](https://img.shields.io/maven-central/v/com.github.jenly1314.WeChatQRCode/wechat-qrcode)](https://repo1.maven.org/maven2/com/github/jenly1314/WeChatQRCode) [![JitPack](https://jitpack.io/v/jenly1314/WeChatQRCode.svg)](https://jitpack.io/#jenly1314/WeChatQRCode) [![CI](https://travis-ci.com/jenly1314/WeChatQRCode.svg?branch=master)](https://travis-ci.com/jenly1314/WeChatQRCode) [![CircleCI](https://circleci.com/gh/jenly1314/WeChatQRCode.svg?style=svg)](https://circleci.com/gh/jenly1314/WeChatQRCode) [![API](https://img.shields.io/badge/API-21%2B-blue.svg?style=flat)](https://android-arsenal.com/api?level=21) [![License](https://img.shields.io/badge/license-Apche%202.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0) [![Blog](https://img.shields.io/badge/blog-Jenly-9933CC.svg)](https://jenly1314.github.io/) [![QQGroup](https://img.shields.io/badge/QQGroup-20867961-blue.svg)](http://shang.qq.com/wpa/qunwpa?idkey=8fcc6a2f88552ea44b1.1.982c94fd124f7bb3ec227e2a400dbbfaad3dc2f5ad) 基于OpenCV开源的微信二维码引擎移植的封装库。又一个扫码相关的轮子，之所以说又，是因为这样的轮子已经开源三个了；几个轮子之间的优缺点，各有千秋，请自寻选择（小孩子才做选择，我全都要）。 > 基于ZXing的扫码轮子 [ZXingLite](https://github.com/jenly1314/ZXingLite) > 基于MLKit的扫码轮子 [MLKit](https://github.com/jenly1314/MLKit) > 基于OpenCV的扫码轮子 [WeChatQRCode](https://github.com/jenly1314/WeChatQRCode) ## GIF 展示 暂时没有录制GIF。 > 你可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/WeChatQRCode/master/app/release/app-release.apk) 体验效果 ## 各Module相关说明 ### [app](app) 示例App：主要用于提供WeChatQRCode的演示效果 ### [opencv](opencv) OpenCV：编译好的OpenCV ### [opencv-armv7a](opencv-armv7a) OpenCV：**armeabi-v7a** 的libopencv_java4.so ### [opencv-armv64](opencv-armv64) OpenCV：**arm64-v8a** 的libopencv_java4.so ### [opencv-x86](opencv-x86) OpenCV：**x86** 的libopencv_java4.so ### [opencv-x86_64](opencv-x86_64) OpenCV：**x86_64** 的libopencv_java4.so ### [wechat-qrcode](wechat-qrcode) 微信二维码识别：封装好的API，通过 **WeChatQRCodeDetector** 你可以很轻松的拥有OpenCV中开源的微信二维码识别功能 ### [wechat-qrcode-scanning](wechat-qrcode-scanning) 微信二维码扫码：有了上面的微信二维码识别功能，基本的扫码相关界面还是需要有个的，扫码加识别完美搭配，依赖[MLKit](https://github.com/jenly1314/MLKit)中的 **mlkit-camera-core**； **wechat-qrcode-scanning** 相当于[MLKit](https://github.com/jenly1314/MLKit)中的 **mlkit-camera-core**的衍生库。 ### [Java版本（点击查看java分支）](https://github.com/jenly1314/WeChatQrCode/tree/java) ## 引入 ### Gradle: 1. 在Project的 **build.gradle** 里面添加远程仓库 ```gradle allprojects { repositories { //... mavenCentral() } } ``` 2. 在Module的 **build.gradle** 里面添加引入依赖项 ```gradle // OpenCV基础库（*必须） implementation 'com.github.jenly1314.WeChatQRCode:opencv:1.2.0' implementation 'com.github.jenly1314.WeChatQRCode:opencv-armv7a:1.2.0' // 微信二维码识别功能（可选） implementation 'com.github.jenly1314.WeChatQRCode:wechat-qrcode:1.2.0' // 微信二维码扫码功能（可选） implementation 'com.github.jenly1314.WeChatQRCode:wechat-qrcode-scanning:1.2.0' //MLKit的Camera核心库：如果您使用了wechat-qrcode-scanning，则必须依赖mlkit-camera-core库 implementation 'com.github.jenly1314.MLKit:mlkit-camera-core:1.0.3' ``` 3. ABI过滤：在Module的 **build.gradle** 里面的 android{} 中设置支持的 SO 库架构（可选，支持多个平台的 so， 支持的平台越多，APK体积越大） ```gradle defaultConfig { //... ndk { //设置支持的 SO 库架构（开发者可以根据需要，选择一个或多个平台的 so） abiFilters 'armeabi-v7a' // , 'arm64-v8a', 'x86', 'x86_64' } } ``` ABI过滤：根据需要选择支持的 SO 库架构 ```gradle // OpenCV基础库（*必须） implementation 'com.github.jenly1314.WeChatQRCode:opencv:1.2.0' implementation 'com.github.jenly1314.WeChatQRCode:opencv-armv7a:1.2.0' // OpenCV的其他ABI（可选），根据你的需求选择想要的so支持 implementation 'com.github.jenly1314.WeChatQRCode:opencv-armv64:1.2.0' implementation 'com.github.jenly1314.WeChatQRCode:opencv-x86:1.2.0' implementation 'com.github.jenly1314.WeChatQRCode:opencv-x86_64:1.2.0' // 微信二维码识别功能（可选） implementation 'com.github.jenly1314.WeChatQRCode:wechat-qrcode:1.2.0' // 微信二维码扫码功能（可选） implementation 'com.github.jenly1314.WeChatQRCode:wechat-qrcode-scanning:1.2.0' //MLKit的Camera核心库：如果您使用了wechat-qrcode-scanning，则必须依赖mlkit-camera-core库 implementation 'com.github.jenly1314.MLKit:mlkit-camera-core:1.0.3' ``` ## 示例 初始化 **OpenCV** 和 **WeChatQRCodeDetector** （建议在 **MainActivity** 的 **onCreate** 方法中初始化） ```kotlin //初始化OpenCV OpenCV.initAsync(context) //初始化WeChatQRCodeDetector WeChatQRCodeDetector.init(context) ``` 识别二维码 （**wechat-qrcode**中的WeChatQRCodeDetector） ```kotlin //识别二维码；results是一个List集合，可能会有多个结果，如果只识别一个码，可以取List中第0个就可以 val results = WeChatQRCodeDetector.detectAndDecode(bitmap) ``` 识别二维码并返回二维码位置信息 （**wechat-qrcode**中的WeChatQRCodeDetector） ```kotlin // 扫码结果二维码的位置信息 val points = ArrayList() //通过WeChatQRCodeDetector识别图片中的二维码并返回二维码的位置信息 val result = WeChatQRCodeDetector.detectAndDecode(bitmap, points) points.forEach { mat -> // 扫码结果二维码的四个点 Log.d(TAG, "point0: ${mat[0, 0][0]}, ${mat[0, 1][0]}") Log.d(TAG, "point1: ${mat[1, 0][0]}, ${mat[1, 1][0]}") Log.d(TAG, "point2: ${mat[2, 0][0]}, ${mat[2, 1][0]}") Log.d(TAG, "point3: ${mat[3, 0][0]}, ${mat[3, 1][0]}") } ``` 通过继承 **wechat-qrcode-scanning** 中的 WeChatCameraScanActivity或者WeChatCameraScanFragment可以很轻松的实现扫码功能 ```kotlin class WeChatQRCodeActivity : WeChatCameraScanActivity() { companion object{ const val TAG = "WeChatQRCodeActivity" } override fun onScanResultCallback(result: AnalyzeResult>) { if(result.result.isNotEmpty()){ //停止分析 cameraScan.setAnalyzeImage(false) Log.d(TAG,result.result.toString()) // 当初始化 WeChatScanningAnalyzer 时，如果是需要二维码的位置信息，则会返回 WeChatScanningAnalyzer.QRCodeAnalyzeResult if(result is WeChatScanningAnalyzer.QRCodeAnalyzeResult){ // 如果需要处理结果二维码的位置信息 val buffer = StringBuilder() val bitmap = result.bitmap.drawRect {canvas,paint -> // 扫码结果可能有多个 for ((index,data) in result.result.withIndex()) { buffer.append("[$index] ").append(data).append("\n") result.points?.forEach { mat -> // 扫码结果二维码的四个点 Log.d(TAG, "point0: ${mat[0, 0][0]}, ${mat[0, 1][0]}") Log.d(TAG, "point1: ${mat[1, 0][0]}, ${mat[1, 1][0]}") Log.d(TAG, "point2: ${mat[2, 0][0]}, ${mat[2, 1][0]}") Log.d(TAG, "point3: ${mat[3, 0][0]}, ${mat[3, 1][0]}") val path = Path() path.moveTo(mat[0, 0][0].toFloat(), mat[0, 1][0].toFloat()) path.lineTo(mat[1, 0][0].toFloat(), mat[1, 1][0].toFloat()) path.lineTo(mat[2, 0][0].toFloat(), mat[2, 1][0].toFloat()) path.lineTo(mat[3, 0][0].toFloat(), mat[3, 1][0].toFloat()) path.lineTo(mat[0, 0][0].toFloat(), mat[0, 1][0].toFloat()) // 将二维码位置在图片上框出来 canvas.drawPath(path, paint) } } } val config = AppDialogConfig(this, R.layout.qrcode_result_dialog).apply { content = buffer onClickConfirm = View.OnClickListener { AppDialog.INSTANCE.dismissDialog() // 继续扫码分析 cameraScan.setAnalyzeImage(true) } onClickCancel = View.OnClickListener { AppDialog.INSTANCE.dismissDialog() finish() } val imageView = getView(R.id.ivDialogContent) imageView.setImageBitmap(bitmap) } AppDialog.INSTANCE.showDialog(config,false) } else { //一般需求都是识别一个码，所以这里取第0个就可以；有识别多个码的需求，可以取全部 val text = result.result[0] val intent = Intent() intent.putExtra(MainActivity.SCAN_RESULT,text) setResult(RESULT_OK,intent) finish() } } } override fun createAnalyzer(): Analyzer>? { // 分析器默认不会返回结果二维码的位置信息 // return WeChatScanningAnalyzer() // 如果需要返回结果二维码位置信息，则初始化分析器时，参数传 true 即可 return WeChatScanningAnalyzer(true) } } ``` ### 特别说明 因为 **wechat-qrcode-scanning** 依赖了 [MLKit](https://github.com/jenly1314/MLKit) 中的 **mlkit-camera-core**，所以布局在使用上完全遵循 **mlkit-camera-core** 的使用方式。 #### 布局示例 （这里贴出部分 **[MLKit](https://github.com/jenly1314/MLKit)** 中的部分示例） > 可自定义布局（覆写getLayoutId方法），布局内至少要保证有PreviewView，然后自己可根据需要添加的控件。 > PreviewView 用来预览，布局内至少要保证有PreviewView，如果是继承BaseCameraScanActivity或BaseCameraScanFragment，控件id可覆写getPreviewViewId方法自定义 > 关于扫码框动画，你可以直接拷贝[MLKit](https://github.com/jenly1314/MLKit)中的[ViewfinderView](https://github.com/jenly1314/MLKit/blob/master/mlkit-barcode-scanning/src/main/java/com/king/mlkit/vision/barcode/ViewfinderView.java)来使用，也可以自定义实现。 ```Xml ``` 更多使用详情，请查看[app](app)中的源码使用示例或直接查看 [API帮助文档](https://jitpack.io/com/github/jenly1314/WeChatQRCode/latest/javadoc/) ### 相关推荐 #### [MLKit](https://github.com/jenly1314/MLKit) 一个强大易用的工具包。通过ML Kit您可以很轻松的实现文字识别、条码识别、图像标记、人脸检测、对象检测等功能。 #### [ZXingLite](https://github.com/jenly1314/ZXingLite) 基于ZXing库优化扫码和生成二维码/条形码功能，扫码界面完全支持自定义。 ## 版本记录 #### v1.2.0：2022-8-4 * 更新OpenCV至v4.6.0 #### v1.1.1：2021-11-2 * 优化细节 * 更新mlkit-camera-core至v1.0.3 #### v1.1.0：2021-8-6 * 编译多种ABI支持 * 更新mlkit-camera-core至v1.0.2 #### v1.0.0：2021-7-24 * WeChatQRCode初始版本 ## 赞赏 如果您喜欢WeChatQRCode，或感觉WeChatQRCode帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :smiley:

您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:

## 关于我 Name: Jenly Email: jenly1314#gmail.com / jenly1314#vip.qq.com CSDN: jenly121 CNBlogs: jenly GitHub: jenly1314 Gitee: jenly1314 加入QQ群: 20867961