Skip to content

Latest commit

 

History

History
240 lines (198 loc) · 8.86 KB

3.1-集成文件.md

File metadata and controls

240 lines (198 loc) · 8.86 KB

集成檔案

介面介紹

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
    開始喚醒
// 對應的任務參數
{
    "enable": bool,             // 是否啟用本任務，可選，預設為 true
    "client_type": string,      // 用戶端版本，可選，預設為空
                                // 選項："Official" | "Bilibili"
    "start_game_enabled": bool   // 是否自動啟動用戶端，可選，預設不啟動
}
  • Fight
    刷理智
// 對應的任務參數
{
    "enable": bool,             // 是否啟用本任務，可選，預設為 true
    "stage": string,            // 關卡名，可選，預設為空，辨識當前/上次的關卡。不支援執行時設置
                                // 支援全部主線關卡，如 "1-7"、"S3-2"等
                                // 另支援少部分資源關卡，如 "CE-6" 等（請參考 C# 集成示例）
    "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"
    "client_type": string,      // 用戶端版本，可選，預設為空。用於遊戲崩潰時重啟並連回去繼續刷，若為空則不啟用該功能
                                // 選項："Official" | "Bilibili"
    "DrGrandet": bool,          // 節省理智碎石模式，可選，預設 false，僅在可能產生碎石效果時生效。
                                // 在碎石確認畫面等待，直到當前的 1 點理智恢復完成後再立刻碎石
}
  • Recruit
    公開招募
// 對應的任務參數
{
    "enable": bool,             // 是否啟用本任務，可選，預設為 true
    "refresh": bool,            // 是否刷新三星 Tags, 可選，預設 false
    "select": [                 // 會去點擊標籤的 Tag 等級，必選
        int,
        ...
    ],
    "confirm": [                // 會去點擊確認的 Tag 等級，必選。若僅公招計算，可設置為空陣列
        int,
        ...
    ],
    "times": int,               // 招募多少次，可選，預設 0。若僅公招計算，可設置為 0
    "set_time": bool,           // 是否設置招募時限。僅在 times 為 0 時生效，可選，預設 true
    "expedite": bool,           // 是否使用加急許可，可選，預設 false
    "expedite_times": int,      // 加急次數，僅在 expedite 為 true 時有效。
                                // 可選，預設無限使用（直到 times 達到上限）
    "skip_robot": bool,         // 是否在辨識到小車詞條時跳過，可選，預設跳過
    "recruitment_time": {       // Tag 等級（大於等於 3）和對應的希望招募時限，單位為分鐘，預設值都為 540（即 09:00:00）
        "3": int,
        "4": int,
        ...
    },
    "report_to_penguin": bool,  // 是否匯報企鵝資料，可選，預設 false
    "penguin_id": string,       // 企鵝資料匯報 id, 可選，預設為空。僅在 report_to_penguin 為 true 時有效
    "report_to_yituliu": bool,  // 是否匯報一圖流資料，可選，預設 false
    "yituliu_id": string,       // 一圖流匯報 id, 可選，預設為空。僅在 report_to_yituliu 為 true 時有效
}
  • Infrast
    基建換班
{
    "enable": bool,         // 是否啟用本任務，可選，預設為 true
    "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
    訪問好友
// 對應的任務參數
{
    "enable": bool          // 是否啟用本任務，可選，預設為 true
}
  • Mall
    領取信用及商店購物。 會先有序的按 buy_first 購買一遍，再從左到右並避開 blacklist 購買第二遍
// 對應的任務參數
{
    "enable": bool,         // 是否啟用本任務，可選，預設為 true
    "shopping": bool,       // 是否購物，可選，預設 false。不支援執行時設置
    "buy_first": [          // 優先購買列表，可選。不支援執行時設置
        string,             // 商品名，如 "招聘許可"、"龍門幣" 等
        ...
    ],
    "blacklist": [          // 黑名單列表，可選。不支援執行時設置
        string,             // 商品名，如 "加急許可"、"家具零件" 等
        ...
    ]
}
  • Award
    領取日常獎勵
// 對應的任務參數
{
    "enable": bool          // 是否啟用本任務，可選，預設為 true
}
  • Roguelike
    無限刷肉鴿
{
    "enable": bool,         // 是否啟用本任務，可選，預設為 true
    "mode": int,            // 模式，可選項。預設 0
                            // 0 - 刷蠟燭，盡可能穩定地打更多層數
                            // 1 - 刷源石錠，第一層投資完就退出
                            // 2 - 【即將棄用】兩者兼顧，投資過後再退出，沒有投資就繼續往後打
                            // 3 - 【開發中】嘗試通關，盡可能打得遠
    "starts_count": int,    // 開始探索 次數，可選，預設 INT_MAX。達到後自動停止任務
    "investments_count": int,
                            // 投資源石錠 次數，可選，預設 INT_MAX。達到後自動停止任務
    "stop_when_investment_full": bool,
                            // 投資滿了自動停止任務，可選，預設 false      
    "squad": string,        // 開局分隊，可選，例如 "突擊戰術分隊" 等，預設 "指揮分隊"
    "roles": string,        // 開局職業組，可選，例如 "先手必勝" 等，預設 "取長補短"
    "core_char": string     // 開局幹員名，可選，僅支援單個幹員中！文！名！ 。預設辨識練度自動選擇
}
  • Copilot
    自動抄作業
{
    "enable": bool,             // 是否啟用本任務，可選，預設為 true
    "stage_name": string,       // 關卡名，需要與作業 JSON 中的 stage_name 欄位相同。不支援執行時設置
    "filename": string,         // 作業 JSON 的檔案路徑，絕對、相對路徑均可。不支援執行時設置
    "formation": bool           // 是否進行 “快捷編隊”，可選，預設否。不支援執行時設置
}

作業 JSON請參考 戰鬥流程協議

  • Depot
    倉庫辨識
// 對應的任務參數
{
    "enable": bool          // 是否啟用本任務，可選，預設為 true
}

AsstSetTaskParams

介面原型

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

介面說明

設置任務參數

返回值

  • bool
    返回是否設置成功

參數說明

  • AsstHandle handle
    實例控制代碼
  • TaskId task
    任務 ID, AsstAppendTask 介面的返回值
  • const char* params
    任務參數，json string，與 AsstAppendTask 介面相同。 未標註“不支援執行時設置”的欄位都支援實時修改；否則若當前任務正在運行，會忽略對應的欄位