跳转到正文
媒体类

上传群图片

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_iduint64_t是在线 Bot QQ 号,不能为 0
platformconst char *是所属平台 PLATFORM_*
group_iduint64_t是群号,不能为 0
dataconst uint8_t *是完整图片字节(非路径或 Base64),调用返回前须保持有效且不得修改
data_lenuint64_t是字节数,范围 1..31,457,280(30 MiB);超限直接返回错误,不会改为群文件
originalbool是true 请求按原图处理;框架不修改或转码字节,文件名由框架生成

使用说明

  • 支持 JPEG、PNG、WebP、BMP、AVIF、TIFF、HEIF、GIF、APNG(实际是否接受以服务器为准)。
  • 成功后将 result->message 原样传给 send_group_message(同一账号、平台和群,需发送权限)。

返回值 UploadGroupImageResult

用完必须调用 free_upload_group_image_result(result) 交还。

字段类型说明
codeint32_t0 表示成功;失败为 RESULT_LOCAL_ERROR
errorconst char *失败原因
messageconst char *成功时为只含一条 image 段的 JSON 数组,失败时为 ""

本页目录