乐趣区

关于前端:钉钉小程序通过-Canvas-将页面生成图片并保存到本地相册

背景

最近公司有个账户充值业务场景须要从线下领取迁徙到线上领取:

  • 线下领取场景:客户通过 POS 机付款或者扫码销售同学提供的付款二维码进行付款来实现领取,之后销售同学将相干信息录入到 CRM 后盾,财务审核通过后才正式实现充值流程。
  • 线上领取场景:销售同学先在 CRM 钉钉小程序中录入充值信息后生成订单,而后系统生成支付宝或者微信付款码,销售同学将付款码页面生成的图片发送给客户,客户付款后即实现充值流程。

整个充值流程优化上线后,大大缩短了客户账户从充值付款到充值到账的工夫,明显提高了给客户账户充值的效率。

需要剖析

本次迭代性能的小程序是应用原生钉钉语言开发的小程序,至于为什么是原生语言开发,那是历史起因了,不在本文探讨范畴,原生语言开发体验显著没有应用了 uni-app、taro 等小程序框架的开发体验好,刚接手时还须要一边查文档一边开发,效率比拟低。

要实现线上领取性能,要解决的关键问题有以下两个:

  • 后端接口返回给小程序的是微信或支付宝的领取链接,小程序须要将它转成二维码显示到页面上
  • 页面上除了付款二维码,还有公司 logo,客户信息,付款金额等须要生成图片的信息,点击页面底部的保留图片按钮后,将上述信息生成图片并保留到本地相册

综合以上两步,实现需求在技术上要解决的问题包含以下几点:

  1. 应用 Canvas 将链接转成二维码, 显示到页面上,能够借助一个第三方库 weapp-qrcode 来实现,这个库是给微信小程序应用的,但钉钉小程序里也能够应用,须要改下源码
  2. 将整个页面的元素画到另一个 Canvas 上,但问题是如何将二维码 Canvas 画到另一个 Canvas 上呢,这一点开发时有遇到坑,前面会说,本次我是采纳了个小技巧,保留图片时,先应用 toTempFilePath 将二维码 Canvas 转成长期图片,而后画到另一个 Canvas 上,再应用 toTempFilePath 将另一个 Canvas 转成长期图片,最初应用 dd.saveImage 将长期图片保留到本地相册
  3. 小程序 Canvas 外面内容的自适应

技术实现

页面实现
    <view class="container">
            // 省略一些代码
            <canvas canvas-id="myQrCode" id="myQrCode" class="pay-code"></canvas>
            // 省略一些代码
    </view>
</view>

最终成果如下:

页面上的二维码就是应用 weapp-qrcode 实现的,因为原生小程序不能应用 npm 装置第三方库,所以咱们须要将源码下载到我的项目目录中,官网文档也给了应用示例:

我下载后须要改下源码,就是将 weapp.qrcode.esm.js 文件中应用到的微信小程序 api 替换成钉钉小程序的 api,全局搜寻 wx. 并替换为 dd.。

第一步:在页面引入插件:

import drawQrcode from '/utils/weapp.qrcode.esm.js'
const app = getApp()
page({data:{},
    onload() {}
})

第二步:在 onload 生命周期将二维码画到 Canvas 上:

import drawQrcode from '/utils/weapp.qrcode.esm.js'
const app = getApp()
page({data:{},
    onload(query) {
        let self = this
        let {qrCodeLink} = query
        setTimeout(() => {
            drawQrcode({
                width: 250,
                height: 250,
                canvasId: 'myQrCode',
                text: qrCodeLink,
            })
        }, 500)

    }
})

这一步有两个要留神的中央,一个是设置了一个倒计时,是为了保障执行 drawQrcode 的时候为了保障能获取到页面上的 canvas 了,否则二维码画不进去,另一个就是 canvas 的 id,插件上的 canvasId 对应的是页面元素上的 canvas-id 属性,而钉钉小程序的 canvasId 对应的是页面元素上的 id,这一点没留神到的话会影响下一步。

第三步:将二维码转为长期图片文件

import drawQrcode from '/utils/weapp.qrcode.esm.js'
const app = getApp()
page({
    data:{filePath: ''},
    onload() {
        let self = this
        let {qrCodeLink} = query
        setTimeout(() => {
            drawQrcode({
                width: 220,
                height: 220,
                canvasId: 'myQrCode',
                text: qrCodeLink,
            })
            setTimeout(() => {let ctx = dd.createCanvasContext('myQrCode')
                ctx.toTempFilePath({
                    fileType: "jpg",
                    quality: 1,
                    canvasId: 'myQrCode',
                    success: function(res) {
                        self.setData({filePath: res.filePath})
                    },
                    fail: function(e) {console.log('fail:', e)
                    }
                })
            }, 500)
        }, 500)
    }
})

这一步应用到了 toTempFilePath 办法,仍旧了设置了一个 1 秒的倒计时,为什么这样做呢? 因为上一步的 drawQrcode 是个耗时的同步工作,将 canvaas 转成图片前须要保障 canvas 曾经在页面上生成了。须要留神的是 dd.createCanvasContext(‘myQrCode’) 和 toTempFilePath 办法里的 canvasId 对应的是页面元素上的 id 属性。

