get_group_video_url

获取群视频地址。

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

{
  "type": "action",
  "id": "get_group_video_url-1",
  "action": "get_group_video_url",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "file_id": "消息返回的file_id"
  }
}

参数

参数	类型	必填	说明
self_id	number	是	当前框架内的 QQ 号，5–10 位整数。
protocol_id	number	是	明确选择账号协议，0 有效；使用 get_protocol_list 查询。
file_id	string	是	当前账号及协议收到的媒体 file_id；不能跨账号或协议复用
group_id	number	否	目标群号。

返回值

字段	类型	说明
file_id	string	本次查询的媒体标识。
url	string	下载地址，可能有时效。
thumb_url	string	视频封面地址，可能为空。

注意事项

file_id 必须来自当前 QQ、当前协议收到的对应类型媒体。缓存不存在、跨账号或跨协议引用会被拒绝，不能用任意文件路径替代。