外观
保存等级任务计划
从 v2.0.9 起提供;v2.0.8 及更早版本不包含此接口。
通过完成令牌认证的插件 WebSocket 服务调用 update_level_task_settings。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| self_id | number | 是 | QQ 号,必须是框架已配置账号 |
| client_type | string | 是 | 明确填写 android 或 linuxqq;等级加速目前只支持 android,linuxqq 返回不支持 |
| selected_tasks | string[] | 是 | 选择的任务标题;可传 [] 清空,去空白、去重,最多 100 项 |
| schedule_enabled | boolean | 是 | 是否启用框架定时执行;false 必须原样保留 |
| schedule_time | string | 是 | 框架主机本地时间,严格 HH:mm,例如 04:00 |
示例
javascript
const result = await api.update_level_task_settings({ self_id: 123456, client_type: "android", selected_tasks: [], schedule_enabled: false, schedule_time: "04:00" })返回
返回保存后的 { selectedTasks, scheduleEnabled, scheduleTime, lastRunDate }。这是完整设置替换,三项均必填;不修改 lastRunDate,不接受由插件指定执行日期。保存操作不执行任务,框架现有调度器使用该计划。
以上返回值是 WebSocket action_result.data;失败为 ok:false 和 error。SDK 自动解包 data 并在失败时拒绝 Promise。
详见共享等级任务管理接入。
