--- title: 4. 월드 테스트하기 slug: world-sdk-guide-kr/4 docTags: createdAt: 2025-04-14T08:32:01.769Z --- 제페토 월드 제작을 완료하셨다면, 실제로 월드를 제출하기 전에 모바일 환경에서 정상적으로 작동하는지 미리 테스트할 수 있습니다. 아래 방법을 참고하여 진행해 주세요. ## 방법 1. 제페토 스튜디오에서 QR 테스트하기 :::::WorkflowBlock ::::WorkflowBlockItem **유니티 에디터 상단에 있는 Publish 버튼을 클릭하여 프로젝트를 빌드합니다.** ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/5VIS3-J1_J0OWC63jEpiX_image.png) :::hint{type="info"} 📘 **Note** Publish 버튼을 누르기 전, Edit > Project Settings > ZEPETO Service에서 프로젝트가 제페토 스튜디오의 월드와 올바르게 연결되어 있는지 꼭 확인해 주세요. 아직 제페토 스튜디오에 월드를 만들지 않으셨다면, [월드 콘솔 만들기](docId:7hdt0OPMEtyQaJjXsa0EI) 가이드를 참고하여 먼저 생성해 주세요. ::: :::: :::WorkflowBlockItem **제페토 스튜디오에 .zepetopackage 파일을 업로드 합니다.** Publish 버튼을 클릭하면 월드 빌드가 시작됩니다. 빌드가 완료되면 자동으로 **Upload Package** 팝업 창이 나타납니다. ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/n8AZIpYHVMtD3zf2ykR39_image.png) 제페토 스튜디오에 .zepetopackage 파일을 업로드하는 방법은 두 가지가 있습니다. 1. 팝업창에서 **upload** 버튼을 눌러 .zepetopackage 파일을 자동으로 업로드합니다. 2. 팝업창에서 **cancel** 버튼을 누르고, 프로젝트 폴더의 **Build > ZEPETO.Script** 경로에 생성된 .zepetopackage 파일을 찾아 직접 제페토 스튜디오에 업로드합니다. (자세한 내용은 [월드 파일 등록하기](docId\:e1_2VK5q9kvpGySTlR4AZ) 가이드를 참고해주세요.) ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/Vgt41xNutl_spw0AXRCVK_image.png) ::: ::::WorkflowBlockItem **QR 코드를 스캔하여 테스트합니다.** .zepetopackage 파일이 성공적으로 업로드되면 **QR 코드로 테스트** 버튼이 표시됩니다. 버튼을 눌러 생성된 QR 코드를 스마트폰의 카메라로 스캔하면 모바일 환경에서 직접 월드를 테스트할 수 있습니다. :::hint{type="success"} ✏️ **Tip** 모바일 테스트를 통해 월드의 메모리 사용량 등 다양한 성능 지표도 확인할 수 있습니다. 자세한 내용은 [Runtime Profiler](docId\:gEUCx0pstJPXdWGHrfYfn) 가이드를 참고해 주세요. ::: ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/Uwbs_5nDu8O7WZz4DgTyw_image.png) ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/MIQCqdu1AX3z7f_eAjguc_image.png) :::hint{type="info"} 📘 **Note** QR 코드 테스트는 미리 등록된 테스터만 가능합니다. 나뿐만 아니라 다른 유저도 QR 코드로 테스트할 수 있도록 설정하고 싶다면 [월드 테스트하기](docId\:icgv9nF7EcybQqVliASF8) 가이드를 확인해 주세요. ::: :::: ::::: ## 방법 2. 유니티 에디터에서 QR 테스트하기 ::::WorkflowBlock :::WorkflowBlockItem **Play On ZEPETO 버튼을 클릭하세요.** 기본 예제를 ZEPETO 앱(모바일)에서 테스트하려면, \[▶︎(play)] 버튼 우측의 ZEPETO 버튼을 클릭합니다. ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/oV6eJwTcCPkVE2TUTTN0O_image.png) 기본 예제 빌드 후, 파일 준비가 완료되면 QR 팝업 창이 표시됩니다. ![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/VHE5HUfZ_amfyoQvbljXk_image.png) ::: :::WorkflowBlockItem **QR 코드를 스캔하세요.** ZEPETO 앱이 설치된 스마트폰에서 카메라 앱을 열고 해당 QR코드를 스캔하면, 테스트 링크가 활성화됩니다. 해당 링크를 클릭하면 기본 예제가 ZEPETO 앱에서 플레이되는 것을 확인할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-3WdGh-X2E3S3KIM-H7reW-20240904-102428.png "QR scan / ZEPETO 월드 로딩 / 기본 예제 동작") ::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Un-MaVIgRvEScuz5HLhbl-20240904-102428.png" size="68" width="423" height="526" position="center" showCaption="false"} ::: :::WorkflowBlockItem **iOS에서 QR 테스트를 진행하려면 아래와 같은 설정이 필요합니다.** **설정 > 앱 > ZEPETO > 로컬 네트워크** 항목을 허용으로 설정해 주세요. ::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/W7tj8ejR1HcedmRfbk0Ob_group-48.png" size="70" width="812" height="691" position="center" showCaption="false"} 안드로이드는 별도의 설정을 하지 않아도 됩니다. ::: :::: :::hint{type="success"} **👍 네트워크 환경 변경 방법** QR 팝업창 우측 하단 부분에 어떤 네트워크 환경에 연결되어 있는지 정보를 확인할 수 있으며, 클릭하면 네트워크 환경을 변경할 수 있습니다. ::: :::hint{type="danger"} - QR코드를 통한 테스트는 스마트폰과 개발 PC가 같은 네트워크 환경에 접속되어야 동작됩니다. - Windows PC에서 연결이 원활하지 않을 경우 방화벽 설정을 변경하여 확인합니다. - Window PC에서 네트워크가 개인이 아닌 공용 네트워크로 설정되어 있을 경우 보안 문제로 월드 접속이 불가합니다. - 네트워크 및 인터넷 설정 > 속성 에서 '개인 '이 선택되어 있는지 확인해주세요. ::: ***