讀古今文學網 > 微信公眾平台開發:從零基礎到ThinkPHP5高性能框架實踐 > 14.2 JS-SDK的使用 >

14.2 JS-SDK的使用

JS-SDK的使用步驟如下。

步驟1:綁定域名。

使用JS接口需要設置JS接口安全域名,設置後該域名下的頁面才有權限調用JS接口。

登錄微信公眾平台後台,在「公眾號設置」|「功能設置」|「JS接口安全域名」中填寫域名,如圖14-1所示。

圖14-1 JS接口安全域名

步驟2:引入JS。

在需要調用JS接口的頁面引入JS文件。引入代碼如下。


<script src="https:// res.wx.qq.com/open/js/jweixin-1.1.0.js"></script>
  

步驟3:通過config接口注入權限驗證配置。


wx.config({
    debug: true,        // 開啟調試模式,調用的所有API的返回值會在客戶端alert出來,若要查看傳入
                        // 的參數,可以在PC端打開,參數信息會通過log打出,僅在PC端時才會打印。
    appId: '',          // 必填,公眾號的唯一標識
    timestamp: ,        // 必填,生成簽名的時間戳
    nonceStr: '',       // 必填,生成簽名的隨機字符串
    signature: '',      // 必填,簽名
    jsApiList:        // 必填,需要使用的JS接口列表
});
  

步驟4:通過ready接口處理成功驗證。


wx.ready(function{
    // config信息驗證後會執行ready方法,所有接口調用都必須在config接口獲得結果之後。config是一
    // 個客戶端的異步操作,所以如果需要在頁面加載時就調用相關接口,則需把相關接口放在ready函數中
    // 調用,以確保正確執行。對於用戶觸發時才調用的接口,則可以直接調用,無須放在ready函數中。
});
  

步驟5:通過error接口處理失敗驗證。


wx.error(function(res){
    // config信息驗證失敗會執行error函數,如簽名過期導致驗證失敗,具體錯誤信息可以打開config的
    // debug模式查看,也可以在返回的res參數中查看。對於SPA,可以在這裡更新簽名。
});
  

步驟6:接口調用。

所有接口通過wx對像(也可使用jWeixin對像)來調用,參數是一個對象,除了每個接口本身需要傳的參數之外,還有以下通用參數。

1)success:接口調用成功時執行的回調函數。

2)fail:接口調用失敗時執行的回調函數。

3)complete:接口調用完成時執行的回調函數,無論成功或失敗都會執行。

4)cancel:用戶點擊取消時的回調函數,僅部分有用戶取消操作的API才會用到。

5)trigger:監聽Menu中的按鈕點擊時觸發的方法,該方法僅支持Menu中的相關接口。

以上函數都帶有一個參數,類型為對象,其中除了每個接口本身返回的數據之外,還有一個通用屬性errMsg,其值的格式如下。

1)調用成功時:"xxx:ok"。其中,xxx為調用的接口名。

2)用戶取消時:"xxx:cancel"。其中,xxx為調用的接口名。

3)調用失敗時:其值為具體的錯誤信息。