FileSystemManager_微信小游戏开发API官方文档

icebreaker手把手教你定制小程序码

前言

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

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

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

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

梳理思路

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

于是就有 2 个方案:

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

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

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

云调用——生码最简便方案

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

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

getWxacodeUnlimit/index.js:

import?cloud?from?'wx-server-sdk'cloud.init({
??env:?cloud.DYNAMIC_CURRENT_ENV})export?async?function?main?(event,?context)?{
??const?{?scene?=?'',?page,?width?=?,?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为了简单易懂,都使用的此分辨率的小程序码,如需求分辨率不同,可按比例进行计算裁剪。)


小程序码标注


从图上的标注可知,在 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上 使用 hidden or display: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?=?
????????canvas.height?=?
??????}
????})}

第一次渲染-画布背景

第一次渲染,把小程序码,作为图像传入画布。 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?=??//?x?轴偏移?120px??const?offsetY?=??//?y?轴偏移?120px??const?diam?=??//?圆的直径?(?-?*?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)
??}}

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

效果展示


自定义码


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


screenshot


自定义生成转发图片

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

附录

wxacode.getUnlimited接口文档


原文链接:,转发请注明来源!