介面介紹

AsstAppendTask

介面原型

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

介面說明

新增任務。

回傳值

• AsstTaskId
  若新增成功，回傳該任務 ID，可用於後續設定任務參數；
  若新增失敗，回傳 0。

參數說明

handleRequiredAsstHandle

執行個體控制代碼 (Handle)

typeRequiredconst char*

任務類型

paramsRequiredconst char*

任務參數，json String

任務類型一覽

• StartUp
  開始喚醒

enableOptionalboolean

true

是否啟用本任務。

client_typeRequiredstring

用戶端版本。

選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

start_game_enabledOptionalboolean

false

是否自動啟動用戶端。

account_nameOptionalstring

切換帳號，預設不切換。

僅支援切換至已登入的帳號。依據登入名稱進行搜尋，請確保輸入內容在所有帳號中具有唯一性。

官服：123****4567，可輸入 123****4567、4567、123、3****4567

B 服：張三，可輸入 張三、張、三

繁中服：帳號為 Email，如 ab****01@gmail.com，建議填不含星號的明文片段，如 01@gmail

Example

{
   "enable": true,
   "client_type": "Official",
   "start_game_enabled": true,
   "account_name": "123****4567"
}

• CloseDown
  關閉遊戲

enableOptionalboolean

true

是否啟用本任務。

client_typeRequiredstring

用戶端版本，若留空則不執行。

選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

Example

{
   "enable": true,
   "client_type": "Official"
}

• Fight
  理智作戰

enableOptionalboolean

true

是否啟用本任務。

stageOptionalstring

關卡名稱。預設為空，將辨識 目前/上次 關卡。不支援在執行中更改設定。
目前支援導航的關卡包含：

• 全部主線關卡：可在關卡末尾新增 -NORMAL 或 -HARD 切換難度：10-14 章對應標準/磨難，15 章及以後對應常規/險地。
• 資源收集：
  • 龍門幣、作戰記錄： 支援第 5 / 6 關，但必須輸入 CE-6 / LS-6。若第六關無法代理，MAA 會自動切換至第五關。
  • 技能書、採購憑證、碳本：支援第 5 關，必須輸入 CA-5 / AP-5 / SK-5。
  • 晶片關卡：支援所有關卡，必須輸入完整編號，例如PR-A-1。
• 剿滅作戰：支援以下傳入值（必須使用對應的 Value）：
  • 當期剿滅：Annihilation
  • 切爾諾伯格：Chernobog@Annihilation
  • 龍門外環：LungmenOutskirts@Annihilation
  • 龍門市區：LungmenDowntown@Annihilation
• 別傳：支援 OF-1 / OF-F3。
• 當期 SideStory 活動：支援活動後三關。可查閱 API 獲取支援的關卡列表。需額外加載 tasks.json 中的活動關卡導航。
• 復刻 SideStory 活動：輸入 SSReopen-<關卡前綴> ，可一次性刷完 XX-1 ~ XX-9 關，如 SSReopen-IC。

medicineOptionalnumber

0

理智藥最大使用量。

medicine_expire_daysOptionalnumber

0

使用過期時間在指定天數內的理智藥，0 表示不使用過期理智藥。

expiring_medicineOptionalDeprecatednumber

0

已棄用，自 v6.8.0 起請使用 medicine_expire_days 代替。

stoneOptionalnumber

0

碎石最大數量。

timesOptionalnumber

2147483647

戰鬥次數。

seriesOptionalnumber

連戰次數，-1 ~ 6。
-1：停用自動切換連戰。
0：自動切換為當前可用的最大連戰次數（若理智不足以進行 6 連戰，則選擇最低可用次數）。
1 ~ 6：指定固定的連戰次數。

dropsOptionalobject

指定物品掉落數量，預設不指定。key 為 item_id，value 為數量。key 可參考 resource/item_index.json 檔案。

例如：{ "30011": 10, "30062": 5 }

上述所有條件（次數、掉落等）均為「或」的關係，任一條件達成即停止任務。

report_to_penguinOptionalboolean

false

是否回報企鵝物流

penguin_idOptionalstring

企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。

report_to_yituliuOptionalboolean

false

是否回報一圖流。

yituliu_idOptionalstring

一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。

