用于展示 QQ 开放的数据。
| 属性名 | 类型 | 默认值 | 说明 | 最低版本 |
|---|---|---|---|---|
| type | String | 开放数据类型 | ||
| lang | String | en | 当 type="user*" 时生效，以哪种语言展示 userInfo，有效值有：en, zh_CN, zh_TW | |
| share-ticket | String | en | 当 type=groupCloudStorage 时有效，群分享对应的 shareTicket | 1.17.0 |
| key-list | String | en | 当 type=*CloudStorage 时有效，指定要拉取的 key 列表 | 1.17.0 |
| component-data | String | en | 当 type=*CloudStorage 时有效，从主域透传给开放数据域的数据，会自动注入到自定义开放数据域组件的 properties 中 | 1.17.0 |
| generic:simple-component | String | en | 当 type=*CloudStorage 时有效,指定使用哪个自定义开放数据域组件来渲染开放数据,具体说明见下方 | 1.17.0 |
| binderror | String | en | 当 type=*CloudStorage 时有效,开放数据请求或定向分享失败时触发，event.detail = {errMsg: "getGroupCloudStorage:fail no data"} | 1.17.0 |
type 有效值：
| 值 | 说明 | 最低版本 |
|---|---|---|
| userNickName | 用户昵称 | |
| userAvatarUrl | 用户头像 | |
| userGender | 用户性别 | |
| userCity | 用户所在城市 | |
| userProvince | 用户所在省份 | |
| userCountry | 用户所在国家 | |
| userLanguage | 用户的语言 | |
| userCloudStorage | 获取当前用户的应用数据 | 1.17.0 |
| friendCloudStorage | 获取当前用户也玩该小程序的好友的应用数据 | 1.17.0 |
| groupCloudStorage | 获取当前用户在某个群中也玩该小程序的成员的应用数据 | 1.17.0 |
当type=*CloudStorage, 可通过 generic:simple-component属性指定自定义开放数据域组件进行渲染
指定的自定义开放数据域组件中会在properties中自动注入以下属性,可在QML文件中执行使用：
| 属性 | 类型 | 说明 |
|---|---|---|
| kvDataList | Array.<KVData> | 当type=userCloudStorage时 |
| userList | Array.<UserData> | 当type=friendCloudStorage 或 type=groupCloudStorage 时 |
| componentData | Object | 从主域透传给开放数据域的数据 |
KVData数据结构说明
| 属性 | 类型 | 说明 |
|---|---|---|
| key | string | 数据的 key |
| value | KVData | 数据的 value |
UserData数据结构说明
| 属性 | 类型 | 说明 |
|---|---|---|
| openid | string | 用户的 openid |
| avatarUrl | string | 用户的 QQ 头像 url |
| nickname | string | 用户的 QQ 昵称 |
| kvDataList | Array.<KVData> | 用户的应用数据 |
用户的 应用数据 指的是用户的分数、段位等小程序业务特有的数据，通过调用 qq.setUserCloudStorage() 可以将当前用户的应用数据托管在 QQ 后台。只有被托管过数据的用户，才会被视为 玩过 该小程序的用户，才会出现在 type=friendCloudStorage 和 type=groupCloudStorage 的<open-data>组件中
<open-data type="userAvatarUrl"></open-data>
<open-data type="userGender" lang="zh_CN"></open-data>