媒体类
上传群图片
upload_group_image:上传群图片(不发送消息)。
const UploadGroupImageResult *upload_group_image(
uint64_t self_id, const char *platform, uint64_t group_id,
const uint8_t *data, uint64_t data_len, bool original);
void free_upload_group_image_result(const UploadGroupImageResult *result);- 权限:
upload_group_image - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号,不能为 0 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
group_id | uint64_t | 是 | 群号,不能为 0 |
data | const uint8_t * | 是 | 完整图片字节(非路径或 Base64),调用返回前须保持有效且不得修改 |
data_len | uint64_t | 是 | 字节数,范围 1..31,457,280(30 MiB);超限直接返回错误,不会改为群文件 |
original | bool | 是 | true 请求按原图处理;框架不修改或转码字节,文件名由框架生成 |
使用说明
- 支持 JPEG、PNG、WebP、BMP、AVIF、TIFF、HEIF、GIF、APNG(实际是否接受以服务器为准)。
- 成功后将
result->message原样传给send_group_message(同一账号、平台和群,需发送权限)。
返回值 UploadGroupImageResult
用完必须调用 free_upload_group_image_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因 |
message | const char * | 成功时为只含一条 image 段的 JSON 数组,失败时为 "" |