又来需求了:微信支持外网打开小程序!

前言

千呼万唤始出来,微信小程序终于支持以URL Scheme的形式从外部唤起了。

long long ago~ 我们只能在微信内的网页中使用微信开发标签-小程序跳转按钮
打开小程序,只有这样一种单一的场景。
而在实际的业务中,我们希望在给用户发送的营销短信、邮件或其他渠道如APP打开小程序,以快速获取用户流量,完成引流、导购等目的。

他来啦,他来啦,微信小程序悄咪咪的上线了新功能:支持 URL Scheme打开小程序
了。

新品上线

URL Scheme打开小程序新品上线,速来尝鲜。
我们首先来看下目前微信官方提供的两种打开微信小程序的方式以及相关适用场景。

打开方式 适用场景 场景值 使用方式 备注
URL Scheme 短信、邮件、 微信外
网页打开小程序
1065 location.href = 'weixin://dl/business/?t= *TICKET*' TICKET由服务端接口返回
微信内
网页
1167 页面配置
标签
需配置JS接口域名或云开发静态网站托管绑定的域名下网页

一定要注意区分两种方式的适用场景:URL scheme是适用于微信外网页,
是适用于微信内的。

小程序URL Scheme的获取

小程序的URL Scheme的结构为 weixin://dl/business/?t= *TICKET*
,其中 TICKET
由服务端接口返回的。服务端接口区分两种形式: HTTPS调用
云开发调用

一、HTTPS调用

  1. 获取ACCESS_TOKEN

    请求地址:

    GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

    对应的APPID和APPSECRET换成自己对应的小程序即可。
    返回的数据结构如下:

    {
    "access_token": "ACCESS_TOKEN",
    "expires_in": 7200
    }

  2. 获取URL Scheme

    请求地址:

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

    请求参数:

    属性 类型 默认值 必填 说明
    access_token string 接口调用凭证
    jump_wxa Object 跳转到的目标小程序信息。
    is_expire boolean false 生成的scheme码类型,到期失效:true,永久有效:false。
    expire_time number 到期失效的scheme码的失效时间,为Unix时间戳。生成的到期失效scheme码在该时间前有效。最长有效期为1年。生成到期失效的scheme时必填。

    jump_wxa 的结构

    属性 类型 默认值 必填 说明
    path string 通过scheme码进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带query。path为空时会跳转小程序主页。
    query string 通过scheme码进入小程序时的query,最大128个字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~

    请求示例:

    {
    "jump_wxa": {
    "path": "/pages/index/index",
    query": ""
    },
    "
    is_expire": true,
    "
    expire_time": 1606737600
    }

    返回结果:

    {
    "errcode": 0,
    "errmsg": "ok",
    "openlink": Scheme,
    }

    openlink就是我们最终需要的URL Scheme啦~

二、云调用
云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用

请求参数:

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
jump_wxa Object 跳转到的目标小程序信息。
isExpire boolean false 生成的scheme码类型,到期失效:true,永久有效:false。
expireTime number 到期失效的scheme码的失效时间,为Unix时间戳。生成的到期失效scheme码在该时间前有效。最长有效期为1年。生成到期失效的scheme时必填。

注意和HTTPS中参数名大小写不一致的情况

jump_wxa 的结构

属性 类型 默认值 必填 说明
path string 通过scheme码进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带query。path为空时会跳转小程序主页。
query string 通过scheme码进入小程序时的query,最大128个字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~

请求示例:

const cloud = require('wx-server-sdk')
cloud.init({
env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
try {
const result = await cloud.openapi.urlscheme.generate({
jumpWxa: {
path: '/pages/index/index',
query: ''
},
isExpire: true,
expireTime: 1606737600
})
return result
} catch (err) {
return err
}
}

返回结果:

{
"errcode": 0,
"errmsg": "ok",
"openlink": Scheme,
}

openlink就是我们最终需要的URL Scheme啦~

小程序URL Scheme的使用

小程序URL Scheme的结构是: weixin://dl/business/?t= *TICKET*
,那我们拿到这个scheme之后如果使用呢。

IOS
系统下是支持直接识别 URL Scheme
的,所以可以直接将 URL Scheme
发送到短信、邮件中,提供给用户使用。但是在 Android
系统不支持直接识别 URL Scheme
,用户无法Scheme正常打开小程序,所以需要开发者自行使用H5页面进行中转,再跳转使用Scheme方式打开微信小程序。

使用方式 备注
Android location.href='weixin://dl/business/?t= *TICKET*' 只有一种方式
IOS 直接识别URL Scheme 或使用location.href方式 两种方式

But, 我们要注意一个问题,当我们进行短信触达时,无法确定用户所使用的的手机设备是 IOS
还是 Android

So, 我们从实际的业务触发,都需要一个H5页面进行中转处理。

小程序唤起业务流程图

当当当,综合两种打开小程序的方式(URL Scheme和
),完整版的小程序唤起业务流程图来啦~

小程序唤起业务流程图