serverOptionalstring

CN

遊戲伺服器，會影響掉落物辨識及數據上傳。

選項：CN | US | JP | KR

client_typeOptionalstring

用戶端版本，預設為空。用於遊戲崩潰後自動重啟並接續任務；若為空則不啟用自動重啟功能。
選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

DrGrandetOptionalboolean

false

博朗台模式（節省理智碎石模式），僅在產生碎石需求時才起作用。
在碎石確認介面等待，直到目前理智自動恢復 1 點後，再立刻執行碎石回復，以避免浪費自然恢復。

Example

{
   "enable": true,
   "stage": "1-7",
   "medicine": 1,
   "medicine_expire_days": 2,
   "stone": 0,
   "times": 10,
   "series": 0,
   "drops": {
      "30011": 10
   },
   "report_to_penguin": true,
   "penguin_id": "123456",
   "report_to_yituliu": true,
   "yituliu_id": "123456",
   "server": "CN",
   "client_type": "Official",
   "DrGrandet": false
}

• Recruit
  公開招募

enableOptionalboolean

true

是否啟用本任務。

refreshOptionalboolean

false

是否刷新三星 Tags。

selectRequiredarray<number>

會被自動點選的 Tag 等級。

confirmRequiredarray<number>

會被自動點選確認的 Tag 等級。若只想計算結果而不實際招募，請設定為空陣列。

first_tagsOptionalarray<string>

首選 Tags，僅在 Tag 等級為 3 時有效，預設為空。
當 Tag 等級為 3 時，會盡可能多選擇此處設定的 Tags（若有出現），且為強制選擇，會忽略所有 "讓 3 星 Tag 不被選擇" 的設定。

extra_tags_modeOptionalnumber

0

選擇更多的 Tags。
0：預設行為。
1：選滿 3 個 Tags，即使可能產生衝突。
2：儘可能同時選擇更多高星標籤組合，即使可能產生衝突。

timesOptionalnumber

0

招募總次數。若僅需公招計算，請設定為 0。

set_timeOptionalboolean

true

是否設定招募時限。僅在 times 為 0 時才套用。

expediteOptionalboolean

false

是否使用加急許可。

expedite_timesOptionalnumber

加急次數，僅在 expedite 為 true 時有效。預設無限次使用（直到 times 達到上限）。

skip_robotOptionalboolean

true

已棄用，僅用於相容舊參數。

當未提供 preserve_tags 且其值為 true 時，會在辨識到 支援机械 時跳過；元素 不再視為舊版 1 星 Tag。

preserve_tagsOptionalarray<string>

需要保留並跳過目前公招欄位的 Tag 名稱清單。預設為空。

當辨識到任一指定 Tag 時，MAA 會保留該欄位並跳過本次招募。

recruitment_timeOptionalobject

Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）。預設皆為 540 分鐘（即 09:00:00）。
範例：{ "3": 540, "4": 540 }

report_to_penguinOptionalboolean

false

是否回報企鵝物流。

penguin_idOptionalstring

企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。

report_to_yituliuOptionalboolean

false

是否回報一圖流數據。

yituliu_idOptionalstring

一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。

serverOptionalstring

CN

遊戲伺服器，會影響數據上傳。
選項：CN | US | JP | KR

Example

{
   "enable": true,
   "refresh": true,
   "select": [5, 4],
   "confirm": [4, 3],
   "first_tags": ["高级资深干员"],
   "extra_tags_mode": 1,
   "times": 4,
   "set_time": true,
   "expedite": false,
   "expedite_times": 0,
   "preserve_tags": ["支援机械"],
   "recruitment_time": {
      "3": 540,
      "4": 540
   },
   "report_to_penguin": false,
   "penguin_id": "123456",
   "report_to_yituliu": false,
   "yituliu_id": "123456",
   "server": "CN"
}

• Infrast
  基建換班

enableOptionalboolean

true

是否啟用本任務。

modeOptionalnumber

0

換班工作模式。
0 - Default：預設換班模式，單設施最優解。
10000 - Custom：自定義換班模式，讀取使用者配置，可參閱 基建排班協定。
20000 - Rotation：一鍵輪換模式，會跳過控制中樞、發電站、宿舍以及辦公室；其餘設施不進行換班，但保留基本操作（如使用無人機、會客室邏輯）。

