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>
  1. Page({
  2.   data: {
  3.     canIUse: qq.canIUse('button.open-type.getUserInfo')
  4.   },
  5.   onLoad() {
  6.     // 查看是否授权
  7.     qq.getSetting({
  8.       success(res) {
  9.         if (res.authSetting['scope.userInfo']) {
  10.           // 已经授权，可以直接调用 getUserInfo 获取头像昵称
  11.           qq.getUserInfo({
  12.             success(res) {
  13.               console.log(res.userInfo)
  14.             }
  15.           })
  16.         }
  17.       }
  18.     })
  19.   },
  20.   bindGetUserInfo(e) {
  21.     console.log(e.detail.userInfo)
  22.   }
  23. })

qq.createUserInfoButton

UserInfoButton qq.createUserInfoButton(Object object)

创建用户信息按钮

参数

Object object
属性类型默认值必填说明
typestring是按钮的类型
textstring否按钮上的文本，仅当 type 为 text 时有效
imagestring否按钮的背景图片，仅当 type 为 image 时有效
styleObject是按钮的样式
withCredentialsboolean是是否带上登录态信息。当 withCredentials 为 true 时，要求此前有调用过 qq.login 且登录态尚未过期，此时返回的数据会包含 encryptedData, iv 等敏感信息；当 withCredentials 为 false 时，不要求有登录态，返回的数据不包含 encryptedData, iv 等敏感信息。
langstringen否描述用户信息的语言

type 的合法值

值说明
text可以设置背景色和文本的按钮
image只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高

style 的结构

属性类型默认值必填说明
leftnumber是左上角横坐标
topnumber是左上角纵坐标
widthnumber是宽度
heightnumber是高度
backgroundColorstring是背景颜色。格式为 6位/8位 16进制数。
borderColorstring是边框颜色。格式为 6位/8位 16进制数。
borderWidthnumber是边框宽度
borderRadiusnumber是边框圆角
colorstring是文本的颜色。格式为 6位 16进制数。
textAlignstring是文本的水平居中方式
fontSizenumber是字号
lineHeightnumber是文本的行高

style.textAlign 的合法值

值说明
left居左
center居中
right居右

object.lang 的合法值

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

返回值

UserInfoButton

示例代码

  1. const button = qq.createUserInfoButton({
  2.   type: 'text',
  3.   text: '获取用户信息',
  4.   style: {
  5.     left: 10,
  6.     top: 76,
  7.     width: 200,
  8.     height: 40,
  9.     lineHeight: 40,
  10.     backgroundColor: '#ff0000',
  11.     color: '#ffffff',
  12.     textAlign: 'center',
  13.     fontSize: 16,
  14.     borderRadius: 4
  15.   }
  16. })
  17. button.onTap((res) => {
  18.   console.log(res)
  19. })

UserInfoButton

用户信息按钮

属性

string type

按钮的类型

type 的合法值

值说明
text可以设置背景色和文本的按钮
image只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高
string text

按钮上的文本，仅当 type 为 text 时有效

string image

按钮的背景图片，仅当 type 为 image 时有效

Object style

按钮的样式

属性类型说明
leftnumber左上角横坐标
topnumber左上角纵坐标
widthnumber宽度
heightnumber高度
backgroundColorstring背景颜色。格式为 6位/8位 16进制数。
borderColorstring边框颜色。格式为 6位/8位 16进制数。
borderWidthnumber边框宽度
borderRadiusnumber边框圆角
colorstring文本的颜色。格式为 6位 16进制数。
textAlignstring文本的水平居中方式
fontSizenumber字号
lineHeightnumber文本的行高

style.textAlign 的合法值

值说明
left居左
center居中
right居右

方法

UserInfoButton.show()

显示用户信息按钮

UserInfoButton.hide()

隐藏用户信息按钮。

UserInfoButton.destroy()

销毁用户信息按钮

UserInfoButton.onTap(function callback)

监听用户信息按钮的点击事件

UserInfoButton.offTap(function callback)

取消监听用户信息按钮的点击事件

.destroy

UserInfoButton.destroy()

销毁用户信息按钮

.hide

UserInfoButton.hide()

隐藏用户信息按钮。

.offTap

UserInfoButton.offTap(function callback)

取消监听用户信息按钮的点击事件

参数

function callback

用户信息按钮的点击事件的回调函数

.onTap

UserInfoButton.onTap(function callback)

监听用户信息按钮的点击事件

参数

function callback

用户信息按钮的点击事件的回调函数

参数

Object res

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

.show

UserInfoButton.show()

显示用户信息按钮

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繁体中文