連線設定
約 2390 字大約 8 分鐘
自動偵測
MAA 可以透過目前正在執行中的單一模擬器,自動偵測並填充 ADB 路徑、連線位址與連線配置。
截至 MAA v5.22.3 為止,支援自動偵測的模擬器及其連線位址如下:
- BlueStacks 藍疊模擬器 5:
127.0.0.1:5555/5556/5565/5575/5585/5595/5554 - MuMu 模擬器:
127.0.0.1:16384/16416/16448/16480/16512/16544/16576 - 雷電模擬器 9:
emulator-5554/5556/5558/5560、127.0.0.1:5555/5557/5559/5561 - 夜神模擬器:
127.0.0.1:62001/59865 - 逍遙模擬器:
127.0.0.1:21503
若偵測失敗,請嘗試以系統管理員權限啟動 MAA 並再次偵測。若仍失敗,請參考下文進行手動設定,並參考上述清單向我們回報。
ADB 路徑
技術細節
自動偵測預設會使用模擬器內建的 ADB,當自動偵測出現問題時才需要手動設定。
點選 強制替換 ADB 會自動下載 Google 提供的 ADB 並自動填入路徑。 若系統環境變數中已有可用的 ADB,可直接填寫 adb。
使用模擬器提供的 ADB
前往模擬器的安裝路徑。在 Windows 系統中,您可以在模擬器執行時,於工作管理員對該程序點擊右鍵,選擇 開啟檔案所在位置。
在該層或下層目錄中,應該能找到一個檔名包含 adb 的 exe 檔案(可使用搜尋功能),將其選取即可。
範例檔名
adb.exe HD-adb.exe adb_server.exe nox_adb.exe
使用 Google 提供的 ADB
點此下載 後解壓縮,並選取其中的 adb.exe。
建議直接解壓縮到 MAA 資料夾下,這樣可以直接在 ADB 路徑中填寫 .\platform-tools\adb.exe,方便隨著 MAA 資料夾移動。
連線位址
提示
執行於本機電腦的模擬器,連線位址通常為 127.0.0.1:<連接埠> 或 emulator-<四位數字>。
模擬器連接埠相關文件
- BlueStacks 藍疊模擬器 5:模擬器設定 → 進階中可查看目前的連線位址。
- MuMu 模擬器:主視窗(多開器)右上角選單按鈕 → 設定中心 → 底部
ADB 端口可查看正在執行的多開連接埠。 - MuMu 模擬器 Pro
- 雷電模擬器 9
- 夜神模擬器
- 逍遙模擬器
其他模擬器可參閱 趙青青的博客。
備選方案
方案 1:使用 ADB 指令查看模擬器連接埠
- 啟動一個模擬器,並確保沒有其他 Android 裝置連接到此電腦。
- 在存放 ADB 執行檔的資料夾中啟動終端機(Terminal)。
- 執行以下指令:
# Windows 命令提示字元 (cmd) adb devices # Windows PowerShell .\adb devices輸出範例如下:
List of devices attached 127.0.0.1:<連接埠> device emulator-<四位數字> device使用
127.0.0.1:<連接埠>或emulator-<四位數字>作為連線位址即可。方案 2 :尋找已建立的 ADB 連線
- 執行方案 1。
- 按下
Win+S開啟搜尋列,輸入資源監控制器並開啟。 - 切換到
網路索引標籤,在接聽連接埠的名稱欄位中尋找模擬器程序名稱(例如HD-Player.exe)。 - 記錄模擬器程序所有的接聽連接埠。
- 在
TCP 連線的名稱欄位尋找adb.exe,遠端連接埠與模擬器接聽連接埠一致者,即為偵錯連接埠。
BlueStacks 藍疊模擬器 Hyper-V 每次啟動連接埠都不一樣
在 連線設定 中將 連線配置 設為 藍疊模擬器,隨後勾選 自動偵測連線 和 每次重新偵測。
通常這樣即可連線。若無法連線,可能是因為存在多個核心或設定異常,請參考下文進行進階設定。
指定
Bluestacks.Config.Keyword注意
若啟用了多開功能或安裝了多個模擬器核心,則需要指定使用的模擬器編號。
在
.\config\gui.json中搜尋Bluestacks.Config.Keyword欄位,內容格式為"bst.instance.<模擬器編號>.status.adb_port"。編號可於模擬器路徑的BlueStacks_nxt\Engine中確認。範例
Nougat64 核心:
"Bluestacks.Config.Keyword":"bst.instance.Nougat64.status.adb_port",Pie64_2 核心(核心名稱後的數字代表這是一個多開核心):
"Bluestacks.Config.Keyword": "bst.instance.Pie64_2.status.adb_port",指定
Bluestacks.Config.Path注意
MAA 現在會嘗試從登錄檔(Registry)讀取
bluestacks.conf的位置,若偵測失敗才需要手動指定路徑。在 BlueStacks 藍疊模擬器的數據目錄下找到
bluestacks.conf檔案:- 國際版預設路徑:
C:\ProgramData\BlueStacks_nxt\bluestacks.conf - 中國版預設路徑:
C:\ProgramData\BlueStacks_nxt_cn\bluestacks.conf
備註:
C:\ProgramData為隱藏目錄,請直接在檔案總管地址欄貼上路徑進入。- 國際版預設路徑:
初次使用請先執行一次 MAA 以產生設定檔。
先關閉 MAA,再開啟
gui.json。找到Configurations下目前的設定名稱(可在設定-切換配置中查看,預設為Default),搜尋Bluestacks.Config.Path並填入bluestacks.conf的完整路徑(斜線請使用轉義符\\)。
範例
以
C:\ProgramData\BlueStacks_nxt\bluestacks.conf為例:{ "Configurations": { "Default": { "Bluestacks.Config.Path": "C:\\ProgramData\\BlueStacks_nxt\\bluestacks.conf" // 其餘配置欄位,不要手動輸入修改 } } }返回 MAA 並測試
您可以使用
設定 - 執行設定中的截圖測試功能,檢查連線的是否為預期的核心。
連線配置
請選擇對應模擬器的配置,若清單中沒有則選擇「通用配置」。若通用配置不可用,請嘗試並選擇其他任一可用的配置。
具體區別可以參閱 原始碼。
MuMu 截圖增強模式
需使用官版或方舟專版 MuMu V4.1.26 及更新版本。
在
設定 - 連線設定勾選啟用 MuMu 截圖增強模式,MAA 會嘗試自動獲取路徑。MuMu 安裝路徑填寫MuMu Player或MuMuPlayerGlobal-12.0或YXArkNights-12.0資料夾路徑(例如C:\Program Files\Netease\MuMuPlayerGlobal-12.0)。若正在使用 MuMu 網路橋接,需勾選
MuMu 網路橋接模式並手動填寫多開器內對應的模擬器序號,主多開為0。
雷電截圖增強模式
需使用官版或國際版雷電模擬器 9 V9.1.32 及更新版本。
在
設定 - 連線設定勾選啟用 LD 截圖增強模式,MAA 會嘗試自動獲取路徑。LD 模擬器路徑填寫LDPlayer9資料夾路徑(例如C:\leidian\LDPlayer9\)。執行個體編號填寫雷電多開器內對應的模擬器序號(ID),主多開為0。
觸控模式
- Minitouch:基於 C 語言編寫的 Android 觸控事件驅動程式,透過操作
evdev裝置,提供 Socket 介面供外部程式觸發觸控事件與手勢。自 Android 10 開始,若系統的 SELinux 為Enforcing(強制)模式,Minitouch 將無法運作。來源 - MaaTouch:由 MAA 基於 Java 對 Minitouch 的重新實作,改用 Android 原生的
InputDevice介面,並加入額外特性。目前在高版本 Android 上的相容性仍待測試,幫我們做做測試。 - Adb Input:直接呼叫 ADB 執行 Android 內建的
input指令來進行觸控操作。此方式的相容性最強,但執行速度最慢。
ADB Lite
由 MAA 獨立實現的 ADB 用戶端,使用 TCP 直接與 ADB Server 通信。相較原版 ADB 可避免頻繁開啟 ADB 程序並減少效能開銷,但部分截圖方式不支援。PR
推薦開啟,但具體表現尚待回饋。幫我們做做測試 x2
MAA 與模擬器多開
實作方式
若需多開模擬器同時執行,可將 MAA 資料夾複製多份,透過 不同的 MAA 程式、同一個 adb.exe、不同的連線地址 來進行連線。
自動啟動多開模擬器
以 BlueStacks 藍疊模擬器國際版 為例,介紹兩種自動啟動多開模擬器的方式。
透過附加指令啟動
- 啟動單一模擬器多開。
- 開啟工作管理員,找到對應的模擬器程序,切換到「詳細資料」索引標籤,右鍵點擊標題列,點選
選擇行(或選擇列),勾選命令列。 - 在多出來的
命令列欄位中,找到...\Bluestacks_nxt\HD-Player.exe"之後的內容。 - 將找到的內容(例如:
--instance Nougat32)填寫到 MAA 的啟動設定 - 附加指令中。
注
操作結束後,建議重新隱藏 步驟 2 中開啟的 命令列 欄位以避免系統卡頓。
範例
多開 1:
模擬器路徑: C:\Program Files\BlueStacks_nxt\HD-Player.exe
附加指令: --instance Nougat32 --cmd launchApp --package "com.hypergryph.arknights"
多開 2:
模擬器路徑: C:\Program Files\BlueStacks_nxt\HD-Player.exe
附加指令: --instance Nougat32_1 --cmd launchApp --package "com.hypergryph.arknights.bilibili"其中 --cmd launchApp --package 部分是啟動後自動執行指定包名的應用程式,可根據需求自行更改。
透過模擬器的捷徑啟動
部分模擬器支援建立應用程式捷徑,可直接使用捷徑啟動模擬器並開啟《明日方舟》。
- 開啟多開管理器,新增對應模擬器的捷徑到桌面。
- 將該模擬器捷徑的路徑填入 MAA 的
啟動設定 - 模擬器路徑中。
範例
多開 1:
模擬器路徑: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\BlueStacks\多開1.lnk
多開 2:
模擬器路徑: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\BlueStacks\多開2-明日方舟.lnk若使用 模擬器路徑 (捷徑方式)進行多開操作,建議將 啟動設定 - 附加指令 欄位清空。
