前言

小程序菊花码,相比与普通的二维码,辨识度高,一看知道拿微信扫。

默认情况下,我们可以自定义生成码的参数,路径,大小,自动或手动配置线条颜色,底色是否为透明这些配置项。

然而,这些配置项往往是无法满足我们的定制化需求的。

举个例子,我们需要在不破坏小程序码可识别性的情况下,把中间的Logo替换掉,怎么做呢? 接下来由笔者手把手来教你。

梳理思路

我们先要理清楚这个问题的本质。这个其实是个图像处理问题, 而这个工作服务端和客户端都能做。

于是有2个方案:

服务端生码并且缝合出结果的服务端处理方案。具体怎么做,有兴趣的同学,可以查看笔者的这篇文章Web 函数自定义镜像实战:构建图象处理函数

服务端生码,客户端缝合方案。这是本篇文章具体提及的。

注:小程序码一般由服务端调用微信api接口生成

云调用——生码简便方案

总所周知,微信小程序环境的wxacode.getUnlimited2种生成模式,一种为HTTPS 调用, 一种为云调用

其中云调用作为一种场景定制化的serverless解决方案,往往能为我们的开发,带来效率上的提升。我们接下来快速部署一个getWxacodeUnlimit函数,来为我们提供测试素材。

getWxacodeUnlimit/index.js:

import cloud from wx-server-sdkcloud.init({   env: cloud.DYNAMIC_CURRENT_ENV})export async function main (event, context) {   const { scene = , page, width = 430, autoColor, lineColor, isHyaline } = event   const result = await cloud.openapi.wxacode.getUnlimited({     scene,     page,     width,     autoColor,     lineColor,     isHyaline   })   return result}// 笔者使用了打包工具, 大家想直接跑,把 esm 转化为 cjs 即可

getWxacodeUnlimit/config.json:

{   “permissions”: {     “openapi”: [“wxacode.getUnlimited”]   }}

通过上述2段代码块,我们的测试函数部署完成了。

把返回的

const suffixMap = {   image/jpeg: jpeg,   …}export function getPath(filename = tmp, contentType = image/jpeg) {   return `${wx.env.USER_DATA_PATH}/${filename}.${suffixMap[contentType] || jpeg}`}export function writeFile(buff, contentType = image/jpeg, filename = tmp) {   return new Promise((resolve, reject) => {     const fsm = wx.getFileSystemManager()     const filePath = getPath(filename, contentType)     fsm.writeFile({       filePath,       data: buff,       encoding: binary,       success() {         resolve(filePath)       },       fail(error) {         reject(error)       }     })   })}….// 在需要用到的地方直接try {   loading(生成中)   const result = await getQrcode(scene, option) // 云调用封装function  return await writeFile(result.buffer, result.contentType, scene) // : string} catch (e) {   console.error(e)} finally {   loaded()}

客户端的图像处理

提到客户端图像处理不得不提到canvas这个原生组件了,所以我们只需要通过它,把小程序码中间的Logo部分,进行测量和裁剪替换为我们想自定义的图像可以了。

测量

这里以默认小程序码大小430px * 430px为例。(本case为了简单易懂,都使用的此分辨率的小程序码,如需求分辨率不同,可按比例进行计算裁剪。)

icebreaker手把手教你定制小程序码插图小程序码标注

从图上的标注可知,在430px * 430px分辨率下,上下左右的边距为120px,可以算出中间Logo圆形的直径为190px, 半径为95px

所以接下来可以轻松愉快的写代码了。

利用canvas 2d实现

1代小程序 api 版本被淘汰了,现在直接使用 type=”2d” 版本,Api文档在MDN

