MaaAssistantArknights/docs/ko-kr/manual/device/android.md

order, icon

order	icon
4	mingcute:android-fill

Android 디바이스 지원

::: info 주의사항

1. Android 10부터 Minitouch는 SELinux가 Enforcing 모드인 경우 더 이상 사용할 수 없습니다. 다른 터치 모드로 전환하거나 SELinux를 일시적으로 Permissive 모드로 전환하세요.
2. Android 생태계가 매우 복잡하기 때문에 MAA 설정 - 연결 설정에서 연결 구성을 일반 모드 또는 호환 모드 또는 두 번째 해상도 또는 일반 모드(이상 출력 차단)로 변경하여 작동하는 모드를 찾을 수 있습니다.
3. MAA는 오직 16:9 비율의 해상도만 지원하므로, 16:9 또는 9:16 화면 비율이 아닌 장치는 해상도를 강제로 변경해야 합니다. 이는 대부분의 현대적인 장치에 해당됩니다. 연결된 장치의 화면 비율이 원래 16:9 또는 9:16인 경우에는 해상도 변경 부분을 건너뛸 수 있습니다.
4. 잘못된 조작을 피하기 위해 기기 내비게이션 방식을 기본 네비게이션 키 등으로 변경하세요.
5. 게임 내 설정의 UI 위치 조절을 0으로 조정하여 작업 오류를 피하세요. :::

::: tip 기본적인 16:9 비율 해상도에는 3840*2160 (4K)、2560*1440 (2K)、1920*1080 (1080P)、1280*720 (720P)등이 있습니다. :::

adb 디버깅 도구 다운로드 및 장치 연결

1. adb를 다운로드하고 압축을 해제합니다.

2. 압축 해제한 폴더를 열고 주소 표시줄을 지우고 cmd를 입력한 후 Enter 키를 누릅니다.

3. 나타나는 명령 프롬프트 창에 adb를 입력하고 많은 영어 도움말 텍스트가 표시되면 실행이 성공한 것입니다.

4. 핸드폰에서 USB 디버깅을 활성화합니다. 각 브랜드의 핸드폰은 다른 방식으로 진입할 수 있으며 검색 엔진을 적극 활용하세요. 제조사는 MIUI에서처럼 추가적인 USB 디버깅 옵션을 제공할 수 있습니다. 이 경우 USB 설치 및 USB 디버깅(보안 설정)과 같은 옵션을 동시에 활성화하세요.

5. 핸드폰을 컴퓨터에 데이터 케이블로 연결한 후 방금 열었던 명령 프롬프트 창에 다음 명령을 입력합니다.

   adb devices
   

• 성공적으로 실행되면 연결된 USB 디버깅 장치 정보가 표시됩니다.

  • 예시:

    List of devices attached
    VFNDU1682100xxxx        device
    

  • device 앞의 영숫자 조합은 장치 시리얼 번호이자 MAA의 연결 주소입니다.

• 현재, 안드로이드 장치에서 USB 디버깅을 하려면 디버깅을 허용하는 팝업을 터치해야 합니다. 허가되지 않은 경우 다음과 같이 표시됩니다:

  List of devices attached
  VFNDU1682100xxxx        unauthorized
  

• 디바이스가 계속 허가되지 않거나 장치 시리얼 번호 뒤에 offline이 표시되면 장치와 컴퓨터를 재부팅한 후 다시 시도해야 합니다. 여전히 문제가 해결되지 않으면 사용자의 현재 사용자 폴더 아래의 .android 폴더를 삭제하고 다시 시작한 후 다시 시도하세요. 구체적인 위치는 스스로 검색하세요.

해상도 변경

::: tip 스마트폰 화면 해상도는 가로*세로로 표시되며, 이는 컴퓨터 모니터의 가로*세로와는 다릅니다. 목표 장치에 따라 구체적인 값은 직접 확인하세요. :::

• 위의 장치 목록에 하나의 장치만 표시된 경우 아래 명령을 실행하여 해상도를 변경하거나 복원할 수 있습니다.

   :: 현재 해상도 확인
   adb shell wm size
   :: 기본 해상도로 복원
   adb shell wm size reset
  
   :: 해상도를 720p로 변경
   adb shell wm size 720x1280
   :: 해상도를 1080p로 변경
   adb shell wm size 1080x1920
  

• 여러 장치가 있는 경우 adb와 shell 사이에 -s <대상 장치 시리얼 번호> 매개변수를 추가해야 합니다. 아래는 예시입니다.

   :: 현재 해상도 확인
   adb -s VFNDU1682100xxxx shell wm size
   :: 기본 해상도로 복원
   adb -s VFNDU1682100xxxx shell wm size reset
  
   :: 해상도를 720p로 변경
   adb -s VFNDU1682100xxxx shell wm size 720x1280
   :: 해상도를 1080p로 변경
   adb -s VFNDU1682100xxxx shell wm size 1080x1920
  

• 일부 설계가 부적절한 앱은 해상도를 복원해도 내용 레이아웃이 여전히 잘못 표시될 수 있습니다. 일반적으로 해당 앱이나 장치를 다시 시작하면 문제가 해결됩니다.

