Skip to content

Latest commit

 

History

History
152 lines (98 loc) · 7.95 KB

1.3-에뮬레이터_지원.md

File metadata and controls

152 lines (98 loc) · 7.95 KB

에뮬레이터 지원

✅ Bluestacks-CN

완벽히 지원됩니다. Settings-Engine Settings에서 Allow ADB connection을 켜야 합니다.

✅ Bluestacks (권장👍)

완벽히 지원됩니다. Settings-Advanced에서 Android Debug Bridge를 켜야 합니다.

✅ Bluestacks Hyper-V 버전

지원됩니다.

  • Settings-Advanced에서 Android Debug Bridge를 켜 주세요.

  • Bluestack Hyper-V 포트는 수시로 변경됩니다. 간단한 해법을 알려드립니다.

    1. 에뮬레이터의 데이터 경로에서 bluestacks.conf 파일을 찾으세요. (기본값: C:\ProgramData\BlueStacks_nxt\bluestacks.conf)

    2. MAA를 최초로 사용하신다면, 실행하실 때 gui.json 파일이 생성됩니다.

    3. MAA를 종료하고 나서, gui.json 파일을 열고, Bluestacks.Config.Path 필드를 추가하세요. 값은 bluestacks.conf의 절대 경로로 설정합니다. (백슬래시는 \\와 같이 이스케이프되어야 합니다). 예시: (파일이 C:\ProgramData\BlueStacks_nxt\bluestacks.conf에 위치해 있음을 가정함)

      "Bluestacks.Config.Path":"C:\\ProgramData\\BlueStacks_nxt\\bluestacks.conf",

    4. LinkStart!

  • 여러 에뮬레이터를 구동해야 하는 경우 (해당되지 않으면 이 단계는 넘어가주세요), MAA의 키워드를 변경해서 구성 파일을 감지할 수 있습니다. Bluestacks.Config.Keyword 필드를 추가로 입력해주세요 예시:

    "Bluestacks.Config.Keyword":"bst.instance.Nougat64.status.adb_port",

✅ Nox

완벽히 지원됩니다.

✅ Nox Android 9

완벽히 지원됩니다.

⚠️ MuMu

지원됩니다. 단,

  • MAA가 ADB 경로와 주소를 얻기 위해 관리자 권한으로 실행되어야 합니다. (MuMu가 관리자 권한으로 실행되기 때문입니다)
  • 관리자 권한으로 실행하고 싶지 않다면 ADB 경로와 주소를 직접 입력할 수도 있습니다.
  • MAA가 메인 화면에서 멈추고 작업에 실패했다는 메시지를 띄울 수 있습니다. MuMu의 렌더링 방식과 연관되어 있는 것으로 보입니다. 다른 에뮬레이터 사용을 권장드립니다.
  • MuMu는 여러 개를 열어도 하나의 adb 포트를 사용하므로, 여러 개의 클라이언트를 지원하지는 못합니다.

🚫 MuMu Mobile Game Assistant

지원되지 않습니다. ADB 포트가 닫혀 있습니다.

🚫 MuMu Android 9

지원되지 않습니다. ADB 스크린샷이 검은 화면으로 나옵니다.

🚫 MuMu Android X

지원되지 않습니다. ADB 스크린샷이 투명한 화면으로 나옵니다.

🚫 LD Player

지원되기는 하지만 작동 가능성은 낮습니다.
LD Player는 연결 실패를 유발하는 포트 변경이나 게임 충돌, 검은 스크린샷, 화면 뒤바뀜 등의 여러 문제점들을 갖고 있습니다.
저희는 MAA가 LD Player를 지원할 수 있게 하기 위해 많은 시간을 들였습니다만 새롭고 어려운 문제들이 지속적으로 발생했습니다. 결국 저희는 LD Player에 대한 지원을 중단하기로 했습니다.
만약에 어떻게든 사용이 가능하시다면 축하드립니다만, 그렇지 않을 경우 에뮬레이터를 바꾸시거나 문제를 직접 해결하셔야 합니다. 저희는 LD Player에 관한 문제에 대한 피드백은 받지 않습니다 (다만, Pull Request를 통한 도움은 여전히 환영입니다)

⚠️ Memu

