1.准备工作
APPID公众号id、申请好友分享接口、ip白名单、js接口安全域名设置(必须是通过备案)。要先登录微信公众平台进入“公众号设置”的功能设置里填写“JS接口域名”
2.引入js
注意:支持使用AMD/CMD标准加载方法
<script src="http://res.wx.qq.com/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="缩列图地址"/>