功能类
查询用户资料卡
get_summary_card:查询指定 QQ 号(含自身或陌生人)的资料卡。
const SummaryCardResult *get_summary_card(uint64_t self_id, const char *platform, uint64_t user_id);
void free_summary_card_result(const SummaryCardResult *result);- 权限:
get_summary_card - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
user_id | uint64_t | 是 | 目标 QQ 号,传 0 查询 Bot 自身;目标也可以是陌生人 |
返回值 SummaryCardResult
失败时 code == RESULT_LOCAL_ERROR,不要使用资料字段。用完必须调用 free_summary_card_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功 |
error | const char * | 失败原因 |
user_id | uint64_t | 查询到的 QQ 号 |
nickname | const char * | 昵称 |
remark | const char * | 备注 |
level | int64_t | QQ 等级,无数据时为 0 |
like_count | int64_t | 名片赞数,无数据时为 0 |
sex | int64_t | 性别标记;未定义的值按未知处理,不猜测 |
age | int64_t | 年龄,无数据时为 0 |
signature | const char * | 个性签名 |