群聊消息
语音
群聊消息中的 voice 消息段字段说明与复用发送限制。
群聊消息中的语音消息段,type 为 "voice"。
voice 字段说明
好友语音和群语音均使用 voice 段,不包含 URL。
| 字段 | 类型 | 说明 |
|---|---|---|
file_id | string | 文件标识 |
name | string | 文件名,缺失时为 "" |
md5 | string | MD5,缺失时为 "" |
sha1 | string | SHA-1,缺失时为 "" |
size | uint64 | 字节数,缺失时为 0 |
duration | uint64 | 时长(秒),缺失时为 0 |
audio_codec | uint64(可选) | 0 为 AMR,1 为 SILK,2 为 MP3,3 为 AAC;未提供时省略,不按文件后缀判断 |
wave_amplitudes | uint8[](可选) | 波形采样无符号字节数组(0–255);缺失或无效时省略 |
群聊复用发送限制
- 发送已有群语音时,消息数组必须只含一条群聊
voice消息段(取自收到的群消息或upload_group_voice返回的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[]) |