媒体类
上传群语音
upload_group_voice:上传群语音(不发送消息)。
const UploadGroupVoiceResult *upload_group_voice(
uint64_t self_id, const char *platform, uint64_t group_id,
const uint8_t *data, uint64_t data_len);
void free_upload_group_voice_result(const UploadGroupVoiceResult *result);- 权限:
upload_group_voice - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号,不能为 0 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
group_id | uint64_t | 是 | 群号,不能为 0 |
data | const uint8_t * | 是 | 完整 SILK V3、标准 PCM WAV 或 MPEG-1 Layer III MP3 字节 |
data_len | uint64_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_group_message。
返回值 UploadGroupVoiceResult
用完必须调用 free_upload_group_voice_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因 |
message | const char * | 成功时为只含一条 voice 段的 JSON 数组,失败时为 "" |