为了h5页面在微信分享效果更好,我们接入了 h5 微信sdk,下面对接入流程总结。

1、在项目中引用微信的js-sdk

js-sdk地址(支持https):http://res.wx.qq.com/open/js/... 或者 http://res2.wx.qq.com/open/js...

2、在微信公众平台绑定安全域名

3、配置config

在1,2步操作成功后,进入我们写代码正题,我们需要在入口js中配置config

wx.config({    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。    appId: '',     timestamp: ,     nonceStr: '',     signature: '',    jsApiList: [] });

参数说明:

  • appId:公众号的唯一标识,在公众号中可以取到;
  • timestamp:生成签名的时间戳
  • nonceStr: 生成签名的随机串
  • signature: 最后生成的签名
  • jsApiList: 需要使用的JS接口列表,我们这里是用分享接口,将分享几个api接口填进去,例如:['updateAppMessageShareData', 'updateTimelineShareData', 'onMenuShareQQ']

(备注:出于安全考虑,微信要求开发者必须在服务器端实现签名的逻辑,故timestamp, nonceStr,signature 可以通过请求自己服务器返回。如果有兴趣了解是如何生成的,如下图1所示。)

图1

4、wx.ready中配置自定义分享信息

config 配置玩成功后,可以在wx.ready回调填写自定义的信息,如下:

 wx.ready(function () {      wx.onMenuShareQQ({ //分享QQ        title: data.wxTitle, // 分享标题        link: data.href, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致且分享的地址不要带端口        desc: data.wxDesc,        imgUrl: data.wxImg || defaultIcon, // 分享图标        success: function () {          // 用户确认分享后执行的回调函数          // alert(e);        },        cancel: function () {          // 用户取消分享后执行的回调函数        }      });      wx.updateAppMessageShareData({ // 分享好友        title: data.wxTitle, // 分享标题        link: data.href, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致且分享的地址不要带端口        desc: data.wxDesc,        imgUrl: data.wxImg || defaultIcon, // 分享图标        type: "", // 分享类型,music、video或link,不填默认为link        dataUrl: "", // 如果type是music或video,则要提供数据链接,默认为空        success: function (e) {          // 用户点击了分享后执行的回调函数          // alert(e);        }      });      wx.onMenuShareTimeline({ // 分享朋友圈        title: data.wxTitle, // 分享标题        link: data.href, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致且分享的地址不要带端口        desc: data.wxDesc,        imgUrl: data.wxImg || defaultIcon, // 分享图标        success: function (e) {          // 用户点击了分享后执行的回调函数          // alert(e)        }      });    });

总结

到这一步分享的操作基本就完成了,建议在测试时将debug打开,看看分享提示,从而判定是否分享成功。如果不成功,可以参考一下在开发时候遇到的坑。

  • 出现nvalid url domain提示
    1)检查当前页面所在域名与使用的appid没有绑定,请确认正确填写绑定的域名,仅支持80(http)和443(https)两个端口,因此不需要填写端口号。
    2)检查生成signature是否正确,可以通过签名校验工具来判定后端传过来的nonceStr、timestamp与请求后端接口传的地址,与最后签名是否一致。
    3) config时,nonceStr 记得驼峰写法哦。
  • 提示是成功的,但是分享出来图标不见或者desc不显示的情况
    1) 分享的地址不要带端口号哦,我们之前带了3000端口,造成出现了这种情况。
    2)分享desc 不要带有敏感词汇,我们带礼包之类的词汇,竟然被也出现这种情况...

以上是对本次微信分享的总结,如果需要更详细的了解内容,可以从微信官网文档更深入的了解。

参考资料:微信官网文档点击查看