> 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-pt/criar-para-mobile/desenvolver/preview-on-mobile.md).

# Pré-visualização no Celular

Pré-visualize sua scene em um dispositivo móvel real a partir do Creator Hub ou da CLI.

Pode pré-visualizar a sua cena diretamente no app móvel do Decentraland a partir do Creator Hub ou da linha de comando. Esta é a única forma confiável de confirmar que a sua UI, o tratamento de input e o desempenho se mantêm num dispositivo real.

## Pré-requisitos

* O app móvel do Decentraland instalado no seu telemóvel — consulte os [links de download](/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md#get-the-mobile-app).
* O telemóvel e a sua máquina de desenvolvimento devem estar na **mesma rede local** (Wi-Fi). A pré-visualização é servida a partir do seu computador; o código QR liga a uma URL de LAN.

## Opção A — A partir do Creator Hub

1. Abra a sua cena no Creator Hub.
2. Clique na seta ao lado do **Play** botão para abrir **Play Options**, depois escolha **Show QR Code for Mobile**.
3. Digitalize o código QR apresentado com a câmera do seu telemóvel. O link abre o app móvel do Decentraland e carrega a pré-visualização da sua cena. Clique na área escura à volta do popup para o fechar.

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-716e6ff7589c05f9ea2c6d87eee884b5c0c230c4%2Fmobile-preview-creator-hub.png?alt=media" alt="Creator Hub Play Options menu with the Show QR Code for Mobile option"><figcaption><p>A opção "Show QR Code for Mobile" no menu Play Options do Creator Hub.</p></figcaption></figure>

## Opção B — A partir da linha de comando

A partir da raiz do seu projeto de cena, execute:

```bash
npm run start -- --mobile
```

A CLI imprime um código QR no terminal que aponta para a URL de LAN da sua cena. Digitalize-o com o seu telemóvel para carregar a cena no app móvel do Decentraland.

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-19562a6b332d4bb5254d6f2d9b92d923b3ce7069%2Fmobile-preview-cli-qr.png?alt=media" alt="QR code printed by the Decentraland CLI for mobile preview"><figcaption><p>Um código QR impresso por <code>npm run start -- --mobile</code>. Digitalize-o com o seu telemóvel para abrir a cena no app móvel do Decentraland.</p></figcaption></figure>

{% hint style="info" %}
**💡 Dica**: Quando passa `--mobile`, o Explorer de desktop também não é iniciado. Se quiser testar ambos ao mesmo tempo, execute `npm run start` num terminal para desktop e `npm run start -- --mobile` noutro para mobile.
{% endhint %}

## Hot reload

Tal como na pré-visualização para desktop, a pré-visualização móvel recarrega automaticamente quando altera os ficheiros da cena. Não precisa de voltar a digitalizar o código QR após cada edição.

## Resolução de problemas

* **O código QR não abre o app** — certifique-se de que o app do Decentraland está instalado e de que o abriu pelo menos uma vez no dispositivo.
* **O telemóvel não consegue aceder ao servidor de pré-visualização** — confirme que o telemóvel e a máquina de desenvolvimento estão na mesma rede Wi-Fi. Algumas redes corporativas isolam os clientes; se for o caso, use um hotspot pessoal ou uma rede diferente.
* **A cena carrega no telemóvel mas parece diferente da versão para desktop** — isso é esperado. Use isto como o momento para validar a sua [área segura](/creator/content-creator-pt/criar-para-mobile/desenvolver/safe-area.md), [dimensionamento da UI](/creator/content-creator-pt/criar-para-mobile/desenvolver/ui-best-practices.md#sizing), e [associações de input](/creator/content-creator-pt/criar-para-mobile/desenvolver/input-on-mobile.md).

## Relacionado

* [Pré-visualize a sua cena](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md)
* [Usando a CLI](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md)
* [Seja destaque no Discover móvel](/creator/content-creator-pt/criar-para-mobile/publicar/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-pt/criar-para-mobile/desenvolver/preview-on-mobile.md?ask=<question>&goal=<user_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.
