关联普通二维码

产品介绍

普通二维码是指开发者使用工具对网页链接进行编码后生成的二维码。

商户可不需更换线下二维码，通过在小程序后台完成配置后，用户用支付宝扫描普通二维码即可打开小程序并跳转到指定页面。

接入指引

配置规则

此功能需要小程序使用的 IDE 版本号高于 0.9.0。普通二维码关联小程序最多可设置20条规则undefined

9fcba1f86faa83e7.png

二维码地址

二维码地址须通过ICP备案的验证，支持http、https、ftp开头的链接（如：http://www.alipay.com、https://www.alipay.com/my/、https://www.alipay.com/my?id=123）

匹配规则

支持按域名“精确匹配”和“模糊匹配”两种方式：

  • 精确匹配：根据填写的二维码地址精确匹配，地址完全一致时才能唤起小程序（如：配置二维码地址为 https://www.alipay.com/my?id=123 ，当用户扫这个地址的二维码可唤起小程序）。
  • 模糊匹配：根据填写的二维码地址模糊匹配，只要地址前缀匹配即可唤起小程序（如：配置二维码地址为 https://www.alipay.com/my/ ，当用户扫的二维码地址为 https://www.alipay.com/my/id=123 ,可唤起小程序）。

校验文件

下载随机校验文件，并将校验文件放置于配置域名的根目录下，方可通过所属权校验。上传后，点击确认校验文件即可正常访问。为保持验证通过的状态，成功验证后请不要删除校验文件。

小程序功能页面

配置扫描二维码后打开的小程序功能页面路径，如：pages/index/index。

调试测试

开发者可对已配置的二维码规则进行测试和调试，可扫系统生成的二维码来进行测试。该配置可对体验版和开发版生效，当扫体验版/开发版二维码唤起体验版小程序后，再扫普通二维码即可唤起对应版本的小程序来测试开发的新功能。

9b7a6bbf6feb46b5.png

获取二维码码值请在小程序 app.js 文件的 app() 的 onlanch() 方法中使用 options.query 获取，小程序代码示例如下：

  1. onlaunch(options){
  2.     my.alert({
  3.       title: 'app onLaunch',
  4.       content:  JSON.stringify(options),
  5.       success: (res) => {
  6.           //成功处理代码段
  7.       },
  8.     });
  10.   //获取关联普通二维码的码值，放到全局变量qrCode中
  11.   if (options.query && options.query.qrCode) {
  12.       this.qrCode = options.query.qrCode;
  13.     }  
  14. }
参数名描述
path当前路径。若没有填写目标页面，那么当前路径为首页（如下图）；若填写则返回目标页面的路径
qrCode二维码码值

无标题.png

发布

测试完成后开发者可将二维码跳转规则发布上线，发布后扫描所有符合匹配规则的二维码，将跳转至指定的小程序页面。

f724208944c0de24.png

IDE调试启动参数

比如普通二维码码值是 http://商户网站域名?bb=cc&dd=ff

  • 对其做 URLENCODE ，得到http%3a%2f%2f%e5%95%86%e6%88%b7%e7%bd%91%e7%ab%99%e5%9f%9f%e5%90%8d%3fbb%3dcc%26dd%3dff。
  • 打开 IDE 顶部功能区中的添加编译模式，选择自定义编译undefined
  • 在之前得到的参数前面加上 “qrCode=” 后填入启动参数并确认undefined
  • 在模拟器中进行调试