MaaAssistantArknights/docs/en-us/manual/connection.md

order, icon

order	icon
3	mdi:plug

Connection

ADB Path

:::info Technical Details Automatic detection uses the emulator's ADB, but sometimes problems occur with automatic detection, then manual settings are required. Replace ADB is to download the ADB provided by Google and then replace it. If you set up Google's ADB yourself, you can do it once and for all. :::

Use the ADB provided by the emulator

Go to the simulator installation path. In Windows, when the simulator is running, right-click the process in the Task Manager and click Open the location of the file.

There should be an exe file with adb in its name in the top-level or lower directory. You can search and select it.

:::details Examples adb.exe HD-adb.exe adb_server.exe nox_adb.exe :::

Use ADB provided by Google

Click to download and unzip, then select adb.exe.

We are recommended to extract it directly to the MAA folder, so that you can directly fill in .\platform-tools\adb.exe in the ADB path, and move it with MAA.

Connection Address

::: tip The connection address of the emulator running on this computer should be 127.0.0.1:<port> 或 emulator-<four numbers>。 :::

Obtain Port Number

Simulator documents and ports for reference

:::warning TODO: replace these Chinese emulators links with English ones :::

• Bluestacks 5 5555
• MuMu Pro 16384
• MuMu 12 16384
• MuMu 6 7555
• Memu 21503
• Nox 62001

For other simulators, please check Zhao Qingqing's blog.

Multiple Emulators

• MuMu 12: The running emulator ports can be found in the upper right corner of the MultiPlayer.
• Bluestacks 5: The current emulator ports can be viewed in the emulator settings.
• TODO

Alternatives

• Method 1: Use the adb command to view the running port directly

  1. Launch one emulator and make sure no other Android devices are connected to this computer.
  2. Launch a terminal in the folder where the adb executable is.
  3. Execute the following command.

  # Windows CMD
  adb devices
  # Windows PowerShell
  .\adb devices
  

  An example of output:

  List of devices attached
  127.0.0.1:<port>   device
  emulator-<four numbers>  device
  

  Use 127.0.0.1:<port> or emulator-<four numbers> as the connection address.

• Method 2: Find established adb connections

  1. Do method 1.
  2. Press Win+S to open the search bar, type Resource Monitor and open it.
  3. Switch to the Network tab and look for the emulator process name in the name column of Listening Port, such as HD-Player.exe.
  4. Make a note of all listening ports for the emulator process.
  5. Find adb.exe in the name column of TCP connection. The port in the remote port column that is consistent with the simulator listening port is the simulator debugging port.

Automatically Start Multiple Emulators

• If you need to operate multiple emulators simultaneously, you can copy the MAA folder multiple times, and use different MAAs, the same adb.exe, and different connection addresses to connect.

• Taking BlueStacks International Version as an example, two ways to start multiple emulators are introduced.

  • Perform multiple operations by attaching commands to HD-Player.exe.

    1. Start the corresponding emulator separately.
    2. Open the Task Manager, find the corresponding emulator process, go to the Details tab, right-click the column above, click Select Columns, and check Command Line.
    3. In the newly added Command Line column, find the content after "...\Bluestacks_nxt\HD-Player.exe".
    4. Fill in the found content, similar to --instance Nougat32, in Startup Settings - Additional Commands.

    Note: After the operation is completed, it is recommended to hide the Command Line column opened in Step 2 to prevent freezing.

    • Example:

      Multi-instance 1:
      Emulator Path: C:\Program Files\BlueStacks_nxt\HD-Player.exe
      Additional Commands: --instance Nougat32 --cmd launchApp --package "com.hypergryph.arknights"
      Multi-instance 2:
      Emulator Path: C:\Program Files\BlueStacks_nxt\HD-Player.exe
      Additional Commands: --instance Nougat32_1 --cmd launchApp --package "com.hypergryph.arknights.bilibili"
      

      The --cmd launchApp --package part starts and automatically runs the specified package name application after startup, which can be changed as needed.

  • Perform multi-instance operation by using the shortcut of emulators or apps.

    1. Open the multi-instance manager and add the corresponding emulator's shortcut.
    2. Fill in the path of the emulator shortcut in Startup Settings - Emulator Path.

    Note: Some emulators support creating app shortcuts, which can directly launch the emulator and open Arknights with the app shortcut.

    • Example:

      Multi-instance 1:
      Emulator Path: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\BlueStacks\Multi-instance 1.lnk
      Multi-instance 2:
      Emulator Path: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\BlueStacks\Multi-instance 2 - Arknights.lnk
      

    If using Emulator Path for multi-instance operation, it is recommended to leave Additional Commands in Startup Settings empty.

The port number of BlueStack emulator Hyper-V is different every time it is started

:::warning TODO: replace these Chinese emulators links with English ones :::

Connection Present

You need to select the configuration of the simulator you are using. If it is not in the list, select General Mode. If General Mode is not available please try and select any of the other available presents.

For specific differences, you can read the source code.

MuMu Screenshot Enhanced Mode

You need to use the official China MuMu 12 3.8.13 and later versions, and close the background keep alive. Ark Edition and Global Edition are not supported now.

1. Settings → Connection Settings, tick Enable MuMu Screenshot Enhanced Mode.

2. MuMu Emulator Path Fill in the path to the MuMuPlayer-12.0 folder, e.g. C:Program Files\Netease\MuMuPlayer-12.0`.

3. Instance Number Fill in the serial number of the corresponding emulator in MuMu Multiplayer, e.g. 0 for Main Multiplayer.

4. Instance Screen Fill in 0.

About background keep alive

It is recommended to turn it off, at this time the instance screen is always 0.

When it is on, the order of MuMu emulator tabs should be the serial number of the instance screen, e.g. 0 for emulator desktop, 1 for Arknights client.

Adaptation for backend live is very imperfect, there are always all kinds of inexplicable problems, it is very not recommended.

Touch Mode

1. Minitouch：An Android touch eventer written in C uses evdev to provide a Socket interface for external programs to trigger touch events and gestures. Starting with Android 10, Minitouch no longer works when SELinux is Enforcing.^Source
2. MaaTouch：A Java-based reimplementation of Minitouch by MAA, which uses Android's InputDevice, and added additional features. Availability of higher versions of Android is yet to be tested. Help us do some testing
3. Adb Input：Directly call ADB to use Android's input command to perform touch operations. It has the highest compatibility and the slowest speed.

ADB Lite

An ADB Client independently implemented by MAA uses TCP to communicate directly with the ADB Server. Compared with the original ADB, it can avoid opening multiple ADB processes continuously and reduce performance overhead, but some screenshot methods are unavailable.^PR

It is recommended to enable it, but the specific advantages and disadvantages need feedback. Help us do some testing x2