一、功能介绍: 1、简介 为了方便小程序开发者更便捷地推广小程序,兼容线下已有的二维码,微信公众平台开放扫描普通链接二维码跳转小程序能力。
2、功能 普通链接二维码,是指开发者使用工具对网页链接进行编码后生成的二维码。线下商户可不需更换线下二维码,在小程序后台完成配置后,即可在用户扫描普通链接二维码时打开小程序,使用小程序的功能。对于普通链接二维码,目前支持使用微信“扫一扫”或微信内长按识别二维码跳转小程序。
二、开放范围: 企业、媒体、政府及其他组织类型小程序。
三、二维码跳转规则: 微信客户端扫码将按以下匹配规则控制跳转: 《a》二维码链接的协议、域名与已配置的二维码规则一致。 《b》二维码链接属于后台配置的二维码规则的子路径。(如需支持子路径匹配,请确认后台配置的二维码规则以/结尾) 《c》 如果二维码规则包含参数,链接?后为参数部分,参数要求前缀匹配。
四、二维码内容获取: 在小程序后台配置二维码跳转小程序规则之后即可使用微信(6.5.6及其以上客户端版本)扫码打开小程序。二维码链接内容会以参数q的形式带给页面,在onLoad事件中提取q参数并自行decodeURIComponent一次,即可获取原二维码的完整内容。
五、配置流程: 1、二维码规则 【1】二维码规则的域名须通过ICP备案的验证。 【2】支持http、https、ftp开头的链接(如:、 【3】一个小程序帐号可配置不多于10个二维码前缀规则。
2、前缀占用规则 开发者可选择是否占用符合二维码匹配规则的所有子规则。如选择占用,则其他帐号不可申请使用满足该前缀匹配规则的其他子规则。如:若开发者A配置二维码规则:
3、校验文件 下载随机校验文件,并将文件上传至服务器指定位置的目录下,方可通过所属权校验。验证文件放置规则: 放置于URL中声明的最后一级子目录下,若无子目录,则放置于host所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。
4、小程序功能页面 配置扫描二维码后打开的小程序功能页面路径,如:pages/index/index。
5、测试调试 开发者可对已配置的二维码规则进行测试和调试。测试仅对指定的测试链接和测试范围内的微信用户生效,其他用户扫码后跳转网页,不影响全网用户正常使用。在二维码规则发布后,开发者仍然可以选择在指定版本(开发版/体验版/线上版本)下测试。 【1】测试范围 开发者可根据开发进度选择在开发板/体验版/线上版本测试“普通二维码跳转小程序”的功能。 【2】测试链接 填写符合二维码前缀匹配规则的二维码完整链接用于测试,如包括参数,请完整填写。一个规则可以填写不多于5个测试链接,可多次修改。若二维码与测试链接匹配,且用户微信号是小程序指定的管理员/开发者/体验者,将打开指定版本的小程序。
6、发布 测试完成后开发者可将二维码跳转规则发布现网,发布后扫描所有符合匹配规则的二维码,将跳转至指定的小程序页面。为确保用户体验,小程序必须先发布代码才可以发布二维码跳转规则。一个小程序帐号一个月可发布不多于20次二维码跳转规则。