facilityRequiredarray<string>

要換班的設施（依序）。不支援在執行中更改設定。
設施名稱：Mfg | Trade | Power | Control | Reception | Office | Dorm | Processing | Training

dronesOptionalstring

\_NotUse

無人機用途。當 mode = 10000 時，此欄位無效。
選項：_NotUse | Money | SyntheticJade | CombatRecord | PureGold | OriginStone | Chip

thresholdOptionalnumber

0.3

工作心情門檻值，取值範圍 [0, 1.0]。
mode = 10000 時，此欄位僅針對 "autofill" 起作用。
mode = 20000 時，此欄位無效。

replenishOptionalboolean

false

貿易站「源石碎片」是否自動補貨。

dorm_notstationed_enabledOptionalboolean

false

是否啟用宿舍「未進駐」選項。

dorm_trust_enabledOptionalboolean

false

是否將宿舍剩餘位置填入信賴值未滿的幹員。

reception_message_boardOptionalboolean

true

是否領取會客室資訊板信用點數。

reception_clue_exchangeOptionalboolean

true

是否進行線索交流。

reception_send_clueOptionalboolean

true

是否贈送線索。

filenameRequiredstring

自定義配置路徑。不支援在執行中更改設定。

僅在 mode = 10000 時才適用

plan_indexRequirednumber

使用配置中的方案序號。不支援在執行中更改設定。

僅在 mode = 10000 時才適用

Example

{
   "enable": true,
   "mode": 0,
   "facility": ["Mfg", "Trade", "Reception"],
   "drones": "PureGold",
   "threshold": 0.3,
   "replenish": true,
   "dorm_notstationed_enabled": false,
   "dorm_trust_enabled": true,
   "reception_message_board": true,
   "reception_clue_exchange": true,
   "reception_send_clue": true,
   "filename": "schedules/base.json",
   "plan_index": 1
}

• Mall
  領取信用點數及商店購物。
  會先依據 buy_first 清單依序購買；接著由左至右掃描商店，避開 blacklist 進行第二輪購買；若信用點數溢出，則會無視黑名單再次由左至右購買，直到信用點數不再溢出為止。

enableOptionalboolean

true

是否啟用本任務。

visit_friendsOptionalboolean

true

是否訪問好友基建以獲得信用點數。

shoppingOptionalboolean

true

是否執行購物流程。

buy_firstOptionalarray<string>

[]

優先購買清單。填入商品名稱，例如 "招聘許可"、"龍門幣" 等。

blacklistOptionalarray<string>

[]

購物黑名單。填入商品名稱，例如 "加急許可"、"傢俱零件" 等。

force_shopping_if_credit_fullOptionalboolean

false

當信用點數溢出時，是否無視黑名單強制購買。

only_buy_discountOptionalboolean

false

是否僅購買折扣商品，此設定僅對第二輪購買有效。

reserve_max_creditOptionalboolean

false

當信用點數低於 300 時是否停止購買，此設定僅對第二輪購買有效。

credit_fightOptionalboolean

false

是否借助戰打一次 OF-1 關卡，以便在隔日獲取更多信用點數。

formation_indexOptionalnumber

0

打 OF-1 關卡時所使用的編隊欄位編號。
範圍為 0–4 的整數，其中 0 表示選擇目前編隊，1-4 分別代表第一、二、三、四編隊。

Example

{
   "enable": true,
   "visit_friends": true,
   "shopping": true,
   "buy_first": ["招聘许可", "龙门币"],
   "blacklist": ["家具零件"],
   "force_shopping_if_credit_full": false,
   "only_buy_discount": true,
   "reserve_max_credit": false,
   "credit_fight": false,
   "formation_index": 0
}

• Award
  領取各種獎勵

enableOptionalboolean

true

是否啟用本任務。

awardOptionalboolean

true

領取 每日/每週任務獎勵。

mailOptionalboolean

false

領取所有郵件獎勵。

recruitOptionalboolean

false

領取「限時尋訪」每日贈送的免費單抽。

orundumOptionalboolean

false

領取「幸運牆」的合成玉獎勵。

miningOptionalboolean

false

領取「限時開採許可」的合成玉獎勵。

