微信JS-SDK是微信公衆平臺面向網頁開發者提供的基於微信內的網頁開發工具包。html
經過使用微信JS-SDK,網頁開發者可藉助微信高效地使用拍照、選圖、語音、位置等手機系統的能力,同時能夠直接使用微信分享、掃一掃、卡券、支付等微信特有的能力, 爲微信用戶提供更優質的網頁體驗。jquery
此文檔面向網頁開發者介紹微信JS-SDK如何使用及相關注意事項。web
先登陸微信公衆平臺進入「公衆號設置」的「功能設置」裏填寫「JS接口安全域名」。ajax
備註:登陸後可在「開發者中心」查看對應的接口權限。api
在須要調用JS接口的頁面引入以下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.0.0.js安全
備註:支持使用 AMD/CMD 標準模塊加載方法加載微信
步驟三:經過config接口注入權限驗證配置app
全部須要使用JS-SDK的頁面必須先注入配置信息,不然將沒法調用(同一個url僅需調用一次,對於變化url的SPA的web app可在每次url變化時進行調用,目前Android微信客 戶端不支持pushState的H5新特性,因此使用pushState來實現web app的頁面會致使簽名失敗,此問題會在Android6.2中修復)。微信公衆平臺
wx.config({ debug: true, // 開啓調試模式,調用的全部api的返回值會在客戶端alert出來,若要查看傳入的參數,能夠在pc端打開,參數信息會經過log打出,僅在pc端時纔會打印。 appId: '', // 必填,公衆號的惟一標識 timestamp: , // 必填,生成簽名的時間戳 nonceStr: '', // 必填,生成簽名的隨機串 signature: '',// 必填,簽名,見附錄1 jsApiList: [] // 必填,須要使用的JS接口列表,全部JS接口列表見附錄2 });
wx.ready(function(){ // config信息驗證後會執行ready方法,全部接口調用都必須在config接口得到結果以後,config是一個客戶端的異步操做,因此若是須要在頁面加載時就調用相關接口,則須把相關接口放在ready函數中調用來確保正確執行。對於用戶觸發時才調用的接口,則能夠直接調用,不須要放在ready函數中。 });
wx.error(function(res){ // config信息驗證失敗會執行error函數,如簽名過時致使驗證失敗,具體錯誤信息能夠打開config的debug模式查看,也能夠在返回的res參數中查看,對於SPA能夠在這裏更新簽名。 });
全部接口經過wx對象(也可以使用jWeixin對象)來調用,參數是一個對象,除了每一個接口自己須要傳的參數以外,還有如下通用參數:dom
備註:不要嘗試在trigger中使用ajax異步請求修改本次分享的內容,由於客戶端分享操做是一個同步操做,這時候使用ajax的回包會尚未返回。
以上幾個函數都帶有一個參數,類型爲對象,其中除了每一個接口自己返回的數據以外,還有一個通用屬性errMsg,其值格式以下:
1 /// <summary> 2 /// 微信參數準備 3 /// </summary> 4 private void WxSdkPramas(bool isShare) 5 { 6 var jsSdk = new JSSDKHelper(); 7 //獲取時間戳 8 var timestamp = JSSDKHelper.GetTimestamp(); 9 //獲取隨機碼 10 var nonceStr = JSSDKHelper.GetNoncestr(); 11 var appId = WeiXinAppId; 12 var appSecret = WeiXinAppSecret; 13 //獲取票證 14 var jsTicket = JsApiTicketContainer.TryGetTicket(appId, appSecret); 15 //獲取簽名 16 var signature = jsSdk.GetSignature(jsTicket, nonceStr, timestamp, Request.Url.AbsoluteUri); 17 18 ViewData["AppId"] = appId;
ViewData["Timestamp"] = timestamp; 21 ViewData["NonceStr"] = nonceStr; 22 ViewData["Signature"] = signature; 23 }
下面是js相關代碼:
1 <head> 2 <meta name="viewport" content="width=device-width" /> 3 <title>公衆號JSSDK演示</title> 4 <script src="~/Scripts/jquery-1.7.1.min.js"></script> 5 <script src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js"></script> 6 <script> 7 wx.config({ 8 debug: false, // 開啓調試模式,調用的全部api的返回值會在客戶端alert出來,若要查看傳入的參數,能夠在pc端打開,參數信息會經過log打出,僅在pc端時纔會打印。 9 appId: '@ViewData["AppId"]', // 必填,公衆號的惟一標識 10 timestamp: '@ViewData["Timestamp"]', // 必填,生成簽名的時間戳 11 nonceStr: '@ViewData["NonceStr"]', // 必填,生成簽名的隨機串 12 signature: '@ViewData["Signature"]',// 必填,簽名 13 jsApiList: [ 14 "checkJsApi", 15 'onMenuShareTimeline', 16 'onMenuShareAppMessage', 17 'onMenuShareQQ', 18 'onMenuShareWeibo', 19 'hideMenuItems', 20 'showMenuItems', 21 'hideAllNonBaseMenuItem', 22 'showAllNonBaseMenuItem', 23 'translateVoice', 24 'startRecord', 25 'stopRecord', 26 'onRecordEnd', 27 'playVoice', 28 'pauseVoice', 29 'stopVoice', 30 'uploadVoice', 31 'downloadVoice', 32 'chooseImage', 33 'previewImage', 34 'uploadImage', 35 'downloadImage', 36 'getNetworkType', 37 'openLocation', 38 'getLocation', 39 'hideOptionMenu', 40 'showOptionMenu', 41 'closeWindow', 42 'scanQRCode', 43 'chooseWXPay', 44 'openProductSpecificView', 45 'addCard', 46 'chooseCard', 47 'openCard' 48 ] // 必填,須要使用的JS接口列表,全部JS接口列表見附錄2。詳見:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html 49 }); 50 51 wx.error(function (res) { 52 console.log(res); 53 alert('驗證失敗'); 54 }); 55 56 wx.ready(function () { 57 var url = 'http://weixin.senparc.com'; 58 var link = url + '@(Request.Url.PathAndQuery)'; 59 var imgUrl = url + '/images/v2/ewm_01.png'; 60 61 //轉發到朋友圈 62 wx.onMenuShareTimeline({ 63 title: 'JSSDK朋友圈轉發測試', 64 link: link, 65 imgUrl: imgUrl, 66 success: function () { 67 alert('轉發成功!'); 68 }, 69 cancel: function () { 70 alert('轉發失敗!'); 71 } 72 }); 73 //轉發給朋友 74 wx.onMenuShareAppMessage({ 75 title: 'JSSDK朋友圈轉發測試', 76 desc: '轉發給朋友', 77 link: link, 78 imgUrl: imgUrl, 79 type: 'link', 80 dataUrl: '', 81 success: function () { 82 alert('轉發成功!'); 83 }, 84 cancel: function () { 85 alert('轉發失敗!'); 86 } 87 }); 88 }); 89 </script> 90 91 </head>
上面用到的Helper:
1 public class JSSDKHelper 2 { 3 public JSSDKHelper() 4 { 5 Parameters = new Hashtable(); 6 } 7 8 protected Hashtable Parameters; 9 10 /// <summary> 11 /// 設置參數值 12 /// </summary> 13 /// <param name="parameter"></param> 14 /// <param name="parameterValue"></param> 15 private void SetParameter(string parameter, string parameterValue) 16 { 17 if (!string.IsNullOrEmpty(parameter)) 18 { 19 if (Parameters.Contains(parameter)) 20 { 21 Parameters.Remove(parameter); 22 } 23 24 Parameters.Add(parameter, parameterValue); 25 } 26 } 27 28 private void ClearParameter() 29 { 30 Parameters.Clear(); 31 } 32 33 /// <summary> 34 /// 獲取隨機字符串 35 /// </summary> 36 /// <returns></returns> 37 public static string GetNoncestr() 38 { 39 Random random = new Random(); 40 return MD5Util.GetMD5(random.Next(1000).ToString(), "GBK"); 41 } 42 43 /// <summary> 44 /// 獲取時間戳 45 /// </summary> 46 /// <returns></returns> 47 public static string GetTimestamp() 48 { 49 TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0); 50 return Convert.ToInt64(ts.TotalSeconds).ToString(); 51 } 52 53 /// <summary> 54 /// sha1加密 55 /// </summary> 56 /// <returns></returns> 57 private string CreateSha1() 58 { 59 StringBuilder sb = new StringBuilder(); 60 ArrayList akeys = new ArrayList(Parameters.Keys); 61 akeys.Sort(); 62 63 foreach (string k in akeys) 64 { 65 string v = (string)Parameters[k]; 66 67 if (sb.Length == 0) 68 { 69 sb.Append(k + "=" + v); 70 } 71 else 72 { 73 sb.Append("&" + k + "=" + v); 74 } 75 } 76 return SHA1UtilHelper.GetSha1(sb.ToString()).ToString().ToLower(); 77 } 78 79 /// <summary> 80 /// 生成cardSign的加密方法 81 /// </summary> 82 /// <returns></returns> 83 private string CreateCardSha1() 84 { 85 StringBuilder sb = new StringBuilder(); 86 ArrayList akeys = new ArrayList(Parameters.Keys); 87 akeys.Sort(); 88 89 foreach (string k in akeys) 90 { 91 string v = (string)Parameters[k]; 92 93 sb.Append(v); 94 } 95 return SHA1UtilHelper.GetSha1(sb.ToString()).ToString().ToLower(); 96 } 97 98 /// <summary> 99 /// 獲取JS-SDK權限驗證的簽名Signature 100 /// </summary> 101 /// <param name="ticket"></param> 102 /// <param name="noncestr"></param> 103 /// <param name="timestamp"></param> 104 /// <param name="url"></param> 105 /// <returns></returns> 106 public string GetSignature(string ticket, string noncestr, string timestamp, string url) 107 { 108 //清空Parameters 109 ClearParameter(); 110 111 SetParameter("jsapi_ticket", ticket); 112 SetParameter("noncestr", noncestr); 113 SetParameter("timestamp", timestamp); 114 SetParameter("url", url); 115 116 return CreateSha1(); 117 } 118 119 /// <summary> 120 /// 獲取位置簽名AddrSign 121 /// </summary> 122 /// <param name="appId"></param> 123 /// <param name="appSecret"></param> 124 /// <param name="noncestr"></param> 125 /// <param name="timestamp"></param> 126 /// <param name="url"></param> 127 /// <returns></returns> 128 public string GetAddrSign(string appId, string appSecret, string noncestr, string timestamp, string url) 129 { 130 //清空Parameters 131 ClearParameter(); 132 133 var accessToken = AccessTokenContainer.TryGetToken(appId, appSecret); 134 SetParameter("appId", appId); 135 SetParameter("noncestr", noncestr); 136 SetParameter("timestamp", timestamp); 137 SetParameter("url", url); 138 SetParameter("accesstoken", accessToken); 139 140 return CreateSha1(); 141 } 142 143 /// <summary> 144 /// 獲取卡券簽名CardSign 145 /// </summary> 146 /// <param name="appId"></param> 147 /// <param name="appSecret"></param> 148 /// <param name="locationId"></param> 149 /// <param name="noncestr"></param> 150 /// <param name="timestamp"></param> 151 /// <param name="cardId"></param> 152 /// <param name="cardType"></param> 153 /// <returns></returns> 154 public string GetCardSign(string appId, string appSecret, string locationId, string noncestr, string timestamp, string cardId, string cardType) 155 { 156 //清空Parameters 157 ClearParameter(); 158 159 SetParameter("appId", appId); 160 SetParameter("appsecret", appSecret); 161 SetParameter("location_id", locationId); 162 SetParameter("nonce_str", noncestr); 163 SetParameter("times_tamp", timestamp); 164 SetParameter("card_id", cardId); 165 SetParameter("card_type", cardType); 166 167 return CreateCardSha1(); 168 } 169 }