Skip to content

execute_level_tasks ​

按数组顺序执行等级任务。

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

适用协议

Android(手机 / 平板);不支持 Linux QQ。

调用方式 ​

向已认证的 WebSocket 连接发送:

json
{
  "type": "action",
  "id": "example-1",
  "action": "execute_level_tasks",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "tasks": ["去看免费小说"]
  }
}

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

参数 ​

参数类型必填说明
self_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
tasksstring[]是要执行的任务名称数组,至少 1 项;可通过 level_task_management 查询当前支持项目

返回值 ​

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

Android 执行完成时 data 为 null。Linux 不执行该功能,返回 {self_id, protocol_id, skipped: true, reason}。任务本身可能产生阅读、签到等上游活动,不应在超时后自动重复执行。

调用条件 ​

Free 不可调用。Plus 每次调用核对当前 QQ 最新等级,至少需要 32 级;Pro 不设这项 QQ 等级门槛。仍需满足账号在线、当前授权及接口本身的业务条件,获取最新等级失败时不继续操作。

萌卡 · 自托管 QQ 机器人框架