specialaccessOptionalboolean

false

領取五週年贈送的月卡獎勵。

Example

{
   "enable": true,
   "award": true,
   "mail": true,
   "recruit": true,
   "orundum": false,
   "mining": true,
   "specialaccess": false
}

• Roguelike
  無限刷肉鴿

enableOptionalboolean

true

是否啟用本任務。

themeOptionalstring

Phantom

主題。
Phantom - 傀影與猩紅孤鑽
Mizuki - 水月與深藍之樹
Sami - 探索者的銀淞止境
Sarkaz - 薩卡茲的無終奇語
JieGarden - 歲的界園誌異

modeOptionalnumber

0

模式。
0 - 刷分 / 獎勵點數：盡可能穩定地打更多層數。
1 - 刷源石錠：第一層投資完後立即退出。
2 - 已棄用 兼顧模式 0 與 1，投資後再退出；若無投資則繼續往後打。
3 - 開發中...
4 - 凹開局：先在難度 0 下到達第三層後重啟，再到指定難度下凹開局獎勵。若未獲得「熱水壺」或「希望」則回到難度 0 重新開始。在 Phantom 主題下則不切換難度，僅在目前難度下嘗試到達第三層、重開、凹開局。
5 - 刷坍縮範式：僅適用於 Sami 主題；透過戰鬥漏怪等方式加快累積坍縮值。若遇到的首個坍縮範式存在於 expected_collapsal_paradigms 清單中則停止任務，否則重啟。
6 - 刷月度小隊獎勵：除了模式適配外，其餘邏輯同模式 0。
7 - 刷深入調查獎勵：除了模式適配外，其餘邏輯同模式 0。

squadOptionalstring

指挥分队

開局分隊名稱。

rolesOptionalstring

取长补短

開局職業組合。

core_charOptionalstring

開局幹員名稱。僅支援單個幹員的中文名稱（不分遊戲伺服器）；若留空或設定為空字串 "" 則根據練度自動選擇。

use_supportOptionalboolean

false

開局幹員是否使用助戰幹員。

use_nonfriend_supportOptionalboolean

false

是否接受非好友助戰幹員。僅在 use_support 為 true 時有效。

starts_countOptionalnumber

2147483647

開始探索的次數上限。達到後自動停止任務。

difficultyOptionalnumber

0

指定難度等級。若未解鎖，則會選擇目前已解鎖的最高難度。

stop_at_final_bossOptionalboolean

false

是否在第 5 層「險路惡敵」節點前停止任務。僅適用於 Phantom 以外的主題。

stop_at_max_levelOptionalboolean

false

是否在肉鴿等級刷滿後停止任務。

investment_enabledOptionalboolean

true

是否進行源石錠投資。

investments_countOptionalnumber

2147483647

投資源石錠的次數上限。達到後自動停止任務。

stop_when_investment_fullOptionalboolean

false

是否在投資到達上限後停止任務。

investment_with_more_scoreOptionalboolean

false

是否在投資後嘗試購物。僅適用於模式 1。

start_with_elite_twoOptionalboolean

false

是否在凹開局的同時凹幹員精二直升。僅適用於模式 4。

only_start_with_elite_twoOptionalboolean

false

是否只凹精二直升而忽略其他開局條件。僅在模式為 4 且 start_with_elite_two 為 true 時有效。

refresh_trader_with_diceOptionalboolean

false

是否消耗骰子刷新商店以購買特殊商品。僅適用於 Mizuki 主題（用於刷指路鱗）。

first_floor_foldartalOptionalstring

希望在第一層「遠見」階段獲得的密文板。僅適用於 Sami 主題（不限模式）；若成功凹到則停止任務。

start_foldartal_listOptionalarray<string>

[]

凹開局時希望在開局獎勵階段獲得的密文板清單。僅在主題為 Sami 且模式為 4 時有效。
開局獎勵階段，需擁有清單中所有的密文板才算凹開局成功。
請注意，此參數須與「生活至上分隊」同時使用，其他分隊在開局獎勵階段不會獲得密文板。

collectible_mode_start_listOptionalobject

