普通二维码打开微信小程序的接入流程

01. 准备项

一个小程序账号
一个已备案的域名

02. 微信小程序后台配置

1、点击『开发』 - 『开发管理』 - 『开发设置』，翻到扫普通链接二维码打开小程序。

2、点击右侧『添加』配置普通链接二维码规则

• 协议规则
  • 每种链接二维码只支持一种协议（如果设置成https，则http访问不会生效）

• 选择大小写

• 二维码规则
  • 访问的域名URL，如www.a.com/
  • 域名需要备案

• 前缀占用规则
  • 假设配置的二维码规则是www.a.com/，当选择占用后，其他小程序将无法使用www.a.com/来打开小程序。

• 校验文件
  • 点击下载校验文件，下载文件。
  • 假设配置的二维码规则是www.a.com/，则把文件传到该目录下，保证通过www.a.com/{验证文件名}.txt能够访问到文件

• 小程序功能页面
  • 打开后跳转到的小程序页面URL
  • 可以在onLoad方法中通过参数q来读取传入的自定义参数

• 测试范围
  • 通过扫描二维码能够打开的小程序版本
  • 三个选项对应的范围说明：
    • 开发版：通过扫码会打开当前开发者上传的开发版本（如果当前用户未上传开发版本则无法打开）
    • 体验版：通过扫码会打开被设置为体验版的小程序版本
    • 线上版本：通过扫码会打开已发布的小程序版本

• 测试链接
  • 在小程序未发布至线上环境时，可以配置最多5个测试链接来测试小程序扫码打开功能

03. 小程序配置项

在配置的小程序功能页面中，通过onLoad方法获取对应的扫码传参

1
2
3
4
5
6

Page({
    onLoad(query) {
        const q = decodeURIComponent(query.q) // 获取到二维码原始链接内容
        const scancode_time = parseInt(query.scancode_time) // 获取用户扫码时间 UNIX 时间戳
    }
})

04. 其他文档

扫普通链接二维码打开小程序 | 微信开放文档