mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 01:40:46 +08:00
docs: 改掉zh-tw的<br>
This commit is contained in:
@@ -98,11 +98,11 @@ icon: ph:question-fill
|
||||
|
||||
## 連接正常,但是無操作
|
||||
|
||||
部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。<br>
|
||||
部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。
|
||||
|
||||
請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗)<br>
|
||||
請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗)
|
||||
|
||||
模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。<br>
|
||||
模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。
|
||||
|
||||
如果這樣也無法正常使用,可將 `連接設定` - `觸控模式` 從 `Minitouch` 切換到 `MaaTouch` 再次嘗試。由於 `Adb Input` 操作過於緩慢,請僅將其作為萬不得已的模式。
|
||||
|
||||
@@ -142,14 +142,14 @@ Pie64_2 核心:(核心名稱後的數字代表這是一個多開核心)
|
||||
MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當該功能失效或出錯時,你需要手動指定配置檔案路徑
|
||||
:::
|
||||
|
||||
1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案<br>
|
||||
1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案
|
||||
|
||||
- 國際版預設路徑為 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf`
|
||||
- 中國內地版預設路徑為 `C:\ProgramData\BlueStacks_nxt_cn\bluestacks.conf`
|
||||
|
||||
2. 如果是第一次使用,請開啟一次 MAA,會在 MAA 的 `config` 目錄下產生 `gui.json`。
|
||||
|
||||
3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`)<br>
|
||||
3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`)
|
||||
|
||||
::: details 範例
|
||||
以 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf` 為例
|
||||
@@ -174,7 +174,7 @@ MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當
|
||||
|
||||
## 檔案下載速度慢
|
||||
|
||||
請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。<br>
|
||||
請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。
|
||||
|
||||
我們的小水管頻寬較低,且流量有限。雖然搭出來就是給大家用的,但也希望不要濫用,若 github 或其他鏡像站可正常下載,建議優先選擇。
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ icon: iconoir:developer
|
||||
|
||||
4. 下載預構建的第三方庫
|
||||
|
||||
**需要有 Python 環境,請自行搜尋 Python 安裝教學**<br>
|
||||
**需要有 Python 環境,請自行搜尋 Python 安裝教學**
|
||||
_(maadeps-download.py 檔案在項目根目錄)_
|
||||
|
||||
```cmd
|
||||
@@ -39,7 +39,7 @@ icon: iconoir:developer
|
||||
- 右鍵 `MaaWpfGui` - 屬性 - 偵錯 - 啟用本地偵錯(這樣就能把斷點掛到 C++ Core 那邊了)
|
||||
|
||||
8. 到這裡,你就可以愉快地~~瞎ㄐㄅ改~~發電了
|
||||
9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message<br>
|
||||
9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message
|
||||
假如你不熟悉 git 的使用,你可能想要新建一個分支進行更改,而不是直接提交在 `dev` 上
|
||||
|
||||
```bash
|
||||
|
||||
@@ -13,8 +13,8 @@ Pull Request 被增加 `ambiguous` 標籤是因為沒有按照 commitizen 規則
|
||||
|
||||
### 自動觸發
|
||||
|
||||
- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。<br>
|
||||
Issue Bot 會根據關鍵字自動增加分類標籤。<br>
|
||||
- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。
|
||||
Issue Bot 會根據關鍵字自動增加分類標籤。
|
||||
具體關鍵字可以參考 [配置檔案](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml)。
|
||||
- 給作者是可見性設定為 public 的 MAA 成員的 issue 和 Pull Request 增加 `MAA Team` 標籤。
|
||||
|
||||
@@ -31,7 +31,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
|
||||
### 手動觸發
|
||||
|
||||
多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。<br>
|
||||
多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。
|
||||
但 **當你知道自己的行為會導致 Issue Bot 誤解時除外**。
|
||||
|
||||
#### Issue 及 Pull Request
|
||||
@@ -45,7 +45,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
|
||||
- `Skip {LABEL_NAME}` 可以保證不增加標籤。
|
||||
- `Skip labels` 可以保證不增加任何標籤。
|
||||
- 以下幾種方法可以為 issue 增加 `fixed` 標籤:<sup>1</sup><br>
|
||||
- 以下幾種方法可以為 issue 增加 `fixed` 標籤:<sup>1</sup>
|
||||
- `https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH} fixed`
|
||||
- `fixed by https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH}`
|
||||
- `{VERSION} fixed`
|
||||
@@ -54,7 +54,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
- **當你知道自己的 issue 評論會導致 Issue Bot 誤解時,盡量添加一些 skip 操作。**
|
||||
|
||||
::: info 注意
|
||||
這裡的 COMMIT_HASH 需要完整的 40 位
|
||||
<sup>1</sup> 這裡的 COMMIT_HASH 需要完整的 40 位
|
||||
:::
|
||||
|
||||
#### 推送(Push)
|
||||
|
||||
@@ -6,7 +6,7 @@ icon: mingcute:git-pull-request-fill
|
||||
牛牛也能看懂的 GitHub Pull Request 使用指南 (\*´▽`)ノノ
|
||||
|
||||
::: warning
|
||||
本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。<br>
|
||||
本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。
|
||||
若您有一定的 git 使用經驗及程式基礎,~~那你還看個~~🔨,可以看稍微進階一點的教學 [Github Pull Request 流程簡述](2.2-開發相關.md)
|
||||
:::
|
||||
|
||||
@@ -24,18 +24,18 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Fork(複製)
|
||||
|
||||
複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了<br>
|
||||
複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了
|
||||
但一般說中文 “複製” 我們可能首先想到的是 copy 的意思,fork 也沒有其他明確的翻譯,所以我們一般習慣直接說英文,比如 “把代碼 fork 一份走”
|
||||
|
||||
既然是複製後的,那就是 `MAA (1)`(bushi)<br>
|
||||
為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”;<br>
|
||||
既然是複製後的,那就是 `MAA (1)`(bushi)
|
||||
為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”;
|
||||
因為每個人都可以自己複製一份走,所以複製後的稱之為 “個人倉庫”
|
||||
|
||||

|
||||
|
||||
### Pull Request(拉取請求、合併請求)
|
||||
|
||||
簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR”<br>
|
||||
簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR”
|
||||
書接上文,你 fork(複製)的個人倉庫,修改完了,怎麽把內容提供給主倉庫呢?這時候我們就可以開一個 PR,申請將自己修改的內容加入到主倉庫中。
|
||||
|
||||
當然啦,既然是 “請求”,那自然是需要審批的,MAA Team 的各位可能會針對你的修改提一些意見等,當然我們的意見也不一定完全正確,大家合理討論 ~
|
||||
@@ -46,9 +46,9 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Conflict(衝突)
|
||||
|
||||
假設一下,主倉庫中有個 A 檔案,它的內容是 111<br>
|
||||
你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333<br>
|
||||
這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突)<br>
|
||||
假設一下,主倉庫中有個 A 檔案,它的內容是 111
|
||||
你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333
|
||||
這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突)
|
||||
衝突解決起來比較麻煩,這裡僅闡述概念,方便實際遇到時能理解發生了什麽,暫不闡述解決方案
|
||||
|
||||
## 純網頁端 PR 操作全流程
|
||||
@@ -83,27 +83,27 @@ icon: mingcute:git-pull-request-fill
|
||||

|
||||
|
||||
9. 還有第二個檔案要改的?改完了發現弄錯了想再改改?都沒關係!重複 5-8 即可!
|
||||
10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁<br>
|
||||
10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁
|
||||
如果有 Compare & Pull Request 按鈕,那最好,直接點他!如果沒有也不用著急,點下面的 New Pull Request 也是一樣的(請看步驟 11)
|
||||
|
||||

|
||||
|
||||
11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。<br>
|
||||
如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。<br>
|
||||
11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。
|
||||
如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。
|
||||
然後寫一下標題,你修改的具體內容等等的,然後點確認
|
||||
|
||||

|
||||
|
||||
12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見<br>
|
||||
12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見
|
||||
👇 比如(純屬娛樂切勿當真)
|
||||

|
||||
|
||||
13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可!<br>
|
||||
注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中<br>
|
||||
13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可!
|
||||
注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中
|
||||
👇 比如可以看到最下面多了一條 “重新修改演示” 的內容
|
||||

|
||||
|
||||
14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻!<br>
|
||||
14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻!
|
||||
~~怎麽全是二次元啊,哦我也是啊,那沒事了~~
|
||||
::: tip 貢獻 / 參與者
|
||||
感謝所有參與到開發 / 測試中的朋友們,是大家的幫助讓 MAA 越來越好! (*´▽`)ノノ
|
||||
@@ -111,11 +111,11 @@ icon: mingcute:git-pull-request-fill
|
||||
[](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
|
||||
:::
|
||||
|
||||
16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作<br>
|
||||
16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作
|
||||
::: warning
|
||||
這個操作會強制將你的個人倉庫同步到和主倉庫一模一樣的狀態,這是最簡單粗暴但行之有效的解決衝突的方法。但如果你的個人倉庫已經有額外的編輯了,會被直接刪掉!
|
||||
:::
|
||||
如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕<br>
|
||||
如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕
|
||||
|
||||
如果你不清楚 / 不 care 我上面說的這一大堆,也請點擊左側的按鈕
|
||||
|
||||
|
||||
@@ -19,23 +19,23 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `AsstTaskId`<br>
|
||||
若添加成功,返回該任務 ID,可用於後續設定任務參數;<br>
|
||||
- `AsstTaskId`
|
||||
若添加成功,返回該任務 ID,可用於後續設定任務參數;
|
||||
若添加失敗,返回 0
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `const char* type`<br>
|
||||
- `const char* type`
|
||||
任務類型
|
||||
- `const char* params`<br>
|
||||
- `const char* params`
|
||||
任務參數,json string
|
||||
|
||||
##### 任務類型一覽
|
||||
|
||||
- `StartUp`<br>
|
||||
開始喚醒<br>
|
||||
- `StartUp`
|
||||
開始喚醒
|
||||
|
||||
```json
|
||||
// 對應的任務參數
|
||||
@@ -51,8 +51,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `CloseDown`<br>
|
||||
關閉遊戲<br>
|
||||
- `CloseDown`
|
||||
關閉遊戲
|
||||
|
||||
```json
|
||||
// 對應的任務參數
|
||||
@@ -61,7 +61,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
|
||||
```json
|
||||
@@ -96,7 +96,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
另支援少部分資源關卡名請參考[集成範例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/tools/AutoLocalization/example/zh-cn.xaml#L260)
|
||||
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
公開招募
|
||||
|
||||
```json
|
||||
@@ -136,7 +136,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建換班
|
||||
|
||||
```json
|
||||
@@ -166,8 +166,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Mall`<br>
|
||||
領取信用及商店購物。<br>
|
||||
- `Mall`
|
||||
領取信用及商店購物。
|
||||
會先有序的按 `buy_first` 購買一遍,再從左到右並避開 `blacklist` 購買第二遍,在信用溢出時則會無視黑名單,從左到右購買第三遍直到不再溢出
|
||||
|
||||
```json
|
||||
@@ -189,7 +189,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
領取日常獎勵
|
||||
|
||||
```json
|
||||
@@ -199,7 +199,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
無限刷肉鴿
|
||||
|
||||
```json
|
||||
@@ -228,7 +228,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自動抄作業
|
||||
|
||||
```json
|
||||
@@ -241,7 +241,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
作業 JSON 請參考 [3.3-戰鬥流程協議](./3.3-戰鬥流程協議.md)
|
||||
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自動抄保全作業
|
||||
|
||||
```json
|
||||
@@ -254,7 +254,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
保全作業 JSON 請參考 [3.7-保全派駐協議](./3.7-保全派駐協議.md)
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識
|
||||
|
||||
```json
|
||||
@@ -264,7 +264,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員 box 辨識
|
||||
|
||||
```json
|
||||
@@ -274,7 +274,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
|
||||
```json
|
||||
@@ -289,7 +289,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
|
||||
自定義任務
|
||||
|
||||
@@ -304,7 +304,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
|
||||
單步任務(目前僅支援戰鬥)
|
||||
|
||||
@@ -323,7 +323,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
|
||||
影片辨識,目前僅支援作業(作戰)影片
|
||||
|
||||
@@ -348,17 +348,17 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* par
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `AsstTaskId task`<br>
|
||||
- `AsstTaskId task`
|
||||
任務 ID, `AsstAppendTask` 接口的返回值
|
||||
- `const char* params`<br>
|
||||
任務參數,json string,與 `AsstAppendTask` 接口相同。<br>
|
||||
- `const char* params`
|
||||
任務參數,json string,與 `AsstAppendTask` 接口相同。
|
||||
未標注 “不支援執行中設定” 的欄位都支援實時修改;否則若當前任務正在執行,會忽略對應的欄位
|
||||
|
||||
### `AsstSetStaticOption`
|
||||
@@ -375,14 +375,14 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstStaticOptionKey key`<br>
|
||||
- `AsstStaticOptionKey key`
|
||||
鍵
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 鍵值一覽
|
||||
@@ -403,16 +403,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `AsstInstanceOptionKey key`<br>
|
||||
- `AsstInstanceOptionKey key`
|
||||
鍵
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 鍵值一覽
|
||||
|
||||
@@ -15,7 +15,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
## 參數總覽
|
||||
|
||||
- `int msg`<br>
|
||||
- `int msg`
|
||||
消息類型
|
||||
|
||||
```cpp
|
||||
@@ -44,9 +44,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
};
|
||||
```
|
||||
|
||||
- `const char* details`<br>
|
||||
- `const char* details`
|
||||
消息詳情,json 字符串,詳見 [欄位解釋](#欄位解釋)
|
||||
- `void* custom_arg`<br>
|
||||
- `void* custom_arg`
|
||||
調用方自定義參數,會原樣傳出 `AsstCreateEx` 接口中的 `custom_arg` 參數,C 系語言可利用該參數傳出 `this` 指針
|
||||
|
||||
## 欄位解釋
|
||||
@@ -82,25 +82,25 @@ Todo
|
||||
|
||||
### 常見 `What` 欄位
|
||||
|
||||
- `ConnectFailed`<br>
|
||||
- `ConnectFailed`
|
||||
連接失敗
|
||||
- `Connected`<br>
|
||||
- `Connected`
|
||||
已連接,注意此時的 `uuid` 欄位值為空(下一步才是獲取)
|
||||
- `UuidGot`<br>
|
||||
- `UuidGot`
|
||||
已獲取到設備唯一碼
|
||||
- `UnsupportedResolution`<br>
|
||||
- `UnsupportedResolution`
|
||||
解析度不被支援
|
||||
- `ResolutionError`<br>
|
||||
- `ResolutionError`
|
||||
解析度獲取錯誤
|
||||
- `Reconnecting`<br>
|
||||
- `Reconnecting`
|
||||
連接斷開(adb / 模擬器 炸了),正在重連
|
||||
- `Reconnected`<br>
|
||||
- `Reconnected`
|
||||
連接斷開(adb / 模擬器 炸了),重連成功
|
||||
- `Disconnect`<br>
|
||||
- `Disconnect`
|
||||
連接斷開(adb / 模擬器 炸了),並重試失敗
|
||||
- `ScreencapFailed`<br>
|
||||
- `ScreencapFailed`
|
||||
截圖失敗(adb / 模擬器 炸了),並重試失敗
|
||||
- `TouchModeNotAvailable`<br>
|
||||
- `TouchModeNotAvailable`
|
||||
不支援的觸控模式
|
||||
|
||||
### AsyncCallInfo
|
||||
@@ -132,39 +132,39 @@ Todo
|
||||
|
||||
#### 常見 `taskchain` 欄位
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
開始喚醒
|
||||
- `CloseDown`<br>
|
||||
- `CloseDown`
|
||||
關閉遊戲
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
信用點及購物
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
自動公招
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建換班
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
領取日常獎勵
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
無限刷肉鴿
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自動抄作業
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自動抄保全作業
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員 box 辨識
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
自定義任務
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
單步任務
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
影片辨識任務
|
||||
- `Debug`<br>
|
||||
- `Debug`
|
||||
偵錯
|
||||
|
||||
### TaskChain 相關消息
|
||||
@@ -196,7 +196,7 @@ Todo
|
||||
|
||||
#### 常見 `subtask` 欄位
|
||||
|
||||
- `ProcessTask`<br>
|
||||
- `ProcessTask`
|
||||
|
||||
```json
|
||||
// 對應的 details 欄位舉例
|
||||
@@ -213,49 +213,49 @@ Todo
|
||||
|
||||
##### 常見 `task` 欄位
|
||||
|
||||
- `StartButton2`<br>
|
||||
- `StartButton2`
|
||||
開始戰鬥
|
||||
- `MedicineConfirm`<br>
|
||||
- `MedicineConfirm`
|
||||
使用理智藥
|
||||
- `ExpiringMedicineConfirm`<br>
|
||||
- `ExpiringMedicineConfirm`
|
||||
使用 48 小時內過期的理智藥
|
||||
- `StoneConfirm`<br>
|
||||
- `StoneConfirm`
|
||||
碎石
|
||||
- `RecruitRefreshConfirm`<br>
|
||||
- `RecruitRefreshConfirm`
|
||||
公招刷新標籤
|
||||
- `RecruitConfirm`<br>
|
||||
- `RecruitConfirm`
|
||||
公招確認招募
|
||||
- `RecruitNowConfirm`<br>
|
||||
- `RecruitNowConfirm`
|
||||
公招使用加急許可
|
||||
- `ReportToPenguinStats`<br>
|
||||
- `ReportToPenguinStats`
|
||||
匯報到企鵝數據統計
|
||||
- `ReportToYituliu`<br>
|
||||
- `ReportToYituliu`
|
||||
匯報到一圖流大數據
|
||||
- `InfrastDormDoubleConfirmButton`<br>
|
||||
- `InfrastDormDoubleConfirmButton`
|
||||
基建宿舍的二次確認按鈕,僅當幹員衝突時才會有,請提示用戶
|
||||
- `StartExplore`<br>
|
||||
- `StartExplore`
|
||||
肉鴿開始探索
|
||||
- `StageTraderInvestConfirm`<br>
|
||||
- `StageTraderInvestConfirm`
|
||||
肉鴿投資了源石錠
|
||||
- `StageTraderInvestSystemFull`<br>
|
||||
- `StageTraderInvestSystemFull`
|
||||
肉鴿投資達到了遊戲上限
|
||||
- `ExitThenAbandon`<br>
|
||||
- `ExitThenAbandon`
|
||||
肉鴿放棄了本次探索
|
||||
- `MissionCompletedFlag`<br>
|
||||
- `MissionCompletedFlag`
|
||||
肉鴿戰鬥完成
|
||||
- `MissionFailedFlag`<br>
|
||||
- `MissionFailedFlag`
|
||||
肉鴿戰鬥失敗
|
||||
- `StageTraderEnter`<br>
|
||||
- `StageTraderEnter`
|
||||
肉鴿關卡:詭異行商
|
||||
- `StageSafeHouseEnter`<br>
|
||||
- `StageSafeHouseEnter`
|
||||
肉鴿關卡:安全的角落
|
||||
- `StageEncounterEnter`<br>
|
||||
- `StageEncounterEnter`
|
||||
肉鴿關卡:不期而遇 / 古堡饋贈
|
||||
- `StageCombatDpsEnter`<br>
|
||||
- `StageCombatDpsEnter`
|
||||
肉鴿關卡:普通作戰
|
||||
- `StageEmergencyDps`<br>
|
||||
- `StageEmergencyDps`
|
||||
肉鴿關卡:緊急作戰
|
||||
- `StageDreadfulFoe`<br>
|
||||
- `StageDreadfulFoe`
|
||||
肉鴿關卡:險路惡敵
|
||||
- `StartGameTask`
|
||||
打開用戶端失敗(配置檔案與傳入 client_type 不匹配)
|
||||
@@ -275,7 +275,7 @@ Todo
|
||||
|
||||
#### 常見 `what` 及 `details` 欄位
|
||||
|
||||
- `StageDrops`<br>
|
||||
- `StageDrops`
|
||||
關卡材料掉落資訊
|
||||
|
||||
```json
|
||||
@@ -326,7 +326,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsDetected`<br>
|
||||
- `RecruitTagsDetected`
|
||||
公招辨識到了 Tags
|
||||
|
||||
```json
|
||||
@@ -342,7 +342,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSpecialTag`<br>
|
||||
- `RecruitSpecialTag`
|
||||
公招辨識到了特殊 Tag
|
||||
|
||||
```json
|
||||
@@ -352,7 +352,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitResult`<br>
|
||||
- `RecruitResult`
|
||||
公招辨識結果
|
||||
|
||||
```json
|
||||
@@ -429,7 +429,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsRefreshed`<br>
|
||||
- `RecruitTagsRefreshed`
|
||||
公招刷新了 Tags
|
||||
|
||||
```json
|
||||
@@ -440,7 +440,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitNoPermit`<br>
|
||||
- `RecruitNoPermit`
|
||||
公招無招聘許可
|
||||
|
||||
```json
|
||||
@@ -451,7 +451,7 @@ Todo
|
||||
```
|
||||
|
||||
|
||||
- `RecruitTagsSelected`<br>
|
||||
- `RecruitTagsSelected`
|
||||
公招選擇了 Tags
|
||||
|
||||
```json
|
||||
@@ -464,13 +464,13 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSlotCompleted`<br>
|
||||
- `RecruitSlotCompleted`
|
||||
當前公招槽位任務完成
|
||||
|
||||
- `RecruitError`<br>
|
||||
- `RecruitError`
|
||||
公招辨識錯誤
|
||||
|
||||
- `EnterFacility`<br>
|
||||
- `EnterFacility`
|
||||
基建進入了設施
|
||||
|
||||
```json
|
||||
@@ -481,7 +481,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `NotEnoughStaff`<br>
|
||||
- `NotEnoughStaff`
|
||||
基建可用幹員不足
|
||||
|
||||
```json
|
||||
@@ -492,7 +492,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `ProductOfFacility`<br>
|
||||
- `ProductOfFacility`
|
||||
基建產物
|
||||
|
||||
```json
|
||||
@@ -504,7 +504,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfo`<br>
|
||||
- `StageInfo`
|
||||
自動作戰關卡資訊
|
||||
|
||||
```json
|
||||
@@ -514,10 +514,10 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfoError`<br>
|
||||
- `StageInfoError`
|
||||
自動作戰關卡辨識錯誤
|
||||
|
||||
- `PenguinId`<br>
|
||||
- `PenguinId`
|
||||
企鵝物流 ID
|
||||
|
||||
```json
|
||||
@@ -527,7 +527,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識結果
|
||||
|
||||
```json
|
||||
@@ -567,7 +567,7 @@ Todo
|
||||
// 目前只支援 ArkPlanner 和 Lolicon 的格式,以後可能會兼容更多網站
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員辨識結果
|
||||
|
||||
```json
|
||||
@@ -615,5 +615,5 @@ Todo
|
||||
]
|
||||
```
|
||||
|
||||
- `UnsupportedLevel`<br>
|
||||
- `UnsupportedLevel`
|
||||
自動抄作業,不支援的關卡名
|
||||
|
||||
@@ -144,5 +144,6 @@ icon: material-symbols:view-quilt-rounded
|
||||
|
||||
## 範例檔案
|
||||
|
||||
[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)<br>
|
||||
[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)<br>
|
||||
[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
|
||||
|
||||
[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
|
||||
|
||||
@@ -139,5 +139,6 @@ icon: game-icons:prisoner
|
||||
|
||||
## 範例檔案
|
||||
|
||||
[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)<br>
|
||||
[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
|
||||
|
||||
[SSS_多索雷斯在建地塊.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
|
||||
|
||||
@@ -47,7 +47,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
- 倉庫辨識並支援匯出至 [企鵝物流刷圖規劃器](https://penguin-stats.io/planner) , [明日方舟工具箱](https://arkn.lolicon.app/#/material) , [ARK-NIGHTS 幹員培養表](https://ark-nights.com/settings) ;
|
||||
- 支援 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多種接口,方便集成調用,自定義你的 MAA!
|
||||
|
||||
話不多說,看圖!<br>
|
||||
話不多說,看圖!
|
||||
|
||||

|
||||

|
||||
@@ -64,7 +64,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
### 基本說明
|
||||
|
||||
1. 請根據 [模擬器支援情況](./1.3-模擬器支援.md),進行對應的操作。
|
||||
2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。<br>
|
||||
2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。
|
||||
對於國際服(美服)玩家,由於介面佈局問題,我們則建議您將解析度修改為 `1920 * 1080`。
|
||||
3. 開始使用吧!
|
||||
|
||||
@@ -84,7 +84,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 外服支援
|
||||
|
||||
目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。<br>
|
||||
目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。
|
||||
若您遇到了 Bug,或對某個功能有強需求,歡迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [討論區](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我們一起建設 MAA!請參考 [外服適配教學](#外服適配)
|
||||
|
||||
## 主要關聯項目
|
||||
@@ -188,12 +188,12 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 廣告
|
||||
|
||||
用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||||
用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
|
||||
自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com)<br>
|
||||
Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~<br>
|
||||
用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
|
||||
用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)
|
||||
自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com)
|
||||
Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~
|
||||
|
||||
技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
|
||||
開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
|
||||
技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)
|
||||
開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||||
|
||||
如果覺得軟體對你有幫助,幫忙點個 Star 吧!~(網頁最上方右上角的小星星),這就是對我們最大的支持了!
|
||||
|
||||
Reference in New Issue
Block a user