Skip to content

多种途径打开小程序

URL Scheme

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html

通过服务端接口或在小程序管理后台「工具」-「生成 URL Scheme」入口可以获取打开小程序任意页面的 URL Scheme。适用于从 短信、邮件、微信外网页 等场景打开小程序。 通过 URL Scheme 打开小程序的场景值为 1065

生成的 URL Scheme 如下所示:

weixin://dl/business/?t= *TICKET*

iOS 系统支持识别 URL Scheme,可在短信等应用场景中直接通过 Scheme 跳转小程序。 Android 系统不支持直接识别 URL Scheme,用户无法通过 Scheme 正常打开小程序,开发者需要使用 H5 页面中转,再跳转到 Scheme 实现打开小程序,跳转代码示例如下:

location.href = 'weixin://dl/business/?t= *TICKET*'

该跳转方法可以在用户打开 H5 时立即调用,也可以在用户触发事件后调用。

注:只能生成已发布的小程序的 URL Scheme

wx-open-launch-weapp

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_Open_Tag.html#开放标签说明文档

适用于微信内网页打开小程序,需引入 JS-SDK 做鉴权处理

用于页面中提供一个可跳转指定小程序的按钮。使用此标签后,用户需在网页内点击标签按钮方可跳转小程序。H5通过开放标签打开小程序的场景值为1167

扫普通链接二维码

https://developers.weixin.qq.com/miniprogram/introduction/qrcode.html#功能介绍

对于普通链接二维码,目前支持使用微信“扫一扫”或微信内长按识别二维码跳转小程序

https://developers.weixin.qq.com/miniprogram/dev/reference/scene-list.html

含多种扫码场景值

配置流程

登录小程序后台,进入“设置-开发设置-扫普通链接二维码打开小程序”,开启功能后即可配置二维码规则。

二维码内容获取

二维码链接内容会以参数 q 的形式带给页面,在onLoad事件中提取 q 参数并自行 decodeURIComponent 一次(对于小游戏可使用 wx.getEnterOptionsSync 接口获取),即可获取原二维码的完整内容。同时会附加一个参数 scancode_time(UNIX 时间戳,单位秒),表示用户扫码的时间。

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

校验文件

下载随机校验文件,并将文件上传至服务器指定位置的目录下,方可通过所属权校验。 验证文件放置规则: 放置于URL中声明的最后一级子目录下,若无子目录,则放置于host所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。

测试调试

开发者可对已配置的二维码规则进行测试和调试。 测试仅对指定的测试链接和测试范围内的微信用户生效,其他用户扫码后跳转网页,不影响全网用户正常使用。在二维码规则发布后,开发者仍然可以选择在指定版本(开发版/体验版/线上版本)下测试,请注意扫码用户要打开开发版必须提交过代码。

测试链接

填写符合二维码前缀匹配规则的二维码完整链接用于测试,如包括参数,请完整填写。 一个规则可以填写不多于5个测试链接,可多次修改。若二维码与测试链接匹配,且用户微信号是小程序指定的管理员/开发者/体验者,将打开指定版本的小程序。

注:开发时配置体验版时需同时配置测试链接,且用户微信号是小程序指定的管理员/开发者/体验者,否则会打开到正式版

公众号自动回复小程序文字链接

https://developers.weixin.qq.com/community/develop/article/doc/000ce41a2a4e08e973fafded857813

// 140字符限制
<a href="xxx" data-miniprogram-appid="xxx" data-miniprogram-path="xxx">点击跳小程序</a>
  • href: 如果无法正常跳转小程序,备用跳转的H5链接

  • data-miniprogram-appid:要跳转的目标小程序appid

  • data-miniprogram-path:要跳转的小程序页面地址