消息类
获取合并转发消息
get_forward_message:获取合并转发卡片内的逐条消息记录。
const ForwardMessageResult *get_forward_message(
uint64_t self_id, const char *platform, uint64_t user_id, const char *res_id);
void free_forward_message_result(const ForwardMessageResult *result);- 权限:
get_forward_message - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 取自收到转发卡片的同一次好友或群聊消息回调 |
platform | const char * | 是 | 取自同一次消息回调的 platform |
user_id | uint64_t | 是 | 取自同一个 forward 段的 data.user_id,不能为 0 |
res_id | const char * | 是 | 取自同一个 forward 段的 data.res_id,非空 UTF-8(最多 256 字节),原样传入 |
返回值 ForwardMessageResult
不需要群号或完整消息段,要求客户端能够识别卡片发送人。用完必须调用 free_forward_message_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因 |
messages | const char * | 成功时为按顺序排列的 UTF-8 JSON 数组;失败时为 "[]" |
数组中每项包含:user_id(uint64,缺失为 0)、msg_time(uint64 Unix 秒,缺失为 0)、nickname(string,缺失为 "")、avatar(string,缺失为 "")、message(与消息回调同格式的消息段数组)。