> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md).
# 모바일에서 미리보기
Creator Hub 또는 CLI에서 실제 모바일 기기로 씬을 미리 보세요.
Creator Hub 또는 명령줄에서 Decentraland 모바일 앱으로 씬을 직접 미리 볼 수 있습니다. 실제 기기에서 UI, 입력 처리, 성능이 잘 동작하는지 확인할 수 있는 유일하고 신뢰할 수 있는 방법입니다.
## 사전 요구 사항
* 휴대폰에 설치된 Decentraland 모바일 앱 — [다운로드 링크를](/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md#get-the-mobile-app).
* 휴대폰과 개발 머신은 **동일한 로컬 네트워크** (Wi‑Fi)에 있어야 합니다. 미리보기는 컴퓨터에서 제공되며, QR 코드는 LAN URL로 연결됩니다.
## 옵션 A — Creator Hub에서
1. Creator Hub에서 씬을 엽니다.
2. 다음 옆의 드롭다운을 클릭하고 **미리보기** 버튼을 선택하고 **모바일용 QR 코드 표시**.
3. 휴대폰 카메라로 표시된 QR 코드를 스캔하세요. 링크가 Decentraland 모바일 앱을 열고 씬 미리보기를 불러옵니다.
Creator Hub 미리보기 드롭다운의 "모바일용 QR 코드 표시" 옵션.
## 옵션 B — 명령줄에서
씬 프로젝트의 루트에서 다음을 실행하세요:
```bash
npm run start -- --mobile
```
CLI가 터미널에 씬의 LAN URL을 가리키는 QR 코드를 출력합니다. 휴대폰으로 스캔하여 Decentraland 모바일 앱에서 씬을 불러오세요.
다음이 출력한 QR 코드 npm run start -- --mobile. 휴대폰으로 스캔하여 Decentraland 모바일 앱에서 씬을 여세요.
{% hint style="info" %}
**💡 팁**: 다음을 전달하면 `--mobile`, 데스크톱 익스플로러도 함께 실행되지 않습니다. 두 곳에서 동시에 테스트하려면 `npm run start` 한 터미널에서는 데스크톱용으로 실행하고 `npm run start -- --mobile` 다른 터미널에서는 모바일용으로 실행하세요.
{% endhint %}
## 핫 리로드
데스크톱 미리보기와 마찬가지로, 모바일 미리보기도 씬 파일을 변경하면 자동으로 다시 로드됩니다. 편집할 때마다 QR 코드를 다시 스캔할 필요는 없습니다.
## 문제 해결
* **QR 코드가 앱을 열지 않음** — Decentraland 앱이 설치되어 있고, 해당 기기에서 최소 한 번은 열어 보았는지 확인하세요.
* **휴대폰이 미리보기 서버에 연결할 수 없음** — 휴대폰과 개발 머신이 동일한 Wi‑Fi 네트워크에 있는지 확인하세요. 일부 기업 네트워크는 클라이언트를 격리하므로, 그런 경우 개인 핫스팟이나 다른 네트워크를 사용하세요.
* **씬은 휴대폰에서 로드되지만 데스크톱과 다르게 보임** — 이는 예상된 동작입니다. 이를 통해 다음을 검증하세요 [안전 영역](/creator/content-creator-ko/build-for-mobile/develop/safe-area.md), [UI 크기](/creator/content-creator-ko/build-for-mobile/develop/ui-best-practices.md#sizing), 그리고 [입력 바인딩](/creator/content-creator-ko/build-for-mobile/develop/input-on-mobile.md).
## 관련
* [씬 미리보기](/creator/content-creator-ko/sdk7/getting-started/preview-scene.md)
* [CLI 사용하기](/creator/content-creator-ko/sdk7/getting-started/using-the-cli.md)
* [모바일 Discover 추천 받기](/creator/content-creator-ko/build-for-mobile/publish/get-featured.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.decentraland.org/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
