모바일에서 미리보기

Creator Hub 또는 CLI에서 실제 모바일 기기로 씬을 미리보기하세요.

Creator Hub 또는 명령줄에서 Decentraland 모바일 앱으로 씬을 직접 미리 볼 수 있습니다. 실제 기기에서 UI, 입력 처리, 성능이 잘 동작하는지 확인할 수 있는 유일하고 신뢰할 수 있는 방법입니다.

사전 요구 사항

• 휴대폰에 설치된 Decentraland 모바일 앱 — 다운로드 링크를.

• 휴대폰과 개발 머신은 동일한 로컬 네트워크 (Wi‑Fi)에 있어야 합니다. 미리보기는 컴퓨터에서 제공되며, QR 코드는 LAN URL로 연결됩니다.

옵션 A — Creator Hub에서

1. Creator Hub에서 씬을 엽니다.

2. 다음 옆의 드롭다운을 클릭하고 미리보기 버튼을 선택하고 모바일용 QR 코드 표시.

3. 휴대폰 카메라로 표시된 QR 코드를 스캔하세요. 링크가 Decentraland 모바일 앱을 열고 씬 미리보기를 불러옵니다.

Creator Hub 미리보기 드롭다운의 "모바일용 QR 코드 표시" 옵션.

옵션 B — 명령줄에서

씬 프로젝트의 루트에서 다음을 실행하세요:

npm run start -- --mobile

CLI가 터미널에 씬의 LAN URL을 가리키는 QR 코드를 출력합니다. 휴대폰으로 스캔하여 Decentraland 모바일 앱에서 씬을 불러오세요.

다음이 출력한 QR 코드 npm run start -- --mobile. 휴대폰으로 스캔하여 Decentraland 모바일 앱에서 씬을 여세요.

💡 팁: 다음을 전달하면 --mobile, 데스크톱 익스플로러도 함께 실행되지 않습니다. 두 곳에서 동시에 테스트하려면 npm run start 한 터미널에서는 데스크톱용으로 실행하고 npm run start -- --mobile 다른 터미널에서는 모바일용으로 실행하세요.

핫 리로드

데스크톱 미리보기와 마찬가지로, 모바일 미리보기도 씬 파일을 변경하면 자동으로 다시 로드됩니다. 편집할 때마다 QR 코드를 다시 스캔할 필요는 없습니다.

문제 해결

• QR 코드가 앱을 열지 않음 — Decentraland 앱이 설치되어 있고, 해당 기기에서 최소 한 번은 열어 보았는지 확인하세요.

• 휴대폰이 미리보기 서버에 연결할 수 없음 — 휴대폰과 개발 머신이 동일한 Wi‑Fi 네트워크에 있는지 확인하세요. 일부 기업 네트워크는 클라이언트를 격리하므로, 그런 경우 개인 핫스팟이나 다른 네트워크를 사용하세요.

• 씬은 휴대폰에서 로드되지만 데스크톱과 다르게 보임 — 이는 예상된 동작입니다. 이를 통해 다음을 검증하세요 안전 영역, UI 크기, 그리고 입력 바인딩.

관련

• 씬 미리보기

• CLI 사용하기

• 모바일 Discover 추천 받기