Pular para o conteúdo
AstraDOCS

Como preencher e entender cada tipo de campo

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

Números, unidades, opções, referências, recursos e condições com exemplos concretos.

Etapa 5 de 10 · Projeto CaixaGira

Ver o percurso completo

Hierarquia → selecione o objeto → Inspector → grupo/componente → campo. Confira o nome do objeto e o componente. O mesmo rótulo, como Ativo, pode controlar um objeto, uma luz, um tween ou outra função. Desativar uma função não significa apagar o objeto.

Leia o campo em quatro partes: qual dado ele muda, qual unidade usa, quando tem efeito e quem o consome. Se só mudar um número sem verificar o resultado, você não sabe ainda se está editando a função correta.

Tipo Como ler Exemplo para experimentar Erro comum
Número com unidade A unidade faz parte do significado Duração 2 s leva o dobro de 1 s para o mesmo tween Tratar duração como velocidade
X / Y / Z Três eixos de um vetor Escala 2 / 1 / 1 alonga apenas X Escrever 2 nos três eixos e aumentar tudo
Graus no Inspector Uma volta completa é 360° Rotação Y 90° é um quarto de volta Reusar esse número numa API em radianos
Radianos na API de rotação Uma volta é aproximadamente 6,283 rad 0,5 rad/s é aproximadamente 28,65°/s Passar 90 esperando um quarto de volta
Massa em kg Propriedade de um corpo físico 1 kg é o padrão do Corpo físico Esperar que massa sozinha faça a malha cair
Meia extensão de forma Metade do tamanho em um eixo Meia extensão 0,5 corresponde a tamanho 1 nesse eixo Confundir tamanho completo com metade

Os números de código C# usam ponto, como 0.5f. As explicações em português podem usar vírgula, como 0,5. Confira o formato aceito pelo controle numérico da sua instalação antes de confirmar; não cole “2 segundos” num campo que pede apenas um número.

Local e mundo: qual posição você está mudando?

Seção intitulada “Local e mundo: qual posição você está mudando?”

Local é relativo ao pai; mundo é a pose resultante na cena. Uma caixa filha de um objeto movido pode estar em Local X = 0 e ainda longe da origem do mundo. Na trilha, criamos na raiz para reduzir essa ambiguidade. Exemplos de referencial e parentesco explicam como escalar/rotacionar o pai afeta os filhos.

Uma enumeração escolhe uma opção de um conjunto: Projeção = Perspectiva ou Ortográfica; Movimento do corpo = Estático, Cinemático ou Dinâmico. Não escreva uma opção inventada. Um booleano liga/desliga uma função: Girar, Mover, Usar no Play. No tween, preencher Rotação Y não basta quando Girar está desligado.

Na câmera seguidora, Alvo recebe uma referência ao objeto que deve ser acompanhado. Escolha o objeto no seletor. Renomear um objeto para “Jogador” não o vincula automaticamente a todos os campos chamados Alvo. Uma referência vazia pode deixar a função sem receptor. Confira também as restrições do seletor: algumas referências não aceitam um objeto da própria subárvore.

Uma imagem importada, um documento UI e um clipe possuem tipos diferentes. Importar registra o recurso; atribuir liga esse recurso a um consumidor. Para um coração, a imagem é usada por Image no documento; o documento é usado por Canvas UI no objeto da cena. Sem essa cadeia, ter o PNG em Arquivos não desenha o HUD.

Leia Image / UiImage: recurso, tamanho, tint e recorte e a montagem completa dos corações. Os seletores devem receber um recurso compatível, não um caminho presumido de outra máquina.

Meia altura da câmera faz sentido em Ortográfica; não é o controle de zoom da perspectiva. Um grupo avançado pode ficar recolhido. Propriedades por slot referem-se a uma parte/recurso da coleção: escolha o slot certo antes de editar. Vários materiais no mesmo objeto não recebem necessariamente o mesmo valor.

Se o campo não está presente, confira modo, grupo, tipo e versão. Não acrescente um componente com nome parecido apenas para fazer o campo aparecer.

Padrão é o valor lido de um componente recém-criado. Valor do exercício é uma escolha para observar um efeito. Domínio é o conjunto aceito pelo contrato, não uma recomendação de qualidade. Receita de criação pode configurar valores diferentes do padrão do componente isolado.

O catálogo de componentes permite buscar o nome ou ID do campo e ler caminho, unidade, domínio, condição e efeito. Depois de editar: observe, salve, reabra e confira no Play. Uma propriedade em referência ainda não representa aceite de todo cenário em Android.

Selecione CaixaGira, mude Escala X de 2 para 3, observe e volte. Depois confira Campo vertical da câmera sem modificá-lo. Explique por que um campo muda a geometria e o outro muda a lente.

Confira se entendeu: posso usar 90 tanto no Inspector quanto em Object.Rotate?

Não sem conferir a unidade. Nesta API de rotação o ângulo é em radianos; o Inspector apresenta graus. O nome “rotação” sozinho não garante a mesma representação.