跳转到正文
媒体类

上传好友语音

upload_friend_voice:上传好友语音(不发送消息)。

const UploadFriendVoiceResult *upload_friend_voice(
    uint64_t self_id, const char *platform, uint64_t user_id,
    const uint8_t *data, uint64_t data_len);
void free_upload_friend_voice_result(const UploadFriendVoiceResult *result);
  • 权限:upload_friend_voice
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号,不能为 0
platformconst char *是所属平台 PLATFORM_*
user_iduint64_t是好友 QQ 号,不能为 0;尚未识别时先调用 list_friends 或与该好友交互
dataconst uint8_t *是完整 SILK V3、标准 PCM WAV 或 MPEG-1 Layer III MP3 字节
data_lenuint64_t是字节数,不能为 0

格式支持

  • SILK V3:按原始数据上传(wave_amplitudes 可能省略)。
  • 标准 PCM WAV:支持 8–192 kHz 与 8/16/24/32 位整数 PCM;进程内混为单声道、重采样至 16 kHz 并转为 SILK,生成按约 100 ms 分桶的 wave_amplitudes。不支持浮点或压缩 WAV。
  • MPEG-1 Layer III MP3:支持 32 / 44.1 / 48 kHz;进程内解码并转为 16 kHz SILK,生成 wave_amplitudes。不支持 MPEG-2 / 2.5、强度立体声或自由码率 MP3。
  • 成功后将 result->message 原样传给 send_friend_message。

返回值 UploadFriendVoiceResult

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

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

本页目录