媒体类
上传好友视频
upload_friend_video:上传好友视频并自动生成封面(不发送消息)。
const UploadFriendVideoResult *upload_friend_video(
uint64_t self_id, const char *platform, uint64_t user_id,
const uint8_t *data, uint64_t data_len);
void free_upload_friend_video_result(const UploadFriendVideoResult *result);- 权限:
upload_friend_video - 调用要求:需要账号在线,请在工作线程中调用
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | 在线 Bot QQ 号,不能为 0 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
user_id | uint64_t | 是 | 好友 QQ 号,不能为 0;尚未识别时先调用 list_friends 或与该好友交互 |
data | const uint8_t * | 是 | 完整 H.264 / H.265 的 MP4 / MOV / 3GP 视频字节(非路径或 Base64) |
data_len | uint64_t | 是 | 字节数,不能为 0 |
使用说明
- 覆盖常见 8-bit、4:2:0 编码参数;封面解码支持 IDR 和纯 I 帧。不转码正片,自动生成与画面尺寸一致的 JPEG 封面。
- 成功后将
result->message原样传给send_friend_message(作为独立消息发送)。
返回值 UploadFriendVideoResult
用完必须调用 free_upload_friend_video_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因,成功时为 "" |
message | const char * | 成功时为只含一条 video 段的 JSON 数组,失败时为 "" |