声明:由于时间有限,目前仅对微信一部分接口进行了封装,陆续会持续增加封装,敬请关注!
微信公众平台 WeixinApi 感谢WeixinApi 因为使用习惯,同时也欢迎大家共同来维护
WeixinApi 的诞生
腾讯官方于2015年1月9日发布了微信的JS-SDK,详细接口可以参考:见微信JS-SDK说明文档 由于微信官方的接口互相独立,但是在事件使用中,我们可能会是很多接口一起使用,所以直接使用官方的接口比较麻烦,重复代码相对较多。为了更方便的使用,我对官方的接口进行了简单的封装,并开源处理,方便大家使用。
快速使用
1、引入js文件 由于该接口是对微信官方js的封装,需要同时引入微信官方的js-sdk文件和JWeixinApi的js文件。引入如下两个文件:
在需要调用JS接口的页面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.4.0.js
WeixinApi.js
2、通过config接口注入权限验证配置 该步骤和官方文档一样,详情微信JS-SDK说明文档
wx.config({
debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
appId: '', // 必填,公众号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名,见附录1
jsApiList: [] // 必填,需要使用的JS接口列表,所有JS接口列表见附录2
});
3、通过ready接口处理成功验证
wx.ready(function(){
// config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});
4、分享功能
wx.ready(function(){
// 初始化wx对象
WeixinApi.ready(wx);
// 微信分享的数据
var wxData = {
"imgUrl" : "http://www.jiayouxiaogui.cn/images/logo.png",// 分享图标
"link" : "http://www.jiayouxiaogui.cn", //分享链接
"desc" : "家有小鬼", //分享描述
"title" : "家有小鬼" // 分享标题
};
// 分享的回调函数
var wxCallbacks={
success:function(res){
// 用户确认分享后执行的回调函数
alert("success");
}
};
// 用户点开右上角popup菜单后,点击分享给好友,会执行下面这个代码
WeixinApi.shareToFriend(wxData, wxCallbacks);
// 点击分享到朋友圈,会执行下面这个代码
WeixinApi.shareToTimeline(wxData, wxCallbacks);
}
5、隐藏右上角option menu入口
wx.ready(function(){
//隐藏右上角的option menu
WeixinApi.hideOptionMenu();
//显示
//WeixinApi.showOptionMenu();
//批量隐藏功能按钮接口
//WeixinApi.hideMenuItems();
//批量显示功能按钮接口
//WeixinApi.showMenuItems();
//隐藏所有非基础按钮接口
//WeixinApi.hideAllNonBaseMenuItem();
//显示所有功能按钮接口
//WeixinApi.showAllNonBaseMenuItem();
}
6、隐藏底部工具栏
wx.ready(function(){
// 隐藏
WeixinApi.hideToolbar();
// 显示
// WeixinApi.showToolbar();
}