지원되지만, 테스트 수가 적으며 알려지지 않은 오류가 있을 수 있습니다.

🚫 Tencent Mobile Game Assistant

지원되지 않습니다. ADB 포트가 닫혀 있습니다.

⚠️ Windows Subsystem for Android

부분적으로 지원됩니다.

  • 수동 연결을 사용해야 합니다.
  • WSA 2204 이상 버전의 경우 '일반 모드'를 시도해 보세요.
  • WSA 2203 이하 버전의 경우 'WSA 레거시 버전'을 시도해 보세요.
  • WSA는 해상도 변경을 지원하지 않으므로, 수동으로 720p 이상의 16:9 비율의 해상도가 되도록 창의 크기를 조절해주세요. (16:9 모니터를 사용하고 있다면 F11을 눌러 전체화면으로 전환하는 것으로도 가능합니다)
  • 에뮬레이터의 창이 활성화된 상태(가장 위에 있는 상태)를 유지하고 다른 안드로이드 앱이 실행되고 있지 않게 해 주세요. 그렇지 않을 경우 게임이 일시정지되거나 인식에 실패할 수 있습니다.
  • 가끔은 WSA의 스크린샷이 비어 있어 인식 실패를 유발합니다. WSA 사용은 권장되지 않습니다.

✅ Android Virtual Device

지원됩니다.

⚙️ 수동 연결

  1. adb를 다운로드해 압축을 풀어주세요.
  2. 설정-연결 설정에서 ADB 경로와 주소를 설정해 주세요. (IP와 포트는 필수입니다. 예시: 127.0.0.1:5555)

⚙️ 디스플레이가 16:9 비율이 아닌 기기에서의 사용

MAA가 16:9 비율만 지원하므로 해상도를 수동으로 변경해야 할 수 있습니다.

  1. USB 디버깅 모드를 켜고 USB 케이블로 기기를 컴퓨터에 연결하거나 원격으로 접속하세요.

  2. 명령 프롬프트(CMD)를 열고, 기기 주소를 확인 후 연결하세요.

    • USB 케이블을 사용하는 경우, 다음의 명령어로 기기 ID를 확인하세요:
    adb devices                          # 현재 기기들의 연결 상태를 확인합니다. 제1열이 기기 ID입니다.

    연결이 성공적으로 되었다면, 다음과 같은 메시지를 볼 수 있습니다:

    C:\Users\username>adb devices
List of devices attached
VFNDU1682100xxxx        device       # "device" 앞의 문자열이 기기 ID입니다
    • 원격으로 접속하려는 경우: Settings -> WLAN -> View에서 IP 주소를 확인할 수 있으며, 포트는 주로 5555 또는 5037입니다.
    adb connect <IP 주소 + 포트>        # 예시: 192.168.0.10:5555
    • 'adb'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.라는 문구가 출력되는 경우는 환경 변수가 제대로 구성되지 않았기 때문입니다. 이 경우 ADB의 전체 경로를 입력해야 합니다.
    D:\adb_unzip_path\adb.exe devices          # 또는 간단하게 adb.exe를 명령 프롬프트 창에 드래그하고 스페이스 바를 누른 후 devices를 입력할 수도 있습니다.

    ADB를 자주 사용할 필요가 있다면 환경 변수를 구성하는 것이 좋습니다. 구성 방법에 대해서는 인터넷의 문서들을 찾아보세요.

  3. 다음의 명령어를 입력해 진행합니다

    adb -s <Device ID or IP + Port> shell  # 기기의 터미널 창에 진입합니다
wm size                               # 기기의 해상도를 확인합니다
wm size 720x1280                      # 해상도를 720p로 변경합니다

  4. MAA에 ADB 경로와 기기의 주소(ID 또는 IP + 포트)를 채워넣으세요

  5. 게임 설정에서 UI 위치 조절을 0(꺼짐)으로 조정해주세요. 그렇지 않으면 나중에 ADB로 해상도를 바꿀 때 터치 입력의 위치가 어긋날 수 있습니다.

  6. MAA를 사용하세요 (≧∇≦)ﾉ

  7. MAA를 나가기 전, 기기의 해상도를 초기화하세요.

    wm size reset                         # 해상도를 초기화합니다