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

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

我们使用的是接口B：

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

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

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

 

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

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

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

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

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

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

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

public Map<String, Object> getTwoDimensionForWX (String accessToken, String page, String scene){
        Map<String, String> map = Maps.newHashMap();
        Map<String, Object> resultMap = Maps.newHashMap();
        map.put("page", page);
        map.put("scene", scene);
        Map<String, String> headers = Maps.newHashMap();
        String method = "POST";
        headers.put("Content-Type", "application/json; charset=UTF-8");
        Map<String, String> 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 处理，请使用其他编码方式）

 

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