### wx.login(OBJECT) 調用接口獲取**登錄憑證（code）**進而換取用戶登錄態信息，包括用戶的**唯一標識（openid）** 及本次登錄的 **會話密鑰（session_key）**等。**用戶數據的加解密通訊**需要依賴會話密鑰完成。 **注：調用 login 會引起登錄態的刷新，之前的 sessionKey 可能會失效。** **OBJECT參數說明：** | 參數名 | 類型 | 必填 | 說明 | | -------- | -------- | ---- | ------------------------ | | success | Function | 否 | 接口調用成功的回調函數 | | fail | Function | 否 | 接口調用失敗的回調函數 | | complete | Function | 否 | 接口調用結束的回調函數（調用成功、失敗都會執行） | **success返回參數說明：** | 參數名 | 類型 | 說明 | | ------ | ------ | ---------------------------------------- | | errMsg | String | 調用結果 | | code | String | 用戶登錄憑證（有效期五分鐘）。開發者需要在開發者服務器后臺調用 api，使用 code 換取 openid 和 session_key 等信息 | **示例代碼：** ``` // app.js App({ onLaunch: function() { wx.login({ success: function(res) { if (res.code) { // do something } else { console.log('獲取用戶登錄態失敗！' + res.errMsg) } } }); } }) ```