优化 cl-qrcode 组件 logo 区域绘制,提升扫码识别率

This commit is contained in:
icssoa
2025-08-22 23:48:00 +08:00
parent 8c1d924faf
commit 22402d55f1
2 changed files with 32 additions and 20 deletions

View File

@@ -72,10 +72,10 @@ const props = defineProps({
type: String,
default: ""
},
// logo 大小,支持 px/rpx 单位
// logo 大小,支持 px/rpx 单位 (建议不超过二维码尺寸的20%以确保识别率)
logoSize: {
type: String,
default: "50px"
default: "40px"
},
// 二维码边距,单位 px
padding: {

View File

@@ -211,10 +211,15 @@ export function drawQrcode(context: CanvasContext, options: QrcodeOptions) {
): boolean {
if (logoSize <= 0) return false;
// 计算logo在矩阵中占用的点数
const logoPoints = Math.ceil(logoSize / px);
// 添加缓冲区logo周围额外空出1个点的距离
const buffer = 1;
// 计算logo在矩阵中占用的点数限制最大不超过二维码总宽度的25%
// 根据二维码标准中心区域最多可以遮挡约30%的数据但为了确保识别率我们限制在20%
const maxLogoRatio = 0.2; // 20%的区域用于logo
const maxLogoPoints = Math.floor(width * maxLogoRatio);
const logoPoints = Math.min(Math.ceil(logoSize / px), maxLogoPoints);
// 减少缓冲区,只保留必要的边距,避免过度遮挡数据
// 当logo较小时不需要缓冲区当logo较大时才添加最小缓冲区
const buffer = logoPoints > width * 0.1 ? 1 : 0;
const totalLogoPoints = logoPoints + buffer * 2;
// 计算logo区域在矩阵中的中心位置
@@ -322,17 +327,17 @@ export function drawQrcode(context: CanvasContext, options: QrcodeOptions) {
img = new Image(options.logoSize, options.logoSize);
// #endif
// 设置图片源并在加载完成后绘制
img.src = options.logo;
// 设置图片加载完成后的回调,然后设置图片源
img.onload = () => {
drawLogo(ctx, options, img);
};
img.src = options.logo;
}
}
/**
* 在二维码中心绘制Logo
* 在二维码中心位置绘制Logo图片,并添加白色背景
* 在二维码中心位置绘制Logo图片,优化背景处理以减少对二维码数据的影响
* @param ctx Canvas上下文
* @param options 二维码配置
* @param img Logo图片对象
@@ -345,15 +350,19 @@ function drawLogo(ctx: CanvasRenderingContext2D, options: QrcodeOptions, img: Im
const contentCenterX = options.padding + contentSize / 2;
const contentCenterY = options.padding + contentSize / 2;
// 添加额外的背景边距,与数据点避让区域保持一致
const backgroundPadding = 6; // 背景比logo大6px
// 优化背景处理:减少背景边距,最小化对二维码数据的影响
// 背景边距从6px减少到3px降低对数据点的遮挡
const backgroundPadding = 3; // 背景比logo大3px
const backgroundSize = options.logoSize + backgroundPadding * 2;
// 绘制白色背景作为Logo的底色大于logo
ctx.fillStyle = "#fff";
// 绘制白色背景作为Logo的底色适当大于logo以确保可读性
ctx.fillStyle = options.background; // 使用二维码背景色而不是固定白色,保持一致性
const backgroundX = contentCenterX - backgroundSize / 2;
const backgroundY = contentCenterY - backgroundSize / 2;
ctx.fillRect(backgroundX, backgroundY, backgroundSize, backgroundSize);
// 绘制圆角背景让logo与二维码更好融合
const cornerRadius = Math.min(backgroundSize * 0.1, 6); // 背景圆角半径
drawRoundedRect(ctx, backgroundX, backgroundY, backgroundSize, backgroundSize, cornerRadius);
// 获取图片信息后绘制Logo
uni.getImageInfo({
@@ -363,14 +372,17 @@ function drawLogo(ctx: CanvasRenderingContext2D, options: QrcodeOptions, img: Im
const logoX = contentCenterX - options.logoSize / 2;
const logoY = contentCenterY - options.logoSize / 2;
// 绘制Logo图片,四周留出3px边距
// 绘制Logo图片减少边距从3px到1.5px让logo更大一些
const logoPadding = 1.5;
const actualLogoSize = options.logoSize - logoPadding * 2;
// #ifdef APP-HARMONY
ctx.drawImage(
img,
logoX + 3,
logoY + 3,
options.logoSize - 6,
options.logoSize - 6,
logoX + logoPadding,
logoY + logoPadding,
actualLogoSize,
actualLogoSize,
0,
0,
imgInfo.width,
@@ -379,7 +391,7 @@ function drawLogo(ctx: CanvasRenderingContext2D, options: QrcodeOptions, img: Im
// #endif
// #ifndef APP-HARMONY
ctx.drawImage(img, logoX + 3, logoY + 3, options.logoSize - 6, options.logoSize - 6);
ctx.drawImage(img, logoX + logoPadding, logoY + logoPadding, actualLogoSize, actualLogoSize);
// #endif
ctx.restore(); // 恢复之前的绘图状态