跳转到正文
群聊消息

语音

群聊消息中的 voice 消息段字段说明与复用发送限制。

群聊消息中的语音消息段,type 为 "voice"。

voice 字段说明

好友语音和群语音均使用 voice 段,不包含 URL。

字段类型说明
file_idstring文件标识
namestring文件名,缺失时为 ""
md5stringMD5,缺失时为 ""
sha1stringSHA-1,缺失时为 ""
sizeuint64字节数,缺失时为 0
durationuint64时长(秒),缺失时为 0
audio_codecuint64(可选)0 为 AMR,1 为 SILK,2 为 MP3,3 为 AAC;未提供时省略,不按文件后缀判断
wave_amplitudesuint8[](可选)波形采样无符号字节数组(0–255);缺失或无效时省略

群聊复用发送限制

  • 发送已有群语音时,消息数组必须只含一条群聊 voice 消息段(取自收到的群消息或 upload_group_voice 返回的 message),不会上传或转码文件。

GroupMessage 公共字段

字段类型说明
self_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
group_iduint64_t群号
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
leveluint64_t发送人的群成员等级,没有时为 0
group_nameconst char *群名称
nicknameconst char *发送人昵称(设置了群名片时为群名片)
roleconst char *发送人身份:"owner" 群主、"admin" 管理员、"member" 成员
titleconst char *发送人头衔,没有时为 ""
messageconst char *消息段 UTF-8 JSON 数组(Segment[])

本页目录