open-data

用于展示 QQ 开放的数据。

属性名 类型 默认值 说明 最低版本
type String 开放数据类型
open-gid String 当 type="groupName" 时生效, 群 id
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 有效值:

说明 最低版本
groupName 拉取群名称,只有当前用户在此群内才能拉取到群名称
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=friendCloudStoragetype=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=friendCloudStoragetype=groupCloudStorage<open-data>组件中

使用示例

<open-data type="groupName" open-gid="xxxxxx"></open-data>

<open-data type="userAvatarUrl"></open-data>

<open-data type="userGender" lang="zh_CN"></open-data>
1
2
3
4
5