前置标签和样式

 {{}}` –>// scss .canvas.offscreen{ // 2个 class 选择器,增加优先级   position: absolute;   bottom: 0;   left: -9999rpx;   // 这叫物理离屏渲染,笑~ }注: 不能在canvas上 使用hiddenordisplay:none,它们会导致渲染空白。

核心 js 实现

初始化canvas实例和上下文

初始化canvas实例和ctx上下文:

let canvaslet ctx{…codes…}onReady(){   uni     .createSelectorQuery()     .in(this)  // 如果canvas在组件中,则需要加这一行    .select(canvas)     .fields({       node: true,       size: true     })     .exec((res) => {       if (res[0]) {         this.canvas = canvas = res[0].node         this.ctx = ctx = canvas.getContext(2d)         // 下面可根据设备的 pixelRatio 自行按比例调整,此处为了演示方便,就直接赋值了。        canvas.width = 430         canvas.height = 430       }     })}

次渲染-画布背景

次渲染,把小程序码,作为图像传入画布。drawBackgroud:

async drawBackgroud (orginQrcodeUrl) {   const [err, res] = await uni.getImageInfo({     // 这里可以是远程地址(需要配置downloadUrl)    // 也可以是本地地址(直接返回参数自己)    // 甚至 cloud:// 前缀的云存储url也可以哟    src: orginQrcodeUrl    })   if (err) {     throw err   }   const { path } = res   const img = canvas.createImage()   img.src = path   await new Promise((resolve, reject) => {     img.onload = () => {       // 下面这一行,把小程序码,整个铺进画布中!      ctx.drawImage(img, 0, 0, canvas.width, canvas.height)       resolve()     }     img.onerror = (event) => {       reject(event)     }   })},

第二次渲染-裁剪加填充

第二次渲染,把背景裁剪一个圆,并把图片填充进去。drawAvatar:

async drawAvatar (remoteAvatarUrl) {   const [err, res] = await uni.getImageInfo({     // 比如这里我用了云储存里的图像地址 prefix: cloud://    src: remoteAvatarUrl   })   if (err) {     throw err   }   const { path } = res   const img = canvas.createImage()   img.src = path   // 测量数据在这里用上了  const offsetX = 120 // x 轴偏移 120px  const offsetY = 120 // y 轴偏移 120px  const diam = 190 // 圆的直径 (430 – 120* 2) / 2  const radius = diam / 2 // 圆的半径  const borderWidth = 2 // 多加2px来把原先logo的纯色边抹除  const circle = { // 裁剪部分圆的大小属性    x: offsetX + radius,     y: offsetY + radius,     radius: radius + borderWidth    }   await new Promise((resolve, reject) => {     img.onload = () => {       ctx.save()       // 开始! 把原先中间的Logo干掉!      ctx.arc(circle.x, circle.y, circle.radius, 0, Math.PI 2, false)       ctx.clip()       // 结束      // 开始! 把我们需要的自定义图像,平铺的插入进去!      ctx.drawImage(         img,         offsetX – borderWidth,         offsetY – borderWidth,         circle.radius * 2,         circle.radius * 2       )       // 结束      ctx.restore()       resolve()     }     img.onerror = (event) => {       reject(event)     }   })},

通过以上几步 ,我们可以轻松的完成图像处理部分,把中间的默认Logo给替换成自定义的图像。

预览及下载到本地

// 获取 tempFilePathasync getImage () {   const [err, res] = await uni.canvasToTempFilePath({     canvas   })   if (err) {     throw err   }   return res.tempFilePath}// 预览async preview (src) {   if (src) {     uni.previewImage({       urls: [src]     })   }},// 保存到相册里async save (src) {   try {     // 先授权,后保存    await authorize(scope.writePhotosAlbum)     const [err, res] = await uni.saveImageToPhotosAlbum({       filePath: src     })     if (err) {       throw err     }     this.$success(保存成功!)   } catch (e) {     console.error(e)   }}

这样,客户端生成自定义小程序码的整套解决方案完成了

效果展示

icebreaker手把手教你定制小程序码插图1自定义码

或者微信搜索程序员名片后,维护名片,上传头像,再点击下方分享二维码按钮,即可预览。

icebreaker手把手教你定制小程序码插图2screenshot

自定义生成转发图片

这篇文章这个案例还算是非常简单的,笔者之前还写过一个小程序Canvas 2D自定义生成转发图片, 还有自定义分享海报,这些原理上都是大同小异的,一通百通。

附录

wxacode.getUnlimited接口文档

作者 nasiapp

在线客服
官方客服
我们将24小时内回复。
12:01
您好,有任何疑问请与我们联系!

选择聊天工具: