Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Pré-visualizar no mobile

Pré-visualize a sua cena num dispositivo móvel real a partir do Creator Hub ou da CLI.

Você pode pré-visualizar a sua Scene diretamente na app móvel da 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 estáveis num dispositivo real.

Pré-requisitos

  • A app móvel da Decentraland instalada no seu telefone — veja os links de download.

  • O telefone e a sua máquina de desenvolvimento precisam de estar na mesma rede local (Wi-Fi). A preview é servida a partir do seu computador; o código QR liga para um URL de LAN.

Opção A — A partir do Creator Hub

  1. Abra a sua Scene no Creator Hub.

  2. Clique no dropdown ao lado do Preview botão e escolha Show QR Code for Mobile.

  3. Leia o código QR exibido com a câmara do seu telefone. O link abre a app móvel da Decentraland e carrega a preview da sua Scene.

Creator Hub preview dropdown with the Show QR Code for Mobile option
A opção "Show QR Code for Mobile" no dropdown de preview do Creator Hub.

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

A partir da raiz do projeto da sua Scene, execute:

A CLI imprime um código QR no terminal que aponta para o URL de LAN da sua Scene. Leia-o com o seu telefone para carregar a Scene na app móvel da Decentraland.

QR code printed by the Decentraland CLI for mobile preview
Um código QR impresso por npm run start -- --mobile. Leia-o com o seu telefone para abrir a Scene na app móvel da Decentraland.

💡 Dica: Quando você passa --mobile, o explorer de desktop também não é iniciado. Se quiser testar em ambos ao mesmo tempo, execute npm run start num terminal para desktop e npm run start -- --mobile noutro para mobile.

Hot reload

Tal como na preview de desktop, a preview móvel recarrega automaticamente quando você altera os ficheiros da Scene. Não precisa de voltar a ler o código QR após cada edição.

Solução de problemas

  • O código QR não abre a app — certifique-se de que a app da Decentraland está instalada e de que a abriu pelo menos uma vez no dispositivo.

  • O telefone não consegue alcançar o servidor de preview — confirme que o telefone e a máquina de desenvolvimento estão na mesma rede Wi-Fi. Algumas redes corporativas isolam os clientes; nesse caso, use um hotspot pessoal ou uma rede diferente.

  • A Scene carrega no telefone, mas parece diferente da versão de desktop — isso é esperado. Use isto como o momento para validar o seu área segura, dimensionamento da UI, e mapeamentos de input.

Relacionado

AnteriorDetetar a plataformaPróximoÁrea segura no mobile

Atualizado