阅读 5051

手把手教你实现H5微信分享

导语

使用微信分享,可以获得更好的传播效果。那如何利用微信公众号向好友进行信息分享呢?

这里以分享 微信红包 为例,手把手教大家实现微信授权与分享。

步骤一. 用户信息获取

1. 注册测试公众号

我们在 https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 可以申请一个测试账号,在测试号管理的页面中能够看到我们appId等信息,这里有个接口配置信息修改的选项需要我们去填写

avatar

这里就要麻烦后端的同学为我们提供URL和Token(URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者任意填写,用作生成签名) 该Token会和接口URL中包含的Token进行比对,从而验证安全性。

2. 微信网页授权

在项目中需要获取用户个人信息,比如手机号和微信头像等,这里我们需要微信网页授权才可以实现,首先在微信测试号管理中找到体验接口权限表

avatar

点击修改进入:

avatar

将你网页的域名添加进去,配置完成后我们对这个路径进行访问https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect 即可拿到code值,从而拿到openid等个人信息。

3. 配置后路径的修改

① .appid为我们测试号中的appid

② .redirect_uri为我们页面路径,访问微信提供的路径会获取code值重定向到我们页面路径(这里的url需要进行urlEncode`处理)

③ . scope的值有两种:

  • snsapi_base为静默授权,用户无感知,但是只能获取到openid,拿不到其他信息。
  • snsapi_userinfo是弹框询问授权,确认授权后可以获取到openid进而拿到昵称、头像等信息

这样我们就可以授权得到用户信息:

avatar

可能遇到的问题

  • scope参数错误或没有scope权限,检查scope参数赋值snsapi_basesnsapi_userinfo
  • redirect_uri参数错误,检查网页授权页面域名配置问题,复制的时候空格也要注意
  • response_type参数错误,检查url路径是否进行了urlEncode处理

步骤二. 微信JS-SDK使用

微信JS-SDK是微信公众平台 面向网页开发者提供的基于微信内的网页开发工具包,通过JS-SDK可以使用微信分享、支付、扫一扫等功能,这里我们使用到了微信分享。

1. js安全域名配置

使用JS-SDK首先找到测试号的JS接口安全域名,配置上页面使用的域名

avatar

2. 引入JS-SDK

在项目中我们引入JS-SDk的资源,可通过 http://res.wx.qq.com/open/js/jweixin-1.4.0.js(支持https) 或者通过模块化加载引入 import wx from 'weixin-js-sdk'

3. 获取签名配置config

在这一步还需要RD的同学给我们支持,提供一个微信签名的接口,详情见下图

avatar

拿到签名后我们对config进行设置,config设置完成后会调用ready方法,我们在ready方法里可以进行业务逻辑处理。

步骤三. 分享接口

getSignature (){ //获取微信签名
  return new Promise((resolve, reject)=>{
    Axios.get(API.getWechatSign,{
    params:{
      appid: appId,
      url: window.location.href.split('#')[0]
    } 
    }).then( res => {
      resolve(res.data)
    }).catch((err)=>{
      reject(err)
    })
  })
},
async setWx(){
  let res = await this.getSignature()
  let {timestamp, nonceStr, appId, signature} = res
  wx.config({
    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
    appId: appId, // 必填,公众号的唯一标识
    timestamp: timestamp, // 必填,生成签名的时间戳
    nonceStr: nonceStr, // 必填,生成签名的随机串
    signature: signature, // 必填,签名
    jsApiList: ["onMenuShareTimeline", "onMenuShareAppMessage"] // 必填,需要使用的JS接口列表
  });
  wx.ready(() => {
    wx.onMenuShareTimeline({
      title: '测试分享', // 分享标题
      link: window.location.href,// 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
      imgUrl: 'http://icon.mobanwang.com/UploadFiles_8971/200910/20091011134333685.png',// 分享图标
      success: function() {
        // 用户点击了分享后执行的回调函数
      }
    });
    wx.onMenuShareAppMessage({
      title: '测试分享', // 分享标题
      desc: '一个测试的分享!!!', // 分享描述
      link: window.location.href, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
      imgUrl: 'http://icon.mobanwang.com/UploadFiles_8971/200910/20091011134333685.png', // 分享图标
      type: "", // 分享类型,music、video或link,不填默认为link
      dataUrl: "", // 如果type是music或video,则要提供数据链接,默认为空
      success: function() {
        // 用户点击了分享后执行的回调函数
      }
    })
  })
}
复制代码

这样我们就实现一个微信分享,效果如下图: 分享给好友

avatar

分享到朋友圈

avatar

常见问题

  1. invalid url domain 检查js安全域名是否正确
  2. invalid signature 这个问题范围比较大:
    • 检查签名接口是否正确,微信提供了校验工具http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign
    • config中写法问题,注意大小写nonceStr
    • 签名入参的时候url路径不能含有'#'hash部分
    • 分享出去的链接域名必须与公众号js安全域名保持一致
    • debug显示config:ok却分享出去没效果,查看分享的方法和js-sdk版本

写在最后

微信网页开发时候最主要的就是环境配置问题,细心配置避免坑点。公众号中js的安全域名可配置三个,网页授权域名为两个,开发项目需要提前留意这些点。还有要关注测试号里的公众号。这样一个红包项目所需要的功能基本完成。

还想说

整个项目开发涉及到很多端支持,以快狗打车为例,有司机端、用户端、支付等。将微信分享功能抽离成一个独立的服务,实现统一化、标准化,以便支持各个业务线使用,这也是我们快狗打车的实战之一。

关注下面的标签,发现更多相似文章
评论