概述
二維碼的應(yīng)用已經(jīng)可以說是非常廣泛了，那么如何在當(dāng)前的app項(xiàng)目中生成自定義二維碼，本文對(duì)采用Google開源庫(kù)Zxing去生成二維碼的流程進(jìn)行簡(jiǎn)單說明。
系列文章：
Android二維碼的基礎(chǔ)使用（一）：利用Zxing生成自定義二維碼
Android二維碼的基礎(chǔ)使用（二）：保存和分享
Android二維碼的基礎(chǔ)使用（三）：二維碼掃描Demo實(shí)現(xiàn)
使用
1. 引入jar包
build.gradle文件中引入jar包。
implementation 'com.google.zxing:core:3.3.0'
2. 基本使用
生成一個(gè)二維碼主要包含如下幾個(gè)步驟：
- 設(shè)置二維碼的配置，如字符轉(zhuǎn)碼格式。容錯(cuò)率以及空白邊距等等參數(shù)。
- 通過
QRWriter生成位矩陣BitMatrix對(duì)象 - 創(chuàng)建像素?cái)?shù)組，并根據(jù)位矩陣對(duì)象逐項(xiàng)賦值顏色。
- 根據(jù)像素?cái)?shù)組創(chuàng)建bitmap對(duì)象生成二維碼圖片。
示例代碼如下：
/**
* 生成簡(jiǎn)單二維碼
*
* @param content 字符串內(nèi)容
* @param width 二維碼寬度
* @param height 二維碼高度
* @param characterSet 編碼方式（一般使用UTF-8）
* @param errorCorrectionLevel 容錯(cuò)率 L：7% M：15% Q：25% H：35%
* @param margin 空白邊距（二維碼與邊框的空白區(qū)域）
* @param colorBlack 黑色色塊
* @param colorWhite 白色色塊
* @return BitMap
*/
fun createQRCodeBitmap(
content: String?, width: Int, height: Int,
characterSet: String?, errorCorrectionLevel: String?,
margin: String?, colorBlack: Int, colorWhite: Int
): Bitmap? {
// 字符串內(nèi)容判空
if (TextUtils.isEmpty(content)) {
return null
}
// 寬和高>=0
if (width < 0 || height < 0) {
return null
}
return try {
/** 1.設(shè)置二維碼相關(guān)配置 */
val hints =
Hashtable<EncodeHintType, String?>()
// 字符轉(zhuǎn)碼格式設(shè)置
if (!TextUtils.isEmpty(characterSet)) {
hints[EncodeHintType.CHARACTER_SET] = characterSet
}
// 容錯(cuò)率設(shè)置
if (!TextUtils.isEmpty(errorCorrectionLevel)) {
hints[EncodeHintType.ERROR_CORRECTION] = errorCorrectionLevel
}
// 空白邊距設(shè)置
if (!TextUtils.isEmpty(margin)) {
hints[EncodeHintType.MARGIN] = margin
}
/** 2.將配置參數(shù)傳入到QRCodeWriter的encode方法生成BitMatrix(位矩陣)對(duì)象 */
val bitMatrix =
QRCodeWriter().encode(content, BarcodeFormat.QR_CODE, width, height, hints)
/** 3.創(chuàng)建像素?cái)?shù)組,并根據(jù)BitMatrix(位矩陣)對(duì)象為數(shù)組元素賦顏色值 */
val pixels = IntArray(width * height)
for (y in 0 until height) {
for (x in 0 until width) {
//bitMatrix.get(x,y)方法返回true是黑色色塊，false是白色色塊
if (bitMatrix[x, y]) {
pixels[y * width + x] = colorBlack //黑色色塊像素設(shè)置，可以通過傳入不同的顏色實(shí)現(xiàn)彩色二維碼，例如Color.argb(1,55,206,141)等設(shè)置不同的顏色。
} else {
pixels[y * width + x] = colorWhite // 白色色塊像素設(shè)置
}
}
}
/** 4.創(chuàng)建Bitmap對(duì)象,根據(jù)像素?cái)?shù)組設(shè)置Bitmap每個(gè)像素點(diǎn)的顏色值,并返回Bitmap對(duì)象 */
val bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)
bitmap.setPixels(pixels, 0, width, 0, 0, width, height)
bitmap
} catch (e: WriterException) {
e.printStackTrace()
null
}
//調(diào)用示例代碼
// imageView.setImageBitmap(QRCodeBitmap.newInstance().createQRCodeBitmap("test",80,80,
// "UTF-8","L","1", Color.BLACK,Color.WHITE));
}
參數(shù)說明：
- characterSet：編碼方式，通常采用UTF-8，格式不對(duì)可能會(huì)導(dǎo)致亂碼。
- errorCorrectionLevel：容錯(cuò)率，即使二維碼破損了一部分也能掃描的程度，容錯(cuò)率越高，二維碼能存儲(chǔ)的內(nèi)容也會(huì)隨之變小。主要等級(jí)分為：L：7% M：15% Q：25% H：35%。
- 顏色：顏色對(duì)應(yīng)二維碼生成時(shí)的顏色顯示，可以通過設(shè)置不用的顏色來實(shí)現(xiàn)彩色二維碼，如
Color.argb(1,55,206,141)
3. 二維碼嵌入logo
常見的二維碼中還可以嵌入logo，添加logo就是圖片合成，將logo圖片以一定比例合成在原二維碼圖片上，即將logo圖片直接拼接在二維碼的中心位置，示例代碼如下：
/***
* 為二維碼添加logo
*
* @param srcBitmap 二維碼圖片
* @param logoBitmap logo圖片
* @param percent logo比例
* @return 生成的最終的圖片
*/
fun addLogo(srcBitmap: Bitmap?, logoBitmap: Bitmap?, percent: Float): Bitmap? {
//判斷參數(shù)是否正確
if (srcBitmap == null)
return null
if (logoBitmap == null)
return srcBitmap
//輸入logo圖片比例錯(cuò)誤自動(dòng)糾正為默認(rèn)的0.2f
var logoPercent = percent
if (percent < 0 || percent > 1)
logoPercent = 0.2f
//分別獲取bitmap圖片的大小
var sHeight = srcBitmap.height
var sWidth = srcBitmap.width
var lHeight = logoBitmap.height
var lWidth = logoBitmap.width
//獲取縮放比例
var scareWidth = sHeight * logoPercent / lWidth
var scareHeight = sWidth * logoPercent / lHeight
//使用canvas重新繪制bitmap
var bitmap = Bitmap.createBitmap(sWidth, sHeight, Bitmap.Config.ARGB_8888)
var canvas = Canvas(bitmap)
canvas.drawBitmap(srcBitmap, 0f, 0f, null)
canvas.scale(
scareWidth,
scareHeight,
(sWidth / 2).toFloat(),
(sHeight / 2).toFloat()
) //設(shè)置縮放中心基點(diǎn)
canvas.drawBitmap(
logoBitmap,
(sWidth/2 - lWidth / 2).toFloat(),
(sHeight/2 - lHeight / 2).toFloat(),
null
)
return bitmap
}
4. 添加圖片展示效果
和生成不同顏色的二維碼本質(zhì)相同，其實(shí)現(xiàn)的基本邏輯就是在繪制二維碼的時(shí)候使用圖片的像素塊去取代當(dāng)前二維碼的非白色的像素塊，其他的步驟和基本生成二維碼的流程沒有區(qū)別，部分示例代碼如下：
//bitmapOther為傳入的需要展示的圖片效果的圖片，類型為bitmap
//先根據(jù)二維碼的大小生成等大的bitmap，方便直接獲取對(duì)應(yīng)的像素塊
var bitmapExtra: Bitmap? = null
if (bitmapOther != null) {
bitmapExtra = Bitmap.createScaledBitmap(bitmapOther, width, height, false)
}
...
if (bitMatrix.get(x, y)) {// 像素塊設(shè)置
if (bitmapExtra != null) {
//圖片不為null，則將黑色色塊換為新位圖的像素。
pixels[y * width + x] = bitmapExtra.getPixel(x, y);
} else {
//無圖片時(shí)默認(rèn)仍然為輸入顏色像素塊
pixels[y * width + x] = colorBlack;
}
} else {
pixels[y * width + x] = colorWhite;// 白色色塊像素設(shè)置
}
如果圖片的大部分顏色都比較淺，使用上述方法會(huì)影響到掃描效果，如果需要使用二維碼上附加圖片效果，盡量使用顏色較深的圖片。
