ZEPETO 월드 개발 시작하기

월드 QR 테스트하기

3min

제페토 월드 제작을 완료하셨다면, 실제로 월드를 제출하기 전에 모바일 환경에서 정상적으로 작동하는지 미리 테스트할 수 있습니다. 아래 방법을 참고하여 진행해 주세요.

방법 1. 제페토 스튜디오에서 QR 테스트하기

1

유니티 에디터 상단에 있는 Publish 버튼을 클릭하여 프로젝트를 빌드합니다.

Document image


📘 Note

Publish 버튼을 누르기 전, Edit > Project Settings > ZEPETO Service에서 프로젝트가 제페토 스튜디오의 월드와 올바르게 연결되어 있는지 꼭 확인해 주세요.

아직 제페토 스튜디오에 월드를 만들지 않으셨다면, 월드 콘솔 만들기 가이드를 참고하여 먼저 생성해 주세요.

2

제페토 스튜디오에 .zepetopackage 파일을 업로드 합니다.

Publish 버튼을 클릭하면 월드 빌드가 시작됩니다. 빌드가 완료되면 자동으로 Upload Package 팝업 창이 나타납니다.

Document image


제페토 스튜디오에 .zepetopackage 파일을 업로드하는 방법은 두 가지가 있습니다.

  1. 팝업창에서 upload 버튼을 눌러 .zepetopackage 파일을 자동으로 업로드합니다.
  2. 팝업창에서 cancel 버튼을 누르고, 프로젝트 폴더의 Build > ZEPETO.Script 경로에 생성된 .zepetopackage 파일을 찾아 직접 제페토 스튜디오에 업로드합니다. (자세한 내용은 월드 파일 등록하기 가이드를 참고해주세요.)
Document image

3

QR 코드를 스캔하여 테스트합니다.

.zepetopackage 파일이 성공적으로 업로드되면 QR 코드로 테스트 버튼이 표시됩니다.

버튼을 눌러 생성된 QR 코드를 스마트폰의 카메라로 스캔하면 모바일 환경에서 직접 월드를 테스트할 수 있습니다.

✏️ Tip

모바일 테스트를 통해 월드의 메모리 사용량 등 다양한 성능 지표도 확인할 수 있습니다. 자세한 내용은 Runtime Profiler 가이드를 참고해 주세요.

Document image

Document image


📘 Note

QR 코드 테스트는 미리 등록된 테스터만 가능합니다.

나뿐만 아니라 다른 유저도 QR 코드로 테스트할 수 있도록 설정하고 싶다면 월드 테스트하기 가이드를 확인해 주세요.



방법 2. 유니티 에디터에서 QR 테스트하기

1

Play On ZEPETO 버튼을 클릭하세요.

기본 예제를 ZEPETO 앱(모바일)에서 테스트하려면, [▶︎(play)] 버튼 우측의 ZEPETO 버튼을 클릭합니다.

Document image


기본 예제 빌드 후, 파일 준비가 완료되면 QR 팝업 창이 표시됩니다.

Document image

2

QR 코드를 스캔하세요.

ZEPETO 앱이 설치된 스마트폰에서 카메라 앱을 열고 해당 QR코드를 스캔하면, 테스트 링크가 활성화됩니다. 해당 링크를 클릭하면 기본 예제가 ZEPETO 앱에서 플레이되는 것을 확인할 수 있습니다.

QR scan / ZEPETO 월드 로딩 / 기본 예제 동작
QR scan / ZEPETO 월드 로딩 / 기본 예제 동작

Document image

3

iOS에서 QR 테스트를 진행하려면 아래와 같은 설정이 필요합니다.

설정 > 앱 > ZEPETO > 로컬 네트워크 항목을 허용으로 설정해 주세요.

Document image


안드로이드는 별도의 설정을 하지 않아도 됩니다.

👍 네트워크 환경 변경 방법 QR 팝업창 우측 하단 부분에 어떤 네트워크 환경에 연결되어 있는지 정보를 확인할 수 있으며, 클릭하면 네트워크 환경을 변경할 수 있습니다.

  • QR코드를 통한 테스트는 스마트폰과 개발 PC가 같은 네트워크 환경에 접속되어야 동작됩니다.
  • Windows PC에서 연결이 원활하지 않을 경우 방화벽 설정을 변경하여 확인합니다.
  • Window PC에서 네트워크가 개인이 아닌 공용 네트워크로 설정되어 있을 경우 보안 문제로 월드 접속이 불가합니다.
  • 네트워크 및 인터넷 설정 > 속성 에서 '개인 '이 선택되어 있는지 확인해주세요.