MaaAssistantArknights/docs/ko-kr/1.2-FAQ.md

# 자주 묻는 질문

## 프로그램이 실행하자마자 곧바로 튕겨요

### 추정 원인 0: 불완전한 파일 다운로드

- 이 소프트웨어를 처음 사용하신다면, `OTA`가 파일 이름에 포함된 파일을 받지 말아주세요. 추가 업데이트를 위한 파일으로, 단독으로 사용하는 것이 아닙니다.
- 이 프로그램이 자동 업데이트 이후 제대로 작동하지 않는다면, 자동 업데이트의 버그일 수 있으며, 전체 파일을 수동으로 다운받아 다시 시도해볼 수 있습니다.

### 추정 원인 1: 실행 라이브러리 없음

- [Microsoft Visual C++ 재배포 가능 패키지](https://learn.microsoft.com/ko-kr/cpp/windows/latest-supported-vc-redist?view=msvc-160#visual-studio-2015-2017-2019-and-2022)와 [.NET8](https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-desktop-8.0.1-windows-x64-installer)을 설치 후 시스템을 재시작하고 나서 시도해 보세요.

### 추정 원인 2: 다른 실행 라이브러리 문제

윈도우 서버나 다른 경량화 버전을 사용 중이시라면, [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) 설치로 완전한 개발 환경을 갖출 수 있습니다. (.NET과 C++ 환경만 있으면 됩니다)

**이 작업은 약 10GB의 저장공간을 필요로 할 수 있습니다. 빈 공간이 충분한지 먼저 확인하세요.**

## 연결 오류가 발생해요

팁: [지원되는 에뮬레이터 목록](./1.3-에뮬레이터_지원.md)을 확인해 에뮬레이터를 맞게 사용하고 있는지 확인하세요. BlueStacks를 사용 중이시라면 설정에서 `Android Debug Bridge`를 활성화해 주세요.

게임 가속기 등의 소프트웨어를 사용 중이시라면, 해당 소프트웨어를 닫고 시스템을 재시작한 후 다시 시도해 주세요.

### 해결 방법 1: ADB 경로와 주소가 정확한지 확인하세요

- MAA `설정` - `연결 설정` - `adb 경로`가 자동으로 채워져 있는지 확인하세요. 채워져 있다면 다음 단계로 넘어가세요. 그렇지 않다면:

  - 선택지 1: 에뮬레이터의 설치 경로에 들어가 `adb.exe`라는 이름의 파일을 찾으세요. (또는 `nox_adb.exe`, `HD-adb.exe`, `adb_server.exe` 같이 `adb`가 들어간 비슷한 exe 파일을 찾으세요) MAA 설정에서 해당 파일을 선택하세요.
  - 선택지 2: [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)를 다운로드받아 압축을 푸세요. `adb.exe` 파일을 선택하세요.
- 연결 주소가 정확히 입력되어 있는지 확인하세요. ADB 주소는 일반적으로 `127.0.0.1:5555`같은 형태입니다. (LD Player 제외)

#### 주요 Android 에뮬레이터의 ADB 포트

- 단일 인스턴스 / 다중 인스턴스의 첫 인스턴스

  각 에뮬레이터의 문서와 NetEase Games의 수석 게임 개발 엔지니어 @자오칭칭의 [블로그](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)를 참고한 일반적인 Android 에뮬레이터들의 ADB 포트는 다음과 같습니다.

    |에뮬레이터|포트 기본값|
    |-|:-:|
    |MuMu 6/X|7555|
    |MuMu 12|16384|
    |NoxPlayer|62001|
    |Memu|21503|
    |BlueStacks|5555|
    |LDPlayer 9|5555 / emulator-5554|

    숫자로만 이루어진 기본 포트의 경우 `127.0.0.1:[port]`로 직접 연결할 수 있습니다. LDPlayer는 별도로 경로가 구성되어 있어 `emulator-5554`로도 연결이 가능합니다.

    Windows나 Mac에서 `설정` - `연결 설정` - `연결 주소`를 변경해야 하는 경우 위 표를 참조할 수 있습니다.

- 다중 인스턴스

  - NoxPlayer의 첫 번째 기기 포트는 `62001`이며, 다음 포트는 `62025`부터 순서대로입니다.
  - NetEase MuMu 12의 다중 인스턴스 ADB 포트는 불규칙적입니다. MuMu Multi-instance Manager 12에서 에뮬레이터를 실행한 다음, 우측 상단의 ADB 아이콘을 클릭하면 실행 중인 에뮬레이터의 ADB 포트를 확인할 수 있습니다.
  - LDPlayer의 경우 LDPlayer 9부터는 로컬 ADB 포트가 `5555`에서 시작해 2씩 증가합니다. 예를 들자면, 2번째 에뮬레이터의 로컬 포트는 `5557`입니다.

### 해결 방법 2: 에뮬레이터 변경

[BlueStacks](https://www.bluestacks.com/download.html) Nougat 64 bit같은 다른 에뮬레이터로 시도하세요.

_BlueStacks 설치 후 설정에서 `Android Debug Bridge`를 활성화해야 합니다._

### 해결 방법 3: 컴퓨터 재시작

컴퓨터를 재시작해 보세요.

## 연결은 성공했는데, 그대로 멈춰 버렸어요

일부 에뮬레이터의 버전은 너무 오래되어 minitouch를 지원하지 않을 수 있습니다. MAA를 관리자 권한으로 실행해 `설정`-`연결 설정`에서 `ADB 강제 교체`를 실행하세요. (진행 전 에뮬레이터를 닫고 MAA를 재시작하는 것을 권장합니다. 그렇지 않으면 제대로 교체되지 않을 수 있습니다)

그래도 작동하지 않는다면, `터치 호환 모드`를 활성화해 주세요.

## 연결에 성공했고, 몇 번 동작하기는 했는데, 그 뒤에는 멈추거나 오류가 떠요

- 자동 전투는 `작전개시` 버튼이 나오는 화면에서 진행되는 것을 필요로 합니다. 문제가 없는지 확인해 주세요.
- CN 클라이언트가 아니라면 `설정`-`시작 설정`에서 클라이언트 버전을 선택해 주세요. 또한 CN 클라이언트 외의 경우에는 모든 기능이 지원되지는 않습니다. [문서](./readme.md#해외-서버-지원)를 참조해 주세요.
- 통합전략 기능을 사용 중이시라면, 원하는 테마가 게임 내에서 선택되어 있도록 하고, `작업 설정`-`통합전략`에서 테마를 설정해 주세요.

## 수동 연결

- [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)를 다운로드해 압축을 풀어주세요.
- `설정`-`연결 설정`에서 ADB 경로를 선택하고, ADB의 주소를 채우고, (IP+포트 형식으로, 예시: `127.0.0.1:5555`) 에뮬레이터의 종류를 선택해 주세요.

## 다운로드 속도가 느리고 미러 사이트는 접속이 불가능해요

1. [다운로드](./readme.md#다운로드)에서 원하는 버전을 선택합니다.
2. 다운로드해야 하는 파일에 대한 링크를 찾습니다.
3. 오른쪽 클릭 후 `링크 복사`를 선택하세요.
4. 브라우저에 링크를 붙여 넣으세요.
5. `github.com`을 `download.fastgit.org`로 교체하세요.
6. `Enter` 키를 눌러 다운로드하세요.

## 스크린샷에 시간이 오래 걸린다/너무 길다는 메시지 표시

- MAA는 현재 `RawByNc`, `RawWithGzip` 및 `Encode`의 3가지 스크린샷 방법을 지원합니다. 작업 실행의 평균 스크린샷 시간이 >400 / >800인 경우 프롬프트 메시지가 출력됩니다. (단일 작업은 한 번만 출력됩니다.)
- '설정 - 연결 설정'은 지난 30개의 스크린샷에 소요된 최소/평균/최대 시간을 표시하며 10개의 스크린샷마다 새로 고쳐집니다.
- 자동 전투 기능(자동 고기 비둘기 등)은 스크린샷 촬영 시간에 따라 크게 영향을 받습니다.
- 이 시간 소모는 MAA와 무관하며, 컴퓨터 성능이나 현재 사용량 또는 에뮬레이터와 관련이 있습니다. 백그라운드 프로세스를 정리하거나, 에뮬레이터를 변경하거나, 컴퓨터 구성의 업그레이드를 시도해 볼 수 있습니다.