# wx.getGameClubData(Object object)

> 基础库 2.25.4 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [开放数据校验与解密](/minigame/dev/guide/open-ability/signature.md)

## 功能描述

获取游戏圈数据。

## 参数

### Object object


```json
[
  {
    "属性": "dataTypeList",
    "类型": "Array.<Object>",
    "默认值": "",
    "必填": "是",
    "说明": "需要获取的数据指标的对象数组",
    "子项": [
      {
        "结构属性": "type",
        "类型": "number",
        "默认值": "",
        "必填": "是",
        "说明": "见type表格说明"
      },
      {
        "结构属性": "subKey",
        "类型": "string",
        "默认值": "",
        "必填": "否",
        "说明": "部分type需要传，见type表格说明"
      }
    ]
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数"
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数"
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）"
  }
]
```

#### object.success 回调函数
##### 参数

###### Object res

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| signature  | string | 使用 sha1( rawData + sessionkey ) 得到字符串，用于校验用户信息 |
| encryptedData  | string | 包括 GameClubData 在内的加密数据，详见[加密数据解密算法](/minigame/dev/guide/open-ability/signature.md) |
| iv  | string | 加密算法的初始向量 |
| cloudID  | string | 敏感数据对应的云 ID，开通云开发的小程序才会返回，可通过[云调用直接获取开放数据](/minigame/dev/guide/open-ability/signature.md) |

## 示例代码

```javascript

wx.getGameClubData({
  dataTypeList: [{
     type:1
 }],
  success: (res)=>console.log(res),
  fail: (res)=>console.error(res),
  complete: (res)=>console.log(res)
})

```

## type说明

| type取值 | 说明                                   | subKey  | GameClubDataByType.value | 
| ------- | -------------------------------------- | -------- | -------- |
| 1   | 加入该游戏圈时间                            | 无需传入 | 秒级Unix时间戳 |
| 3   | 用户禁言状态                                | 无需传入  | 0：正常 1：禁言  |
| 4   | 当天(自然日)点赞贴子数                       | 无需传入  |  |
| 5   | 当天(自然日)评论贴子数                        | 无需传入  |  |  
| 6   | 当天(自然日)发表贴子数                       | 无需传入  |  |
| 7   | 当天(自然日)发表视频贴子数                    | 无需传入  |  |
| 8   | 当天(自然日)赞官方贴子数                      | 无需传入  |  |
| 9   | 当天(自然日)评论官方贴子数                     | 无需传入  |  |
| 10   | 当天(自然日)发表到本圈子话题的贴子数           | 传入话题id，从mp-游戏圈话题管理处获取  |  |
| 11  | 用户最近一次推荐游戏时间                      | 无需传入  | 秒级时间戳 |  |

## encryptedData 解密后得到的 GameClubData 的结构

| 属性 | 类型 | 说明                                   |
| ------- | ------- | -------------------------------------- |
|  dataList   | Array\ | 游戏圈相关数据的对象数组           |

## GameClubDataByType 的结构

| 属性 | 类型 | 说明                                   |
| ------- |------- |  -------------------------------------- |
|  dataType   | number | 与输入的 dataType 一致          |
|  value   | number | 不同type返回的value含义不同，见type表格说明           |