功能类
获取好友列表
list_friends:分页获取在线账号的好友列表。
const FriendList *list_friends(uint64_t self_id, const char *platform, uint64_t next_user_id);
void free_friends(const FriendList *list);- 权限:
list_friends - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
next_user_id | uint64_t | 是 | 分页起点:第一页传 0,之后传上一页返回的 next_user_id |
返回值 FriendList
每页最多 300 个好友;next_user_id == 0 表示已是最后一页,失败时 count == 0。用完必须调用 free_friends(list) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功 |
error | const char * | 失败原因 |
total | uint64_t | 好友总数 |
next_user_id | uint64_t | 下一页起点,0 表示无更多 |
count | uint32_t | 本页好友数 |
items | Friend[] | 好友数组 |
Friend
| 字段 | 类型 | 说明 |
|---|---|---|
user_id | uint64_t | QQ 号 |
category_id | uint64_t | 好友分组编号 |
nickname | const char * | 昵称 |
remark | const char * | 备注 |
signature | const char * | 个性签名 |