消息类
上传合并转发消息
upload_forward_message:上传自定义合并转发正文(不发送消息)。
#define FORWARD_TARGET_FRIEND 1u
#define FORWARD_TARGET_GROUP 2u
const UploadForwardMessageResult *upload_forward_message(
uint64_t self_id, const char *platform, uint32_t target_type, uint64_t target_id,
const char *title, const char *summary,
const char *const *preview, uint32_t preview_count,
const char *messages_json);
void free_upload_forward_message_result(const UploadForwardMessageResult *result);- 权限:
upload_forward_message - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号,不能为 0 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
target_type | uint32_t | 是 | FORWARD_TARGET_FRIEND(1)或 FORWARD_TARGET_GROUP(2) |
target_id | uint64_t | 是 | 好友 QQ 号或群号,不能为 0;好友目标找不到信息时失败 |
title | const char * | 是 | 非空 UTF-8 标题(最多 1024 字节) |
summary | const char * | 否 | 摘要(最多 1024 字节),不显示可传 "" 或 NULL |
preview / preview_count | const char *const * / uint32_t | 否 | 预览文案数组(最多 20 条,每条最多 1024 字节);不需要时传 NULL, 0 |
messages_json | const char * | 是 | UTF-8 JSON 数组,每条记录含 nickname(必填,最多 128 字节,显示带 "[自定义]" 前缀)与 message 消息段数组;每组至少 1 条,嵌套最多 2 层,每条文本合计最多 8192 字节 |
使用限制
- 每条记录的
nickname必填且最多 128 字节,显示时自动带"[自定义]"前缀,不接受他人的账号标识。 - 任一输入无效则整个上传直接失败,不执行上传。
- 嵌套引用已有转发:取同一账号、平台和目标的
upload_forward_message结果中result->message数组中唯一的forward对象,原样放入当前记录的message数组——不要传入整个结果数组、只传res_id,或自行添加user_id。
返回值 UploadForwardMessageResult
成功后将 result->message 原样传给 send_friend_message 或 send_group_message(同一账号、平台和目标,需对应发送权限)。用完必须调用 free_upload_forward_message_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因 |
res_id | const char * | 合并转发资源 ID |
message | const char * | 含一条 forward 段的 JSON 数组(data.count 为顶层条数) |