关系链数据

您所在的位置:网站首页 小程序获取data数据 关系链数据

关系链数据

2023-05-29 06:27| 来源: 网络整理| 查看: 265

# 关系链数据

** 基础库最低版本: 1.17.0

一个 QQ 用户的关系链数据包括两部分:

该用户好友的用户数据 该用户所在的某个群的群成员的用户数据。

为了丰富小程序的社交玩法,我们提供了类似于小游戏使用关系数据链的方法:

组件

属性 类型 默认值 必填 说明 type string 是 开放数据类型 share-ticket string 否 当 type=groupCloudStorage 时有效,群分享对应的 shareTicket key-list Array. 否 要拉取的 key 列表 component-data Object 否 从主域透传给开放数据域的数据,会自动注入到自定义开放数据域组件的 properties 中 generic:simple-component string 是 指定使用哪个自定义开放数据域组件来渲染开放数据,具体说明见下方 binderror eventhandle 否 开放数据请求或定向分享失败时触发,event.detail = {errMsg: "getGroupCloudStorage:fail no data"}

type的合法值

值 说明 最低版本 userCloudStorage 获取当前用户的应用数据 1.17.0 friendCloudStorage 获取当前用户也玩该小程序的好友的应用数据 1.17.0 groupCloudStorage 获取当前用户在某个群中也玩该小程序的成员的应用数据 1.17.0 potentialFriendList 获取可能对游戏感兴趣的未注册的好友名单。每次调用最多可获得 5 个好友 1.20.0 reactiveFriendList 获取曾经玩过游戏但最近不常玩的好友名单。每次调用最多可获得 5 个好友 1.20.0

可通过 generic:simple-component属性指定自定义开放数据域组件进行渲染. 使用方法同抽象节点

当数据获取成功后,通过generic:simple-component指定的自定义开放数据域组件中会在properties中自动注入以下属性:

属性 类型 说明 kvDataList Array. 当type=userCloudStorage时 userList Array. 当type=friendCloudStorage 或 type=groupCloudStorage 时 list Array. 当type=potentialFriendList 或 type=reactiveFriendList 时 componentData Object 从主域透传给开放数据域的数据

KVData数据结构说明

属性 类型 说明 key string 数据的 key value KVData 数据的 value

UserData数据结构说明

属性 类型 说明 openid string 用户的 openid avatarUrl string 用户的 QQ 头像 url nickname string 用户的 QQ 昵称 kvDataList Array. 用户的应用数据

FriendInfo数据结构说明

属性 类型 说明 openid string 用户的 openid avatarUrl string 用户的 QQ 头像 url nickname string 用户的 QQ 昵称

用户的 应用数据 指的是用户的分数、段位等小程序业务特有的数据,通过调用 qq.setUserCloudStorage() 可以将当前用户的应用数据托管在 QQ 后台。只有被托管过数据的用户,才会被视为 玩过 该小程序的用户,才会出现在 type=friendCloudStorage 和 type=groupCloudStorage 的组件中

除此之外,我们还提供了以下 API:

qq.removeUserCloudStorage() 删除用户托管数据中指定字段的数据 # 自定义开放数据域组件说明

自定义开放数据域组件 类似于自定义组件,不过有以下限制:

组件所有的生命周期函数都不会被触发 无法绑定任何事件回调(所有事件绑定都会被过滤掉) 无法通过createSelectorQuery、createIntersectionObserver 接口获取自定义开放数据域组件的任何节点 仅支持使用、、、 组件,其他组件会被自动过滤掉 开放数据域组件内引用的任何组件,其style属性都会被置空 拥有独立的作用域,qml 文件引用的 qs 模块会重新生成新的实例

同时自定义开放数据域组件内使用的组件有以下限制:

组件:

只能使用本地或 QQ CDN 的图片,不能使用开发者自己服务器上的图片。

组件:

仅支持以下类型:

open-type=shareMessageToFriend 定向分享 open-type=modifyFriendInteractiveStorage 修改好友的互动型托管数据 # 如何在自定义开放数据域组件中使用关系链数据

使用组件请求关系链数据后,其返回结果在自定义开放数据域组件自动注入中kvDataList或userList属性

如果需要对数据进行预处理(排序,过滤等操作)可通过QS文件对属性进行处理。

使用示例:

page/index/index.qml

12345678

page/index/index.json

{ "usingComponents": { "ranklist": "/openDataContext/ranklist" } } 12345

openDataContext/ranklist.qml

{{item.nickname}} {{item.kvDataList[0].value}} 12345678

openDataContext/tools.qs

module.exports.processData = function (userList) { return userList.sort(function (a, b) { a.kvDataList[0].value > b.kvDataList[0].value; }); }; 12345

← 获取小程序码 关系链互动数据 →



【本文地址】


今日新闻


推荐新闻


    CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3