用户信息

qq.getUserInfo

qq.getUserInfo(Object object)

调用前需要 用户授权 scope.userInfo。

获取用户信息。

参数

Object object
属性类型默认值必填说明
withCredentialsboolean否是否带上登录态信息。当 withCredentials 为 true 时，要求此前有调用过 qq.login 且登录态尚未过期，此时返回的数据会包含 encryptedData, iv 等敏感信息；当 withCredentials 为 false 时，不要求有登录态，返回的数据不包含 encryptedData, iv 等敏感信息。
langstringen否显示用户信息的语言
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

object.lang 的合法值

值说明
en英文
zh_CN简体中文
zh_TW繁体中文
object.success 回调函数

参数

Object res

属性类型说明
userInfoUserInfo用户信息对象，不包含 openid 等敏感信息
rawDatastring不包括敏感信息的原始数据字符串，用于计算签名
signaturestring使用 sha1( rawData + sessionkey ) 得到字符串，用于校验用户信息，详见 用户数据的签名验证和加解密
encryptedDatastring包括敏感数据在内的完整用户信息的加密数据，详见 用户数据的签名验证和加解密
ivstring加密算法的初始向量，详见 用户数据的签名验证和加解密

接口调整说明

在用户未授权过的情况下调用此接口，将不再出现授权弹窗，会直接进入 fail 回调。在用户已授权的情况下调用此接口，可成功获取用户信息。

示例代码

  1. // 必须是在用户已经授权的情况下调用
  2. qq.getUserInfo({
  3.   success(res) {
  4.     const userInfo = res.userInfo
  5.     const nickName = userInfo.nickName
  6.     const avatarUrl = userInfo.avatarUrl
  7.     const gender = userInfo.gender // 性别 0：未知、1：男、2：女
  8.     const province = userInfo.province
  9.     const city = userInfo.city
  10.     const country = userInfo.country
  11.   }
  12. })

encryptedData 解密后为以下 json 结构，详见加密数据解密算法

  1. {
  2.   "openId": "OPENID",
  3.   "nickName": "NICKNAME",
  4.   "gender": GENDER,
  5.   "city": "CITY",
  6.   "province": "PROVINCE",
  7.   "country": "COUNTRY",
  8.   "avatarUrl": "AVATARURL",
  9.   "unionId": "UNIONID",
  10.   "watermark": {
  11.     "appid": "APPID",
  12.     "timestamp": TIMESTAMP
  13.   }
  14. }

示例代码

  1. <!-- 如果只是展示用户头像昵称，可以使用 <open-data /> 组件 -->
  2. <open-data type="userAvatarUrl"></open-data>
  3. <open-data type="userNickName"></open-data>
  4. <!-- 需要使用 button 来授权登录 -->
  5. <button
  6.   qq:if="{{canIUse}}"
  7.   open-type="getUserInfo"
  8.   bindgetuserinfo="bindGetUserInfo"
  9. >
  10.   授权登录
  11. </button>
  12. <view qq:else>请升级QQ版本</view>
Page({
  data: {
    canIUse: qq.canIUse('button.open-type.getUserInfo')
  },
  onLoad() {
    // 查看是否授权
    qq.getSetting({
      success(res) {
        if (res.authSetting['scope.userInfo']) {
          // 已经授权，可以直接调用 getUserInfo 获取头像昵称
          qq.getUserInfo({
            success(res) {
              console.log(res.userInfo)
            }
          })
        }
      }
    })
  },
  bindGetUserInfo(e) {
    console.log(e.detail.userInfo)
  }
})

UserInfo

用户信息

属性

string nickName

用户昵称

string avatarUrl

用户头像图片的 URL。URL 最后一个数值代表正方形头像大小（有 0、46、64、96、132 数值可选，0 代表 640x640 的正方形头像，46 表示 46x46 的正方形头像，剩余数值以此类推。默认132），用户没有头像时该项为空。若用户更换头像，原有头像 URL 将失效。

number gender

用户性别

gender 的合法值

值说明
0未知
1男性
2女性
string country

用户所在国家

string province

用户所在省份

string city

用户所在城市

string language

显示 country，province，city 所用的语言

language 的合法值

值说明
en英文
zh_CN简体中文
zh_TW繁体中文