凹開局時期望的獎勵，預設全為 false。僅在模式為 4 時有效。
hot_water：熱水壺獎勵，常用於觸發燒水機制（通用）。
shield：護盾獎勵，約等於額外生命值（通用）。
ingot：源石錠獎勵（通用）。
hope：希望獎勵（通用，請注意：JieGarden 主題下無此獎勵）。
random：隨機獎勵選項，指遊戲中的 "消耗所有源石錠換一個隨機收藏品"（通用）。
key：鑰匙獎勵，僅在 Mizuki 主題時有效。
dice：骰子獎勵，僅在 Mizuki 主題時有效。
ideas：2 構想獎勵，僅在 Sarkaz 主題時有效。
ticket：票券獎勵，僅在 JieGarden 主題時有效。

use_foldartalOptionalboolean

是否使用密文板。僅適用於 Sami 主題。模式 5 預設為 false，其餘模式為 true。

check_collapsal_paradigmsOptionalboolean

是否偵測獲得的坍縮範式。模式 5 預設為 true，其餘模式為 false。

double_check_collapsal_paradigmsOptionalboolean

true

是否執行坍縮範式偵測的防漏措施。僅在 Sami 主題且 check_collapsal_paradigms 為 true 時才適用。模式 5 下預設值 true，其他模式下預設值 false。

expected_collapsal_paradigmsOptionalarray<string>

['目空一些', '睁眼瞎', '图像损坏', '一抹黑']

希望觸發的坍縮範式。僅在主題為 Sami 且模式為 5 時有效。

monthly_squad_auto_iterateOptionalboolean

是否啟用月度小隊自動切換。

monthly_squad_check_commsOptionalboolean

是否將月度小隊通訊狀態作為切換依據。

deep_exploration_auto_iterateOptionalboolean

是否啟用深入調查自動切換。

collectible_mode_shoppingOptionalboolean

false

「燒水」時是否啟用購物。

collectible_mode_squadOptionalstring

燒水時使用的分隊。預設與 squad 同步；若 squad 為空且未指定 collectible_mode_squad 時，則預設為「指揮分隊」。

start_with_seedOptionalboolean

false

是否使用種子刷錢。
僅在 Sarkaz 主題中的 Investment 模式，且為「點刺成錠分隊」或「後勤分隊」時才可能為 true。
使用固定種子。

Example

{
   "enable": true,
   "theme": "Sami",
   "mode": 5,
   "squad": "指挥分队",
   "roles": "取长补短",
   "core_char": "塑心",
   "use_support": false,
   "use_nonfriend_support": false,
   "starts_count": 3,
   "difficulty": 8,
   "stop_at_final_boss": false,
   "stop_at_max_level": false,
   "investment_enabled": true,
   "investments_count": 2,
   "stop_when_investment_full": false,
   "investment_with_more_score": false,
   "start_with_elite_two": false,
   "only_start_with_elite_two": false,
   "refresh_trader_with_dice": false,
   "first_floor_foldartal": "",
   "start_foldartal_list": [],
   "collectible_mode_start_list": {
      "hot_water": true,
      "shield": false,
      "ingot": false,
      "hope": true,
      "random": false,
      "key": false,
      "dice": false,
      "ideas": false
   },
   "use_foldartal": true,
   "check_collapsal_paradigms": true,
   "double_check_collapsal_paradigms": true,
   "expected_collapsal_paradigms": ["目空一些", "睁眼瞎"],
   "monthly_squad_auto_iterate": false,
   "monthly_squad_check_comms": false,
   "deep_exploration_auto_iterate": false,
   "collectible_mode_shopping": false,
   "collectible_mode_squad": "",
   "start_with_seed": false
}

刷坍縮範式功能，具體請參閱 肉鴿輔助協定

• Copilot
  自動抄作業

enableOptionalboolean

true

是否啟用本任務。

filenamestring

單一作業 json 檔案路徑。與 copilot_list 二選一（必填），支援相對路徑與絕對路徑。

copilot_listarray<object>

作業列表。與 filename 二選一（必填）。若兩者同時存在，將忽略 copilot_list。此參數起作用時，僅可執行 set_params 一次。
每個物件包含：

• filename：作業 json 檔案路徑（相對或絕對路徑均可）。
  
• stage_name：關卡名稱，具體請參閱 PRTS.Map
  
• is_raid：是否切換為突襲模式，選填，預設為 false。

