Skip to content

Latest commit

 

History

History
187 lines (149 loc) · 5.82 KB

集成文档.md

File metadata and controls

187 lines (149 loc) · 5.82 KB
Raw

集成文档

接口介绍

AsstAppendTask

接口原型

TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);

接口说明

添加任务

返回值

  • TaskId
    若添加成功，返回该任务 ID, 可用于后续设置任务参数；
    若添加失败，返回 0

参数说明

  • AsstHandle handle
    实例句柄
  • const char* type
    任务类型
  • const char* params
    任务参数，json string
任务类型一览
  • StartUp
    开始唤醒
// 对应的任务参数
{
    "client_type": string,      // 客户端版本，可选，默认为空
                                // 选项："Official" | "Bilibili"
    "start_game_enable": bool   // 是否自动启动客户端，可选，默认不启动
}
  • Fight
    刷理智
// 对应的任务参数
{
    "stage": string,            // 关卡名，可选，默认“当前关卡”。不支持运行中设置
    "medicine": int,            // 最大使用理智药数量，可选，默认 0
    "stone": int,               // 最大吃石头数量，可选，默认 0
    "times": int,               // 指定次数，可选，默认无穷大
    "drops": {                  // 指定掉落数量，可选，默认不指定
        "30011": int,           // key - item_id, value 数量. key 可参考 resource/item_index.json 文件
        "30062": int            // 是或的关系
    },
    /* 以上全部是或的关系，即任一达到即停止任务 */

    "report_to_penguin": bool,  // 是否汇报企鹅数据，可选，默认 false
    "penguin_id": string,       // 企鹅数据汇报 id, 可选，默认为空。仅在 report_to_penguin 为 true 时有效
    "server": string            // 服务器，可选，默认 "CN", 会影响掉落识别及上传
                                // 选项："CN" | "US" | "JP" | "KR"
}
  • Recruit
    公开招募
// 对应的任务参数
{
    "refresh": bool,            // 是否刷新三星 Tags, 可选，默认 false
    "select": [                 // 会去点击标签的 Tag 等级，必选
        int,
        ...
    ],
    "confirm": [                // 会去点击确认的 Tag 等级，必选。若仅公招计算，可设置为空数组
        int,
        ...
    ],
    "times": int,               // 招募多少次，可选，默认 0。若仅公招计算，可设置为 0
    "set_time": bool,           // 是否设置 9 小时。仅在 times 为 0 时生效，可选，默认 true
    "expedite": bool,           // 是否使用加急许可，可选，默认 false
    "expedite_times": int,      // 加急次数，仅在 expedite 为 true 时有效。
                                // 可选，默认无限使用（直到 times 达到上限）
    "skip_robot": bool          // 是否在识别到小车词条时跳过，可选，默认跳过
}
  • Infrast
    基建换班
{
    "mode": int,            // 换班工作模式，保留接口，暂时可以不传。不支持运行中设置
    "facility": [           // 要换班的设施（有序），必选。不支持运行中设置
        string,             // 设施名，"Mfg" | "Trade" | "Power" | "Control" | "Reception" | "Office" | "Dorm"
        ...
    ],
    "drones": string,       // 无人机用途，可选项，默认 _NotUse
                            // "_NotUse"、"Money"、"SyntheticJade"、"CombatRecord"、"PureGold"、"OriginStone"、"Chip"
    "threshold": float,     // 宿舍进驻心情阈值，可选，取值范围 [0, 1.0]，默认 0.3
    "replenish": bool       // 贸易站“源石碎片”是否自动补货，可选，默认 false
}

  • Visit
    访问好友
    不支持设置参数

  • Mall
    领取信用及商店购物。
    会先有序的按 buy_first 购买一遍，再从左到右并避开 blacklist 购买第二遍

// 对应的任务参数
{
    "shopping": bool,       // 是否购物，可选，默认 false。不支持运行中设置
    "buy_first": [          // 优先购买列表，可选。不支持运行中设置
        string,             // 商品名，如 "招聘许可"、"龙门币" 等
        ...
    ],
    "blacklist": [          // 黑名单列表，可选。不支持运行中设置
        string,             // 商品名，如 "加急许可"、"家具零件" 等
        ...
    ]
}

  • Award
    领取日常奖励
    不支持设置参数

  • Roguelike
    无限刷肉鸽

{
    "mode": int             // 模式，可选项。默认 0
                            // 0 - 尽可能一直往后打
                            // 1 - 第一层投资完源石锭就退出
                            // 2 - 投资过后再退出，没有投资就继续往后打
}
  • Copilot
    自动抄作业
{
    "stage_name": string,       // 关卡名，需要与作业 JSON 中的 stage_name 字段相同。不支持运行期设置
    "filename": string,         // 作业 JSON 的文件路径，绝对、相对路径均可。不支持运行期设置
    "formation": bool           // 是否进行 “快捷编队”，可选，默认否。不支持运行期设置
}

作业 JSON请参考 战斗流程协议

AsstSetTaskParams

接口原型

bool ASSTAPI AsstSetTaskParams(AsstHandle handle, TaskId id, const char* params);

接口说明

设置任务参数

返回值

  • bool
    返回是否设置成功

参数说明

  • AsstHandle handle
    实例句柄
  • TaskId task
    任务 ID, AsstAppendTask 接口的返回值
  • const char* params
    任务参数，json string，与 AsstAppendTask 接口相同。
    未标注“不支持运行中设置”的字段都支持实时修改；否则若当前任务正在运行，会忽略对应的字段