本文針對(duì)微信jssdk用法進(jìn)行了詳細(xì)匯總,分享給大家,供大家參考,具體內(nèi)容如下
1.綁定域名
2.引入js文件
在需要調(diào)用JS接口的頁(yè)面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.0.0.js
請(qǐng)注意,如果你的頁(yè)面啟用了https,務(wù)必引入 https://res.wx.qq.com/open/js/jweixin-1.0.0.js ,否則將無(wú)法在iOS9.0以上系統(tǒng)中成功使用JSSDK
3.通過(guò)config接口注入權(quán)限驗(yàn)證配置
這一步是通過(guò)用當(dāng)前的url向后臺(tái)發(fā)請(qǐng)求拿到一系列參數(shù)。即后臺(tái)會(huì)拿我的url去向微信進(jìn)行認(rèn)證。這里需要注意的事用于驗(yàn)證的當(dāng)前的url寫(xiě)法,
let url = location.href.split(‘#')[0];
務(wù)必寫(xiě)成以上形勢(shì)。否則會(huì)在進(jìn)行config時(shí)報(bào)invalid signature,
確認(rèn)url是頁(yè)面完整的url(請(qǐng)?jiān)诋?dāng)前頁(yè)面alert(location.href.split('#')[0])確認(rèn)),包括'http(s)://'部分,以及'?'后面的GET參數(shù)部分,但不包括'#'hash后面的部分。
確保你獲取用來(lái)簽名的url是動(dòng)態(tài)獲取的,動(dòng)態(tài)頁(yè)面可參見(jiàn)實(shí)例代碼中php的實(shí)現(xiàn)方式。如果是html的靜態(tài)頁(yè)面在前端通過(guò)ajax將url傳到后臺(tái)簽名,前端需要用js獲取當(dāng)前頁(yè)面除去'#'hash部分的鏈接(可用location.href.split('#')[0]獲取,而且需要encodeURIComponent),因?yàn)轫?yè)面一旦分享,微信客戶(hù)端會(huì)在你的鏈接末尾加入其它參數(shù),如果不是動(dòng)態(tài)獲取當(dāng)前鏈接,將導(dǎo)致分享后的頁(yè)面簽名失敗。
注意這里的動(dòng)態(tài),不要隨便自己拼接,同時(shí)encodeURIComponent。
$.ajax({
type:'GET',
url: url,
dataType: 'jsonp'
})
.then((data)=> {
wx.config({
debug: true, // 開(kāi)啟調(diào)試模式,調(diào)用的所有api的返回值會(huì)在客戶(hù)端alert出來(lái),若要查看傳入的參數(shù),可以在pc端打開(kāi),參數(shù)信息會(huì)通過(guò)log打出,僅在pc端時(shí)才會(huì)打印。
appId: '', // 必填,公眾號(hào)的唯一標(biāo)識(shí)
timestamp: , // 必填,生成簽名的時(shí)間戳
nonceStr: '', // 必填,生成簽名的隨機(jī)串
signature: '',// 必填,簽名,見(jiàn)附錄1
jsApiList: [] // 必填,需要使用的JS接口列表,所有JS接口列表見(jiàn)附錄2
});
})
4.通過(guò)ready接口處理成功驗(yàn)證
config信息驗(yàn)證后會(huì)執(zhí)行ready方法,所有接口調(diào)用都必須在config接口獲得結(jié)果之后,config是一個(gè)客戶(hù)端的異步操作,所以如果需要在頁(yè)面加載時(shí)就調(diào)用相關(guān)接口,則須把相關(guān)接口放在ready函數(shù)中調(diào)用來(lái)確保正確執(zhí)行。對(duì)于用戶(hù)觸發(fā)時(shí)才調(diào)用的接口,則可以直接調(diào)用,不需要放在ready函數(shù)中。
wx.ready (()=> {
// alert('ready');
//$('#onMenuShareAppMessage').on('click', ()=> {
// 分享給朋友
wx.onMenuShareAppMessage({
title: '',
desc: '',
link: shareUrl,
imgUrl: '',
trigger: function (res) {
// alert('用戶(hù)點(diǎn)擊發(fā)送給朋友');
},
success: function (res) {
alert('已分享');
},
cancel: function (res) {
alert('已取消');
},
fail: function (res) {
alert(JSON.stringify(res));
}
});
//});
//分享到朋友圈
wx.onMenuShareTimeline({
title: '', // 分享標(biāo)題
link: shareUrl, // 分享鏈接
imgUrl: '', // 分享圖標(biāo)
success: function () {
alert('已分享');
// alert($('.no-num').html());
},
cancel: function () {
alert('已取消');
// 用戶(hù)取消分享后執(zhí)行的回調(diào)函數(shù)
// alert('取消');
}
});
});
5.通過(guò)error接口處理失敗驗(yàn)證
config信息驗(yàn)證失敗會(huì)執(zhí)行error函數(shù),如簽名過(guò)期導(dǎo)致驗(yàn)證失敗,具體錯(cuò)誤信息可以打開(kāi)config的debug模式查看,也可以在返回的res參數(shù)中查看
wx.error((res)=> {
alert(res.errMsg);
})
6.基礎(chǔ)接口
•分享到朋友圈接口
wx.onMenuShareTimeline({
title: '', // 分享標(biāo)題
link: '', // 分享鏈接
imgUrl: '', // 分享圖標(biāo)
success: function () {
// 用戶(hù)確認(rèn)分享后執(zhí)行的回調(diào)函數(shù)
},
cancel: function () {
// 用戶(hù)取消分享后執(zhí)行的回調(diào)函數(shù)
}
});
•分享給好友的接口
wx.onMenuShareAppMessage({
title: '', // 分享標(biāo)題
desc: '', // 分享描述
link: '', // 分享鏈接
imgUrl: '', // 分享圖標(biāo)
type: '', // 分享類(lèi)型,music、video或link,不填默認(rèn)為link
dataUrl: '', // 如果type是music或video,則要提供數(shù)據(jù)鏈接,默認(rèn)為空
success: function () {
// 用戶(hù)確認(rèn)分享后執(zhí)行的回調(diào)函數(shù)
},
cancel: function () {
// 用戶(hù)取消分享后執(zhí)行的回調(diào)函數(shù)
}
});
如果這里需要在分享的內(nèi)容中加入用ajax異步請(qǐng)求拿到的內(nèi)容,必須在ajax請(qǐng)求返回后的成功函數(shù)中再調(diào)用一次該分享接口,但是必須將分享接口放在wx.ready函數(shù)中,不能單獨(dú)調(diào)用。因?yàn)榭蛻?hù)端分享操作是一個(gè)同步操作,這時(shí)候使用 ajax的數(shù)據(jù)還沒(méi)有返回。
7. 這些步驟看起來(lái)似乎比較簡(jiǎn)單,但是調(diào)試的過(guò)程中難免會(huì)遇到很多問(wèn)題,因?yàn)閖ssdk接口還是有很多的限制的。一不小心就踩到了坑。
8. 最后,我將這個(gè)接口進(jìn)行了一下封裝。
'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, // 分享標(biāo)題
link: param.link, // 分享鏈接
imgUrl: param.imgUrl, // 分享圖標(biāo)
success: function () {
// 用戶(hù)確認(rèn)分享后執(zhí)行的回調(diào)函數(shù)
param.suCallback();
},
cancel: function () {
// 用戶(hù)取消分享后執(zhí)行的回調(diào)函數(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, //默認(rèn)配置,進(jìn)行config配置 和ready后定制微信分享內(nèi)容,
}
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助