--- title: "Como preencher e entender cada tipo de campo" 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/ler-o-inspector/ --- # Como preencher e entender cada tipo de campo Números, unidades, opções, referências, recursos e condições com exemplos concretos. **Etapa 5 de 10 · Projeto CaixaGira** [Ver o percurso completo](/pt-br/snapshot-2026-10-06/comece/indice/) ## Antes de preencher qualquer coisa **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. ## Números, vetores e unidades | 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? **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](/pt-br/snapshot-2026-10-06/conceitos/indice/) explicam como escalar/rotacionar o pai afeta os filhos. ## Opções e booleanos 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. ## Referência de objeto não é o nome digitado 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. ## Recurso não é qualquer arquivo 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](/pt-br/snapshot-2026-10-06/ui/image/) e [a montagem completa dos corações](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/). Os seletores devem receber um recurso compatível, não um caminho presumido de outra máquina. ## Campos condicionais e slots **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, exemplo e limite são diferentes **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](/pt-br/snapshot-2026-10-06/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. ## Exercício curto 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.