跳转到正文
好友消息

语音

好友消息中的 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_friend_voice 返回的 message),不会下载、上传或转码文件。

FriendMessage 公共字段

字段类型说明
self_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
messageconst char *消息段 UTF-8 JSON 数组(Segment[])
nicknameconst char *好友显示名:优先本 Bot 的备注,其次昵称;未取到时为 ""

本页目录