背景
在小程序中佃蚜，可以直接分享小程序到聊天窗口，但是無(wú)法分享小程序到朋友圈谐算，但是朋友圈又是一個(gè)重要的推廣場(chǎng)地，所以分享小程序碼就成了重要途徑氯夷。常常被朋友圈刷屏的各種帶有小程序碼的海報(bào)臣樱，就是一個(gè)應(yīng)用場(chǎng)景雇毫。
普通的分享小程序碼飘蚯，直接在后臺(tái)放一個(gè)通用的小程序碼就可以了福也。但是如果需要分享一個(gè)特定路徑+參數(shù)的小程序碼就必須要借助小程序提供的API來(lái)實(shí)現(xiàn)了暴凑。
此次來(lái)和大家說(shuō)一說(shuō)如何利用云函數(shù)來(lái)實(shí)現(xiàn)獲取特定路徑+參數(shù)的小程序碼峦甩。
接口
云函數(shù)為我們提供了三種獲取小程序碼的API：
| 名稱 | 功能說(shuō)明 |
|---|---|
| wxacode.createQRCode | 獲取小程序二維碼，適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景 |
| wxacode.get | 獲取小程序碼现喳，適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景 |
| wxacode.getUnlimited | 獲取小程序碼凯傲，適用于需要的碼數(shù)量極多的業(yè)務(wù)場(chǎng)景 |
前兩個(gè)都有數(shù)量限制犬辰，無(wú)法滿足一些類似詳情分享的場(chǎng)景，所以留給我們的道路只有wxacode.getUnlimited接口了冰单。
先來(lái)看一下這個(gè)接口的主要參數(shù)：
| 屬性 | 說(shuō)明 |
|---|---|
| scene | 最大32個(gè)可見(jiàn)字符幌缝，只支持?jǐn)?shù)字，大小寫英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~诫欠，其它字符請(qǐng)自行編碼為合法字符（因不支持%涵卵，中文無(wú)法使用 urlencode 處理，請(qǐng)使用其他編碼方式） |
| page | 必須是已經(jīng)發(fā)布的小程序存在的頁(yè)面（否則報(bào)錯(cuò)）呕诉，例如 pages/index/index, 根路徑前不要填加 /,不能攜帶參數(shù)（參數(shù)請(qǐng)放在scene字段里）缘厢，如果不填寫這個(gè)字段，默認(rèn)跳主頁(yè)面 |
其他參數(shù)就不一一列舉了甩挫，有需要可以直接去官方文檔查看贴硫。
根據(jù)上面的參數(shù)，我們可以指定任意page伊者，而且還可以傳入頁(yè)面參數(shù)英遭，最終在小程序頁(yè)面加載的時(shí)候，通過(guò)options來(lái)獲取到scene亦渗，從而做數(shù)據(jù)加載挖诸。
實(shí)現(xiàn)
云函數(shù)
先來(lái)看一下云函數(shù)如何配置。
新建一個(gè)云函數(shù)qrcode后法精，在config.json中配置如下：
{
"permissions": {
"openapi": [
"wxacode.getUnlimited"
]
}
}
然后在index.js中加入如下代碼：
// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函數(shù)入口函數(shù)
exports.main = async(event, context) => {
try {
let param = {
// 小程序傳入的 scene 參數(shù)
scene: event.scene,
// 可以換成任意 page
page: 'pages/index/index',
};
// 調(diào)用接口
var result = await cloud.openapi.wxacode.getUnlimited(param)
return result
} catch (err) {
return err
}
}
然后部署到云端多律，云函數(shù)部分就完成了。
小程序
再來(lái)看看小程序端如何調(diào)用：
requestQrcode(scene) {
let that = this;
wx.cloud.callFunction({
name: 'qrcode',
data: {
scene: scene
}
})
.then((res) => {
let path = wx.env.USER_DATA_PATH + '/' + res.requestID + '.jpg'
if (res.result.contentType == 'image/jpeg') {
// 返回的結(jié)束是 base64 編碼的二進(jìn)制流
// 這里直接保存到文件
wx.getFileSystemManager()
.writeFile({
filePath: path,
data: res.result.buffer,
encoding: 'base64',
success: (res) => {
},
fail: (res) => {
}
})
} else {
// 異常處理
}
})
},
最終在頁(yè)面的onLoad(options)中可以這樣獲取到小程序碼傳遞的參數(shù)scene：
onLoad: function(options) {
let scene = options.scene;
},
這樣就完成了利用云函數(shù)來(lái)生成特定路徑+參數(shù)的小程序碼了搂蜓，后面就可以利用這個(gè)小程序碼來(lái)繪制海報(bào)狼荞。
問(wèn)題
不知道你是否注意到scene參數(shù)有一個(gè)限制,最大32個(gè)可見(jiàn)字符，有時(shí)候很容易就超出了帮碰，那豈不是就沒(méi)法用了相味？
沒(méi)有什么可以難倒程序員！如果有殉挽，那一定是需求不合理~
短鏈丰涉，一個(gè)很好的方案。把所有的參數(shù)生成一個(gè)唯一的短鏈斯碌，作為scene參數(shù)傳遞一死，最后在加載的時(shí)候先解析短鏈，就可以獲取到超長(zhǎng)參數(shù)啦~
小技巧
如果你不需要給頁(yè)面?zhèn)魅雲(yún)?shù)傻唾，直接在小程序管理平臺(tái)最上方摘符，有個(gè)工具->生成小程序碼，填上頁(yè)面路徑就可以生成小程序碼素材啦~
