Pular para o conteúdo
AstraDOCS

Perguntas de quem está começando

Astra atual · C# · 06 out. 2026Conferido em fonteGuia revisado · 07 out. 2026

Respostas práticas sobre código, projetos, UI, instalação e diferenças entre edição e execução.

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.

Na trilha CaixaGira. 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 durante a aula.

Criar objeto e adicionar componente são a mesma coisa?

Seção intitulada “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.

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.

Por que o editor mostra o objeto, mas o Play fica vazio?

Seção intitulada “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.

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 e HUD funcional mostram a sequência.

Posso baixar os corações e já abrir como jogo completo?

Seção intitulada “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.

Confira Recompilar projeto → Publicado → anexar o Behavior ao objeto → Play. O arquivo salvo é somente uma das etapas. Veja cada passo e seu resultado.

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.

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.

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.

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.

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.

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.

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?

Seção intitulada “Uma atualização das docs também atualiza meu aplicativo?”

Não. Leia origem, disponibilidade e versão em Atualizações. 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?

Seção intitulada “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.

No Discord oficial, com versão, etapa, passos, resultado esperado e mensagem exata. Use o modelo de relato. Explique o problema que a função resolveria, além de seu nome.