跳转到正文
消息类

获取合并转发消息

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_iduint64_t是取自收到转发卡片的同一次好友或群聊消息回调
platformconst char *是取自同一次消息回调的 platform
user_iduint64_t是取自同一个 forward 段的 data.user_id,不能为 0
res_idconst char *是取自同一个 forward 段的 data.res_id,非空 UTF-8(最多 256 字节),原样传入

返回值 ForwardMessageResult

不需要群号或完整消息段,要求客户端能够识别卡片发送人。用完必须调用 free_forward_message_result(result) 交还。

字段类型说明
codeint32_t0 表示成功;失败为 RESULT_LOCAL_ERROR
errorconst char *失败原因
messagesconst char *成功时为按顺序排列的 UTF-8 JSON 数组;失败时为 "[]"

数组中每项包含:user_id(uint64,缺失为 0)、msg_time(uint64 Unix 秒,缺失为 0)、nickname(string,缺失为 "")、avatar(string,缺失为 "")、message(与消息回调同格式的消息段数组)。

本页目录