---
title: QR 테스트가 원활하지 않아요
slug: world-sdk-guide-kr/qr
docTags: 
createdAt: 2024-09-02T08:34:13.136Z
---

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

:::hint{type="info"}
**📘 **다음 가이드를 참조하십시오. [월드 QR 테스트하기](docId\:uxiZi140YuGG-gLJFBtJn) 
:::



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

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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-67Xxl8mpSeDyLfKWLHcjr-20240904-102411.png)

```text
- ZEPETO 월드에 접근하는 중 오류 발생. 다시 시도해 주세요
- 월드 메타데이터를 가져오는 데 실패했습니다.
```

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
SocketException: 호스트 {PC 이름}을(를) 확인할 수 없습니다.
```

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

1. 터미널을 실행하십시오.
2. 아래 명령을 복사하여 붙여넣으십시오.

- 변경하십시오 `{PC 이름}` 오류 메시지의 PC 이름으로 (예: `My-Computer.local`).
- 비밀번호가 필요한 경우, macOS 계정의 비밀번호를 입력하십시오.

```shell
sudo -- sh -c "echo '127.0.0.1 {PC 이름}' >> /private/etc/hosts" && sudo dscacheutil -flushcache
```



## 모바일 실행 중 APPLICATION\_ERROR 발생

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-2N8ahdOxwyBNvM5LE08kX-20240904-102411.png" size="74" width="1033" height="547" position="center" showCaption="false"}

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

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

:::hint{type="info"}
- 다음 가이드를 참조하십시오. [서버 코드 디버깅](docId\:iiNAIJDtYAQLPVUn16rug) 
:::



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

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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-t9XX-hodRsLq993PQWf7k-20240904-102411.png)



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

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

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

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



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

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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-tlXbzcP66mNZrKGdhN_SC-20240904-102411.png)



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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-A-HQYCao8Xpdj5iDPkhlF-20240904-102411.png)



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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-GpqdkJJB4YhXFemrIHlOX-20240904-102411.png)

```text
 127.0.0.1	yourHostname.local
```



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

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-cHwnjFI10CqzJIxiNu80w-20240904-102411.png)



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

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

:::CodeblockTabs
text

```javascript
sudo dscacheutil -flushcache
```
:::

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-OiTyjooUw28jYP0KIXF0r-20240904-102411.png)



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