loop_timesOptionalnumber

1

循環次數。僅在指定 filename 的單一作業模式下有效；此參數起作用時，僅可執行 set_params 一次。

use_sanity_potionOptionalboolean

false

是否允許在理智不足時自動使用理智藥。

formationOptionalboolean

false

是否執行自動編隊。

formation_indexOptionalnumber

0

自動編隊所使用的編隊欄位編號。僅在 formation 為 true 時才有效。
範圍為 0–4 的整數，其中 0 表示選擇目前編隊，1-4 分別代表第一、二、三、四編隊。

user_additionalOptionalarray<object>

[]

自定義追加幹員清單。僅在 formation 為 true 時有效。
每個物件包含：

• name：幹員名稱，選填，預設為空字串，若留空則忽略此幹員。
  
• skill：指定攜帶技能，選填，預設為 1。範圍為 1–3 的整數，若超出範圍則遵照遊戲內的預設技能。

add_trustOptionalboolean

false

是否在自動編隊時，以信賴值升序自動填充剩餘空位。僅在 formation 為 true 時有效。

ignore_requirementsOptionalboolean

false

是否在自動編隊時忽略幹員屬性要求。僅在 formation 為 true 時有效。

support_unit_usageOptionalnumber

0

助戰幹員使用模式。範圍為 0–3 的整數，僅在 formation 為 true 時有效。
0：不使用助戰幹員。
1：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則不使用助戰幹員。
2：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則使用指定助戰幹員。
3：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則使用隨機助戰幹員。

support_unit_nameOptionalstring

指定助戰幹員名稱。僅在 support_unit_usage 為 2 時有效。

作業 json 請參閱 戰鬥流程協定

Example

{
   "enable": true,
   "filename": "copilot/1-7.json",
   "loop_times": 2,
   "use_sanity_potion": false,
   "formation": true,
   "formation_index": 1,
   "user_additional": [
      {
         "name": "能天使",
         "skill": 3
      }
   ],
   "add_trust": true,
   "ignore_requirements": false,
   "support_unit_usage": 2,
   "support_unit_name": "艾雅法拉"
}

• SSSCopilot
  自動抄保全派駐作業

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

單一作業 json 檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。

loop_timesOptionalnumber

循環執行次數。

保全派駐作業 json 請參考 保全派駐協定

Example

{
   "enable": true,
   "filename": "sss/plan.json",
   "loop_times": 1
}

• ParadoxCopilot 自動抄悖論模擬作業

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

單一作業 json 檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。與 list 二選一（必填）。

listRequiredarray<string>

作業 json 列表。支援絕對或相對路徑。不支援在執行中更改設定。與 filename 二選一（必填）。

Example

{
   "enable": true,
   "filename": "paradox/exusiai.json",
   "list": []
}

• Depot
  倉庫辨識

enableOptionalboolean

true

是否啟用本任務。

Example

{
   "enable": true
}

• OperBox
  幹員 box 辨識

enableOptionalboolean

true

是否啟用本任務。

Example

{
   "enable": true
}

• Reclamation
  生息演算

enableOptionalboolean

true

是否啟用本任務。

themeOptionalstring

Tales

主題。
Fire - 沙中之火（已關閉）
Tales - 沙洲遺聞
RelaunchAnchor - 重啟錨點

modeOptionalnumber

0

模式。不同主題支援的模式不同：
Tales（沙洲遺聞）：
0 - 無存檔，透過進出關卡刷生息點數。
1 - 有存檔，透過組裝支援道具刷生息點數。
RelaunchAnchor（重啟錨點）：
16 (RA1) - RA-1，自動執行精耕細作、建設、交付資源、結算循環。
32 (RA15) - RA-15，用聖聆初雪完成 60 殺任務。
48 (RA4) - RA-4，使用籌劃經營策略給予的赤金解鎖區域，使用維什戴爾完成擊殺 boss 任務。

tools_to_craftOptionalarray<string>

["荧光棒"]

自動製造的物品清單。建議填寫名稱關鍵字即可。僅 Tales 主題有效。

increment_modeOptionalnumber

0

點擊類型。僅 Tales 主題有效。
0：連點
1：長按

num_craft_batchesOptionalnumber

16

