功能类
获取群聊列表
list_groups:获取在线账号加入的全部群聊(不分页)。
const GroupList *list_groups(uint64_t self_id, const char *platform);
void free_groups(const GroupList *list);- 权限:
list_groups - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
返回值 GroupList
一次返回全部群聊,不分页;失败时 count == 0。用完必须调用 free_groups(list) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功 |
error | const char * | 失败原因 |
count | uint32_t | 群数量 |
items | Group[] | 群数组 |
Group
| 字段 | 类型 | 说明 |
|---|---|---|
group_id | uint64_t | 群号 |
member_count | uint64_t | 成员数 |
member_max | uint64_t | 成员上限 |
create_time | uint64_t | 创建时间(Unix 秒) |
name | const char * | 群名称 |
remark | const char * | 群备注 |
description | const char * | 群简介 |
question | const char * | 入群问题 |
announcement | const char * | 群公告 |