---
title: "Como ler uma ficha de componente"
version: snapshot-2026-10-28
engineGeneration: astra-current
language: C#
status: source-reviewed
reviewedAt: 2026-10-26
appRelease: "0.4.0-preview.20261028"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/guia/componentes/ler-uma-ficha/
---

# Como ler uma ficha de componente

O que significa cada parte da ficha: padrão, domínio, por slot, ponto seguro no Play, dependências, fachada C# e roadmap.

> **Conferido na fonte e no computador** · APK 0.4.0 · formato das fichas geradas do catálogo

| Parte da ficha | O que diz |
| --- | --- |
| Para que usar · Criar e configurar | o problema que o componente resolve e o caminho no editor |
| Vindo de outra engine | a página Unity ou Godot estudada e as palavras que a busca aceita |
| Exemplo de uso | valores para experimentar e o resultado esperado |
| Dependências e Conflitos | o que precisa estar no mesmo objeto, e o que não pode |
| Edição e ciclo de vida | se dá para adicionar, remover e mudar em Play ("ponto seguro" = aplicado entre passos da simulação) |
| Propriedades | cada campo com **tipo/unidade**, **padrão** (o valor de um componente recém-criado) e **domínio** (a faixa aceita) |
| Comandos e eventos | o que o script e a Conexão de evento podem chamar e ouvir |
| Roadmap | o que ainda falta nessa família |

**Valores típicos:** o padrão é o ponto de partida seguro; as fichas dos componentes gráficos e os tutoriais de [Criar um jogo](/guia/criar/cena-luz-ceu-clima/) trazem valores de exemplo testados.

**Por slot:** campos que valem para cada material ou recurso do objeto (escolha o slot antes).

**Recursos:** seletores de arquivo do projeto (material, malha, perfil, clipe), que não entram na contagem de propriedades numéricas.