微信内H5页面唤起小程序

2020-12-19 本文已影响0人南城FE

微信开放标签是微信公众平台面向网页开发者提供的扩展标签集合。通过使用微信开放标签，网页开发者可安全便捷地使用微信或系统的能力，为微信用户提供更优质的网页体验。此文档面向网页开发者，介绍微信开放标签如何使用及相关注意事项。需要注意的是，微信开放标签有最低的微信版本要求，以及最低的系统版本要求。微信版本要求为：7.0.12及以上。系统版本要求为：iOS 10.3及以上、Android 5.0及以上。

开放标签使用步骤

1.绑定域名

登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”, JS接口安全域名对应H5页面域名地址

2.引入JS文件

在需要调用JS接口的页面引入如下JS文件：http://res.wx.qq.com/open/js/jweixin-1.6.0.js （支持https）

也支持npm包方式引入, 版本需==1.6.0==及以上

3.通过config接口注入权限验证配置并申请所需开放标签

与使用JS-SDK配置方式相同，所有需要使用开放标签的页面必须先注入配置信息，并通过openTagList字段申请所需要的开放标签，否则将无法使用（同一个url仅需调用一次）。

wx.config({
  debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印
  appId: '', // 必填，公众号的唯一标识
  timestamp: , // 必填，生成签名的时间戳
  nonceStr: '', // 必填，生成签名的随机串
  signature: '',// 必填，签名
  jsApiList: [], // 必填，需要使用的JS接口列表
  openTagList: [] // 可选，需要使用的开放标签列表，例如['wx-open-launch-app']
});

4.页面唤起小程序代码

<wx-open-launch-weapp
    id="launch-btn"
    username="gh_XXXXX"
    weappid="wxd44d0XXX0f0dXXX"
    path="/pages/page/page.html?id=aaa"
>
    <script type="text/wxtag-template">
        <!--html页面展示代码-->
    </script>
</wx-open-launch-weapp>

注意点

1.此功能的开放对象

已认证的服务号，服务号绑定“JS接口安全域名”下的网页可使用此标签跳转任意合法合规的小程序。
已认证的非个人主体的小程序，使用小程序云开发的静态网站托管绑定的域名下的网页，可以使用此标签跳转任意合法合规的小程序。

2.参数说明

username 所需跳转的==小程序原始id==，即小程序对应的以gh_开头的id, 注意不是公众号的id
对于path属性，所声明的页面路径必须添加.html后缀，如pages/home/index.html
如果跳转提示缺少ID, 检查username对应原始ID是否正确

3. Vue项目中会报错该标签不存在, 在main.js文件中添加忽略代码

// 忽略打开微信小程序的组件
Vue.config.ignoredElements = ['wx-open-launch-weapp']

参考

开放标签说明文档