西海岸关于小程序未上线二维码识别功能开发

 发布时间:2018-04-04     |      25662 次浏览

近期接触了小程序开发,发现我们可以使用微信小程序提供的接口来生成小程序二维码,具体如何操作可以参见这里:微信小程序获取二维码。

我们使用的是接口B:

https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN

发现有个坑:未上线的小程序生成二维码时如果传入的page未上线,那么会生成失败。但是我们线上肯定是需要跳转到指定页面的,所以测试起来就比较蛋疼。各方咨询,最终结果依然是未上线无法测试。。。

page要求:必须是已经发布的小程序存在的页面(否则报错),例如 "pages/index/index" ,根路径前不要填加'/',不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面

我们看一下微信官方提供的一些内容:

注意:通过该接口生成的小程序码,永久有效,数量暂无限制。用户扫描该码进入小程序后,开发者需在对应页面获取的码中 scene 字段的值,再做处理逻辑。 
使用如下代码可以获取到二维码中的 scene 字段的值。调试阶段可以使用开发工具的条件编译自定义参数 scene=xxxx 进行模拟,开发工具模拟时的 scene 的参数值需要进行 urlencode

// 这是首页的 jsPage({  onLoad: function(options) {    // options 中的 scene 需要使用 decodeURIComponent 才能获取到生成二维码时传入的 scene    var scene = decodeURIComponent(options.scene)  }})

也就是说我们可以在通过开发工具的条件编译自定义参数模拟。这个方法我这边没有尝试。

我们就按照最有可能正确的方式去做。对于后端是这样传值的:

  scene = "uid=" + uid + "&cid=" + cid; Map twoDimensionMap = this.getTwoDimensionForWX(accessToken, page, scene);

其中的getTwoDimensionForWX是我们自定义的方法,里面是调用微信的接口:

public Map getTwoDimensionForWX (String accessToken, String page, String scene){        Map map = Maps.newHashMap();        Map resultMap = Maps.newHashMap();        map.put("page", page);        map.put("scene", scene);        Map headers = Maps.newHashMap();        String method = "POST";        headers.put("Content-Type", "application/json; charset=UTF-8");        Map querys = Maps.newHashMap();        String bodys = JSONObject.toJSONString(map);     String host = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + accessToken;     HttpResponse res =HttpUtils.doPost(host, "", method, headers, querys, bodys);//res就是我们拿到的二维码数据}

这样写就可以成功获取到二维码(发布线上之后), 因此后端发布时这样写就ok。(这里的方法只有一部分,并不完全,但完全可以表达出来意思)

接下来就是微信小程序端的处理:

  onLoad: function (options) {    // 扫描二维码获取的数据    if (options.scene) {      var scene = decodeURIComponent(options.scene)      // var scence = options.scene;      var arrPara = scene.split("&");      var arr = [];      var testData = {};      for (var i in arrPara) {        arr = arrPara[i].split("=");        if (i == 0) {          testData.uid = arr[1];        } else {          testData.cid = arr[1]        }      }      //这里的testData就包括了uid和cid    }  },

小程序端按照这种方式处理就可以了。

想想也是这个逻辑,微信那边只是把scene做了encode处理,里面的数据只是一个字符串,所以我们使用的时候后端传的内容是什么,我们小程序端取到的数据就是什么,所以如果按照我上面呢的那种方式传值,需要对字符串进行分割获取需要数据。

另外需要注意一点:那就是scene的字符限制:

最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)

以上便是对生成码和扫码的逻辑处理。