set_group_portrait

设置指定群聊的头像。萌卡NT会按 QQ Android 的 Highway command_id=3000 上传链路，先获取当前账号的 Highway 会话，再将公开群号转换为 QQ 内部群 UIN 后提交图片。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

本地文件只可从管理员允许的媒体目录读取；不允许任意读取框架数据、密钥或系统文件。也可使用本服务的 file_transfer 已完成上传引用。

适用协议

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

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "set_group_portrait",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "file": "data/media-downloads/example.png"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
file	string	是	文件来源；受媒体目录权限约束，可使用 transfer:// 引用

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
result	integer	上游操作结果
errMsg	string	上游错误说明
new_seq	integer	更新后的头像序列