::: danger 주의 장치 재부팅 전에 해상도를 반드시 복구하는 것이 좋습니다. 그렇지 않으면 장치에 따라 예기치 않은 결과가 발생할 수 있습니다. 레이아웃 위치 오류, 터치 위치 오류, 앱 충돌, 잠금 해제 불가 등의 오류가 발생할 수 있습니다! :::

해상도 자동 변경

1. MAA 폴더 아래에 두 개의 텍스트 파일을 생성하고 다음 내용을 입력합니다.

   :: 해상도를 1080p로 조정
   adb -s <대상 장치 시리얼 번호> shell wm size 1080x1920
   :: 화면 밝기 낮추기 (선택 사항)
   adb -s <대상 장치 시리얼 번호> shell settings put system screen_brightness 1
   

   :: 해상도 복원
   adb -s <대상 장치 시리얼 번호> shell wm size reset
   :: 화면 밝기 높이기 (선택 사항)
   adb -s <대상 장치 시리얼 번호> shell settings put system screen_brightness 20
   :: 홈 화면으로 이동 (선택 사항)
   adb -s <대상 장치 시리얼 번호> shell input keyevent 3
   :: 잠금 화면 (선택 사항)
   adb -s <대상 장치 시리얼 번호> shell input keyevent 26
   

2. 첫 번째 파일을 startup.bat으로 이름을 바꾸고, 두 번째 파일을 finish.bat으로 이름을 바꿉니다.

   • 이름을 바꾼 후 파일 아이콘이 변경되지 않고 확장명을 변경하는 이중 확인 대화 상자가 표시되지 않는 경우 "Windows에서 파일 확장명 표시하는 방법"을 검색하세요.

3. MAA의 설정 - 연결 설정 - 시작 전 스크립트 및 종료 후 스크립트에 각각 startup.bat과 finish.bat을 입력합니다.

MAA에 연결하기

유선 연결

::: tip 유선 연결을 사용하면 IP 주소나 포트가 필요하지 않습니다. 단지 adb devices 명령으로 얻은 장치 시리얼 번호만 필요합니다. :::

1. 방금 얻은 대상 장치의 시리얼 번호를 MAA 설정 - 연결 설정 - 연결 주소에 입력합니다.
2. Link Start!

무선 연결

• 장치가 컴퓨터와 동일한 LAN 환경에 있고 서로 통신할 수 있는지 확인하세요. AP 격리, 게스트 네트워크 등의 설정은 장치 간 통신을 차단할 수 있습니다. 관련 라우터 문서를 참조하세요.
• 장치를 다시 시작하면 무선 디버깅이 비활성화되므로 다시 설정해야 합니다.

adb tcpip를 사용하여 무선 포트를 엽니다

1. 방금 열린 명령 프롬프트 창에 다음 명령을 입력하여 무선 디버깅을 활성화합니다.

   adb tcpip 5555
   :: 여러 장치가 있는 경우 -s 매개변수를 추가하여 시리얼 번호를 지정합니다.
   

2. 장치 IP 주소를 확인합니다.

   • 장치의 설정 - WLAN으로 이동하여 현재 연결된 무선 네트워크를 클릭하여 IP 주소를 확인합니다.
   • 각 브랜드의 장치는 설정 위치가 다를 수 있으므로 검색하여 찾으세요.

3. MAA 설정 - 연결 설정 - 연결 주소에 <IP>:5555와 같이 현재 장치의 IP 주소를 입력합니다. (예: 192.168.1.2:5555)

4. Link Start!

adb pair를 사용하여 무선 포트를 엽니다

::: tip adb pair는 안드로이드 11 이상에서 개발자 옵션의 무선 디버깅을 사용하여 페어링한 후 연결하는 것으로, 유선 연결을 안할 수 있습니다. :::

1. 휴대폰의 개발자 옵션으로 이동하여 무선 디버깅을 클릭하여 활성화하고 확인을 클릭한 후 페어링 코드로 디바이스 페어링을 클릭하고 페어링이 완료될 때까지 나타나는 팝업을 닫지 마세요.

2. 페어링을 시작합니다.

   1. 명령 프롬프트에서 adb pair <장치에 표시된 IP 주소와 포트>를 입력하고 엔터를 누릅니다.。
   2. <장치에 표시된 6자리 페어링 코드>를 입력하고 엔터를 누릅니다.
   3. 창에 Successfully paired to <IP:포트>와 같은 내용이 나타나면서 장치에서 팝업이 자동으로 닫히고 페어링된 장치 아래에 컴퓨터 이름이 표시됩니다.

3. 현재 장치 화면에 나타나는 <IP 주소 및 포트>를 MAA 설정 - 연결 설정 - 연결 주소에 입력합니다. (예: 192.168.1.2:11451), 이전에 입력한 것과 반드시 다르게 입력하세요.

4. Link Start!

루트 권한을 사용하여 무선 포트를 엽니다

root를 했으면 이 문서를 더이상 보지 않아도 됩니다

1. WADB를 다운로드하고 루트 권한을 부여하여 설치합니다.
2. WADB를 열고 무선 adb를 시작합니다.
3. WADB에서 제공하는 IP 주소 및 포트를 MAA 설정 - 연결 설정 - 연결 주소에 입력합니다. (예: 192.168.1.2:5555)
4. Link Start!