群聊消息
图片
群聊消息中的 image 消息段字段说明与发送复用规则。
群聊消息中的图片消息段,type 为 "image",收发均支持。
image 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
file_id | string | 图片文件标识 |
name | string | 文件名 |
md5 | string | 图片 MD5 |
sha1 | string | 图片 SHA-1 |
size | uint64 | 文件大小(字节) |
width | uint64 | 图片宽度(像素) |
height | uint64 | 图片高度(像素) |
pic_type | uint64 | 图片类型值 |
original | bool | 是否为原图 |
url | string | 图片地址;上传结果中为空字符串,不影响发送,发送时不参与下载或上传 |
群聊发送说明
- 通过
upload_group_image上传成功后,返回只含一条image消息段的 JSON 数组;上传返回的image.data.url为空字符串,不影响直接传给send_group_message发送。 - 发送图片时须使用同一账号、平台和群,并具备
send_group_message权限。
GroupMessage 公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
self_id | uint64_t | 收到消息的 Bot 账号 |
platform | const char * | 所属平台 PLATFORM_* |
group_id | uint64_t | 群号 |
user_id | uint64_t | 发送人 QQ 号 |
msg_seq | uint64_t | 消息序号 |
msg_uid | uint64_t | 消息唯一编号 |
random | uint64_t | 消息随机数 |
msg_time | uint64_t | 发送时间(Unix 秒) |
level | uint64_t | 发送人的群成员等级,没有时为 0 |
group_name | const char * | 群名称 |
nickname | const char * | 发送人昵称(设置了群名片时为群名片) |
role | const char * | 发送人身份:"owner" 群主、"admin" 管理员、"member" 成员 |
title | const char * | 发送人头衔,没有时为 "" |
message | const char * | 消息段 UTF-8 JSON 数组(Segment[]) |