單次製造輪數上限。僅 Tales 主題有效。

Example

{
   "enable": true,
   "theme": "Fire",
   "mode": 1,
   "tools_to_craft": ["荧光棒", "发电机"],
   "increment_mode": 0,
   "num_craft_batches": 12
}

• Custom
  自定義任務

enableOptionalboolean

true

是否啟用本任務。

task_namesRequiredarray<string>

執行清單中第一個符合的任務名稱（及其後續的 next 任務等）。若想執行多個任務，可多次 append Custom task。

Example

{
   "enable": true,
   "task_names": ["StartUp", "Infrast", "Fight"]
}

• SingleStep
  單步任務（目前僅支援戰鬥）

enableOptionalboolean

true

是否啟用本任務。

typeRequiredstring

copilot

任務類型。目前僅支援 "copilot"。

subtaskRequiredstring

子任務類型。
stage：設定關卡名稱，格式為 "details": { "stage": "xxxx" }。
start：開始作戰，無需設定 details。
action：單步作戰操作，details 須為作戰協議中的單一動作（action），例如："details": { "name": "史尔特尔", "location": [ 4, 5 ], "direction": "左" }，詳情請參閱 戰鬥流程協定。

detailsOptionalobject

子任務的詳細參數。

Example

{
   "enable": true,
   "type": "copilot",
   "subtask": "stage",
   "details": {
      "stage": "1-7"
   }
}

• VideoRecognition
  影片辨識（目前僅支援作業 / 作戰影片）

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

影片檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。

Example

{
   "enable": true,
   "filename": "videos/copilot.mp4"
}

AsstSetTaskParams

介面原型

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

介面說明

設定任務參數。

回傳值

• bool
  回傳是否設定成功。

參數說明

handleRequiredAsstHandle

實例控制代碼（Handle）。

taskRequiredAsstTaskId

任務 ID，為 AsstAppendTask 介面的回傳值。

paramsRequiredconst char\*

任務參數，json 字串，格式與 AsstAppendTask 介面相同。
未標註「不支援在執行中更改設定」的欄位皆支援即時修改；若該欄位不支援且目前任務正在執行，將忽略該欄位的變更。

AsstSetStaticOption

介面原型

bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);

介面說明

設定行程級（Process-level）全域參數。

回傳值

• bool
  回傳是否設定成功。

參數說明

keyRequiredAsstStaticOptionKey

鍵（Key）。

valueRequiredconst char\*

值（Value）。

鍵值一覽

暫無

AsstSetInstanceOption

介面原型

bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);

介面說明

設定實例級（Instance-level）參數。

回傳值

• bool
  回傳是否設定成功。

參數說明

handleRequiredAsstHandle

實例控制代碼（Handle）。

keyRequiredAsstInstanceOptionKey

鍵（Key）。

valueRequiredconst char\*

值（Value）。

鍵值一覽

InvalidOptionalnumber

0

無效佔位。列舉值：0。

MinitouchEnabledOptionalboolean

已棄用。原為是否啟用 Minitouch；"1" 開，"0" 關。請注意設備可能不支援。列舉值：1（已棄用）。

TouchModeOptionalstring

minitouch

觸控模式設定。可選值：minitouch | maatouch | adb | MaaFwAdb。預設為 minitouch。列舉值：2。

DeploymentWithPauseOptionalboolean

是否暫停下幹員，同時影響抄作業、肉鴿、保全派駐。可用值："1" 或 "0"。列舉值：3。

AdbLiteEnabledOptionalboolean

是否使用 AdbLite。可用值："0" 或 "1"。列舉值：4。

KillAdbOnExitOptionalboolean

退出時是否結束 ADB。可用值："0" 或 "1"。列舉值：5。

ClientTypeOptionalstring

客戶端類型（遊戲渠道）。大多數連線設定不需要設定。僅當傳給 AsstConnect / AsstAsyncConnect 的 config 在連線階段命令中使用 [PackageName] 時，才需要在連線前呼叫 AsstSetInstanceOption(..., ClientType, ...)。目前內建設定中僅 Androws 與 WSA 的 displayId 查詢依賴該值。此選項不取代 StartUp / CloseDown 等任務參數中的 client_type。列舉值：6。

編輯此頁