第四步:使 Canvas 上的内容自适应

在 onload 生命周期里曾经获取到屏幕尺寸:

dd.getSystemInfo({success(res){
        self.setData({
            canWidth: res.windowWidth / 750, // 750 宽的设计稿
            canHeight: res.windowWidth / 750 * 1239 // 750px 宽设计稿导出图片的高度像素
        })
    }
})

设置最终要转成图片的 canvas 宽高:

<canvas style="width:{{canWidth*750}}px;height:{{canHeight}}px;position:absolute;left:-1000px;top:-1000px;"  canvas-id="myCanvas" id="myCanvas" class="myCanvas"></canvas>

同时我还设置了相对定位,目标是让这个画布脱离文档流并且显示在屏幕之外。

将元素绘制到 canvas 上:

let rpx = res.windowWidth / 750
const ctx = dd.createCanvasContext('myCanvas')
ctx.setFillStyle('#fff'); // 默认红色

ctx.drawImage('/static/icon/logo.png',rpx * 307, rpx * 32, rpx * 135.2, rpx * 64)
ctx.fillRect(0, 0, rpx * 750, res.windowWidth / 750 * 1239) // fillRect(x,y, 宽度,高度)

ctx.setFontSize(rpx * 56)
ctx.setFillStyle('#191F25')
ctx.setTextAlign('center')
ctx.fillText(self.data.shopName, rpx * 750 / 2, rpx * 176)

ctx.setFontSize(rpx * 24)
ctx.setFillStyle('#333333')
ctx.fillText('档口 ID:'+ self.data.shopId, rpx * 750 / 2, rpx * 246)

ctx.setFontSize(rpx * 28)
ctx.setFillStyle('#333333')
ctx.fillText('领取金额', rpx * 750 / 2, rpx * 338)

ctx.setFontSize(rpx * 48)
ctx.setFillStyle('#333333')
ctx.fillText('¥' + self.data.totalAmount, rpx * 750 / 2, rpx * 396)

ctx.drawImage(self.data.bankType == 2 ? '/static/icon/wechat.png' : '/static/icon/alipay.png',rpx * 153, rpx * 478, rpx * 64, rpx * 64)

ctx.setFontSize(rpx * 28)
ctx.setFillStyle('#333333')
ctx.setTextAlign('left')
ctx.fillText(self.data.bankType == 2 ? '微信' : '支付宝', rpx * 236, rpx * 520)

ctx.setFontSize(rpx * 28)
ctx.setFillStyle('#3296FA')
ctx.setTextAlign('left')
ctx.fillText('请应用' + (self.data.bankType == 2 ? '微信' : '支付宝') + '扫一扫', rpx * 355, rpx * 500)

ctx.setFontSize(rpx * 28)
ctx.setFillStyle('#3296FA')
ctx.fillText('扫描二维码领取', rpx * 355, rpx * 544)
ctx.drawImage(self.data.filePath, rpx * 149, rpx * 570, rpx * 452, rpx * 458)

ctx.setFontSize(rpx * 24)
ctx.setFillStyle('#919497')
ctx.setTextAlign('center')
ctx.fillText('充值单号', rpx * 750 / 2, rpx * 1095)

ctx.setFontSize(rpx * 24)
ctx.setFillStyle('#919497')
ctx.setTextAlign('center')
ctx.fillText(self.data.applyId, rpx * 750 / 2, rpx * 1134)

ctx.draw(true)

下面代码中的数值都是间接在设计稿上量进去的乘以 rpx 后就能自适应显示了。

最初一步:将 canvas 转成图片并保留到相册,这些操作在 draw 办法的回调办法里执行:

dd.showLoading() // 点击保留图片按钮后展现 loading
let rpx = res.windowWidth / 750
const ctx = dd.createCanvasContext('myCanvas')
// 省略一些代码
ctx.draw(true, (()=>{setTimeout(()=>{
        ctx.toTempFilePath({
            fileType: "jpg",
            quality: 1,
            canvasId: 'myCanvas',
            success: function(res) {
                dd.saveImage({
                    url: res.filePath,
                    showActionSheet: true,
                    success: () => {dd.hideLoading()
                        dd.alert({title: '保留胜利',});
                    },
                    fail: function() {dd.hideLoading()
                            dd.alert({title: '保留失败',});
                    }
                });
            },
            fail: function() {dd.hideLoading()
                    dd.alert({title: '保留失败',});
            }
        })
    }, 1000)
})())

到这里就根本实现需求了,当然还有能够优化的中央。导出的图片效果图如下:

总结

需要是实现了,但还是有几个点是值得再思考一下的:

  • canvas 转成图片后不清晰的问题
  • 保留图片到相册时,如果用户已禁止钉钉拜访相册的话,如果给予用户敌对的提醒

程度无限,文中不免有不足之处,欢送大家与我交换。

退出移动版