本文針對微信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以上系統中成功使用JSSDK
3.通過config接口注入權限驗證配置
這一步是通過用當前的url向後台發請求拿到一系列參數。即後台會拿我的url去向微信進行認證。這裡需要注意的事用於驗證的當前的url寫法,
let url = location.href.split(‘#')[0];
務必寫成以上形勢。否則會在進行config時報invalid signature,
確認url是頁面完整的url(請在當前頁面alert(location.href.split('#')[0])確認),包括'http(s)://'部分,以及'?'後面的GET參數部分,但不包括'#'hash後面的部分。
確保你獲取用來簽名的url是動態獲取的,動態頁面可參見實例代碼中php的實現方式。如果是html的靜態頁面在前端通過ajax將url傳到後台簽名,前端需要用js獲取當前頁面除去'#'hash部分的鏈接(可用location.href.split('#')[0]獲取,而且需要encodeURIComponent),因為頁面一旦分享,微信客戶端會在你的鏈接末尾加入其它參數,如果不是動態獲取當前鏈接,將導致分享後的頁面簽名失敗。
注意這裡的動態,不要隨便自己拼接,同時encodeURIComponent。
$.ajax({ type:'GET', url: url, dataType: 'jsonp' }) .then((data)=> { wx.config({ debug: true, // 開啟調試模式,調用的所有api的返回值會在客戶端alert出來,若要查看傳入的參數,可以在pc端打開,參數信息會通過log打出,僅在pc端時才會打印。 appId: '', // 必填,公眾號的唯一標識 timestamp: , // 必填,生成簽名的時間戳 nonceStr: '', // 必填,生成簽名的隨機串 signature: '',// 必填,簽名,見附錄1 jsApiList: [] // 必填,需要使用的JS接口列表,所有JS接口列表見附錄2 }); })
4.通過ready接口處理成功驗證
config信息驗證後會執行ready方法,所有接口調用都必須在config接口獲得結果之後,config是一個客戶端的異步操作,所以如果需要在頁面加載時就調用相關接口,則須把相關接口放在ready函數中調用來確保正確執行。對於用戶觸發時才調用的接口,則可以直接調用,不需要放在ready函數中。
wx.ready (()=> { // alert('ready'); //$('#onMenuShareAppMessage').on('click', ()=> { // 分享給朋友 wx.onMenuShareAppMessage({ title: '', desc: '', link: shareUrl, imgUrl: '', trigger: function (res) { // alert('用戶點擊發送給朋友'); }, 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('已取消'); // 用戶取消分享後執行的回調函數 // alert('取消'); } }); });
5.通過error接口處理失敗驗證
config信息驗證失敗會執行error函數,如簽名過期導致驗證失敗,具體錯誤信息可以打開config的debug模式查看,也可以在返回的res參數中查看
wx.error((res)=> { alert(res.errMsg); })
6.基礎接口
•分享到朋友圈接口
wx.onMenuShareTimeline({ title: '', // 分享標題 link: '', // 分享鏈接 imgUrl: '', // 分享圖標 success: function () { // 用戶確認分享後執行的回調函數 }, cancel: function () { // 用戶取消分享後執行的回調函數 } });
•分享給好友的接口
wx.onMenuShareAppMessage({ title: '', // 分享標題 desc: '', // 分享描述 link: '', // 分享鏈接 imgUrl: '', // 分享圖標 type: '', // 分享類型,music、video或link,不填默認為link dataUrl: '', // 如果type是music或video,則要提供數據鏈接,默認為空 success: function () { // 用戶確認分享後執行的回調函數 }, cancel: function () { // 用戶取消分享後執行的回調函數 } });
如果這裡需要在分享的內容中加入用ajax異步請求拿到的內容,必須在ajax請求返回後的成功函數中再調用一次該分享接口,但是必須將分享接口放在wx.ready函數中,不能單獨調用。因為客戶端分享操作是一個同步操作,這時候使用 ajax的數據還沒有返回。
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 () { // 用戶確認分享後執行的回調函數 param.suCallback(); }, cancel: function () { // 用戶取消分享後執行的回調函數 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後定制微信分享內容, }
本文已被整理到了《JavaScript微信開發技巧匯總》,歡迎大家學習閱讀。
為大家推薦現在關注度比較高的微信小程序教程一篇:《微信小程序開發教程》小編為大家精心整理的,希望喜歡。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持。