--- title: "Perguntas de quem está começando" version: snapshot-2026-10-06 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-07 runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/perguntas-frequentes/ --- # Perguntas de quem está começando Respostas práticas sobre código, projetos, UI, instalação e diferenças entre edição e execução. ## Preciso saber programar para começar? Não para criar objetos, configurar componentes e fazer a primeira animação por campos. Regras próprias normalmente exigem entender os consumidores disponíveis e, quando necessário, C#. A trilha começa visualmente e explica um script completo antes de propor expansões. ## Onde começo se não conheço nada de jogos? Na [trilha CaixaGira](/pt-br/snapshot-2026-10-06/comece/indice/). Não comece pelo catálogo de milhares de membros: use a referência quando souber a ação que quer realizar. Consulte o [Glossário com exemplos](/pt-br/snapshot-2026-10-06/comece/glossario/) durante a aula. ## Criar objeto e adicionar componente são a mesma coisa? Não. Hierarquia → + cria uma entidade/receita. Inspector → Componentes → + acrescenta função ao objeto selecionado. Uma receita pode criar vários componentes juntos; confira sua composição. ## Por que o cubo não cai? Ele pode ser apenas visual. Gravidade/contato precisam da composição física e do tipo de movimento correto. O chão visível também precisa de composição física para bloquear a queda. [Veja física 3D](/pt-br/snapshot-2026-10-06/sistemas/indice/). ## Por que o editor mostra o objeto, mas o Play fica vazio? O editor tem sua própria vista. Confira a câmera de jogo, **Usar no Play**, pose, recorte e prioridade. [Monte CameraPrincipal a partir da vista](/pt-br/snapshot-2026-10-06/comece/primeira-cena/). ## Onde fica UIIMG ou UiImage? O elemento documentado é **Image**, dentro de um documento UI .aeui. Canvas UI liga o documento à cena. Não procure Image como se fosse um componente 3D. [Campos de Image](/pt-br/snapshot-2026-10-06/ui/image/) e [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) mostram a sequência. ## Posso baixar os corações e já abrir como jogo completo? O pacote oferece documento, imagens e scripts para integração. Não representa uma cena completa com jogador, gatilhos e todos os vínculos prontos. Siga a montagem e confira IDs/referências. Não renomeie o ZIP para uma extensão de projeto. ## Salvei um script. Por que ele não está rodando? Confira **Recompilar projeto → Publicado → anexar o Behavior ao objeto → Play**. O arquivo salvo é somente uma das etapas. [Veja cada passo e seu resultado](/pt-br/snapshot-2026-10-06/comece/primeiro-script-c/). ## Posso copiar código de Unity ou Godot? Os conceitos ajudam, mas APIs, tipos e lifecycle não são automaticamente compatíveis. Use o SDK Astra desta geração. Um script com `MonoBehaviour` ou APIs de outra engine não se transforma num Behavior da Astra por mudar só o nome do arquivo. ## Posso usar vírgula no número do script? C# usa ponto decimal: `0.5f`. Vírgula separa argumentos e pode mudar o significado ou causar erro. No texto português, 0,5 representa o mesmo valor, mas não é a sintaxe para colar no código. ## Rotação é sempre em graus? Não. O Inspector apresenta graus; a API de rotação usada no exemplo recebe radianos. Confira a unidade do membro, não apenas seu nome. [Unidades e tipos de campos](/pt-br/snapshot-2026-10-06/comece/ler-o-inspector/). ## Tudo que mudo no Play vai ser salvo? Não presuma isso. Estado autoral e estado de execução têm funções diferentes. Progresso do jogador usa persistência explícita. [Compare antes/durante/depois](/pt-br/snapshot-2026-10-06/comece/play-e-stop/). ## Desfazer substitui backup? Não. Histórico pertence ao contexto de edição e não garante recuperação depois de reinstalar, limpar dados ou perder arquivos. Faça cópia recuperável antes de ações arriscadas. ## Tenho um Windows/iPhone. Há instalador aqui? O download público desta distribuição é o APK Android. O portal não oferece instalador equivalente para essas plataformas. Consulte requisitos e disponibilidade em [Download](/download/). ## “20%” significa 20% dos recursos testados? Não. É a estimativa declarada da meta global do projeto. Estados/evidências de cada capacidade devem ser lidos separadamente; não use essa porcentagem como cobertura de testes ou promessa de paridade. ## Uma atualização das docs também atualiza meu aplicativo? Não. Leia origem, disponibilidade e versão em [Atualizações](/atualizacoes/). Mudança editorial não troca o APK instalado. Trabalho “em desenvolvimento” ainda precisa de uma distribuição correspondente. ## O download via GitHub expõe o código privado da engine? Um link público revela o endereço do repositório/asset usado para distribuição e permite ver o que é público nele. Um APK não publica automaticamente o código-fonte privado. O site de documentação e seus exemplos são públicos; não devem receber os arquivos internos da engine. Repositório de documentação, binário distribuído e código da engine são materiais diferentes. ## Como pedir ajuda ou sugerir uma função? No [Discord oficial](https://discord.gg/KpqnBvt4uG), com versão, etapa, passos, resultado esperado e mensagem exata. [Use o modelo de relato](/pt-br/snapshot-2026-10-06/comece/ajuda-por-sintoma/). Explique o problema que a função resolveria, além de seu nome.