> 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
