wx.getUserInfo(OBJECT),小程序獲取用戶信息
2018-05-18
導(dǎo)讀：獲取用戶信息，withCredentials 為 true 時(shí)需要先調(diào)用 wx.login 接口。 需要 用戶授權(quán) scope.userInfo OBJECT參數(shù)說(shuō)明： 參數(shù)名 類型 必填 說(shuō)明 最低版本 withCredentials Boolean 否 是否帶上登錄態(tài)信息...
獲取用戶信息，withCredentials 為 true 時(shí)需要先調(diào)用 wx.login 接口。
需要用戶授權(quán) scope.userInfo
OBJECT參數(shù)說(shuō)明：
| 參數(shù)名 | 類型 | 必填 | 說(shuō)明 | 最低版本 |
|---|---|---|---|---|
| withCredentials | Boolean | 否 | 是否帶上登錄態(tài)信息 | 1.1.0 |
| lang | String | 否 | 指定返回用戶信息的語(yǔ)言，zh_CN 簡(jiǎn)體中文，zh_TW 繁體中文，en 英文。默認(rèn)為en。 | 1.3.0 |
| success | Function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
| fail | Function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) | |
| complete | Function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行） |
注：當(dāng) withCredentials 為 true 時(shí)，要求此前有調(diào)用過(guò) wx.login 且登錄態(tài)尚未過(guò)期，此時(shí)返回的數(shù)據(jù)會(huì)包含 encryptedData, iv 等敏感信息；當(dāng) withCredentials 為 false 時(shí)，不要求有登錄態(tài)，返回的數(shù)據(jù)不包含 encryptedData, iv 等敏感信息。
success返回參數(shù)說(shuō)明：
| 參數(shù) | 類型 | 說(shuō)明 |
|---|---|---|
| userInfo | OBJECT | 用戶信息對(duì)象，不包含 openid 等敏感信息 |
| rawData | String | 不包括敏感信息的原始數(shù)據(jù)字符串，用于計(jì)算簽名。 |
| signature | String | 使用 sha1( rawData + sessionkey ) 得到字符串，用于校驗(yàn)用戶信息，參考文檔 signature。 |
| encryptedData | String | 包括敏感數(shù)據(jù)在內(nèi)的完整用戶信息的加密數(shù)據(jù)，詳細(xì)見(jiàn)加密數(shù)據(jù)解密算法 |
| iv | String | 加密算法的初始向量，詳細(xì)見(jiàn)加密數(shù)據(jù)解密算法 |
userInfo參數(shù)說(shuō)明：
| 參數(shù) | 類型 | 說(shuō)明 |
|---|---|---|
| nickName | String | 用戶昵稱 |
| avatarUrl | String | 用戶頭像，最后一個(gè)數(shù)值代表正方形頭像大小（有0、46、64、96、132數(shù)值可選，0代表640*640正方形頭像），用戶沒(méi)有頭像時(shí)該項(xiàng)為空。若用戶更換頭像，原有頭像URL將失效。 |
| gender | String | 用戶的性別，值為1時(shí)是男性，值為2時(shí)是女性，值為0時(shí)是未知 |
| city | String | 用戶所在城市 |
| province | String | 用戶所在省份 |
| country | String | 用戶所在國(guó)家 |
| language | String | 用戶的語(yǔ)言，簡(jiǎn)體中文為zh_CN |
示例代碼：
wx.getUserInfo({
success: function(res) {
var userInfo = res.userInfo
var nickName = userInfo.nickName
var avatarUrl = userInfo.avatarUrl
var gender = userInfo.gender //性別 0：未知、1：男、2：女
var province = userInfo.province
var city = userInfo.city
var country = userInfo.country
}
})
相關(guān)文章：
微信小程序getUserInfo授權(quán)問(wèn)題的解決辦法
第二部分：如何開(kāi)通一個(gè)小商店
掃碼免費(fèi)領(lǐng)取運(yùn)營(yíng)資料包
