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

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.

  • 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.

Creator Hub Play Options menu with the Show QR Code for Mobile option
A opção "Show QR Code for Mobile" no menu Play Options do Creator Hub.

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

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

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.

QR code printed by the Decentraland CLI for mobile preview
Um código QR impresso por npm run start -- --mobile. Digitalize-o com o seu telemóvel para abrir a cena no app móvel do Decentraland.

💡 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.

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, dimensionamento da UI, e associações de input.

Relacionado

AnteriorDetectar a plataforma
PróximoÁrea Segura no Mobile

Atualizado