> 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 na aplicação móvel Decentraland a partir do Creator Hub ou da linha de comandos. Esta é a única forma fiável de confirmar que a sua UI, o processamento de entradas e o desempenho funcionam corretamente num dispositivo real.

## Pré-requisitos

* A aplicação móvel Decentraland instalada no seu telemóvel — consulte as [ligações para transferência](https://docs.decentraland.org/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 têm de estar na **mesma rede local** (Wi-Fi). A pré-visualização é disponibilizada a partir do seu computador; o código QR contém uma ligação para um URL da rede local.

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

1. Abra a sua cena no Creator Hub.
2. Clique na seta junto ao botão **Play** para abrir **Play Options**, e depois escolha **Show QR Code for Mobile**.
3. Leia o código QR apresentado com a câmara do telemóvel. A ligação abre a aplicação móvel Decentraland e carrega a pré-visualização da sua cena. Clique na área escura à volta da janela pop-up para a fechar.

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ddc491f10139982fa912b82f7de6bb036bdda01%2Fmobile-preview-creator-hub.webp?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 comandos

Na raiz do projeto da sua cena, execute:

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

A CLI apresenta no terminal um código QR que aponta para o URL da rede local da sua cena. Leia-o com o telemóvel para carregar a cena na aplicação móvel Decentraland.

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f2acf45611e8fea4cfc1b193724bab888d0e17b6%2Fmobile-preview-cli-qr.webp?alt=media" alt="QR code printed by the Decentraland CLI for mobile preview"><figcaption><p>Um código QR apresentado por <code>npm run start -- --mobile</code>. Leia-o com o telemóvel para abrir a cena na aplicação móvel Decentraland.</p></figcaption></figure>

{% hint style="info" %}
**💡 Sugestão**: Quando utiliza `--mobile`, o Explorer para computador também não é iniciado. Se quiser testar em ambos em simultâneo, execute `npm run start` num terminal para computador e `npm run start -- --mobile` noutro para dispositivos móveis.
{% endhint %}

## Recarga automática

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

## Resolução de problemas

* **O código QR não abre a aplicação** — certifique-se de que a aplicação Decentraland está instalada e de que já a 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 ligados à mesma rede Wi-Fi. Algumas redes empresariais isolam os dispositivos; nesse caso, utilize um hotspot pessoal ou outra rede.
* **A cena carrega no telemóvel, mas tem um aspeto diferente do que tem no computador** — isso é esperado. Aproveite para validar a [área segura](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/safe-area.md), [dimensão da UI](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/ui-best-practices.md#sizing), e as [associações de entrada](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/input-on-mobile.md).

## Relacionados

* [Pré-visualizar a sua cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md)
* [Utilizar a CLI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md)
* [Destaque-se na secção Discover para dispositivos móveis](https://docs.decentraland.org/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.
