HELP
개발 FAQ

QR 테스트가 원활하지 않아요

15min

유니티에서 개발된 월드는 QR 코드를 통해 ZEPETO 앱(모바일)에서 테스트할 수 있습니다.

📘 다음 가이드를 참조하십시오. 월드 QR 테스트하기



QR 테스트가 불안정한 경우, 다음 유형에 따라 문제를 해결해 보십시오.

QR 코드가 인식되었지만 오류 메시지가 나타납니다.

Document image

Text


QR 코드 인식 후 위 메시지와 함께 월드가 실행되지 않는 경우 네트워크 설정을 확인하십시오.

PC에서

  1. VPN 서비스에 연결되어 있지 않아야 합니다.
  2. 모든 방화벽 설정을 비활성화하십시오.
  3. (Windows PC에서 Wi-Fi를 사용할 때) 네트워크 및 인터넷 > 이더넷으로 이동하여 '개인 네트워크'를 선택하십시오.
  4. (Windows PC에서 Wi-Fi를 사용할 때) 네트워크 및 인터넷 > 고급 네트워크 설정으로 이동하여 Wi-Fi를 제외한 모든 어댑터를 비활성화하십시오.

모바일에서

  1. PC와 동일한 네트워크에 연결하십시오.
  2. (iOS 기기) ZEPETO 앱의 로컬 네트워크 접근 권한을 부여하십시오.



월드의 수정 사항은 ZEPETO 앱에 반영되지 않습니다.

ZEPETO 앱에서 월드를 실행했지만 개발 수정 사항이 반영되지 않은 경우, 다음 사항을 확인하십시오.

  1. 작업한 장면이 파일 > 빌드 설정 > 빌드에 포함된 장면 목록에 있어야 하며 체크되어 있어야 합니다.
  2. 당신의 ZEPETO 앱은 최신 버전이어야 합니다.



생성된 QR 코드 이미지가 손상되었습니다.

편집 > 프로젝트 설정 > 품질 > 렌더링 > 텍스처 품질로 이동하여 설정을 "전체 해상도"로 변경하십시오.



빌드를 실행하는 동안 "호스트를 확인할 수 없습니다" 오류가 발생합니다.

Text


macOS PC에서 QR 테스트를 위한 빌드를 실행하는 동안 위의 오류 메시지가 나타나면 다음 방법을 시도해 보십시오.

  1. 터미널을 실행하십시오.
  2. 아래 명령을 복사하여 붙여넣으십시오.
  • 변경하십시오 {PC 이름} 오류 메시지의 PC 이름으로 (예: My-Computer.local).
  • 비밀번호가 필요한 경우, macOS 계정의 비밀번호를 입력하십시오.
Shell




모바일 실행 중 APPLICATION_ERROR 발생

Document image


모바일 장치에서 애플리케이션을 실행하는 동안 APPLICATION_ERROR가 발생하면, 이 문제는 일반적으로 서버 코드의 논리 오류로 인해 발생합니다. 예를 들어, 처리되지 않은 예외가 있습니다.

이 문제를 해결하려면, 서버 스크립트를 디버깅하고 코드에 필요한 수정을 하는 것이 좋습니다.



MacOS - 호스트를 확인할 수 없습니다 오류

QR 빌드를 시도하는 동안 "호스트를 확인할 수 없습니다" 오류가 발생하여 빈 QR 코드 창이 나타나는 MacOS 사용자라면 아래 단계를 따르세요:

Document image




1) MacOS에서 터미널을 엽니다.

  • Command+Space를 눌러 Spotlight 검색을 열고, Terminal을 입력한 후 Enter를 누릅니다.

2) 터미널 창이 나타나면 "user@" 뒤에 있는 텍스트를 확인하세요. 이것이 호스트 이름입니다.

  • 예를 들어, "user@ABC"라고 표시되면, "ABC"가 호스트 이름입니다.



3) 터미널에 다음 명령어를 입력합니다:

  • sudo nano /private/etc/hosts를 입력하고 Enter를 누릅니다.
  • 비밀번호를 입력하라는 메시지가 표시되면, MacOS 로그인 비밀번호를 입력합니다.
Document image




4) 호스트 데이터베이스 편집 화면에서 아래 화살표 키를 눌러 가장 아래로 이동합니다.

Document image




  • 127.0.0.1을 입력한 후 탭을 누르고, 그런 다음 호스트 이름.local을 입력하세요.
Document image

Text




5) 변경 사항을 저장하려면 Control (^) + O를 누르고, 그런 다음 Enter를 누르세요.

Document image




6) Control (^) + X를 눌러 편집 모드를 종료하세요.

7) 터미널에서 다음 명령어를 입력하여 DNS를 재설정하세요:

text

Document image




8) 유니티로 돌아가서 QR 빌드를 다시 실행해 보세요. QR 코드가 이제 올바르게 표시되어야 합니다.