在小程序中生成分享海报是一个很常见的需求,目前主要有以下两种做法:
直接由前端生成,使用小程序提供的 canvas
API
本文将介绍通过知晓云「云函数」来生成分享海报的功能,并使用 webpack
和 mincloud
将代码打包上传到知晓云。
技术栈:
代码打包工具: webpack@4.22.0
部署工具:mincloud@1.0.4
图片处理:gm@1.23.1
其他:知晓云 SDK
、imageMagick
(云函数内置)
一、项目搭建
项目文件结构:
gm-draw-image
├── index.js
├── package.json
├── src
│ └── index.js
├── webpack.config.js
└── yarn.lock
项目搭建与云函数代码打包示例文档基本一致。项目搭建好后,还需要安装以下依赖(两种安装方式选其一即可):
// 使用 yarn 安装
yarn add gm mincloud
// 使用 npm 安装
npm install --save gm mincloud
修改 deploy
脚本,如下:
// package.json
...
"scripts": {
"build": "webpack --mode production",
"predeploy": "npm run build",
"deploy": "mincloud deploy gm-draw-image ../"
},
...
最终我们会使用以下两个命令来部署和测试:
npm run deploy // 部署到知晓云
mincloud invoke gm-draw-image // 测试已经部署到知晓云上的云函数
二、生成海报
这里分为 4 个步骤:
- 下载海报需要的资源
- 图片 / 文本处理
- 海报绘制
- 将绘制完成的海报上传到知晓云
使用知晓云 Node SDK 的 request
方法将资源下载下来(不能直接使用其他第三方 request
包):
BaaS.request.get(url)
.then(res => {})
.catch(err => {})
引入 gm 库对图片进行处理,云函数沙箱环境已经内置 `imageMagick` 工具:
const gm = require('gm').subClass({ imageMagick: true })
在处理文字的时候需要注意,设置字体时需选择知晓云已支持的字体,详见文档文档。
另外,这里有一个 bug:在同一个图层中,如果填充颜色之前有填充图片操作,那么后续填充的颜色将会不起作用。推荐的做法是如果有需要同时填充图片以及填充颜色,建议将这两个操作分开处理,最后再合成一张图。
bug 示例如下:
gm(width, height, 'none')
.fill(bg) // 填充了一张图片
.drawRectangle(`0, 0, ${width}, ${height}`)
.fill('#fff') // 字体颜色,这个操作不起作用
.fontSize(20)
.drawText(140, 170, 'mincloud')
下载图片,图片保存路径需在 `/tmp/` 路径下:
BaaS.request.get(url, {responseType: 'arraybuffer'})
.then(res => {})
.catch(err => {})
上传图片到知晓云:
var MyFile = new BaaS.File()
MyFile.upload(img, {filename: 'test.png'})
完整代码如下:
const fs = require('fs')
const gm = require('gm').subClass({ imageMagick: true })
// 海报资源
const avatarImg = 'https://cloud-minapp-6.cloud.ifanrusercontent.com/1gQ5Mat7WAwyW1hl.jpg'
const backgroundImg = 'https://cloud-minapp-6.cloud.ifanrusercontent.com/1gQ7hCpFCK1qw8XQ.jpeg'
const MyFile = new BaaS.File()
const imageSize = {
width: 375,
height: 250,
}
function downloadImage(url) {
const filename = `/tmp/${Math.random().toString().slice(2)}.jpg`
const file = fs.createWriteStream(filename)
return BaaS.request.get(url, {responseType: 'arraybuffer'}).then(res => {
file.write(res.data)
file.end()
return filename
})
}
function uploadImage(buffer) {
return MyFile.upload(buffer, {filename: Math.random().toString().slice(2) + '.png'})
}
function drawText(filename) {
return new Promise((resolve, reject) => {
gm(imageSize.width, imageSize.height, 'none')
// 设置字体以及文字大小,这里只能设置云函数已支持的字体
.font('/usr/share/fonts/ttf-bitstream-vera/VeraMoBd.ttf')
.fill('#fff')
.fontSize(20)
.drawText(140, 170, 'mincloud')
.fill('#fff')
.fontSize(14)
.drawText(30, 200, 'An easy-to-use MiniApp development tool.')
.write(filename, function(err) {
if (err) {
return reject(err)
}
resolve(filename)
})
})
}
function genAvatar(avatar) {
return new Promise((resolve, reject) => {
gm(avatar)
.resize(100, 100)
.write(avatar, function(err) {
if (err) {
return reject(err)
}
resolve(avatar)
})
})
}
function genBackground(bg) {
return new Promise((resolve, reject) => {
gm(bg)
.resize(500, 350)
.blur(20, 2)
.write(bg, function(err) {
if (err) {
return reject(err)
}
resolve(bg)
})
})
}
module.exports = function (event, callback) {
const {width, height} = imageSize
const job1 = downloadImage(backgroundImg).then(res => genBackground(res))
const job2 = downloadImage(avatarImg).then(res => genAvatar(res))
const job3 = drawText('/tmp/textLayer.png')
Promise.all([job1, job2, job3]).then(res => {
gm(width, height, 'none')
.fill(res[0])
.drawRectangle(`0, 0, ${width}, ${height}`) // 绘制背景
.fill(res[1])
.drawCircle(190, 80, 190, 125) // 绘制头像
.fill(res[2])
.drawRectangle(`0, 0, ${width}, ${height}`) // 绘制文本
.toBuffer('PNG', function (err, buffer) {
if (err) {
return callback(err)
}
uploadImage(buffer).then((res) => {
console.log('success')
callback(null, res.data.file_link)
}).catch(err => {
callback(err)
})
})
})
}
三、部署并测试
跟 npm
一样,部署前需要先登录,请参照文档配置。
使用以下命令即可将云函数部署到知晓云:
npm run deploy
执行结果如下:
使用以下的命令来测试:
mincloud invoke image-crawler
执行结果如下:
上传到知晓云的图片如下:
生成的海报效果图:
素材原图:
四、参考文档
知晓云开发文档:https://doc.minapp.com/
gm 官方文档:http://aheckmann.github.io/gm/docs.html
五、源码
仓库地址:https://github.com/ifanrx/gm-draw-image