本文針對微信jssdk用法進行了詳細匯總,分享給大家,供大家參考,具體內容如下
1.綁定域名
2.引入js文件
在需要調用JS接口的頁面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.0.0.js
請注意,如果你的頁面啟用了https,務必引入 https://res.wx.qq.com/open/js/jweixin-1.0.0.js ,否則將無法在iOS9.0以上系統(tǒng)中成功使用JSSDK
3.通過config接口注入權限驗證配置
這一步是通過用當前的url向后臺發(fā)請求拿到一系列參數(shù)。即后臺會拿我的url去向微信進行認證。這里需要注意的事用于驗證的當前的url寫法,
let url = location.href.split(‘#')[0];
務必寫成以上形勢。否則會在進行config時報invalid signature,
確認url是頁面完整的url(請在當前頁面alert(location.href.split('#')[0])確認),包括'http(s)://'部分,以及'?'后面的GET參數(shù)部分,但不包括'#'hash后面的部分。
確保你獲取用來簽名的url是動態(tài)獲取的,動態(tài)頁面可參見實例代碼中php的實現(xiàn)方式。如果是html的靜態(tài)頁面在前端通過ajax將url傳到后臺簽名,前端需要用js獲取當前頁面除去'#'hash部分的鏈接(可用location.href.split('#')[0]獲取,而且需要encodeURIComponent),因為頁面一旦分享,微信客戶端會在你的鏈接末尾加入其它參數(shù),如果不是動態(tài)獲取當前鏈接,將導致分享后的頁面簽名失敗。
注意這里的動態(tài),不要隨便自己拼接,同時encodeURIComponent。
$.ajax({
type:'GET',
url: url,
dataType: 'jsonp'
})
.then((data)=> {
wx.config({
debug: true, // 開啟調試模式,調用的所有api的返回值會在客戶端alert出來,若要查看傳入的參數(shù),可以在pc端打開,參數(shù)信息會通過log打出,僅在pc端時才會打印。
appId: '', // 必填,公眾號的唯一標識
timestamp: , // 必填,生成簽名的時間戳
nonceStr: '', // 必填,生成簽名的隨機串
signature: '',// 必填,簽名,見附錄1
jsApiList: [] // 必填,需要使用的JS接口列表,所有JS接口列表見附錄2
});
})
4.通過ready接口處理成功驗證
config信息驗證后會執(zhí)行ready方法,所有接口調用都必須在config接口獲得結果之后,config是一個客戶端的異步操作,所以如果需要在頁面加載時就調用相關接口,則須把相關接口放在ready函數(shù)中調用來確保正確執(zhí)行。對于用戶觸發(fā)時才調用的接口,則可以直接調用,不需要放在ready函數(shù)中。
wx.ready (()=> {
// alert('ready');
//$('#onMenuShareAppMessage').on('click', ()=> {
// 分享給朋友
wx.onMenuShareAppMessage({
title: '',
desc: '',
link: shareUrl,
imgUrl: '',
trigger: function (res) {
// alert('用戶點擊發(fā)送給朋友');
},
success: function (res) {
alert('已分享');
},
cancel: function (res) {
alert('已取消');
},
fail: function (res) {
alert(JSON.stringify(res));
}
});
//});
//分享到朋友圈
wx.onMenuShareTimeline({
title: '', // 分享標題
link: shareUrl, // 分享鏈接
imgUrl: '', // 分享圖標
success: function () {
alert('已分享');
// alert($('.no-num').html());
},
cancel: function () {
alert('已取消');
// 用戶取消分享后執(zhí)行的回調函數(shù)
// alert('取消');
}
});
});
5.通過error接口處理失敗驗證
config信息驗證失敗會執(zhí)行error函數(shù),如簽名過期導致驗證失敗,具體錯誤信息可以打開config的debug模式查看,也可以在返回的res參數(shù)中查看
wx.error((res)=> {
alert(res.errMsg);
})
6.基礎接口
•分享到朋友圈接口
wx.onMenuShareTimeline({
title: '', // 分享標題
link: '', // 分享鏈接
imgUrl: '', // 分享圖標
success: function () {
// 用戶確認分享后執(zhí)行的回調函數(shù)
},
cancel: function () {
// 用戶取消分享后執(zhí)行的回調函數(shù)
}
});
•分享給好友的接口
wx.onMenuShareAppMessage({
title: '', // 分享標題
desc: '', // 分享描述
link: '', // 分享鏈接
imgUrl: '', // 分享圖標
type: '', // 分享類型,music、video或link,不填默認為link
dataUrl: '', // 如果type是music或video,則要提供數(shù)據(jù)鏈接,默認為空
success: function () {
// 用戶確認分享后執(zhí)行的回調函數(shù)
},
cancel: function () {
// 用戶取消分享后執(zhí)行的回調函數(shù)
}
});
如果這里需要在分享的內容中加入用ajax異步請求拿到的內容,必須在ajax請求返回后的成功函數(shù)中再調用一次該分享接口,但是必須將分享接口放在wx.ready函數(shù)中,不能單獨調用。因為客戶端分享操作是一個同步操作,這時候使用 ajax的數(shù)據(jù)還沒有返回。
7. 這些步驟看起來似乎比較簡單,但是調試的過程中難免會遇到很多問題,因為jssdk接口還是有很多的限制的。一不小心就踩到了坑。
8. 最后,我將這個接口進行了一下封裝。
'use strict';
let wxDefaultOptions = {
debug: true,
appId: '',
timestamp: 0,
nonceStr: '',
signature: '',
jsApiList: [
'checkJsApi',
'onMenuShareTimeline',
'onMenuShareAppMessage',
'onMenuShareQQ',
'onMenuShareWeibo',
'hideMenuItems',
'showMenuItems',
'hideAllNonBaseMenuItem',
'showAllNonBaseMenuItem',
'translateVoice',
'startRecord',
'stopRecord',
'onRecordEnd',
'playVoice',
'pauseVoice',
'stopVoice',
'uploadVoice',
'downloadVoice',
'chooseImage',
'previewImage',
'uploadImage',
'downloadImage',
'getNetworkType',
'openLocation',
'getLocation',
'hideOptionMenu',
'showOptionMenu',
'closeWindow',
'scanQRCode',
'chooseWXPay',
'openProductSpecificView',
'addCard',
'chooseCard',
'openCard'
]
};
//let shareUrl = 'http://xxx' + location.pathname;
let getWxParam = (url, wxOptions) => {
let url = location.href.split('#')[0];
url = encodeURIComponent(url);
let promise = new Promise((resolve, reject)=> {
$.ajax({
type:'GET',
url: 'http://xxx/xxx?param='+url,
dataType: 'jsonp'
})
.then((data)=> {
let wxParam = data;
console.log(wxParam);
wxOptions.appId = 'wxeb5c3f4a03b880f0';
wxOptions.timestamp = wxParam.timestamp;
wxOptions.nonceStr = wxParam.nonceStr;
wxOptions.signature = wxParam.signature;
wx.config(wxOptions);
wx.error((res)=> {
alert(res.errMsg);
})
resolve();
}, (error)=> {
console.log(error);
})
});
return promise;
}
//分享到朋友圈
let shareSocial = (param)=> {
wx.onMenuShareTimeline({
title: param.title, // 分享標題
link: param.link, // 分享鏈接
imgUrl: param.imgUrl, // 分享圖標
success: function () {
// 用戶確認分享后執(zhí)行的回調函數(shù)
param.suCallback();
},
cancel: function () {
// 用戶取消分享后執(zhí)行的回調函數(shù)
param.failCalback();
}
});
}
//分享給好友
let shareToFriends = (param) => {
wx.onMenuShareAppMessage({
title: param.title,
desc: param.desc,
link: param.link,
imgUrl: param.imgUrl,
trigger: function (res) {
},
success: function (res) {
param.suCallback();
},
cancel: function (res) {
},
fail: function (res) {
param.failCalback();
console.alert(JSON.stringify(res));
}
});
}
//title,desc,link,imgUrl,suCallback, failCalback
let jssdk = (param) => {
wx.ready(()=> {
//分享到朋友圈
shareSocial(param);
shareToFriends(param);
})
}
function callWx(param, wxoptions) {
getWxParam(param.url, wxOptions).then(()=> {
jssdk(param);
})
}
//param = {url: '', title:'',desc:'',link:'',imgUrl:'',suCallback:func, failCalback: func}
module.exports = {
wxDefaultOptions,//更改配置
callWx, //默認配置,進行config配置 和ready后定制微信分享內容,
}
以上就是本文的全部內容,希望對大家的學習有所幫助