send_packet

• action：send_packet
• 使用条件：已认证的正向或反向 WebSocket 服务，目标账号在线。托管和外部插件均可调用，使用服务令牌认证。

使用条件：账号在线且 QQ 等级满足框架账号类型要求（free 至少 48 级，plus 至少 16 级，pro 无框架等级限制）。Free/Plus 的等级由服务端账号状态核验，未知或不足时返回错误；Pro 不要求同步等级，但仍需满足原有权限、在线状态及平台规则。

调用方式

const responseHex = await api.send_packet(selfId, command, packetHex, true, reserveHex)
// Linux QQ 账号
const linuxResponse = await api.forProtocol('linuxqq').send_packet(selfId, command, packetHex)

参数

参数	类型	必填	说明
self_id	number	是	已登录的机器人 QQ 号
cmd	string	是	SSO 协议命令名称
data	string	是	请求体，偶数长度十六进制，解码后最大 4 MiB
rsp	boolean	否	是否等待响应，默认 true
reserve	string	否	自定义 reserve 十六进制，最大 4 MiB；省略时框架生成标准 reserve
client_type	string	通用调用必填	android 或 linuxqq；SDK 方法默认 android，可用 forProtocol 切换

const responseHex = await api.call('send_packet', {
  self_id: selfId,
  client_type: 'android',
  cmd: command,
  data: packetHex,
  rsp: true,
})

command 和 packetHex 使用插件业务实际需要的协议与内容。

返回值

rsp=true 返回响应体的小写十六进制字符串；rsp=false 提交后返回 null。响应仍需按对应协议解析。

无效参数、账号离线、协议错误或超时会使调用失败。结果未知时先核对业务状态，不要自动重发。

基础连接见SDK 快速开始。