微信JS-SDK

微信JS-SDK是微信公衆平臺爲咱們這些開發者提供了基於微信內的網頁開發工具包。其使用步驟以下:javascript

1. 綁定域名java

  先登陸微信公衆平臺進入「公衆號設置」的「功能設置」裏填寫「JS接口安全域名」後端

2. 引入js文件api

<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.2.0.js"></script>

3. 經過config接口注入權限驗證配置(全部須要使用JS-SDK的頁面必須先注入配置信息安全

  這裏的appId,timestamp,nonceStr,signature是後臺給咱們的,此時咱們須要給後端的是當前的地址,由於簽名的生成規則中包括noncestr(隨機字符串), 有效的jsapi_ticket, timestamp(時間戳), url(當前網頁的URL,不包含#及其後面部分)。微信

    // 初始化數據
    globalObj.post({
        url: window.location.href,
    }, '/apis/Wxshare/share_wx', function(res) {
        var signPackage = res.data.signPackage
        wx.config({
            debug: false, // 開啓調試模式,調用的全部api的返回值會在客戶端alert出來,若要查看傳入的參數,能夠在pc端打開,參數信息會經過log打出,僅在pc端時纔會打印。
            appId: signPackage.appId, // 必填,公衆號的惟一標識
            timestamp: signPackage.timestamp, // 必填,生成簽名的時間戳
            nonceStr: signPackage.nonceStr, // 必填,生成簽名的隨機串
            signature: signPackage.signature, // 必填,簽名,見附錄1
            jsApiList: ['getLocation'], // 全部要調用的 API 都要加到這個列表中
        });
    })

4. 咱們能夠經過調用ready接口處理配置成功驗證app

wx.ready(function(){
    // config信息驗證後會執行ready方法,全部接口調用都必須在config接口得到結果以後,config是一個客戶端的異步操做,
    因此若是須要在頁面加載時就調用相關接口,則須把相關接口放在ready函數中調用來確保正確執行。對於用戶觸發時才調用的接口,
    則能夠直接調用,不須要放在ready函數中。
});

對於接口,除了自己返回的數據以外,還有一個通用的屬性errMsg,其值格式以下微信公衆平臺

調用成功時:"xxx:ok" ,其中xxx爲調用的接口名
用戶取消時:"xxx:cancel",其中xxx爲調用的接口名
調用失敗時:其值爲具體錯誤信息

5.判斷當前客戶端版本是否支持指定JS接口異步

wx.checkJsApi({
    jsApiList: ['chooseImage'], // 須要檢測的JS接口列表,全部JS接口列表見附錄2,
    success: function(res) {
        // 以鍵值對的形式返回,可用的api值true,不可用爲false
        // 如:{"checkResult":{"chooseImage":true},"errMsg":"checkJsApi:ok"}
    }
});
相關文章
相關標籤/搜索