### 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) } } }); } }) ```