随着小程序的普及,越来越多的宣传需要小程序码的配合,通过微信扫一扫直接打开小程序很简易方便.
这是微信官方对于小程序码的总述:
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/qr-code.html
微信官方文档给出了三种小程序码的生成方法:
1.createWXAQRCode
获取小程序二维码,适用于需要的码数量较少的业务场景。通过该接口生成的小程序码,永久有效,有数量限制,详见获取二维码。
https://developers.weixin.qq.com/miniprogram/dev/api/open-api/qr-code/createWXAQRCode.html
2.getWXACode
获取小程序码,适用于需要的码数量较少的业务场景。通过该接口生成的小程序码,永久有效,有数量限制,详见获取二维码。
https://developers.weixin.qq.com/miniprogram/dev/api/open-api/qr-code/getWXACode.html
3.getWXACodeUnlimit
获取小程序码,适用于需要的码数量极多的业务场景。通过该接口生成的小程序码,永久有效,数量暂无限制。 更多用法详见 获取二维码。
https://developers.weixin.qq.com/miniprogram/dev/api/open-api/qr-code/getWXACodeUnlimit.html
由于业务需求,我选择了第三种,getWXACodeUnlimit,主要是因为永久有效且数量暂无限制.
请注意,该接口生成的小程序码服务的是已经发布的小程序,对于正在开发中的小程序不能通过此接口获取小程序码.
获取小程序码需要发起POST请求:
https://api.weixin.qq.com/wxa/getWXACodeUnlimit?access_token='获取的accesstoken'
获取accessToken的链接:https://developers.weixin.qq.com/miniprogram/dev/api/open-api/access-token/getAccessToken.html
注意:POST 参数需要转成 JSON 字符串,不支持 form 表单提交。
POST请求中的参数:
string scene 小程序码中的参数(最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)),注意,在获取时,scene只对应一个字符串.所以有多个参数的情况,请根据自己参数的情况拼接字符串传入,在获取时根据拼接方法自行解析.
string page 必须是已经发布的小程序存在的页面(否则报错),例如 pages/index/index, 根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面
number width 二维码的宽度,默认为 430px,最小 280px,最大 1280px
boolean auto_color 自动配置线条颜色,如果颜色依然是黑色,则说明不建议配置主色调,默认 false
Object line_color auto_color 为 false 时生效,使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"} 十进制表示,默认全 0
boolean is_hyaline 是否需要透明底色,为 true 时,生成透明底色的小程序码,默认 false
返回值说明:
如果失败,接口返回json数据
如果成功,则直接返回图片格式文件,该链接可直接作为图片链接使用.
通过扫小程序码打开小程序,获取scene参数:
Page({
onLoad(options){
if (options.scene) {
// scene需要使用decodeURIComponent 才能获取到二维码生成是传入的scene
var params = decodeURIComponent(options.scene)
// TODO:根据个人需要处理参数params
}
}
})