1.准备工作
APPID公众号id、申请好友分享接口、ip白名单、js接口安全域名设置(必须是通过备案)。要先登录微信公众平台进入“公众号设置”的功能设置里填写“JS接口域名”
2.引入js
注意:支持使用AMD/CMD标准加载方法
<script src="http://res./open/js/jweixin-1.2.0.js"></script>
3.通过config接口注入权限验证配置
所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用(同一个url仅需要调用一次,对于变化url的SPA的web app可在每次url变化时进行调用,目前Android微信客户端不支持pushShate的H5新特性,所以使用pushState来实现web app的页面会导致签名失败,此问题在Android6.2修复)
wx.config({debug: true, //开启调试模式,调用所有的api的返回值会在客户端alert出来,若要查看传入的参数,可以在PC端打印出来appId: '', //必填,公账号的唯一标识timestamp: '', //必填,生成签名的时间戳nonceStr: '', //必填,生成签名的随机串signature: '', //必填,签名jsApiList: [ //必填,需要使用js列表,否则无法分享成功'onMenuShareTimeline',//朋友圈'onMenuShareAppMessage', //朋友'onMenuShareQQ', //QQ'onMenuShareWeibo', //QQ空间]})
4.通过ready接口处理成功验证
wx.ready(function(){//config信息验证后会执行ready方法,所有接口调用必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中});
5.通过error接口处理失败验证
wx.error({//config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名});
js代码
var data = {title: '',summary: '',pic: '',url: '',success: function(){getWeixin() ;//用户确认分享后执行的回调函数},cancel: function(){//用户取消分享后执行的回调函数}}wx.config({swapTitleInWX: true,appId: "<?php echo $weixin_package['appid'];?>",timestamp: "<?php echo $weixin_package['timestamp'];?>",nonceStr: "<?php echo $weixin_package['noncestr'];?>",signature: "<?php echo $weixin_package['signature'];?>",jsApiList: ['onMenuShareTimeline','onMenuShareAppMessage','onMenuShareQQ','onMenuShareWeibo',]})wx.ready(function () {wx.onMenuShareTimeline(data);wx.onMenuShareAppMessage(data);wx.onMenuShareQQ(data)wx.onMenuShareWeibo(data)})
注意点:
title,建议在14个字以内图片尺寸: 300*300像素;图片格式:大小不超过10kB,不支持GIF格式;会取当前页面body内最前面的一张符合条件的图片对标题简要解读,建议20字以内link:'', //分享链接,改链接域名或路径必须与当前页面对应的公账号JS安全域名一致
二、QQ分享
QQ是通过head里面的标签来识别分享的图标和标题,涉及到h5微数据的一个属性itemprop,
<meta itemprop="name" content="标题"/><meta itemprop="description" name="description" content="描述"/><meta itemprop="image" content="缩列图地址"/>