---
title: "Você joga. Agora, você cria."
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: editorial
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/
---

# Você joga. Agora, você cria.

Documentação da Astra. Comece a criar, explore os componentes e consulte a API C#.

# Astra Docs

## Projeto em desenvolvimento

**A Astra ainda é bem limitada e incompleta.** O projeto está em aproximadamente **20% da meta final**. Ainda há muito a construir, completar e refinar.

Estimativa do criador sobre a meta final. Não representa estabilidade ou cobertura de testes.

Aceitamos sugestões! Compartilhe ideias, dúvidas e problemas no [Discord oficial da Astra](https://discord.gg/KpqnBvt4uG), nosso canal oficial para interagir com a comunidade.

Você joga. Agora, você cria.

- [Baixar Astra](/download/)
- [Comece aqui](/pt-br/snapshot-2026-10-06/comece/visao-geral/)
- [Componentes](/pt-br/snapshot-2026-10-06/componentes/)
- [API C#](/pt-br/snapshot-2026-10-06/api/)
- [Exemplos](/pt-br/snapshot-2026-10-06/exemplos/como-executar-exemplos/)


---

---
title: "Baixar Astra para Android"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: editorial
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/download/
---

# Baixar Astra para Android

Baixe a prévia pública da Astra para Android. APK assinado, requisitos, instruções de instalação e verificação de integridade.

## Projeto em desenvolvimento

**A Astra ainda é bem limitada e incompleta.** O projeto está em aproximadamente **20% da meta final**. Ainda há muito a construir, completar e refinar.

Estimativa do criador sobre a meta final. Não representa estabilidade ou cobertura de testes.

Aceitamos sugestões! Compartilhe ideias, dúvidas e problemas no [Discord oficial da Astra](https://discord.gg/KpqnBvt4uG), nosso canal oficial para interagir com a comunidade.

## Astra 0.2.0-preview.20261006

Prévia pública de 6 de outubro de 2026. Android 8.0+, ARM64, GPU com Vulkan 1.1. APK de 211,5 MiB.

[Baixar APK](https://github.com/kacerato/AstraDocs/releases/download/astra-android-2026.10.06/Astra-0.2.0-preview.20261006-android-arm64.apk) · [Notas da versão](https://github.com/kacerato/AstraDocs/releases/tag/astra-android-2026.10.06)

SHA-256: `ca9ca3ee0cdf842986de496f892e7cfeb3f6e2e2562a7abe811df278f7f0d290`

Baixe e abra o APK, autorize a instalação pelo navegador quando solicitado e abra a Astra. Preserve projetos antes de atualizar: instalações com outra assinatura exigem reinstalação. A compilação e a assinatura foram verificadas; esta publicação não inclui nova validação em aparelho físico. Dispositivos com páginas de memória de 16 KB não são suportados nesta distribuição.

[Primeiro projeto](/pt-br/snapshot-2026-10-06/comece/primeiro-projeto/)

[Manifesto](/releases/latest.json)


---

---
title: "O seu primeiro universo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/visao-geral/
---

# O seu primeiro universo

Entenda a Astra e escolha um caminho para começar.

## Projeto em desenvolvimento

**A Astra ainda é bem limitada e incompleta.** O projeto está em aproximadamente **20% da meta final**. Ainda há muito a construir, completar e refinar.

Estimativa do criador sobre a meta final. Não representa estabilidade ou cobertura de testes.

Aceitamos sugestões! Compartilhe ideias, dúvidas e problemas no [Discord oficial da Astra](https://discord.gg/KpqnBvt4uG), nosso canal oficial para interagir com a comunidade.

## O que você vai encontrar

Astra combina autoria de cenas, componentes e comportamentos C#. Você organiza objetos, configura suas propriedades e executa o resultado em Play. Este portal documenta a geração atual em um snapshot de 06/10/2026.

## Escolha sua trilha

- **Primeiro contato:** siga [primeiro projeto](/pt-br/snapshot-2026-10-06/comece/primeiro-projeto/), [primeira cena](/pt-br/snapshot-2026-10-06/comece/primeira-cena/) e [primeiro script](/pt-br/snapshot-2026-10-06/comece/primeiro-script-c/).
- **Criação visual:** consulte o [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/) e o [catálogo de componentes e campos](/pt-br/snapshot-2026-10-06/componentes/).
- **HUD e interface:** siga [onde fica a UI](/pt-br/snapshot-2026-10-06/ui/comece-aqui/) e [corações com dano/cura](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).
- **Programação:** abra a [API C#](/pt-br/snapshot-2026-10-06/api/), com acesso, uso e roadmap em cada membro. As assinaturas são extraídas semanticamente do código.

## Como ler os estados

“Conferido em fonte” identifica um contrato observado no código. “Referência de assinaturas” não afirma que cada método foi testado em um aparelho. Os exemplos novos declaram separadamente sua compilação e execução. Consulte a [cobertura da versão](/pt-br/snapshot-2026-10-06/versoes/estado-da-versao/).

## Antes de começar

Baixe a prévia pública na [página de download](/download/), confira os requisitos e preserve seus projetos antes de instalar. Não misture estes exemplos C# com o planejamento de Astra 2/Luau.


---

---
title: "Requisitos e compatibilidade"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/requisitos-e-compatibilidade/
---

# Requisitos e compatibilidade

Separe os requisitos da instalação dos requisitos de uma cena.

## Instalação e geração

Esta documentação corresponde à Astra atual, com API C# e renderer Vulkan no Android. A compatibilidade deve ser conferida para o APK efetivamente distribuído; um modelo de aparelho ou a presença de Vulkan, isoladamente, não confirma todos os recursos.

## Antes de importar uma cena

Verifique espaço livre para arquivos originais e derivados, memória disponível, texturas, quantidade de geometria e recursos referenciados. Importar um arquivo não garante que todo recurso da ferramenta que o exportou terá equivalente na Astra.

## Como registrar um problema

Anote a versão da engine, aparelho/GPU, versão do Android, cena, resolução e qualidade. Informe se o erro ocorre ao abrir o projeto, iniciar Play ou retomar o aplicativo. Veja [limites e capacidades](/pt-br/snapshot-2026-10-06/conceitos/limites-e-capacidades/).


---

---
title: "Instalação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/instalacao/
---

# Instalação

Prepare uma instalação compatível antes de seguir os tutoriais.

## Distribuição deste snapshot

A prévia pública para Android está na [página de download](/download/), com versão, requisitos, tamanho e SHA-256. Baixe o APK no aparelho, abra o arquivo e autorize a instalação pelo navegador quando o Android solicitar. O pacote exige Android 8.0+, ARM64 e Vulkan 1.1.

## Preserve seus projetos

Antes de substituir uma instalação existente, mantenha uma cópia dos projetos fora dos dados do aplicativo. A prévia pública usa uma assinatura de distribuição própria: se a instalação anterior tiver outra assinatura, o Android exigirá reinstalação. Desinstalar pode apagar projetos locais. Não limpe os dados do aplicativo para resolver uma falha de migração sem preservar os arquivos.

## Depois de instalar

Abra a lista de projetos e crie um projeto vazio. Entre no editor, salve uma cena simples e reabra o projeto antes de importar conteúdo grande. Continue em [primeiro projeto](/pt-br/snapshot-2026-10-06/comece/primeiro-projeto/).


---

---
title: "Seu primeiro projeto"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/primeiro-projeto/
---

# Seu primeiro projeto

Comece com uma cena pequena e um resultado fácil de conferir.

## Crie a base

Na tela de projetos, use a ação de criar projeto, escolha um nome identificável e abra a cena vazia. A disponibilidade de modelos depende da versão instalada; não trate projetos demonstrativos históricos como modelos obrigatórios.

## Organize antes de crescer

Use nomes que descrevam a função dos objetos. Separe o objeto que receberá o comportamento, a câmera e os elementos do ambiente. O editor de cena trabalha em landscape; a área de código pode usar outra orientação.

## Faça uma primeira gravação

Salve o projeto, volte à lista e reabra. Confira nome, objetos e transformações. Essa pequena conferência separa problemas de persistência de problemas que poderiam aparecer depois da importação.

## Próximo resultado

Crie uma [primeira cena](/pt-br/snapshot-2026-10-06/comece/primeira-cena/) e adicione um comportamento de rotação. O objetivo inicial é observar uma mudança simples em Play e recuperar a cena autoral ao parar.


---

---
title: "Conheça o editor"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/conheca-o-editor/
---

# Conheça o editor

Viewport, Hierarquia, Inspector e código têm papéis diferentes.

## Viewport e seleção

O viewport mostra a cena. A Hierarquia permite localizar um objeto mesmo quando ele está fora da câmera ou encoberto. Selecione um objeto antes de procurar suas propriedades.

## Inspector e componentes

O Inspector apresenta os dados do objeto selecionado. Transformação posiciona o objeto; componentes acrescentam comportamento e dados especializados. Campos podem aparecer somente quando uma configuração os torna relevantes.

## Código, console e execução

A área de código edita comportamentos C#. Compile antes de entrar em Play. Consulte as mensagens de diagnóstico quando um script não carregar; uma edição de texto não significa que a nova versão já está executando.

## Continue

Leia [Viewport e navegação](/pt-br/snapshot-2026-10-06/editor/viewport-e-navegacao/), [Inspector](/pt-br/snapshot-2026-10-06/editor/inspector/) e [Play e Stop](/pt-br/snapshot-2026-10-06/comece/play-e-stop/).


---

---
title: "Sua primeira cena"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/primeira-cena/
---

# Sua primeira cena

Monte um cenário mínimo para observar um objeto em Play.

## Composição

Crie uma primitiva visível, uma câmera com enquadramento útil e iluminação adequada ao material. Prefira uma forma assimétrica para testar rotação; uma esfera lisa pode girar sem produzir uma mudança visual perceptível.

## Posição e enquadramento

Selecione a geometria na Hierarquia e confira sua escala. Posicione a câmera de modo que o objeto fique entre os planos próximo e distante. A câmera de edição e a câmera de gameplay não precisam compartilhar a mesma pose.

## Salve e observe

Salve a cena antes de Play. Confirme se o objeto aparece na câmera do jogo. Se a imagem estiver vazia, consulte [câmera sem imagem](/pt-br/snapshot-2026-10-06/diagnostico/camera-sem-imagem/).

## Adicione comportamento

Continue com [primeiro componente](/pt-br/snapshot-2026-10-06/comece/primeiro-componente/) ou [primeiro script C#](/pt-br/snapshot-2026-10-06/comece/primeiro-script-c/).


---

---
title: "Seu primeiro componente"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/primeiro-componente/
---

# Seu primeiro componente

Adicione uma capacidade pelo seu contrato de composição.

## Escolha pela função

Selecione um objeto e abra a ação de adicionar componente. Use o [catálogo](/pt-br/snapshot-2026-10-06/componentes/) para localizar o nome no editor, requisitos e conflitos. Um tipo listado em uma referência de outra engine não está automaticamente disponível na Astra.

## Resolva a composição

O schema pode exigir outros componentes no mesmo objeto. Também pode recusar uma combinação por conflito de autoridade, como dois sistemas que tentam publicar a mesma transformação. Leia o motivo apresentado em vez de remover dependências ao acaso.

## Confira uma propriedade

Altere um campo com efeito observável e mantenha os demais valores estáveis. Observe o resultado, desfaça e refaça. Salve e reabra para verificar o estado autoral.

## Durante Play

Consulte na página do tipo se a mudança estrutural é permitida. Operações em ponto seguro não devem ser tratadas como execução imediata dentro de um callback.


---

---
title: "Seu primeiro script C#"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/primeiro-script-c/
---

# Seu primeiro script C#

Faça um objeto girar a 0,5 rad/s com um Behavior.

## Prepare a cena

Use um objeto visível, sem corpo físico nem controlador de personagem comandando sua pose. Prefira geometria assimétrica. Crie um script C# e anexe o comportamento ao objeto pela área de código.

## Código completo

```csharp title="RotateObject.cs"
using Astra;
using System.Numerics;

[ComponentId("docs.rotate-object")]
public sealed class RotateObject : Behavior
{
    public override void Update(float deltaTime)
    {
        Object.Rotate(Vector3.UnitY, 0.5f * deltaTime,
                      TransformSpace.Local);
    }
}
```

O identificador de componente é estável e deve ser único no projeto. A taxa de 0,5 rad/s é multiplicada uma vez pelo intervalo de atualização. A Astra usa **radianos** nesta operação.

## Compile e observe

Compile no editor e resolva os erros antes de iniciar Play. O resultado esperado é a rotação em torno do eixo Y local. Pare a execução e confira a cena autoral. Este exemplo foi preparado para esta API; a execução no aparelho não foi realizada nesta publicação.

## Se o objeto não girar

Confira se o comportamento está anexado e habilitado, se o objeto recebe atualização e se outro sistema escreve a orientação depois dele. Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/) e [autoridade de transformação](/pt-br/snapshot-2026-10-06/conceitos/autoridade-de-transformacao/).

[Baixar RotateObject.cs](/examples/rotate-object/RotateObject.cs)


---

---
title: "Play e Stop"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/play-e-stop/
---

# Play e Stop

Entenda o que está executando e o que pertence à cena autoral.

## Antes de Play

Salve a cena e compile os scripts. O mundo de execução é criado a partir dos dados autorais; callbacks e recursos pertencem àquela sessão.

## Enquanto executa

Objetos podem ser criados, removidos ou alterados por scripts. Certas operações são enfileiradas para um ponto seguro. A interface do editor pode capturar entrada e suspender a resposta do gameplay.

## Ao parar

Referências da sessão encerrada deixam de ser válidas. Não armazene handles entre sessões e não suponha que uma transformação aplicada por script foi gravada na cena autoral. Para progresso do jogador, use [persistência](/pt-br/snapshot-2026-10-06/sistemas/persistencia/).


---

---
title: "Salvar e reabrir"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/salvar-e-reabrir/
---

# Salvar e reabrir

Confira persistência com mudanças identificáveis e recuperáveis.

## O que salvar

A cena autoral descreve objetos, composição e propriedades persistentes. O progresso de gameplay possui outro contrato. Salvar uma cena não equivale a executar SaveStore.Flush.

## Conferência prática

1. Selecione um objeto e altere nome ou posição.
2. Salve e encerre a edição normalmente.
3. Reabra o projeto.
4. Confira a mesma propriedade e as referências a recursos.
5. Entre em Play somente depois dessa conferência.

## Se a leitura falhar

Preserve o arquivo e seus backups. Uma versão desconhecida, recurso ausente ou arquivo truncado exige diagnóstico; não sobrescreva imediatamente a única cópia. Veja [cena não reabre](/pt-br/snapshot-2026-10-06/diagnostico/cena-nao-reabre/).


---

---
title: "Próximos passos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/comece/proximos-passos/
---

# Próximos passos

Transforme a primeira cena em um sistema pequeno e observável.

## Expanda uma variável por vez

Depois da rotação, experimente [movimento local](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/). Em seguida, escolha input, câmera ou física. Alterar tudo ao mesmo tempo dificulta identificar a origem de um erro.

## Escolha a referência certa

Use o manual para descobrir o fluxo do editor, o catálogo para compor objetos, a API para conferir assinaturas e as receitas para combinar sistemas.

## Conserve um caso mínimo

Mantenha uma cópia pequena que reproduz o comportamento. Registre versão e resultado esperado antes de adicionar assets, efeitos e cenas maiores.


---

---
title: "Projetos e modelos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/projetos-e-modelos/
---

# Projetos e modelos

Organize a cena e os recursos como uma unidade de trabalho.

## Como funciona

Um projeto agrupa cenas, scripts e recursos. Começar vazio facilita identificar dependências; um exemplo pronto pode trazer composição e configurações próprias. Não presuma que todos os exemplos históricos estão distribuídos como templates.

## Fluxo de trabalho

Dê nomes distintos aos experimentos. Antes de importar ou migrar, preserve uma cópia do projeto. Confira referências ao reabrir, especialmente quando os recursos foram movidos fora do editor.

## Continue

Consulte [primeiro projeto](/pt-br/snapshot-2026-10-06/comece/primeiro-projeto/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Viewport e navegação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/viewport-e-navegacao/
---

# Viewport e navegação

Use a cena como área principal de trabalho.

## Como funciona

A câmera do editor serve à inspeção. A câmera de gameplay é um objeto com configuração própria. Use a Hierarquia para selecionar e enquadrar objetos que não estão visíveis; um viewport de edição correto não prova que a câmera do jogo está configurada.

## Fluxo de trabalho

Trabalhe em landscape no editor de cena. Recolha superfícies que não precisa consultar durante a manipulação. Ao investigar um problema de enquadramento, confira transformações, projeção e planos de recorte.

## Continue

Consulte [camera sem imagem](/pt-br/snapshot-2026-10-06/diagnostico/camera-sem-imagem/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Seleção e multisseleção"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/selecao-e-multisselecao/
---

# Seleção e multisseleção

Saiba qual objeto e qual conjunto uma ação vai alterar.

## Como funciona

A seleção liga Hierarquia, gizmo e Inspector. Antes de editar um componente, confira o nome do alvo. Com vários objetos selecionados, uma propriedade pode representar valores diferentes e uma ação pode atuar sobre todo o conjunto.

## Fluxo de trabalho

Faça uma mudança pequena, observe os objetos afetados e use Undo para conferir a transação. Se o alvo estiver encoberto, selecione pela Hierarquia em vez de insistir no toque sobre geometria sobreposta.

## Continue

Consulte [undo e redo](/pt-br/snapshot-2026-10-06/editor/undo-e-redo/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Hierarquia e parenting"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/hierarquia-e-parenting/
---

# Hierarquia e parenting

Relacione objetos sem perder a distinção entre local e mundo.

## Como funciona

A transformação local é relativa ao pai. Mudar de pai pode manter a pose local ou tentar preservar a pose de mundo; essas escolhas produzem resultados diferentes. A API explicita a política de reparenting.

## Fluxo de trabalho

Não crie ciclos. Escalas e matrizes que não podem ser representadas por transformação válida podem impedir a operação. Confira posição, rotação e escala após mover um objeto na árvore.

## Continue

Consulte [espaco local e mundo](/pt-br/snapshot-2026-10-06/conceitos/espaco-local-e-mundo/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Gizmos e coordenadas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/gizmos-e-coordenadas/
---

# Gizmos e coordenadas

Alterne entre manipulação visual e valores precisos.

## Como funciona

O gizmo transforma o objeto selecionado. Local e mundo definem a orientação dos eixos. Valores do Inspector ajudam quando é necessário repetir uma distância, alinhar objetos ou corrigir uma escala.

## Fluxo de trabalho

Confira a unidade do campo. Rotate em C# usa radianos, enquanto um campo de lente pode declarar graus. O rótulo e o contrato da propriedade têm prioridade sobre hábitos de outras engines.

## Continue

Consulte [unidades e convencoes](/pt-br/snapshot-2026-10-06/conceitos/unidades-e-convencoes/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Inspector"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/inspector/
---

# Inspector

Leia os dados do objeto e as condições de cada propriedade.

## Como funciona

O Inspector mostra transformações e componentes do objeto selecionado. Propriedades condicionais aparecem de acordo com o estado: uma lente ortográfica e uma perspectiva não exigem os mesmos controles.

## Fluxo de trabalho

Consulte o catálogo para padrões e intervalos. Um campo restrito pode depender de recurso, slot ou autoridade de runtime. Não interprete a ausência de um campo como perda do valor sem conferir sua condição.

## Continue

Consulte [componentes](/pt-br/snapshot-2026-10-06/componentes/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Adicionar componentes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/adicionar-componentes/
---

# Adicionar componentes

Monte um objeto com dependências reais.

## Como funciona

O catálogo de criação é alimentado pelo schema. Procure pelo nome no editor ou pela função. Scripts Behavior e ferramentas especializadas podem ter criação própria e não aparecem necessariamente no Add genérico.

## Fluxo de trabalho

Ao adicionar, confira os componentes exigidos no mesmo objeto. Ao remover, verifique se outro componente ainda depende daquele tipo. O motivo da recusa é parte do contrato.

## Continue

Consulte [dependencias e conflitos](/pt-br/snapshot-2026-10-06/editor/dependencias-e-conflitos/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Dependências e conflitos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/dependencias-e-conflitos/
---

# Dependências e conflitos

Entenda por que uma composição pode ser recusada.

## Como funciona

Uma dependência precisa estar presente para o consumidor funcionar. Um conflito impede dois tipos de coexistirem, por exemplo quando ambos reivindicam a pose. Essas regras são publicadas nas páginas de componentes.

## Fluxo de trabalho

Resolva a cadeia completa de dependências. Remova o dependente antes da dependência quando necessário. Consulte também se a alteração estrutural é permitida durante Play.

## Continue

Consulte [composicao de componentes](/pt-br/snapshot-2026-10-06/conceitos/composicao-de-componentes/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Assets e importação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/assets-e-importacao/
---

# Assets e importação

Recursos importados possuem identidade e dependências.

## Como funciona

Importar envolve interpretar o formato, resolver imagens e materiais, gerar derivados e registrar identidades. Um arquivo aceito pelo importador ainda pode conter recursos sem equivalente no backend.

## Fluxo de trabalho

Preserve os originais. Confira mensagens sobre dependências ausentes, materiais e animações. Reabra o projeto depois de importar e teste a instância na cena real antes de excluir a fonte.

## Continue

Consulte [importacao glb](/pt-br/snapshot-2026-10-06/sistemas/importacao-glb/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Materiais e texturas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/materiais-e-texturas/
---

# Materiais e texturas

Separe o recurso compartilhado dos ajustes por instância.

## Como funciona

Material define a resposta visual e referências de textura. Alterar um recurso compartilhado pode afetar vários objetos; um override por instância deve ser tratado como uma camada diferente.

## Fluxo de trabalho

Observe a mesma superfície sob luz estável. Confira cor linear, rugosidade, metalicidade, emissão, alfa e normal conforme o contrato disponível. Ausência de textura não deve ser confundida com um valor escalar incorreto.

## Continue

Consulte [materiais](/pt-br/snapshot-2026-10-06/sistemas/materiais/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Código e compilação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/codigo-e-compilacao/
---

# Código e compilação

Uma edição só entra em execução depois de compilada e carregada.

## Como funciona

Behaviors C# declaram um identificador estável e callbacks de lifecycle. Compile o projeto, leia o primeiro erro e confira a assinatura na referência desta versão. Não traduza exemplos da Unity por substituição de nomes.

## Fluxo de trabalho

Um script que compila ainda pode depender de objetos ou recursos ausentes. Confira anexação, enabled e diagnóstico da sessão. Use um comportamento mínimo para separar falha de compilação de falha de runtime.

## Continue

Consulte [erros de compilacao](/pt-br/snapshot-2026-10-06/diagnostico/erros-de-compilacao/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Console e diagnóstico"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/console-e-diagnostico/
---

# Console e diagnóstico

Use a mensagem, a fase e o alvo para localizar o problema.

## Como funciona

Uma falha em Awake tem contexto diferente de uma escrita recusada em Update. Registre o texto completo e a operação. WorldStatus distingue referências vencidas, componente ausente, autoridade física e limite de capacidade.

## Fluxo de trabalho

Corrija a primeira causa reproduzível antes de tratar mensagens posteriores. Evite repetir uma operação inválida a cada frame: isso aumenta ruído e custo sem resolver a configuração.

## Continue

Consulte [handle invalido](/pt-br/snapshot-2026-10-06/diagnostico/handle-invalido/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Undo e Redo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/undo-e-redo/
---

# Undo e Redo

Revise alterações autorais por transação.

## Como funciona

Uma operação de autoria pode mudar vários valores relacionados. Undo e Redo trabalham sobre o histórico do editor; não são uma máquina do tempo para toda a simulação de Play.

## Fluxo de trabalho

Após um arraste, use Undo uma vez e observe o que foi restaurado. Salvar e desfazer têm propósitos diferentes. Para operações de importação e mudanças de formato, mantenha uma cópia adicional.

## Continue

Consulte [salvar e reabrir](/pt-br/snapshot-2026-10-06/comece/salvar-e-reabrir/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Busca global"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/busca-global/
---

# Busca global

Encontre a informação usando o vocabulário do editor ou da API.

## Como funciona

Neste portal, Ctrl/Cmd+K abre a busca de documentação. Ela indexa o conteúdo publicado deste snapshot, incluindo nomes de componentes, tipos e membros. Escape fecha a busca.

## Fluxo de trabalho

No catálogo, combine texto e família; o filtro fica na URL para poder compartilhar a consulta. Uma busca sem resultado não comprova ausência de capacidade na engine: confira a cobertura editorial. Os atalhos do portal não são atalhos do editor.

## Continue

Consulte [indice markdown](/pt-br/snapshot-2026-10-06/ia/indice-markdown/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Atalhos e gestos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/atalhos-e-gestos/
---

# Atalhos e gestos

Distinga os comandos do portal dos gestos do editor.

## Como funciona

No portal, Tab percorre links e controles, Ctrl/Cmd+K abre a busca e Escape fecha o diálogo. O menu de navegação fica recolhido em telas estreitas. Código possui ação de cópia.

## Fluxo de trabalho

No editor, a interpretação do toque depende da ferramenta ativa e da superfície com foco. Teclado, modal e manipulação podem capturar input que iria ao jogo. Esta página não publica um mapa de gestos não verificado para cada versão.

## Continue

Consulte [input e acoes](/pt-br/snapshot-2026-10-06/sistemas/input-e-acoes/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Preferências"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/preferencias/
---

# Preferências

Ajustes de leitura e políticas da cena têm escopos distintos.

## Como funciona

O tema claro/escuro deste portal pode ser escolhido no controle de tema e acompanha sua preferência local. Isso não altera o tema, a qualidade ou o estado do editor Astra.

## Fluxo de trabalho

Na engine, confira se um ajuste pertence ao aplicativo, projeto, cena ou sessão de Play antes de esperar que ele acompanhe uma exportação. Para investigar custo gráfico, registre os valores efetivos de qualidade e resolução.

## Continue

Consulte [qualidade e resolucao](/pt-br/snapshot-2026-10-06/desempenho/qualidade-e-resolucao/). A descrição é baseada no contrato atual; capturas e aceite físico de cada fluxo não foram produzidos nesta publicação.


---

---
title: "Objetos e identidade"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/objetos-e-identidade/
---

# Objetos e identidade

Objetos são referências a uma cena e a uma sessão.

## Contrato

Um GameObject não é somente um nome: a identidade inclui o mundo e a geração que permitem detectar referências vencidas. Renomear não deve ser usado como mecanismo para invalidar handles.

## Aplicação prática

Use IsAlive/IsValid quando precisar verificar uma referência conservada. Uma busca por nome pode ser ambígua; mantenha referências explícitas para relações importantes.

## Referência

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Composição de componentes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/composicao-de-componentes/
---

# Composição de componentes

O objeto reúne capacidades com regras compartilhadas.

## Contrato

Componentes acrescentam dados e comportamento. O registro define identidade persistente, propriedades, requisitos, conflitos, multiplicidade e mutabilidade em Play.

## Aplicação prática

Adicionar por API não elimina as regras do editor. Uma composição inválida deve ser corrigida; não ignore WorldStatus.ComponentUnavailable ou ComponentInUse.

## Referência

Consulte [Component](/pt-br/snapshot-2026-10-06/api/astra-component/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Handles e lifetime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/handles-e-lifetime/
---

# Handles e lifetime

Uma referência só vale enquanto o seu proprietário existir.

## Contrato

Destruir um objeto ou encerrar Play invalida referências. Uma referência de outra sessão não deve ser reaproveitada mesmo quando o nome ou o número do objeto parecem iguais.

## Aplicação prática

StaleHandle indica uma referência vencida; ForeignWorld indica outra execução. Resolva o alvo novamente no lifecycle adequado e cancele trabalho que sobreviveria ao dono.

## Referência

Consulte [WorldStatus](/pt-br/snapshot-2026-10-06/api/astra-worldstatus/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Cenas e recursos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/cenas-e-recursos/
---

# Cenas e recursos

A cena instancia relações; os recursos possuem identidade própria.

## Contrato

Geometria, texturas, scripts, áudio e cenas podem ser recursos referenciados. A identidade de um recurso não é necessariamente o caminho mostrado no navegador de arquivos.

## Aplicação prática

Verifique dependências e tipos ao atribuir recursos. ResourceTypeMismatch e UnknownResource pedem correção da referência, não uma tentativa de interpretar qualquer arquivo como outro tipo.

## Referência

Consulte [AssetGuid](/pt-br/snapshot-2026-10-06/api/astra-assetguid/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Espaço local e mundo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/espaco-local-e-mundo/
---

# Espaço local e mundo

Escolha o referencial antes de somar um deslocamento ou rotação.

## Contrato

Local interpreta a operação na orientação do objeto; World usa o referencial global. Hierarquia e escala do pai afetam a relação entre esses espaços.

## Aplicação prática

TransformPoint inclui translação; TransformDirection trata direção; TransformVector também considera a transformação vetorial. Não substitua um pelo outro só porque todos retornam Vector3.

## Referência

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Unidades e convenções"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/unidades-e-convencoes/
---

# Unidades e convenções

Confira a unidade no contrato de cada campo.

## Contrato

GameObject.Rotate recebe radianos. O campo vertical_fov da câmera declara graus. Campos de distância podem declarar metros, tempo usa segundos e cores podem estar em RGB linear.

## Aplicação prática

Converta graus para radianos com graus * PI / 180. Ao integrar uma velocidade, multiplique por deltaTime uma vez. Não extrapole a unidade de uma API para todas as propriedades do Inspector.

## Referência

Consulte [TransformSpace](/pt-br/snapshot-2026-10-06/api/astra-transformspace/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Lifecycle de Behavior"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/lifecycle-de-behavior/
---

# Lifecycle de Behavior

Use a fase adequada para inicializar, atualizar e liberar.

## Contrato

Behavior expõe Awake, Enable, Start, Update, FixedUpdate, LateUpdate, Disable, Stop e Destroy, além de eventos especializados. Nem todas as fases têm o mesmo propósito ou frequência.

## Aplicação prática

Inicialize referências na fase de criação apropriada. Use o intervalo recebido pelo callback de atualização. Libere inscrições e trabalho associado ao dono ao encerrar; não mantenha handles de Play antigo.

## Referência

Consulte [Behavior](/pt-br/snapshot-2026-10-06/api/astra-behavior/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Play e cena autoral"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/
---

# Play e cena autoral

Estado de execução e dados de autoria são domínios separados.

## Contrato

O mundo de Play pode criar objetos e trocar cenas sem substituir o documento autoral. Scenes.Load solicita a troca no fim do quadro; a cena editada volta ao parar o Play.

## Aplicação prática

Não use escrita em Transform como mecanismo de gravação de progresso. Use a autoria para salvar cenas e SaveStore para persistência de gameplay.

## Referência

Consulte [ScenesAccess](/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Tempo e atualização"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/tempo-e-atualizacao/
---

# Tempo e atualização

Escolha entre tempo de simulação, tempo não escalado e passo fixo.

## Contrato

TimeAccess pertence à sessão e à thread de despacho. Scale aceita valores finitos entre 0 e 4; zero congela a simulação e a nova escala tem efeito no próximo quadro.

## Aplicação prática

Para uma animação independente de pausa, confira o relógio não escalado. Para física, respeite o passo apropriado. Não reutilize TimeAccess depois de encerrar Play.

## Referência

Consulte [TimeAccess](/pt-br/snapshot-2026-10-06/api/astra-timeaccess/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Thread e ponto seguro"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/thread-e-ponto-seguro/
---

# Thread e ponto seguro

Agendamento não concede acesso concorrente ao mundo.

## Contrato

Operações estruturais podem ser aceitas e aplicadas entre passos. Uma Task comum em outra thread não torna o acesso à cena seguro. APIs da sessão podem exigir a thread de despacho.

## Aplicação prática

Use os mecanismos de corrotina e awaitable oferecidos pela engine. Observe cancelamento, término da sessão e resultado das operações rastreadas.

## Referência

Consulte [BehaviorAwaitables](/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitables/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Autoridade de transformação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/autoridade-de-transformacao/
---

# Autoridade de transformação

Escolha um responsável para publicar a pose do objeto.

## Contrato

Scripts, física, personagens, caminhos e restrições podem disputar a transformação. Um corpo simulado não deve ser movimentado como um objeto puramente visual sem respeitar sua autoridade.

## Aplicação prática

TransformOwnedByPhysics é uma recusa explícita. Use força, impulso ou movimento cinemático conforme o corpo. Remover a física só para ocultar o erro muda o comportamento do jogo.

## Referência

Consulte [PhysicsBodyRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsbodyruntime/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Serialização e migração"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/serializacao-e-migracao/
---

# Serialização e migração

Persistência depende de identidade, formato e recursos compatíveis.

## Contrato

O componente possui typeId e versão de payload. A cena precisa preservar relações e referências, não apenas números do Inspector. Leitura bem-sucedida não comprova que todos os recursos externos continuam disponíveis.

## Aplicação prática

Preserve uma cópia anterior à migração. Reabra, confira objetos e propriedades e execute um cenário pequeno. Versão desconhecida não deve ser tratada como arquivo vazio.

## Referência

Consulte [ComponentIds](/pt-br/snapshot-2026-10-06/api/astra-componentids/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Limites e capacidades"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/conceitos/limites-e-capacidades/
---

# Limites e capacidades

Diferencie contrato, backend, política e aparelho.

## Contrato

Uma propriedade pode ter consumidor no código e ainda depender do dispositivo ou da política de qualidade. Um item pesquisado no atlas não equivale a capacidade implementada.

## Aplicação prática

Consulte os limites de cada componente e registre a configuração efetiva. Não transforme uma medição pontual em promessa de desempenho para todos os aparelhos.

## Referência

Consulte [WorldStatus](/pt-br/snapshot-2026-10-06/api/astra-worldstatus/). O contrato de fonte e a execução em um dispositivo são evidências diferentes.


---

---
title: "Input e ações"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/input-e-acoes/
---

# Input e ações

O projeto define as ações; o comportamento consome seus valores.

## Como o sistema se conecta

InputAccess consulta ações por nome e por papéis. Axis, Axis2, Pressed, JustPressed e JustReleased atendem leituras diferentes. Verifique Exists antes de depender de uma ação opcional.

## Configuração e cuidados

Configure vínculos e contexto, confirme o foco do gameplay e só então leia o valor. O editor pode capturar a entrada durante IDE, teclado, modal e gizmo. Rebinding e política de habilitação em runtime não são automaticamente alterações autorais.

## API e composição

Consulte [InputAccess](/pt-br/snapshot-2026-10-06/api/astra-inputaccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Câmeras"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/cameras/
---

# Câmeras

Projeção, controle de olhar e acompanhamento são contratos separados.

## Como o sistema se conecta

Camera define a lente e o enquadramento. CameraLook recebe controle de orientação. CameraFollow publica posição após física e animação e exige uma câmera no mesmo objeto.

## Configuração e cuidados

Comece por uma Camera estática. Verifique planos próximo/distante e projeção. Depois adicione acompanhamento, alvo, offset e amortecimento. Não combine a câmera seguidora com outra autoridade física de pose.

## API e composição

Consulte [CameraFollowRig](/pt-br/snapshot-2026-10-06/api/astra-camerafollowrig/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Renderização"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/renderizacao/
---

# Renderização

A imagem depende de cena, recursos, câmera e política gráfica.

## Como o sistema se conecta

Uma malha precisa de recurso válido e material; a câmera determina o enquadramento e o backend resolve as capacidades. Recursos importados e configurações autorais passam por etapas diferentes antes do desenho.

## Configuração e cuidados

Ao investigar ausência visual, reduza a cena a uma malha, um material e uma câmera. Registre a configuração efetiva e não atribua um artefato à GPU antes de verificar referências, visibilidade e escala.

## API e composição

Consulte [GameViewAccess](/pt-br/snapshot-2026-10-06/api/astra-gameviewaccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Iluminação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/iluminacao/
---

# Iluminação

Luzes e ambiente têm unidades e consumidores específicos.

## Como o sistema se conecta

O componente Light declara tipo, cor, intensidade e alcance, além de propriedades condicionais. A unidade depende do modo selecionado; uma escala legada e uma unidade fotométrica não são intercambiáveis.

## Configuração e cuidados

Aumentar intensidade não resolve uma luz fora do alcance, descartada pelo orçamento ou sem suporte à sombra desejada. Confira a página do componente e a política efetiva. Faça comparações com exposição e câmera fixas.

## API e composição

Consulte [Components.Light](/pt-br/snapshot-2026-10-06/api/astra-components-light/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Materiais"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/materiais/
---

# Materiais

Use parâmetros e recursos compatíveis com o material ativo.

## Como o sistema se conecta

MaterialSlot representa o acesso ao material de um slot. Malhas com vários materiais precisam do slot correto. Texturas, valores escalares, alfa e projeção UV afetam etapas diferentes do resultado.

## Configuração e cuidados

Mude um parâmetro por vez. Confirme que uma textura de normal não está sendo tratada como cor e que a emissão é avaliada com exposição consistente. Evite editar todos os slots quando a intenção é alterar apenas uma superfície.

## API e composição

Consulte [MaterialSlot](/pt-br/snapshot-2026-10-06/api/astra-materialslot/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Importação GLB"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/importacao-glb/
---

# Importação GLB

Preserve a fonte e examine o que foi realmente importado.

## Como o sistema se conecta

GLB pode carregar geometria, materiais, texturas, hierarquia e animação. A presença dessas informações no arquivo não prova que todas as extensões ou comportamentos são executados pelo importador atual.

## Configuração e cuidados

Confira recursos ausentes e avisos de importação. Abra a cena, revise escala, materiais e hierarquia e reabra o projeto. Dados preservados, fidelidade visual e comportamento executável devem ser avaliados separadamente.

## API e composição

Consulte [AssetGuid](/pt-br/snapshot-2026-10-06/api/astra-assetguid/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Física 3D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/fisica-3d/
---

# Física 3D

Corpos, colisores, consultas e eventos formam um sistema.

## Como o sistema se conecta

Collider define participação geométrica; PhysicsBody define o corpo e a autoridade da simulação. PhysicsAccess oferece consultas. Um MeshRenderer visível não substitui um collider.

## Configuração e cuidados

Confira tipo de corpo, massa, camada, máscara e estado ativo. Use impulso ou força conforme o efeito desejado. Para consultar colisões, observe filtros e truncamento de resultados.

## API e composição

Consulte [PhysicsAccess](/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Física 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/fisica-2d/
---

# Física 2D

Trate a simulação 2D como um contrato próprio.

## Como o sistema se conecta

Body2D, Collider2D, Joint2D e campos 2D compõem a família de física 2D. A referência mantém seus tipos separados da física 3D para evitar mistura de coordenadas e propriedades.

## Configuração e cuidados

Consulte a fachada e o schema do componente 2D escolhido. Não use uma consulta 3D esperando encontrar um corpo apenas porque ele aparece na tela. Valide a composição e os filtros do mundo correto.

## API e composição

Consulte [Physics2DAccess](/pt-br/snapshot-2026-10-06/api/astra-physics2daccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Personagem"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/personagem/
---

# Personagem

Movimento de personagem tem autoridade e estado próprios.

## Como o sistema se conecta

O controlador de personagem recebe intenção de movimento e publica o resultado de contato com o mundo. GameObject expõe MoveCharacter, TryJumpCharacter e ReadCharacterState.

## Configuração e cuidados

Passe orientação em radianos onde o contrato pede yawRadians. Verifique estado de apoio e retorno da tentativa de salto. Não some deslocamento visual por fora enquanto o controlador escreve a pose.

## API e composição

Consulte [CharacterRuntimeState](/pt-br/snapshot-2026-10-06/api/astra-characterruntimestate/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Juntas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/juntas/
---

# Juntas

Uma relação física precisa de corpos e referenciais coerentes.

## Como o sistema se conecta

Juntas restringem movimento entre corpos. Âncoras, eixos e limites têm significado no referencial declarado. A família 2D usa seu próprio componente.

## Configuração e cuidados

Antes de ajustar rigidez ou limites, confira os corpos ligados, suas poses e a existência de uma configuração que satisfaça a restrição. Uma junta tentando corrigir uma montagem impossível pode produzir instabilidade.

## API e composição

Consulte [Components.Joint](/pt-br/snapshot-2026-10-06/api/astra-components-joint/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Campos físicos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/campos-fisicos/
---

# Campos físicos

Aplique influência espacial sem esconder os alvos e limites.

## Como o sistema se conecta

Gravidade, vento, arrasto e campo radial possuem componentes próprios em 3D e 2D. A configuração define influência e consumo no sistema físico correspondente.

## Configuração e cuidados

Confira quais corpos estão dentro do campo, suas camadas e o espaço dos vetores. Comece com um corpo isolado e uma intensidade pequena para distinguir influência do campo da gravidade global.

## API e composição

Consulte [PhysicsFieldRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsfieldruntime/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Animação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/animacao/
---

# Animação

Um clipe válido também precisa pertencer ao componente.

## Como o sistema se conecta

AnimationPlayer controla a reprodução no componente Animation. A lista de clips e o clip padrão são referências a recursos; uma identidade existente fora dessa lista pode produzir ClipNotInComponent.

## Configuração e cuidados

Confira importação, vínculo do clip e alvo antes de ajustar velocidade ou mistura. Para malhas deformáveis, confirme esqueleto e qualidade de skinning; tocar uma animação não cria ossos ausentes.

## API e composição

Consulte [AnimationPlayer](/pt-br/snapshot-2026-10-06/api/astra-animationplayer/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Áudio"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/audio/
---

# Áudio

Controle reprodução e lifetime de uma voz.

## Como o sistema se conecta

AudioVoice expõe Play, Pause, Resume, Stop, Seek e Snapshot. O componente e o recurso de áudio precisam continuar válidos durante o uso. Audio Listener e Audio Bus fazem parte da composição.

## Configuração e cuidados

Confirme o clip, ganho, bus e listener. Observe Snapshot antes de culpar o arquivo; pausa, término e estado inválido são situações diferentes. Esta referência não constitui teste de saída de áudio em aparelho.

## API e composição

Consulte [AudioVoice](/pt-br/snapshot-2026-10-06/api/astra-audiovoice/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "UI de jogo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/ui-de-jogo/
---

# UI de jogo

Canvas, elementos, foco e eventos participam do mesmo fluxo.

## Como o sistema se conecta

GuiAccess encontra e cria elementos e permite selecionar um canvas. GuiElement expõe layout, estilo, ações, texto e estado de interação. Poll entrega eventos que precisam ser interpretados pelo tipo.

## Configuração e cuidados

Em cenas com vários canvases, use o proprietário e a instância corretos. Confirme enabled, ordem, foco e captura. Um botão visível pode estar coberto por outra superfície que recebe a entrada.

## API e composição

Consulte [GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Curvas e caminhos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/curvas-e-caminhos/
---

# Curvas e caminhos

Separe o recurso geométrico do objeto que o percorre.

## Como o sistema se conecta

O componente Path contém o caminho; PathFollow consome uma referência para publicar movimento. CurvePath e PathFollower oferecem operações especializadas.

## Configuração e cuidados

Configure um caminho com pontos válidos, vincule o seguidor e confira espaço, orientação e política de término. Não combine outro escritor de transformação sem definir a autoridade.

## API e composição

Consulte [CurvePath](/pt-br/snapshot-2026-10-06/api/astra-curvepath/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Timers"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/timers/
---

# Timers

Agende comportamento com duração e dono explícitos.

## Como o sistema se conecta

O componente Timer tem uma fachada gerada chamada GameTimer. Behavior.TimerElapsed recebe o identificador da instância e a contagem de expirações acumuladas no quadro.

## Configuração e cuidados

Distinga timers por instância. Um quadro longo pode entregar mais de uma expiração. Não suponha que o callback seja chamado uma vez para cada tick; use o parâmetro count.

## API e composição

Consulte [Components.GameTimer](/pt-br/snapshot-2026-10-06/api/astra-components-gametimer/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Tweens"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/tweens/
---

# Tweens

Uma transição precisa de uma propriedade elegível e um dono.

## Como o sistema se conecta

NumberTween representa uma operação numérica que pode pausar, retomar, cancelar e ser descartada. O schema identifica campos tweenable; nem todo número aceita a operação.

## Configuração e cuidados

PropertyNotTweenable, PropertyAlreadyTweening e PropertyWrittenExternally distinguem inelegibilidade e disputa de escrita. Resolva o escritor concorrente antes de reiniciar continuamente a transição.

## API e composição

Consulte [NumberTween](/pt-br/snapshot-2026-10-06/api/astra-numbertween/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Corrotinas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/corrotinas/
---

# Corrotinas

Divida trabalho em etapas ligadas ao lifecycle.

## Como o sistema se conecta

Behavior oferece StartCoroutine e StartAsync. Coroutine informa estado, falha e se o trabalho permanece ativo. BehaviorAwaitables fornece os pontos de espera da engine.

## Configuração e cuidados

Associe a tarefa ao Behavior e respeite cancelamento. Uma Task arbitrária não autoriza acessar o mundo em outra thread. Pare ou libere trabalho que não faz sentido após remover o objeto.

## API e composição

Consulte [BehaviorAwaitables](/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitables/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Troca de cena"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/troca-de-cena/
---

# Troca de cena

Escolha entre substituir o mundo e acrescentar uma cena.

## Como o sistema se conecta

Scenes.Load pede substituição no fim do quadro. Scenes.LoadAdditive acrescenta conteúdo sob um contêiner e pode receber um pai. Names lista as cenas do projeto.

## Configuração e cuidados

Use um nome existente e não conserve referências ao mundo substituído. A troca chama lifecycle dos comportamentos; não confunda o mundo novo com o documento autoral que volta ao parar.

## API e composição

Consulte [ScenesAccess](/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Persistência"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/persistencia/
---

# Persistência

Grave progresso em um namespace pertencente ao projeto.

## Como o sistema se conecta

SaveStore oferece chaves tipadas e arquivos. Alterações de chaves são confirmadas por Flush; arquivos independentes são confirmados imediatamente. O contrato possui cotas de tamanho.

## Configuração e cuidados

Use chaves estáveis, valores de fallback para ausência e um tipo consistente por chave. Leitura com tipo diferente é erro, não conversão automática. Preserve a possibilidade de recuperação e não escreva fora dos caminhos permitidos.

## API e composição

Consulte [SaveStore](/pt-br/snapshot-2026-10-06/api/astra-savestore/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Aleatoriedade"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/sistemas/aleatoriedade/
---

# Aleatoriedade

Use um fluxo explícito para repetir uma sequência local.

## Como o sistema se conecta

RandomStream recebe seed e stream e fornece inteiros, valores, distribuições e amostras geométricas. Capture e Restore conservam o estado do fluxo.

## Configuração e cuidados

Range usa limite superior exclusivo. A mesma seed só é comparável com a mesma versão do algoritmo e a mesma ordem de chamadas. Isso não prova determinismo de toda a física ou do jogo entre plataformas.

## API e composição

Consulte [RandomStream](/pt-br/snapshot-2026-10-06/api/astra-randomstream/) e o [catálogo de componentes](/pt-br/snapshot-2026-10-06/componentes/) para assinaturas e propriedades. O suporte em um aparelho deve ser conferido com os recursos e a versão efetivamente instalados.


---

---
title: "Erros de compilação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/erros-de-compilacao/
---

# Erros de compilação

O script não compila ou o Behavior não fica disponível.

## Causas a conferir

Assinatura de outra engine; namespace incorreto; tipo renomeado; identificador duplicado; dependência de script ausente.

## Investigar

Leia o primeiro erro com arquivo e linha. Compare a assinatura com esta API. Reduza o script a um Behavior com Update vazio e reintroduza as chamadas até localizar a incompatibilidade.

## Confirmar a correção

Uma compilação sem erros permite passar à verificação de anexação e lifecycle; ainda não comprova comportamento de gameplay.

## Contrato relacionado

[Behavior](/pt-br/snapshot-2026-10-06/api/astra-behavior/)


---

---
title: "Componente indisponível"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/componente-indisponivel/
---

# Componente indisponível

O Add ou a API recusa a composição.

## Causas a conferir

Dependência ausente, conflito, segunda instância de um tipo único, tipo não registrado ou mudança estrutural proibida em Play.

## Investigar

Abra a ficha do componente. Confira requirements, conflicts, multiplicidade e mutabilidade. Interprete ComponentUnavailable, ComponentMissing e ComponentInUse como causas distintas.

## Confirmar a correção

A composição deve ser aceita com todas as dependências presentes e sem conflito.

## Contrato relacionado

[Component](/pt-br/snapshot-2026-10-06/api/astra-component/)


---

---
title: "Handle inválido"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/handle-invalido/
---

# Handle inválido

Uma operação aponta para objeto removido ou outra sessão.

## Causas a conferir

O alvo foi destruído, o Play foi reiniciado, a cena foi trocada ou uma tarefa conservou referência além do lifetime do dono.

## Investigar

Confira IsAlive e a origem da referência. Refaça a resolução na sessão atual. Cancele callbacks que sobreviveriam ao objeto. Não suprima StaleHandle ou ForeignWorld em um loop por frame.

## Confirmar a correção

O acesso deve usar o alvo da sessão atual sem reutilizar o handle antigo.

## Contrato relacionado

[WorldStatus](/pt-br/snapshot-2026-10-06/api/astra-worldstatus/)


---

---
title: "Objeto não se move"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/objeto-nao-se-move/
---

# Objeto não se move

Uma transformação não produz o efeito esperado.

## Causas a conferir

Behavior desabilitado; objeto inativo; delta zero; câmera não enquadra o alvo; escrita posterior por outro sistema; autoridade física.

## Investigar

Comece sem física em um objeto visual. Verifique o callback e a unidade. Observe TransformOwnedByPhysics e o escritor responsável pela pose. Para corpos, use a API física adequada.

## Confirmar a correção

Uma mudança isolada deve aparecer na pose e na câmera usada em Play.

## Contrato relacionado

[GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/)


---

---
title: "Câmera sem imagem"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/camera-sem-imagem/
---

# Câmera sem imagem

A cena aparece no editor, mas o Play não enquadra conteúdo.

## Causas a conferir

Câmera ativa diferente da esperada, orientação, near/far, escala, recurso ausente ou estado de visibilidade.

## Investigar

Use uma cena pequena com geometria conhecida. Confira pose da câmera de jogo, projeção e planos de recorte. Compare a câmera selecionada com a usada no mundo de Play.

## Confirmar a correção

O mesmo objeto de referência deve aparecer de forma estável no enquadramento do jogo.

## Contrato relacionado

[GameViewAccess](/pt-br/snapshot-2026-10-06/api/astra-gameviewaccess/)


---

---
title: "Colisão ausente"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/colisao-ausente/
---

# Colisão ausente

Objetos atravessam a geometria ou a consulta não encontra o alvo.

## Causas a conferir

Há malha visual sem colisor; camada/máscara exclui o par; mistura de física 2D/3D; corpo inativo; geometria inadequada.

## Investigar

Confira a composição, o tipo de corpo e os filtros. Use formas simples e movimento moderado para isolar configuração de problemas de velocidade ou geometria.

## Confirmar a correção

A configuração mínima deve produzir contato ou hit antes de reintroduzir a geometria complexa.

## Contrato relacionado

[PhysicsAccess](/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/)


---

---
title: "Input sem resposta"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/input-sem-resposta/
---

# Input sem resposta

A ação existe no código, mas não responde ao controle.

## Causas a conferir

Nome de ação diferente, vínculo ausente, contexto desabilitado, grupo de dispositivo excluído ou foco capturado pelo editor.

## Investigar

Consulte Exists e ActionState. Feche modal/teclado, devolva foco ao gameplay e confira os vínculos do projeto. Verifique Pressed versus JustPressed conforme a mecânica.

## Confirmar a correção

A fase e o valor devem mudar ao pressionar e voltar ao estado esperado ao soltar.

## Contrato relacionado

[InputAccess](/pt-br/snapshot-2026-10-06/api/astra-inputaccess/)


---

---
title: "Asset não encontrado"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/asset-nao-encontrado/
---

# Asset não encontrado

Um componente referencia um recurso que não pode ser resolvido.

## Causas a conferir

Identidade não registrada, arquivo movido, dependência externa ausente, importação incompleta ou tipo de recurso incompatível.

## Investigar

Confira o registro e o resultado da importação. Preserve a fonte e a mensagem. Diferencie UnknownResource de ResourceTypeMismatch; não atribua um GUID arbitrário para ocultar o erro.

## Confirmar a correção

O recurso deve resolver, aparecer na cena e continuar resolvendo após reabrir o projeto.

## Contrato relacionado

[AssetGuid](/pt-br/snapshot-2026-10-06/api/astra-assetguid/)


---

---
title: "Cena não reabre"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/cena-nao-reabre/
---

# Cena não reabre

A leitura do projeto falha ou os dados não correspondem ao salvo.

## Causas a conferir

Formato incompatível, arquivo incompleto, referência de recurso ausente ou tentativa de abrir conteúdo de outra geração.

## Investigar

Faça uma cópia do arquivo antes de agir. Registre versão e mensagem de leitura. Confira backups e recursos. Não salve uma cena vazia sobre o único arquivo com falha.

## Confirmar a correção

Reabra uma cópia recuperada e verifique objetos, propriedades e recursos antes de substituir a original.

## Contrato relacionado

[ScenesAccess](/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/)


---

---
title: "Play não inicia"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/play-nao-inicia/
---

# Play não inicia

A sessão de runtime não chega a executar o cenário.

## Causas a conferir

Compilação inválida, script ausente, recurso necessário não resolvido ou falha durante inicialização de um comportamento.

## Investigar

Confira diagnóstico de compilação e lifecycle. Tente uma cena mínima sem o último componente adicionado. Identifique a primeira falha em Awake/Start em vez de seguir erros em cascata.

## Confirmar a correção

A sessão deve iniciar, atualizar e encerrar sem referências conservadas da execução anterior.

## Contrato relacionado

[Behavior](/pt-br/snapshot-2026-10-06/api/astra-behavior/)


---

---
title: "UI sem evento"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/ui-sem-evento/
---

# UI sem evento

Um controle visível não entrega a interação esperada.

## Causas a conferir

Canvas errado, elemento desabilitado, sobreposição capturando input, foco, nome diferente ou fila de eventos não consumida.

## Investigar

Selecione explicitamente o canvas correto. Confira o elemento com TryFind, seu estado e interação. Consuma Poll e compare o Kind do evento.

## Confirmar a correção

Pressionar e soltar deve produzir o evento correto sem ativar elementos que estejam atrás.

## Contrato relacionado

[GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/)


---

---
title: "Áudio sem reprodução"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/diagnostico/audio-sem-reproducao/
---

# Áudio sem reprodução

Uma voz não produz som audível.

## Causas a conferir

Clip ausente, voz parada/pausada, ganho baixo, bus silenciado, listener ou lifetime inválido.

## Investigar

Leia Snapshot e confira o recurso. Teste uma voz com configuração simples e volume conhecido. Verifique o áudio do dispositivo antes de alterar a cena inteira.

## Confirmar a correção

Play, Pause, Resume e Stop devem refletir no estado e na saída observada.

## Contrato relacionado

[AudioVoice](/pt-br/snapshot-2026-10-06/api/astra-audiovoice/)


---

---
title: "Como medir"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/como-medir/
---

# Como medir

Construa uma comparação reproduzível.

## O que observar

Registre build, aparelho/GPU, cena, resolução, qualidade, duração, aquecimento e condições térmicas. Diferencie Debug com validação de uma build de desempenho.

## Método de comparação

Compare o mesmo percurso e a mesma câmera. Guarde tempos de CPU/GPU e distribuição de frames, não apenas um FPS instantâneo. Metas de 60/120 FPS não são resultados medidos.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "CPU e atualização"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/cpu-e-atualizacao/
---

# CPU e atualização

Descubra em qual etapa o quadro gasta tempo.

## O que observar

Scripts, transformações, física, culling e submissão têm custos diferentes. Uma espera pela GPU pode aparecer como tempo de CPU sem significar trabalho útil do processador.

## Método de comparação

Reduza uma carga de cada vez e compare o perfil. Evite procurar objetos por nome repetidamente em Update quando uma referência válida pode ser conservada durante a sessão.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "GPU e draw calls"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/gpu-e-draw-calls/
---

# GPU e draw calls

Mais FPS exige localizar o custo dominante.

## O que observar

Draw calls são apenas uma dimensão: pixels, sombras, transparência, largura de banda e complexidade do shader também consomem GPU. Diminuir chamadas não garante ganho se o gargalo estiver em outro estágio.

## Método de comparação

Compare a mesma imagem e configuração. Se reduzir resolução melhora muito o tempo de GPU, investigue custo por pixel. Registre qualquer mudança visual junto da medição.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Texturas e memória"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/texturas-e-memoria/
---

# Texturas e memória

Considere o tamanho residente, não apenas o arquivo comprimido.

## O que observar

Dimensões, formato, mipmaps e número de recursos simultâneos influenciam memória e bandwidth. Um arquivo pequeno no disco pode resultar em uma imagem grande na GPU.

## Método de comparação

Revise materiais e texturas repetidas. Compare qualidade em distâncias reais de câmera. Não remova mipmaps ou diminua resolução sem verificar estabilidade visual e aliasing.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Alocações C#"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/alocacoes-c/
---

# Alocações C#

Evite criar lixo continuamente nos caminhos por frame.

## O que observar

Coleções temporárias, strings e materialização de consultas podem gerar pressão no coletor. Algumas APIs retornam arrays ou listas; confira a assinatura e a frequência de uso.

## Método de comparação

Conserve referências enquanto forem válidas e faça consultas caras na frequência necessária. Não transforme otimizações locais em estado global que sobreviva indevidamente ao Play.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Física e queries"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/fisica-e-queries/
---

# Física e queries

Meça corpos ativos e consultas como cargas separadas.

## O que observar

A quantidade de pares, formas, contatos e passos influencia a simulação. RayCastAll e Overlap também dependem da capacidade solicitada e podem indicar truncamento.

## Método de comparação

Use filtros compatíveis com a necessidade da mecânica. Observe truncated e não interprete uma lista limitada como todos os objetos do mundo. Compare o custo mantendo a mesma cena.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Carga de cenas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/carga-de-cenas/
---

# Carga de cenas

Separe I/O, importação, criação e publicação.

## O que observar

Abrir uma cena pode envolver leitura, resolução de recursos, derivados e criação de objetos. Medir só o clique até a primeira imagem não explica qual etapa causa a espera.

## Método de comparação

Compare primeira abertura e reabertura com cache. Registre recursos e tamanho. Não declare ganho se a versão rápida apenas deixou de carregar parte do conteúdo.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Térmica e bateria"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/termica-e-bateria/
---

# Térmica e bateria

Desempenho sustentado exige uma janela de observação.

## O que observar

A frequência e o custo podem mudar com aquecimento, energia, brilho e limite de frames. Temperatura de bateria isolada não determina a temperatura ou throttling do SoC.

## Método de comparação

Use build e condições comparáveis, warmup e duração registrada. Anote queda ao longo do tempo e preserve o mesmo cenário. Um pico de FPS não comprova estabilidade térmica.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Qualidade e resolução"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/qualidade-e-resolucao/
---

# Qualidade e resolução

Publique a configuração efetiva junto de qualquer métrica.

## O que observar

Resolução dinâmica, sombras, luzes, materiais e efeitos alteram custo e imagem. Dois números de FPS não são comparáveis se uma execução reduziu a resolução sem registrar isso.

## Método de comparação

Fixe ou registre a escala real. Capture a mesma câmera para comparar perda visual. Distinga opção autoral, política solicitada e capacidade resolvida pelo backend.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Orçamentos por aparelho"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/desempenho/orcamentos-por-aparelho/
---

# Orçamentos por aparelho

Trate cada perfil como evidência específica.

## O que observar

Um orçamento depende de GPU, driver, resolução, cenário, energia e temperatura. Não transfira a medição de um aparelho para todos os modelos com uma classificação comercial parecida.

## Método de comparação

Defina uma cena representativa e acompanhe média, p95/p99 e estabilidade. Este portal não publica uma tabela universal de desempenho nem promete uma taxa de frames sem ensaio correspondente.

## Registro mínimo

Guarde versão, configuração, cena e resultado junto da evidência. Ensaios de host, build Android, instalação e execução física são etapas distintas.


---

---
title: "Girar um objeto"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/
---

# Girar um objeto

Integre velocidade angular com o delta da atualização.

## Composição da cena

Objeto visual sem corpo ou personagem escrevendo sua pose; câmera enquadrada.

## Implementação

```csharp
using Astra;
using System.Numerics;

[ComponentId("docs.rotate-object")]
public sealed class RotateObject : Behavior
{
    public override void Update(float deltaTime)
    {
        Object.Rotate(Vector3.UnitY, 0.5f * deltaTime,
                      TransformSpace.Local);
    }
}
```

## Resultado esperado

Rotação local contínua a 0,5 rad/s.

## Cuidados

Use radianos e multiplique por deltaTime uma única vez. Uma esfera sem detalhes pode esconder visualmente a rotação.

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Mover em espaço local"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/
---

# Mover em espaço local

Mova na direção do objeto, mesmo quando ele está rotacionado.

## Composição da cena

Objeto visual com orientação diferente da identidade, sem física comandando a pose.

## Implementação

```csharp
using Astra;
using System.Numerics;

[ComponentId("docs.move-local")]
public sealed class MoveLocal : Behavior
{
    public override void Update(float deltaTime)
    {
        Object.Translate(Vector3.UnitZ * deltaTime,
                         TransformSpace.Local);
    }
}
```

## Resultado esperado

O objeto percorre seu eixo Z local; rotacioná-lo muda a direção do movimento.

## Cuidados

Compare com TransformSpace.World mantendo a mesma rotação. Não use este exemplo como motor de personagem físico.

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Criar e remover objetos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/criar-e-remover-objetos/
---

# Criar e remover objetos

Associe criação e lifetime a uma intenção de gameplay.

## Composição da cena

Objeto com Behavior e câmera capaz de ver sua posição.

## Implementação

```csharp
using Astra;

[ComponentId("docs.spawn-temporary")]
public sealed class SpawnTemporary : Behavior
{
    public override void Start()
    {
        var child = Object.CreatePrimitive(PrimitiveType.Cube);
        child.Name = "Cubo temporário";
        child.Destroy(3.0);
    }
}
```

## Resultado esperado

Um cubo é criado e a remoção é solicitada após o atraso.

## Cuidados

A composição da primitiva depende do contrato da engine. Não conserve o handle após destruição; mudanças estruturais seguem o ponto seguro.

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Encontrar componentes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/encontrar-componentes/
---

# Encontrar componentes

Trate ausência como uma possibilidade real.

## Composição da cena

Objeto que pode ou não possuir Light.

## Implementação

```csharp
var light = Object.GetComponent(ComponentIds.Light);
if (light is not null)
{
    light.SetFloat("intensity", 2.0f);
}
```

## Resultado esperado

Somente o componente encontrado é editado.

## Cuidados

Trecho para uso dentro de um Behavior. Multiplicidade exige escolher a instância certa; não faça buscas sem necessidade a cada frame.

Consulte [Component](/pt-br/snapshot-2026-10-06/api/astra-component/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Câmera acompanhando alvo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/camera-acompanhando-alvo/
---

# Câmera acompanhando alvo

Separe alvo, offset e amortecimento.

## Composição da cena

Uma Camera com CameraFollow no mesmo objeto; alvo válido na mesma sessão.

## Implementação

```csharp
var component = Object.GetComponent(ComponentIds.CameraFollow);
var target = Object.FindInWorld("Alvo");
if (component is not null && target is not null)
{
    var follow = component.CameraFollow();
    follow.Target = target.AsReference();
    follow.Offset = new System.Numerics.Vector3(0, 2, -5);
    follow.DampingSeconds = 0.2f;
}
```

## Resultado esperado

A posição da câmera acompanha o alvo com o offset configurado.

## Cuidados

Trecho de inicialização de um Behavior na câmera. O acompanhamento descrito não cria automaticamente um sistema de enquadramento, oclusão ou orientação.

Consulte [CameraFollowRig](/pt-br/snapshot-2026-10-06/api/astra-camerafollowrig/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Ler uma ação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/ler-uma-acao/
---

# Ler uma ação

Use o nome configurado pelo projeto.

## Composição da cena

Uma ação chamada Interagir configurada com um vínculo.

## Implementação

```csharp
if (Input.Exists("Interagir") && Input.JustPressed("Interagir"))
{
    Object.Name = "Interação recebida";
}
```

## Resultado esperado

No quadro do pressionamento, o nome do objeto muda.

## Cuidados

Trecho para Update. Se a ação usa outro nome, ajuste-o. Confira foco, contexto e grupos de dispositivo.

Consulte [InputAccess](/pt-br/snapshot-2026-10-06/api/astra-inputaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Interagir com raycast"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/interagir-com-raycast/
---

# Interagir com raycast

Consulte a geometria física na direção do objeto.

## Composição da cena

Objeto emissor, alvo com collider e camadas incluídas no filtro.

## Implementação

```csharp
var hit = Physics.RayCast(Object.WorldPosition,
    Object.Forward * 5.0f, QueryFilter.Default.Ignoring(Object));
if (hit is { } contact)
{
    contact.Object.Name = "Alvo encontrado";
}
```

## Resultado esperado

Um alvo físico encontrado pelo raio recebe o nome indicado.

## Cuidados

Trecho para uma ação de interação em Behavior. O vetor carrega a extensão da consulta; não substitua por uma direção unitária quando deseja outro alcance. O exemplo altera nome, não implementa inventário ou regras de interação.

Consulte [PhysicsAccess](/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Reagir a colisão"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/reagir-a-colisao/
---

# Reagir a colisão

Receba um evento e mantenha o contexto do contato.

## Composição da cena

Composição física capaz de produzir contatos e Behavior no objeto receptor.

## Implementação

```csharp
public override void CollisionEnter(Collision collision)
{
    var other = Resolve(collision.Other);
    if (other is not null)
        Object.Name = "Contato com " + other.Name;
}
```

## Resultado esperado

O nome do receptor identifica o outro objeto quando o contato começa.

## Cuidados

Trecho dentro de uma classe Behavior. Normal pode ser nula; triggers têm callbacks próprios e não equivalem a contato sólido.

Consulte [Collision](/pt-br/snapshot-2026-10-06/api/astra-collision/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Porta cinemática"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/porta-cinematica/
---

# Porta cinemática

Uma porta móvel precisa manter a autoridade física coerente.

## Composição da cena

Porta com collider e corpo configurado como cinemático; botão ou sensor separado para a interação.

## Implementação

Configure os valores pelo Inspector e consulte a API relacionada antes de adicionar controle por script.

## Resultado esperado

A porta percorre uma pose aberta/fechada sem atravessar a parede por erro de montagem.

## Cuidados

Antes de escrever o movimento, confira a API de corpo da versão. Não aplique o exemplo de Translate para um corpo dinâmico. Defina duração, reversão e comportamento ao encontrar obstáculo; esta receita descreve a composição, não entrega um controlador completo de porta.

Consulte [PhysicsBodyRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsbodyruntime/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Aplicar impulso"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/aplicar-impulso/
---

# Aplicar impulso

Aplique um impulso no ponto de mundo escolhido.

## Composição da cena

Corpo dinâmico com collider e massa válida.

## Implementação

```csharp
var body = Object.PhysicsBody();
body.AddImpulseAtPosition(
    new System.Numerics.Vector3(0, 2, 0), body.CenterOfMass);
```

## Resultado esperado

O corpo recebe impulso vertical no centro de massa.

## Cuidados

Trecho executado uma vez por ação. Aplicar impulso em todo Update muda a mecânica e faz o resultado depender da frequência; não confunda impulso com força contínua.

Consulte [PhysicsBodyRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsbodyruntime/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Contagem regressiva"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/contagem-regressiva/
---

# Contagem regressiva

Dispare um Timer sem depender da contagem de frames.

## Composição da cena

Componente Timer no mesmo objeto do Behavior.

## Implementação

```csharp
public override void Start()
{
    var component = Object.GetComponent("astra.time.timer");
    if (component is not null)
        component.Timer().Start(5.0);
}

public override void TimerElapsed(ulong timerInstanceId, uint count)
{
    Object.Name = "Tempo encerrado";
}
```

## Resultado esperado

O evento altera o nome após o intervalo.

## Cuidados

Trecho dentro de Behavior. Confira Repeat e IgnoreTimeScale. Se há vários timers, compare timerInstanceId e considere count.

Consulte [Components.GameTimer](/pt-br/snapshot-2026-10-06/api/astra-components-gametimer/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Transição com tween"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/transicao-com-tween/
---

# Transição com tween

Anime somente uma propriedade elegível.

## Composição da cena

Uma Camera no objeto e nenhum outro escritor do campo de visão.

## Implementação

```csharp
var camera = Object.GetComponent(ComponentIds.Camera);
if (camera is not null)
{
    var transition = camera.TweenFloat("vertical_fov", 75.0f, 1.0f);
    // Conserve a operação se precisar consultar ou cancelar a transição.
}
```

## Resultado esperado

O campo de visão progride até 75 graus ao longo de um segundo.

## Cuidados

Trecho de inicialização com using Astra. A propriedade é marcada como tweenable no contrato; trate conflito de escrita e cancelamento conforme o lifetime do Behavior.

Consulte [NumberTween](/pt-br/snapshot-2026-10-06/api/astra-numbertween/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Salvar progresso"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/salvar-progresso/
---

# Salvar progresso

Confirme alterações de chaves explicitamente.

## Composição da cena

Behavior em projeto com namespace de persistência disponível.

## Implementação

```csharp
using Astra;

[ComponentId("docs.visit-counter")]
public sealed class VisitCounter : Behavior
{
    public override void Start()
    {
        long visits = Save.GetInt64("visits", 0) + 1;
        Save.SetInt64("visits", visits);
        Save.Flush();
        Object.Name = "Visita " + visits;
    }
}
```

## Resultado esperado

A contagem aumenta a cada nova inicialização do Behavior e é gravada com Flush.

## Cuidados

A chave deve manter o mesmo tipo entre versões. Trate erros de I/O e não use Flush a cada frame.

Consulte [SaveStore](/pt-br/snapshot-2026-10-06/api/astra-savestore/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Trocar de cena"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/trocar-de-cena/
---

# Trocar de cena

Solicite uma cena que pertence ao projeto.

## Composição da cena

Duas cenas registradas e nome de destino conferido em Scenes.Names.

## Implementação

```csharp
Scenes.Load("segunda-cena");
```

## Resultado esperado

O mundo é substituído no fim do quadro corrente.

## Cuidados

Trecho dentro de Behavior; o nome é um exemplo e precisa existir no seu projeto. Não faça a solicitação continuamente em Update nem conserve referências do mundo antigo.

Consulte [ScenesAccess](/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Botão de UI"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/botao-de-ui/
---

# Botão de UI

Consuma o evento do controle certo.

## Composição da cena

Canvas com um botão chamado Comecar e Behavior consultando esse canvas.

## Implementação

```csharp
while (Gui.Poll(out var message))
{
    if (message.Kind == GuiEventKind.Click &&
        message.Element.Name == "Comecar")
    {
        Object.Name = "Botão acionado";
    }
}
```

## Resultado esperado

Um click no controle nomeado altera o objeto receptor.

## Cuidados

Trecho de Update. Se houver vários canvases, obtenha o GuiAccess correto. Esta receita consome a fila; coordene os consumidores para não retirar eventos de outro sistema.

Consulte [GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Controle de volume"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/controle-de-volume/
---

# Controle de volume

Ajuste o parâmetro de áudio correspondente ao escopo desejado.

## Composição da cena

AudioSource com clip válido, listener e bus configurados.

## Implementação

Configure os valores pelo Inspector e consulte a API relacionada antes de adicionar controle por script.

## Resultado esperado

O ajuste de ganho/mute no componente altera a reprodução da fonte.

## Cuidados

Escolha se o controle atua em uma voz, um bus ou na política global. Confira os limites da propriedade no componente; um slider visual sem escrita na fonte não controla áudio.

Consulte [Components.AudioSource](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Percorrer caminho"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/percorrer-caminho/
---

# Percorrer caminho

Conecte o seguidor ao caminho antes de iniciar.

## Composição da cena

Path com pontos válidos e PathFollow no objeto que deve se mover.

## Implementação

```csharp
var component = Object.GetComponent(ComponentIds.PathFollow);
if (component is not null)
    component.FollowPath().Restart();
```

## Resultado esperado

O seguidor reinicia a execução do caminho atribuído.

## Cuidados

Trecho de Behavior. Atribua a referência do caminho e configure progressão/orientação no Inspector. Restart não cria um caminho nem corrige disputa de autoridade.

Consulte [PathFollower](/pt-br/snapshot-2026-10-06/api/astra-pathfollower/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Instanciar prefab"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/instanciar-prefab/
---

# Instanciar prefab

Use a identidade de um recurso prefab do projeto.

## Composição da cena

Prefab importado/registrado e AssetGuid válido obtido de uma propriedade de recurso.

## Implementação

```csharp
// prefabAsset é um AssetGuid de recurso atribuído pelo projeto.
var instance = Object.InstantiatePrefab(prefabAsset);
instance.Name = "Instância";
```

## Resultado esperado

Uma instância do recurso é criada sob o contexto de autoria definido pela API.

## Cuidados

Trecho contextual: prefabAsset deve ser fornecido pelo projeto. Não invente um GUID e não confunda instanciar com copiar o arquivo de cena.

Consulte [GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.


---

---
title: "Como executar exemplos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/como-executar-exemplos/
---

# Como executar exemplos

Use os scripts pequenos para isolar um comportamento.

## Downloads desta publicação

Os microexemplos são arquivos C# independentes escritos para o portal. Eles não incluem o código da engine nem um projeto completo. Acompanhe os pré-requisitos e o estado no [manifesto](/pt-br/snapshot-2026-10-06/ia/manifesto-de-exemplos/).

## Preparação

Crie uma cena pequena, adicione geometria e câmera, crie/anexe o script e compile no editor. Inicie Play e compare o resultado com a receita. Ao terminar, pare e confira a cena autoral.

## Escolha um exemplo

- [Rotação](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/)
- [Movimento local](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/)
- [Objeto temporário](/pt-br/snapshot-2026-10-06/receitas/criar-e-remover-objetos/)
- [Persistência](/pt-br/snapshot-2026-10-06/receitas/salvar-progresso/)

## Projetos maiores

Os jogos a seguir são referências de curadoria baseadas na documentação interna existente. O portal não oferece downloads de pacotes ainda não auditados e não afirma que a distribuição atual já os inclui.


---

---
title: "Cena mínima de lifecycle"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/cena-minima-de-lifecycle/
---

# Cena mínima de lifecycle

Observe a ordem das fases sem misturar vários sistemas.

## Cena

Use um objeto ativo com Behavior e uma câmera. Mantenha o script sem dependências de física, áudio ou recursos externos.

## Experimento

Adicione marcadores de diagnóstico em Awake, Enable, Start, Update, Disable, Stop e Destroy conforme a API de logging da instalação. Evite emitir mensagem em todo Update durante uma sessão longa.

## O que conferir

Inicie, desabilite/habilite o comportamento, remova o objeto e encerre Play em execuções separadas. Registre a ordem observada e compare os callbacks com a referência de Behavior. Este é um roteiro de investigação, sem log de execução fabricado.


---

---
title: "Cristais do Templo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/cristais-do-templo/
---

# Cristais do Templo

Recolher seis cristais e alcançar o portal.

## O que estudar

Câmera ortográfica, input, ativação de objetos e materiais emissivos.

## Fluxo descrito no projeto

Movimento no eixo esquerdo e Ação para impulso. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Circuito Neon"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/circuito-neon/
---

# Circuito Neon

Atravessar cinco portais em ordem.

## O que estudar

Câmera em perspectiva, acompanhamento, corpos e checkpoints.

## Fluxo descrito no projeto

Eixo vertical para acelerar/frear, horizontal para desviar e Ação para turbo. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Arena de Drones"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/arena-de-drones/
---

# Arena de Drones

Eliminar 48 drones com pulsos de ação.

## O que estudar

Muitos objetos, comportamentos, corpos e carga de desenho.

## Fluxo descrito no projeto

Movimento no eixo esquerdo e Ação para o pulso. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Quarentena 04"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/quarentena/
---

# Quarentena 04

Recolher fusíveis, religar o gerador e escapar.

## O que estudar

Personagem, raycast, porta cinemática e recursos GLB.

## Fluxo descrito no projeto

Movimento e olhar em primeira pessoa; interação por mira. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Resgate na Mina"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/resgate-na-mina/
---

# Resgate na Mina

Acionar bombas, socorrer pessoas e alcançar o elevador.

## O que estudar

Raycast, impulso físico, iluminação e controle de oxigênio.

## Fluxo descrito no projeto

Movimento em primeira pessoa e ação de interação. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Perímetro Delta"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/perimetro-delta/
---

# Perímetro Delta

Neutralizar sentinelas e alcançar a extração.

## O que estudar

Raycast, dano, recarga, patrulha e linha de visão.

## Fluxo descrito no projeto

Mira e tiro, cobertura e recarga conforme o projeto. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Linha Fantasma"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/linha-fantasma/
---

# Linha Fantasma

Religar uma estação antes da partida.

## O que estudar

Cenário GLB, texturas, física, lanterna e missão cronometrada.

## Fluxo descrito no projeto

Exploração em primeira pessoa e interação com fusíveis e equipamentos. Abra o projeto na versão distribuída, compile os scripts antes de Play e confira os recursos importados.

## Estado da curadoria

Esta página resume um projeto documentado anteriormente. Não foi reexecutado neste snapshot e não há download público auditado nesta publicação. Contagens históricas de entidades, vitórias ou FPS não são usadas como prova da versão atual.

## Como aproveitar

Isole uma mecânica em uma cena pequena e compare com as [receitas](/pt-br/snapshot-2026-10-06/receitas/girar-um-objeto/). Preserve uma cópia autoral antes de modificar o exemplo.


---

---
title: "Curadoria de outros projetos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/exemplos/curadoria-de-outros-projetos/
---

# Curadoria de outros projetos

Um projeto demonstrativo precisa ser distribuível e reproduzível.

## Antes de publicar

Confira recursos, licenças, scripts, versão de arquivo e dependências externas. O pacote deve abrir sem acesso ao repositório privado.

## Cenário de aceite

Abrir → compilar → iniciar Play → executar a mecânica central → parar → salvar → reabrir. Registre o aparelho e a versão. Uma screenshot do editor não prova gameplay.

## Entrega

Disponibilize arquivo, tamanho, hash, requisitos e roteiro. Projetos que ainda não passaram por essa revisão permanecem em curadoria, sem botão de download fictício.


---

---
title: "Estado da versão"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/estado-da-versao/
---

# Estado da versão

Snapshot de documentação de 06 de outubro de 2026.

## Projeto em desenvolvimento

**A Astra ainda é bem limitada e incompleta.** O projeto está em aproximadamente **20% da meta final**. Ainda há muito a construir, completar e refinar.

Estimativa do criador sobre a meta final. Não representa estabilidade ou cobertura de testes.

Aceitamos sugestões! Compartilhe ideias, dúvidas e problemas no [Discord oficial da Astra](https://discord.gg/KpqnBvt4uG), nosso canal oficial para interagir com a comunidade.

## Aprofundamento por uso

Esta revisão documenta caminho/efeito dos 892 campos de 49 registros de componentes; inclui 13 elementos de documento UI, Image/UiImage, layout, ações, animação e tutorial de corações com recursos/scripts para baixar. Os 3.095 membros da API têm acesso e vínculo ao roadmap; explicações especializadas ainda pendentes são sinalizadas. Contagens atuais ficam no [manifesto de cobertura](/snapshot-2026-10-06/coverage.json).

## Geração documentada

Astra atual · C# · assembly Astra.Scripting. Este identificador é um snapshot datado, não uma versão comercial inventada. Planos de Astra 2, Luau, The Forge e RmlUi não são apresentados como capacidades simultâneas desta geração.

## O que foi extraído

A API foi analisada semanticamente com Roslyn/MSBuild. Interfaces de infraestrutura, namespaces Runtime/Compilation e tipos de transporte selecionados ficam fora do recorte de gameplay. Componentes e padrões foram extraídos dos descritores compilados da engine. Consulte as contagens no [manifesto de cobertura](/snapshot-2026-10-06/coverage.json).

## O que a publicação não comprova

As páginas de API fornecem assinaturas e comentários existentes; nem todo membro tem explicação editorial de custo, exceções e lifecycle. A referência dos componentes cobre números, booleanos, enums e referências de objeto; recursos e coleções podem exigir APIs específicas. Não foi realizada uma campanha de testes de engine ou validação física Android nesta publicação.

## Como interpretar os guias

Guias e receitas explicam contratos e oferecem cenários de conferência. Projetos maiores permanecem em curadoria. Uma página existente não significa que todo gate editorial do plano foi concluído.

## Atualizações

Novas revisões devem regenerar a referência e os exports, revisar o impacto de comportamento e publicar este portal. Os [dados para IA](/pt-br/snapshot-2026-10-06/ia/como-consultar-por-versao/) mantêm versão e limitações.


---

---
title: "Changelog do portal"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/changelog/
---

# Changelog do portal

Mudanças da documentação, separadas de releases da engine.

## 06/10/2026 — documentação pelo fluxo de criação

UI de jogo e roadmap ganharam seções próprias; Image pode ser encontrada como UiImage/UIIMG. Tutorial de HUD de corações inclui árvore, campos, PNGs, documento AEUI e scripts de dano/cura. Componentes ganharam uso/caminho de cada campo, e a API ganhou acesso/roadmap por membro com backlog explícito. Registro público contém 91 famílias do inventário base e 41 capacidades do renderer.

## 06/10/2026 — fundação do portal

Identidade Astra e Orbit aplicada ao site; navegação responsiva; tema claro/escuro; busca estática; catálogo filtrável; guias, receitas e diagnósticos; referência C# semântica; páginas de componentes; exports Markdown/JSON e manifesto de exemplos.

## Sem release de engine implícita

O snapshot de documentação e o APK têm identificadores próprios. Consulte a [página de download](/download/) para a versão distribuída, assinatura e evidências do pacote. Funcionalidades citadas aqui são documentadas no contexto do snapshot; a publicação do portal não comprova execução no aparelho.

## Próximas revisões editoriais

Aprofundar descrição de membros que só possuem assinatura; executar os cenários de exemplos; revisar fluxos do editor em aparelho; auditar recursos e coleções que não entram na tabela de reflexão.


---

---
title: "Compatibilidade"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/compatibilidade/
---

# Compatibilidade

Mantenha código, conteúdo e documentação na mesma geração.

## Scripts

Confira namespace, assinatura, enum e unidade na versão consultada. Não substitua chamadas por equivalentes de outra engine sem ler o contrato.

## Cenas

Uma cena depende de versão de payload e recursos. Preserve uma cópia antes de converter. Um arquivo reconhecido não garante que todos os seus recursos estão presentes.

## Gerações futuras

Astra 2 permanece fora desta referência. Uma futura migração de linguagem exige revisar lifecycle, bindings, ownership e formatos; não se resume a traduzir sintaxe.


---

---
title: "Breaking changes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/breaking-changes/
---

# Breaking changes

Identifique alterações que exigem ação do autor do projeto.

## Contrato público

Mudança de assinatura, unidade, valor padrão, comportamento de callback, identidade persistente ou semântica de enum pode exigir migração mesmo quando o projeto ainda compila.

## Snapshot inicial

Não há uma versão anterior publicada neste portal para produzir um diff confiável. Nenhuma lista de breaking changes da engine é inventada a partir da data de criação do site.

## Revisão de atualização

Compare os índices JSON entre snapshots, revise as diferenças de comportamento e execute o cenário central do projeto. Registre substituto e ação necessária para cada item obsoleto.


---

---
title: "Migração de cenas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/migracao-de-cenas/
---

# Migração de cenas

Preserve dados antes de converter um projeto.

## Preparação

Duplique o projeto e seus recursos. Registre a versão que consegue abrir a cópia original. Evite misturar conversão de formato com reorganização de assets.

## Conferência

Compare quantidade de objetos, hierarquia, transformações, componentes e referências de recurso. Salve a cópia migrada, reabra e execute uma cena curta em Play.

## Falha

Preserve arquivos rejeitados e mensagens. Uma migração incompleta deve ser tratada explicitamente; não substitua componentes ausentes por placeholders silenciosos.


---

---
title: "Migração de scripts"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/migracao-de-scripts/
---

# Migração de scripts

Atualize o significado da chamada, não apenas seu nome.

## Comece pelos contratos

Confira callbacks, tipos, overloads, defaults e unidades. A diferença entre radianos e graus pode passar pela compilação e ainda quebrar a mecânica.

## Identidades persistentes

Preserve ComponentId e PropertyId quando a intenção é manter referências e valores existentes. Renomear uma classe e trocar sua identidade persistente são decisões distintas.

## Depois de compilar

Confira criação, atualização, remoção e término de Play. Verifique objetos criados em runtime e inscrições/corrotinas que podem manter referências antigas.


---

---
title: "Privacidade e uso"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/versoes/privacidade/
---

# Privacidade e uso

Informações de leitura e limites de distribuição do portal.

## Dados no navegador

A busca é estática e executada no navegador. O tema utiliza armazenamento local para lembrar a preferência. O portal não inclui formulário de conta, analytics próprio ou envio dos termos de busca para um backend de pesquisa. O provedor de hospedagem pode processar dados técnicos das requisições.

## Código e materiais

O portal publica documentação, contratos selecionados e microexemplos. Não distribui o repositório privado da engine. Nenhuma licença aberta para o código da engine é concedida por esta publicação.

## Exemplos e autoria

Os arquivos de exemplo acompanham explicação, versão, tamanho e hash. A política de redistribuição e uma licença editorial pública ainda não foram definidas. Consulte o responsável pelo projeto antes de redistribuir materiais como um pacote próprio.


---

---
title: "Como consultar por versão"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/como-consultar-por-versao/
---

# Como consultar por versão

Use contratos explícitos antes de gerar código.

## Descoberta

Comece em [llms.txt](/llms.txt). Todas as rotas desta publicação apontam para snapshot-2026-10-06, geração astra-current e linguagem C#.

## Consulta

1. Localize o tipo no [índice de API](/snapshot-2026-10-06/api-index.json).
2. Leia a página Markdown correspondente e as restrições.
3. Confira o componente e os requisitos no [índice de componentes](/snapshot-2026-10-06/component-index.json).
4. Use exemplos da mesma versão.
5. Declare quando uma resposta depende de comportamento ainda não validado.

## Não inferir

Ausência de comentário não autoriza inventar uma exceção, default ou suporte. Assinatura presente não é prova de execução em Android. Nomes de Unity/Godot servem de referência e não autorizam importar suas APIs para a Astra.


---

---
title: "Índice Markdown"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/indice-markdown/
---

# Índice Markdown

Leia a mesma documentação sem depender da interface.

## Arquivos

Cada página possui uma representação Markdown estável em /markdown/. Use o link “Ler em Markdown” no rodapé dos artigos. O [índice completo](/snapshot-2026-10-06/markdown-index.json) associa título, URL e arquivo.

## Paridade

O export é produzido a partir do mesmo corpo que gera as páginas. Assinaturas, tabelas e avisos acompanham o conteúdo. Catálogos interativos possuem uma representação textual com todos os links.

## Leitura consolidada

[llms-full.txt](/llms-full.txt) contém a exportação consolidada. Para consultas menores, prefira o índice e a página relevante.


---

---
title: "Índice de API JSON"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/indice-de-api-json/
---

# Índice de API JSON

Encontre a identidade semântica de tipos e membros.

## Contrato

O [api-index.json](/snapshot-2026-10-06/api-index.json) contém UID, assinatura, categoria, versão, URL e resumo quando existe no código. As âncoras derivam do UID semântico e não do título traduzido.

## Overloads

Overloads possuem identidades distintas. Confira parâmetros, modificadores e defaults; o nome do método sozinho não identifica o contrato.

## Limite

O índice não publica corpos de implementação nem substitui revisão do comportamento. runtimeVerified e platformEvidence permanecem explícitos.


---

---
title: "Índice de componentes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/indice-de-componentes/
---

# Índice de componentes

Consulte composição e propriedades do mesmo snapshot.

## Dados

O [component-index.json](/snapshot-2026-10-06/component-index.json) inclui typeId, família, fachada, requisitos, conflitos, versão de payload, mutabilidade e propriedades.

## Padrões

Os padrões são lidos do componente recém-criado. Campos por slot e propriedades condicionais incluem essa distinção. Um padrão vazio pode depender de recursos atribuídos.

## Cobertura

A projeção atual cobre números, booleanos, enums e referências de objeto. Recursos e coleções especializados precisam da API correspondente; não trate a tabela como todo o estado serializado.


---

---
title: "Manifesto de exemplos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/manifesto-de-exemplos/
---

# Manifesto de exemplos

Identifique os arquivos disponíveis e o que foi verificado.

## Downloads

O [examples.json](/snapshot-2026-10-06/examples.json) registra descrição, pré-requisitos, URL, tamanho, SHA-256 e evidência de cada microexemplo. Os arquivos são pequenos e próprios desta documentação.

## Preparação

Anexe o Behavior ao objeto compatível com a receita, compile e execute o cenário. Os arquivos não incluem APK, assets da engine ou um projeto completo.

## Evidência

Compilação e execução são campos separados. Projetos históricos em curadoria não recebem links de download nem hashes inventados.


---

---
title: "Limitações conhecidas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ia/limitacoes-conhecidas/
---

# Limitações conhecidas

Mantenha as lacunas junto dos dados consumidos por ferramentas.

## Referência técnica

Nem todo membro tem comentários editoriais de parâmetros, exceções, custo ou thread. O extrator garante identidade semântica e assinatura do recorte; não sintetiza garantias ausentes.

## Comportamento

Não há validação física Android nova associada a esta publicação. Exemplos e roteiros precisam de aceite na instalação efetiva. O catálogo não representa paridade integral com Unity/Godot.

## Distribuição

Não há instalador público nem pacote completo dos jogos históricos neste portal. A política de licença editorial ainda não está definida.

## Versão

Não misture esta API C# com o planejamento de Astra 2/Luau. Ao atualizar o snapshot, regenere os exports e revise os exemplos em conjunto.


---

---
title: "UI de jogo: onde fica e o que é possível"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/comece-aqui/
---

# UI de jogo: onde fica e o que é possível

Encontre Canvas UI, Image e os elementos de interface pelo caminho real de autoria.

## Comece pelo que você quer criar

| Quero criar | Ferramenta de hoje | Tutorial |
|---|---|---|
| HUD de corações com dano e cura | Canvas UI + documento + Image + Behavior C# | [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) |
| Ícone, retrato ou coração | Image, elemento do documento | [Image](/pt-br/snapshot-2026-10-06/ui/image/) |
| Barra contínua | Progress + escrita de Value | [Progress](/pt-br/snapshot-2026-10-06/ui/progress/) |
| Botão clicável ilustrado | Image + Clicável + Poll | [Interação e animação](/pt-br/snapshot-2026-10-06/ui/interacao-e-animacao/) |
| Menu de botões | Button, Text, VBox | [Catálogo de elementos](/pt-br/snapshot-2026-10-06/ui/elementos/) |
| Mover e olhar no touch | Joystick, ActionButton, LookArea + receptor | [Controles e receptores](/pt-br/snapshot-2026-10-06/ui/controles-e-receptores/) |

## O nome certo na Astra

**UiImage, UIImage, UIIMG e imagem de UI** são termos úteis de busca. Nesta geração da Astra, o nome exibido é **Image**. Ele é um nó de um documento **.aeui**, manipulado por [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/). O componente do objeto é [Canvas UI](/pt-br/snapshot-2026-10-06/componentes/astra-ui-canvas/), com fachada **Astra.Components.UiCanvas**. Não há uma classe pública Astra.Components.UiImage neste snapshot.

## Criar e salvar o documento

1. Abra o projeto e, no menu do editor, entre em **Interface (UI + ImGui)**. Essa é a área de autoria de UI; não é o editor de scripts.
2. No campo do recurso, use **UI/hud.aeui**. O caminho deve ficar dentro do projeto e terminar em .aeui. Se já existe um rascunho aberto, salve-o antes de trocar de documento.
3. Crie os elementos pelo menu de criação. No Inspector integrado da cena, a ação equivalente é **+ Elemento**. **Image** aparece nessa lista, junto de Panel, Text e Button.
4. Dê nomes únicos e estáveis aos elementos usados por scripts. Nome resolve a busca; o handle de execução conserva o ID e a instância do Canvas.
5. Use **Salvar** na área Interface ou **Salvar UI** no Inspector integrado. Isso salva e registra o documento no projeto. Salvar apenas a cena não substitui Salvar UI.

## Exibir o documento na cena

1. Crie um objeto vazio chamado **HUD** na Hierarquia da cena.
2. Selecione HUD → **Adicionar componente** → procure **Canvas UI** na família **Renderização**.
3. No Inspector do componente, atribua **UI/hud.aeui** ao recurso **Documento UI**. O arquivo deve ter sido salvo/registrado, não é um GUID inventado.
4. Use **Apresentação = Tela** para HUD. O modo Mundo / objeto é para uma interface presa a um plano na cena.
5. Use **Editar documento UI** para abrir a fonte desse Canvas. Expandir o Canvas na Hierarquia mostra os elementos; selecionar Image abre suas propriedades no mesmo Inspector.
6. A trilha mostra o proprietário e quantos Canvas compartilham o recurso. Editar a fonte altera todos os Canvas autorais ligados a ela. Overrides individuais autorais ainda estão pendentes.

## Editar, Interagir e Play

| Modo | O que faz | O que conferir |
|---|---|---|
| Autoria | Edita o documento e seleciona elementos | Layout, recurso, nomes, Undo/Redo e salvar |
| Interagir | Usa uma cópia para testar hit, ações nativas, estados e animação | Pressionar, soltar, cancelar; não executa o Behavior C# do jogo |
| Play | Executa cena e scripts com uma instância de UI por Canvas | Poll, vida do jogador, controle e alterações por C# |

As escritas do script em Play não modificam o .aeui autoral. Ao parar/reabrir Play, resolva os handles de novo. Não guarde GuiElement entre execuções.

## Contrato e roadmap

Documentos externos, Canvas Tela/Mundo, seleção integrada e cópias de Play estão presentes no código. Esta atualização de docs não executa novamente o APK no aparelho. [Roadmap UI](/pt-br/snapshot-2026-10-06/ui/roadmap/) identifica as lacunas de layout, imagem, foco, bindings e autoria por instância.


---

---
title: "Os 13 elementos da UI de jogo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/elementos/
---

# Os 13 elementos da UI de jogo

Escolha o tipo pelo resultado que precisa produzir, com caminho, campos e limites.

Todos os tipos abaixo são **elementos do documento .aeui**. Use Interface → criar elemento, ou selecione um nó do Canvas na Hierarquia → Inspector → **+ Elemento**. Eles não são 13 componentes adicionais de objetos da cena.

| Tipo | Para que serve | Exemplo |
|---|---|---|
| [Panel](/pt-br/snapshot-2026-10-06/ui/panel/) | Agrupa elementos e oferece fundo opcional. | Caixa de vida com Images por cima. |
| [Text](/pt-br/snapshot-2026-10-06/ui/text/) | Mostra uma string alterável em Play. | Vida: 3/3, pontuação ou instruções. |
| [Button](/pt-br/snapshot-2026-10-06/ui/button/) | Entrega Click ao pressionar e soltar no controle. | Botão de dano para experimentar o HUD. |
| [Toggle](/pt-br/snapshot-2026-10-06/ui/toggle/) | Guarda um valor marcado/desmarcado e emite ValueChanged. | Ligar/desligar uma opção do jogo. |
| [Slider](/pt-br/snapshot-2026-10-06/ui/slider/) | Recebe arraste e muda um valor em um intervalo. | Escolher volume ou sensibilidade no menu. |
| [Progress](/pt-br/snapshot-2026-10-06/ui/progress/) | Apresenta um valor proporcional ao intervalo. | Barra contínua de vida ou carregamento. |
| [Image](/pt-br/snapshot-2026-10-06/ui/image/) | Desenha uma imagem do projeto, com transparência. Se você procura UiImage, UIImage ou UIIMG, este é o elemento Image da Astra. | Coração, retrato, ícone ou painel ilustrado. |
| [HBox](/pt-br/snapshot-2026-10-06/ui/hbox/) | Distribui filhos em uma linha. | Uma fileira de corações com tamanho preferido 48 × 48. |
| [VBox](/pt-br/snapshot-2026-10-06/ui/vbox/) | Distribui filhos em uma coluna. | Lista de instruções ou opções do menu. |
| [Grid](/pt-br/snapshot-2026-10-06/ui/grid/) | Distribui filhos em colunas. | Grade pequena de itens autorados. |
| [Joystick](/pt-br/snapshot-2026-10-06/ui/joystick/) | Converte o gesto em eixo de ação. | Mover o jogador ligado ao receptor do Canvas. |
| [ActionButton](/pt-br/snapshot-2026-10-06/ui/actionbutton/) | Emite uma ação de entrada de botão para o receptor. | Saltar ou Atirar; não confundir com Button que entrega eventos de GUI. |
| [LookArea](/pt-br/snapshot-2026-10-06/ui/lookarea/) | Converte arraste em ação de olhar. | Olhar a câmera atribuída ao Canvas. |

Consulte [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) antes de misturar posicionamento manual com containers. O [GuiKind](/pt-br/snapshot-2026-10-06/api/astra-guikind/) enumera esses tipos na API, e [GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/) cria ou encontra instâncias em Play.


---

---
title: "Layout e campos comuns da UI"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/layout-e-campos/
---

# Layout e campos comuns da UI

Entenda âncoras, bordas, containers, estado e aparência antes de ajustar o HUD.

## Onde editar

Selecione o elemento na Hierarquia sob o Canvas ou na árvore da área Interface. Os grupos **Estado**, **Layout**, **Aparência**, **Composição automática**, **Interação**, **Ações**, **Estados visuais** e **Animação** aparecem conforme o tipo e seu pai. Campos escondidos podem depender do contexto.

## Layout manual: âncoras e bordas

| Campo / API | Efeito e uso |
|---|---|
| Âncora inicial / GuiLayout.AnchorMin | X/Y normalizados do pai: 0 é esquerda/topo, 1 é direita/base. Padrão (0,0). |
| Âncora final / GuiLayout.AnchorMax | Extremo oposto no pai. Igual à inicial conserva tamanho definido pelas bordas; diferente acompanha o tamanho do pai. |
| Bordas / GuiLayout.Offsets | Esquerda, topo, direita, base, em pixels relativos às respectivas âncoras. Não são X, Y, largura, altura. |
| Esticar | Preset com âncoras (0,0)–(1,1) e bordas 16,16,-16,-16; mantém margens no pai. |
| Centralizar | Coloca as duas âncoras em (0,5;0,5) e bordas simétricas, preservando o tamanho medido. |
| Recortar filhos / Style.ClipChildren | Restringe desenho/hit dos descendentes ao retângulo. Um filho para fora pode desaparecer. |

Para um Image 48 × 48 no canto superior esquerdo do pai, use âncoras (0,0) e (0,0), bordas **0,0,48,48**. Para outro 8 px à direita, use **56,0,104,48**. Na raiz, o retângulo do Canvas Tela acompanha o viewport. Não há CanvasScaler por resolução de referência entregue nesta versão.

## Composição automática

| Campo / API | Efeito e uso |
|---|---|
| Tamanho mínimo / Sizing.Minimum | Limite mínimo XY do filho. Padrão (0,0); escolha 48 × 48 para um coração que não deve encolher. |
| Preferido (0 = medir) / Preferred | Tamanho desejado. Zero usa a medição do conteúdo; Image pode medir a textura inteira, portanto defina 48 × 48 para um PNG grande. |
| Peso de expansão / Flexible | Distribui espaço extra nos filhos de HBox/VBox. Peso zero conserva o tamanho preferido; não é propriedade de expansão de Grid. |
| Padding / Padding | Margens internas esquerda, topo, direita, base. Padrão 8 em cada lado. |
| Espaçamento / Spacing | Distância entre filhos; HBox usa X, VBox usa Y, Grid usa ambos. Padrão 8. |
| Alinhamento / Alignment | Início, Centro, Fim ou Esticar no espaço do container. Padrão Esticar. |
| Colunas / Columns | Quantidade de colunas do Grid, 1–64 no editor; padrão 2. |
| Fora do fluxo / Ignore | Retira esse filho da distribuição; libera âncoras e arraste. Ele ainda pertence à árvore. |

Quando HBox/VBox/Grid controla o filho, os campos de layout manual ficam bloqueados. Use tamanho, peso e ordem. Um container não é uma lista de objetos da cena e não faz data binding de inventário.

## Estado e aparência

| Campo / API | Efeito e uso |
|---|---|
| Visível / Visible | Esconde o elemento e sua subárvore no runtime; em container, um filho invisível deixa de participar da medição. Use overlay em Panel para conservar o espaço de um coração vazio. |
| Habilitado / Enabled | Controla a participação na entrada e o estado desabilitado. Pode continuar visível. Ancestrais desabilitados afetam os filhos. |
| Nome / Name | Busca exata de Find/TryFind; mantenha nomes únicos. Nome não é o ID persistente. |
| Texto / Text | Conteúdo de Text e controles textuais. Image não desenha texto. |
| Desenhar fundo / Style.Background | Ativa alpha do fundo; desligado não adiciona uma placa atrás da imagem. |
| Fundo, Texto / Controle e Destaque | Cores de pintura: fundo, conteúdo e preenchimento de controles. C# usa 0xAARRGGBB. |
| Fonte / FontSize | Tamanho do texto em pixels; editor 6–128. Não é a resolução do Canvas. |
| Raio / Radius | Arredondamento do fundo desenhado. Não cria recorte por máscara na imagem. |
| Valor / Value | Estado numérico de Toggle, Slider e Progress. Image não consome Value como vida/preenchimento. |
| Mínimo / Máximo | Intervalo autorado do Slider/Progress; Máximo precisa superar Mínimo. Snapshot permite ler o intervalo; o setter Value é separado. |

## Acesso C# e erros

As propriedades de [GuiLayout](/pt-br/snapshot-2026-10-06/api/astra-guilayout/), [GuiSizing](/pt-br/snapshot-2026-10-06/api/astra-guisizing/), [GuiStyle](/pt-br/snapshot-2026-10-06/api/astra-guistyle/) e [GuiImageStyle](/pt-br/snapshot-2026-10-06/api/astra-guiimagestyle/) são records. Para preservar os outros campos, use **with**:

```csharp
var hud = Gui.ForCanvas(Object);
var heart = hud.Find("Heart1");
heart.Layout = heart.Layout with { Offsets = new System.Numerics.Vector4(0, 0, 48, 48) };
heart.ImageStyle = heart.ImageStyle with { Fit = GuiImageFit.Contain };
```

Essas escritas exigem Behavior em Play, no proprietário do Canvas. Alteram a cópia runtime. Consulte [diagnóstico do HUD](/pt-br/snapshot-2026-10-06/ui/diagnostico/) para fonte ausente, handles vencidos e layout controlado pelo pai.


---

---
title: "Interação, ações e animação da Image"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/interacao-e-animacao/
---

# Interação, ações e animação da Image

Use uma imagem clicável sem criar fundo obrigatório; configure ações, estados e duas poses.

## Caminho no editor

Image selecionada → **Interação** → **Clicável** → **Ao clicar** → escolha ação e alvo. Uma imagem decorativa do HUD não precisa de Clicável. Button/Toggle/Slider já têm entrada própria. Text, Panel e containers podem optar por clique.

| Campo / API | Efeito e uso |
|---|---|
| Clicável / Interaction.Clickable | Habilita emissão opcional de Click no elemento; padrão falso para Image. |
| Ao clicar / Action | Notificar, alternar visibilidade/habilitação, definir valor, iniciar ou parar animação. Notificar permite o script consumir Poll. |
| Alvo / Target | ID estável de outro elemento no mesmo documento; zero representa o próprio elemento. Não aceita objeto da cena ou outro Canvas como se fosse um ID local. |
| Valor / Value | Argumento de Definir valor; o destino precisa ser Toggle, Slider ou Progress. Não troca a textura de Image. |
| Ações adicionais / AddAction | Listeners ordenados depois da ação principal. O documento permite até 16 por elemento; Click ou ValueChanged precisam ser emitidos pelo tipo de origem. |

## Script: ler o clique uma vez

Em **Play**, use Gui.ForCanvas e consuma Poll. Filtre **GuiEventKind.Click**, depois compare ID/elemento ou o nome exato. O exemplo [HeartHud.cs](/examples/heart-hud/HeartHud.cs) faz isso. Poll retira a mensagem da fila: centralize o consumo desse Canvas em um Behavior e repasse a outros sistemas; dois scripts concorrendo pela mesma fila podem perder eventos entre si.

## Estados visuais

O grupo **Estados visuais** configura Normal, Pressionado e Desabilitado, tempo de transição e curva. Cada estado combina deslocamento XY, escala uniforme, opacidade e tinta. Padrão da configuração: desativada, 0,12 s, curva Smooth; pose pressionada 0,94 de escala e desabilitada 0,45 de alpha. A tinta multiplica a imagem, não cria fundo obrigatório.

## Animação de duas poses

| Campo / API | Efeito e uso |
|---|---|
| Ativar / Animation.Enabled | Habilita a transição autorada; padrão falso. |
| De / Para / From / To | Cada pose tem Position XY (pixels), Scale uniforme e Opacity. Padrão (0,0), 1, 1. |
| Duração / Duration | Tempo da passagem; padrão 0,3 s. Não é a taxa de quadros. |
| Atraso / Delay | Espera inicial; padrão zero. Loop não reaplica esse atraso a cada ciclo. |
| Curva / Easing | Linear, Smooth, EaseIn ou EaseOut. |
| Autoplay / AutoPlay | Inicia no runtime sem chamada PlayAnimation. |
| Repetir / Loop | Repete a transição; não existe timeline de múltiplos keyframes aqui. |
| Ida e volta / PingPong | Executa a ida e depois a volta; pode combinar com loop. |
| PlayAnimation / StopAnimation | Tocar reinicia; parar restaura a pose autoral. Conclusão sem loop mantém a pose final. |

Filhos herdam a transformação, alpha e clipping; o hit acompanha a pose. Opacidade efetiva zero rejeita novas capturas. Interagir usa o tempo real do editor; Play acompanha relógio/pausa do mundo. O Inspector tem prévia, mas Interagir não executa scripts C#.

## Roadmap desta função

Ações ordenadas e estados básicos estão presentes na revisão atual. O relatório de Image de 03/10 tratava uma revisão anterior; não use sua limitação de uma ação como limite atual. Timeline/keyframes, rotação/escala por eixo, sprite animation, callbacks de conclusão, pause/resume dedicado e reduced motion completo seguem pendentes no [R10](/pt-br/snapshot-2026-10-06/ui/roadmap/#r10-animação). Hit mask e foco/acessibilidade têm trabalho próprio.


---

---
title: "Controles touch e receptores"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/controles-e-receptores/
---

# Controles touch e receptores

Diferencie botão de GUI de ação de entrada e atribua jogador/câmera ao Canvas.

## Caminho completo

1. Configure as ações do projeto no editor de entrada: eixo 2D para Mover/Olhar, botão para Saltar/Atirar. Use os nomes reais do catálogo do seu projeto.
2. Documento UI → **+ Elemento** → **Joystick**, **ActionButton** ou **LookArea**.
3. Nas propriedades do controle, atribua **Ação** compatível. O padrão inicial é Mover, Saltar ou Olhar conforme o tipo; criar esse texto não cria a ação no catálogo.
4. Canvas UI → **Jogador / receptor**: escolha um objeto com Character ou Motor dinâmico ativo.
5. Atribua **Câmera de entrada** e **Espaço do movimento** se o vetor precisa seguir a câmera ou o jogador. Para o HUD visual de corações, receptor/câmera de entrada não são necessários.
6. Execute Play e use [GuiInputAccess](/pt-br/snapshot-2026-10-06/api/astra-guiinputaccess/) do contexto retornado por Gui.ForCanvas. Ler [GuiControlSnapshot](/pt-br/snapshot-2026-10-06/api/astra-guicontrolsnapshot/) mostra estado bruto; não representa por si só movimento físico.

## Campos de controle

| Campo / API | Efeito e uso |
|---|---|
| Modo | Fixo: origem definida; Flutuante/Dinâmico alteram a origem conforme o gesto. Aplicação depende do tipo de controle. |
| Eixo e gate | Livre/Horizontal/Vertical restringem o vetor; Círculo/Quadrado escolhem o domínio. |
| Raio de entrada / InputRadius | Escala espacial do gesto; padrão 80 px. Não confundir com o tamanho visual da base. |
| BaseRadius / KnobRadius | Raios visuais padrão 80 e 28 px. |
| Deadzone / OuterDeadzone | Zonas mortas internas/externas; padrões 0,12 e 0. |
| Exponent / Sensitivity | Curva e ganho do vetor; padrões 1 e 1. |
| ReturnSeconds | Tempo de retorno visual, padrão 0,12 s. |
| ShowBase / ShowKnob | Mostra/esconde as partes visuais, sem definir o receptor. |
| BaseImage / KnobImage | Caminhos de imagens do projeto para base/puxador; não URLs externas. |
| InputAction | Nome da ação de entrada; distinto de GuiClickAction e do nome do elemento. |

## Limites e roadmap

O código prevê até 32 capturas por documento e 32 receptores por mundo. Isso não prova gestos simultâneos em cada aparelho. Atribuição de receptor, Character e motor dinâmico possui implementação; pareamento geral de hardware/jogador, buffer de comandos e partes do aceite multitouch seguem parciais em [R4](/pt-br/snapshot-2026-10-06/ui/roadmap/#r4-controles-e-receptores). Separação geral por viewport/player e modal scopes não está concluída.


---

---
title: "Diagnóstico de Image e HUD"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/diagnostico/
---

# Diagnóstico de Image e HUD

Localize a etapa que falhou: documento, imagem, elemento, script, evento ou estado de vida.

| Sintoma | Confira | Correção |
|---|---|---|
| Image não está em Adicionar componente | É elemento do .aeui | Abra Interface ou + Elemento no Inspector da UI; use Image |
| HUD não aparece | Canvas habilitado, Documento UI, Apresentação e estado da fonte | Salve/registre o .aeui e atribua ao Canvas; HUD usa Tela |
| Ícone ausente ou indicação de erro | Recurso do projeto, nome/maiúsculas, diagnóstico da imagem | Importe o PNG para o projeto e use caminho relativo correto |
| Coração branco/esticado/cortado | Tinta, Ajuste, tamanho do retângulo e clipping | Tinta branca, Conter e 48 × 48; revise alpha e Recortar filhos |
| Tamanho muda quando escondo um coração | Ele é filho gerenciado de HBox/VBox/Grid | Use um slot Panel com vazio/cheio ou o overlay manual do tutorial |
| Campo Layout bloqueado | Pai controla composição automática | Altere tamanho/peso/ordem ou use Fora do fluxo |
| Botão funciona em Interagir mas não muda vida | Interagir não executa HeartHud C# | Compile/anexe o script e use Play |
| Find falha | Nome exato, contexto e documento | Confira Heart1–3/Status/Damage/Heal e Gui.ForCanvas no objeto HUD |
| Vida altera, corações não | Player errado, Behavior ausente/desabilitado ou handle vencido | Atribua Player, anexe PlayerHealth; reinicie Play após reload do Canvas |
| Cliques não chegam | Habilitado, sobreposição, captura e consumo de Poll | Um consumidor por fila; filtre Click; confira o Canvas correto |
| Dano contínuo a cada frame | Mecânica usando TriggerStay sem cooldown | O exemplo usa TriggerEnter; defina invulnerabilidade explicitamente se precisar |
| Alteração desapareceu ao reabrir | Editou só a cópia runtime ou não salvou UI | Faça a autoria fora de Play e Salvar UI; salve a cena para referências |
| Duas instâncias alteram a mesma fonte | Documento .aeui compartilhado | Crie outro recurso autoral se precisam divergir; overrides por instância pendentes |

Use **Gui.Diagnostic** do contexto correto para ações/alvos inválidos. GuiElement default não é um handle válido; elementos removidos e handles do Play anterior são rejeitados. O atlas atual limita fontes de imagem e dimensões: [roadmap e limites](/pt-br/snapshot-2026-10-06/ui/roadmap/).


---

---
title: "Roadmap da UI por função"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/roadmap/
---

# Roadmap da UI por função

Estado atual, lacunas e critérios para ampliar imagem, layout, interação e HUD sem prometer suporte ausente.

## Como ler

Revisão de código e relatórios até 06/10/2026. **Presente no código** é diferente de **validado neste APK/aparelho**. O tutorial do HUD recebe evidência de compilação separada; esta edição das docs não acrescenta um novo aceite físico. Não há datas prometidas para os itens pendentes. Os IDs R vêm do plano de UI universal da Astra, e não representam uma porcentagem de conclusão.

## R0: identidade, dados e persistência

**Parcial.** Documento AEUI 5 com leitura 1–4, IDs locais estáveis, recurso registrado e instância runtime por Canvas. Identidade de mundo/lease evita misturar nós de sessões distintas. Falta completar separação de pintura/hit/foco/semântica, PropertyId de UI e bindings persistentes entre documentos. Aceite futuro: referência sobreviver a salvar/reabrir/duplicar, com diagnóstico de alvo removido.

## R1: autoria integrada

**Parcial.** Hierarquia projeta Canvas/elementos; seleção abre Inspector contextual; criação, rename, reorder, duplicate/remove, Undo e fonte compartilhada presentes. Faltam drag-and-drop entre fontes, gizmos completos de layout, prévia autoral simultânea de todos os Canvas e overrides por instância. Aceite: criar/editar a UI na cena com contexto claro e sem alterar outra fonte por engano.

## R2: Image, skins e recursos

**Parcial.** Image lê recurso do projeto, Tinta e Esticar/Conter/Cobrir, com atlas. Atlas atual: uma página **2048 × 2048**, até **64 fontes**, cada imagem até **1024 × 1024 RGBA8**; documentos até **1024 nodes**, e **64 leases por mundo**. Não entregue: nine-slice, sprite sheets, múltiplas páginas/fences e skins completos. Aceite: bordas preservadas em vários tamanhos, paginação sem colisão e erro explícito para recurso ausente. HUD inteiro/vazio já pode usar duas Images sobrepostas.

## R3: input, captura e foco

**Parcial.** Captura por device/pointer, até 32 por documento; cancelar ao remover/desabilitar/trocar fonte. Não entregue: foco/navegação geral, modal scopes, hit mask de Image e semântica/acessibilidade completa. Aceite: pressionar/arrastar/cancelar múltiplos controles sem ativar a cena por baixo, em aparelho.

## R4: controles e receptores

**Parcial.** Joystick, ActionButton e LookArea autorados; receptor Character/motor dinâmico, câmera e espaço de movimento. Pareamento geral de hardware/player, buffers e restante do aceite multitouch precisam de fechamento. Os subpacotes de criação de Character/motor têm relatórios próprios; sua presença não conclui toda R4.

## R5: layout responsivo

**Parcial.** Âncoras/bordas, HBox/VBox/Grid, medidas, pesos, padding e espaçamento presentes. Não declarar CanvasScaler, breakpoints, wrap/virtualização ou safe area automática como prontos. Aceite: HUD legível em viewport pequeno/tablet com área segura e mudança de resolução, sem offsets compensatórios ocultos.

## R6: texto

Text e escrita de strings presentes; pipeline avançado de fontes, shaping/localização, rich text e comportamento completo de overflow continuam no planejamento. Aceite: idioma/tamanho distintos preservarem medição e legibilidade.

## R7: bindings e coleções

**Pendente no fluxo geral.** O HUD atual usa Behavior C# para ligar PlayerHealth às Images. Não há vínculo automático "campo vida → corações" exposto como propriedade entregue. Próximo trabalho: contratos persistentes, mudanças observáveis e coleções. Aceite: fonte de dados mudar e o elemento atualizar sem binding quebrado após reload.

## R8: inventário

Grid organiza filhos autorados. Inventário completo, slots tipados, drag/drop, stacks e transações continuam pendentes. Não tratar a existência de Grid como um sistema de inventário.

## R9: apresentação

Tela e plano Mundo/objeto presentes. RenderTexture, superfície curva, ligação a osso e composição geral de viewports/players continuam pendentes. Aceite: desenho e hit concordarem com apresentação, transformações, oclusão e viewport.

## R10: animação

**Parcial.** Duas poses XY/escala uniforme/alpha, curvas, delay, autoplay, loop e ida/volta; estados Normal/Pressionado/Desabilitado e ações ordenadas. Faltam timeline/keyframes, sprite animation, rotação/escala por eixo, callbacks de término, pause/resume dedicado e política completa de reduced motion. Aceite: cancelamento/reload/destruição liberarem estado e eventos corretamente.

## R11: templates e exportação

Os exemplos públicos de docs são receitas e scripts autorados. Biblioteca completa de templates, exportação e importação com fidelidade de todas as funções permanece no planejamento. Não presumir que um exemplo histórico já seja modelo distribuído no APK.

## R12: acesso, diagnóstico e performance

Diagnóstico básico e limites existem. Fechamento inclui acessibilidade, profiler/telemetria de UI, orçamento de imagens, grandes coleções e aceite físico. Medição de CPU em host não mede GPU/Android.

## Referências estudadas

[Godot 4.5 TextureRect](https://docs.godotengine.org/en/4.5/classes/class_texturerect.html) separa textura e ajuste ao retângulo; a Astra usa os três modos de Image descritos, sem presumir todos os modos Godot. [Unity uGUI 2.0 Image](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/script-Image.html) e [Godot 4.5 TextureProgressBar](https://docs.godotengine.org/en/4.5/classes/class_textureprogressbar.html) oferecem recursos de preenchimento que não autorizam inventar fillAmount na Astra. Nosso exemplo usa imagens inteiro/vazio ou Progress para barra contínua.


---

---
title: "Panel: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/panel/
---

# Panel: uso e campos

Agrupa elementos e oferece fundo opcional.

## Para que serve

Agrupa elementos e oferece fundo opcional.

## Onde fica

**Interface → criar elemento → Panel**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Panel**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Fundo, raio e Recortar filhos; os filhos usam seu retângulo como pai.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Panel**.

## Exemplo prático

Caixa de vida com Images por cima.

## Limitações e roadmap

Layout manual por âncoras; não distribui os filhos como HBox.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Text: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/text/
---

# Text: uso e campos

Mostra uma string alterável em Play.

## Para que serve

Mostra uma string alterável em Play.

## Onde fica

**Interface → criar elemento → Text**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Text**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Texto, Fonte e Texto / Controle; use GuiElement.Text.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Text**.

## Exemplo prático

Vida: 3/3, pontuação ou instruções.

## Limitações e roadmap

Texto avançado, localização e fontes completas permanecem no roadmap R6.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Button: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/button/
---

# Button: uso e campos

Entrega Click ao pressionar e soltar no controle.

## Para que serve

Entrega Click ao pressionar e soltar no controle.

## Onde fica

**Interface → criar elemento → Button**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Button**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Texto, Habilitado, Interação, ações e estados.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Button**.

## Exemplo prático

Botão de dano para experimentar o HUD.

## Limitações e roadmap

Uma imagem decorativa não vira Button automaticamente; Image pode optar por clique.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Toggle: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/toggle/
---

# Toggle: uso e campos

Guarda um valor marcado/desmarcado e emite ValueChanged.

## Para que serve

Guarda um valor marcado/desmarcado e emite ValueChanged.

## Onde fica

**Interface → criar elemento → Toggle**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Toggle**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Marcado, Texto e Destaque; GuiElement.Value lê o valor.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Toggle**.

## Exemplo prático

Ligar/desligar uma opção do jogo.

## Limitações e roadmap

A opção precisa de um consumidor no seu script para alterar o gameplay.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Slider: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/slider/
---

# Slider: uso e campos

Recebe arraste e muda um valor em um intervalo.

## Para que serve

Recebe arraste e muda um valor em um intervalo.

## Onde fica

**Interface → criar elemento → Slider**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Slider**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Mínimo, Máximo, Valor, Destaque; leia ValueChanged.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Slider**.

## Exemplo prático

Escolher volume ou sensibilidade no menu.

## Limitações e roadmap

O script aplica o valor ao sistema de áudio/entrada; a barra sozinha não altera esses sistemas.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Progress: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/progress/
---

# Progress: uso e campos

Apresenta um valor proporcional ao intervalo.

## Para que serve

Apresenta um valor proporcional ao intervalo.

## Onde fica

**Interface → criar elemento → Progress**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Progress**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Mínimo, Máximo, Valor e Destaque; escreva GuiElement.Value.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Progress**.

## Exemplo prático

Barra contínua de vida ou carregamento.

## Limitações e roadmap

Não implementa imagem com preenchimento radial; Image não tem fillAmount nesta versão.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Image (UiImage): imagens na interface"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/image/
---

# Image (UiImage): imagens na interface

Desenha uma imagem do projeto, com transparência. Se você procura UiImage, UIImage ou UIIMG, este é o elemento Image da Astra.

## Para que serve

Desenha uma imagem do projeto, com transparência. Se você procura UiImage, UIImage ou UIIMG, este é o elemento Image da Astra.

## Onde fica

**Interface → criar elemento → Image**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Image**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Recurso do projeto, Ajuste, Tinta, Layout, Estado, Interação e Animação.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Image**.

## Exemplo prático

Coração, retrato, ícone ou painel ilustrado.

### Imagem: recurso, proporção e alpha

- **Recurso do projeto / Image:** caminho relativo, como **Images/heart-full.png**. Não use C:/, /sdcard/ ou URL. PNG com transparência serve para o contorno de coração. O seletor lista recursos do projeto e informa erros de decodificação/atlas.
- **Ajuste / ImageStyle.Fit:** **Esticar (Stretch)** preenche o retângulo deformando proporção; **Conter (Contain)** preserva proporção e cabe inteira (padrão); **Cobrir (Cover)** preserva proporção e recorta excedente.
- **Tinta / ImageStyle.Tint:** multiplica a cor; branco **0xFFFFFFFF** conserva a imagem (padrão). Alpha zero a torna transparente.
- **Desenhar fundo:** Image nasce com fundo transparente, bordas 24,24,224,224 (200 × 200), âncoras (0,0). Ajuste para 48 × 48 no HUD.
- **Visível:** o script pode esconder a camada cheia e deixar o coração vazio atrás. Image não tem valor de vida próprio, nem fillAmount.
- **Clicável, ações, estados e duas poses:** são opcionais; veja [interação/animação](/pt-br/snapshot-2026-10-06/ui/interacao-e-animacao/).

[Tutorial completo: HUD de corações](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Limitações e roadmap

Esticar/Conter/Cobrir disponíveis; nine-slice, sprite sheet e hit mask não estão entregues.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "HBox: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/hbox/
---

# HBox: uso e campos

Distribui filhos em uma linha.

## Para que serve

Distribui filhos em uma linha.

## Onde fica

**Interface → criar elemento → HBox**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → HBox**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Padding, Espaçamento, Alinhamento; filhos usam tamanho mínimo/preferido e peso.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.HBox**.

## Exemplo prático

Uma fileira de corações com tamanho preferido 48 × 48.

## Limitações e roadmap

Fora do fluxo retira o filho da distribuição; wrap automático não está documentado como suporte atual.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "VBox: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/vbox/
---

# VBox: uso e campos

Distribui filhos em uma coluna.

## Para que serve

Distribui filhos em uma coluna.

## Onde fica

**Interface → criar elemento → VBox**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → VBox**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Padding, Espaçamento e Alinhamento; filhos usam tamanho mínimo/preferido e peso.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.VBox**.

## Exemplo prático

Lista de instruções ou opções do menu.

## Limitações e roadmap

Para arrastar um filho manualmente, use Fora do fluxo; isso muda o contrato do layout.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Grid: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/grid/
---

# Grid: uso e campos

Distribui filhos em colunas.

## Para que serve

Distribui filhos em colunas.

## Onde fica

**Interface → criar elemento → Grid**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Grid**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Colunas, Espaçamento XY, Padding e tamanho dos filhos.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Grid**.

## Exemplo prático

Grade pequena de itens autorados.

## Limitações e roadmap

Virtualização, data binding e inventário completo são trabalhos R7/R8.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "Joystick: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/joystick/
---

# Joystick: uso e campos

Converte o gesto em eixo de ação.

## Para que serve

Converte o gesto em eixo de ação.

## Onde fica

**Interface → criar elemento → Joystick**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Joystick**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Ação, modo Fixo/Flutuante/Dinâmico, eixo, zona morta, raios e visual.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Joystick**.

## Exemplo prático

Mover o jogador ligado ao receptor do Canvas.

## Limitações e roadmap

Requer ação compatível e receptor; pareamento geral por jogador/hardware continua parcial em R4.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "ActionButton: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/actionbutton/
---

# ActionButton: uso e campos

Emite uma ação de entrada de botão para o receptor.

## Para que serve

Emite uma ação de entrada de botão para o receptor.

## Onde fica

**Interface → criar elemento → ActionButton**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → ActionButton**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Ação de botão, Habilitado, texto e estados.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.ActionButton**.

## Exemplo prático

Saltar ou Atirar; não confundir com Button que entrega eventos de GUI.

## Limitações e roadmap

Buffer e pareamento gerais continuam parciais; não presume toda ação de gameplay implementada.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "LookArea: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/lookarea/
---

# LookArea: uso e campos

Converte arraste em ação de olhar.

## Para que serve

Converte arraste em ação de olhar.

## Onde fica

**Interface → criar elemento → LookArea**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → LookArea**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Ação, sensibilidade e área de captura.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.LookArea**.

## Exemplo prático

Olhar a câmera atribuída ao Canvas.

## Limitações e roadmap

Depende de câmera/receptor compatíveis; composição de jogadores/viewports segue pendente.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.


---

---
title: "HUD de corações: do editor ao dano e cura"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/hud-coracoes/
---

# HUD de corações: do editor ao dano e cura

Monte três corações com Image, ligue à vida do jogador e confira dano, cura e zero vida.

## É possível nesta versão?

**Sim, pela composição Canvas UI + Image + Behavior C#.** Image desenha o ícone e permite mudar Visible. A regra de vida é implementada no script PlayerHealth do exemplo. Não existe um componente pronto de "HUD de corações" ou binding automático de vida no snapshot. Este tutorial usa três corações inteiros; meio coração/preenchimento radial exigem outra composição, e Image não tem fillAmount.

## O resultado e a árvore

```text
Jogador                         HUD (objeto da cena)
└─ PlayerHealth                 ├─ Canvas UI → UI/hud.aeui
                                └─ HeartHud → Player = Jogador

UI/hud.aeui (documento)
├─ Hearts (Panel, sem fundo)
│  ├─ Empty1 (Image vazio)       ← fica visível
│  ├─ Heart1 (Image cheio)       ← script liga/desliga
│  ├─ Empty2 (Image vazio)
│  ├─ Heart2 (Image cheio)
│  ├─ Empty3 (Image vazio)
│  └─ Heart3 (Image cheio)
├─ Status (Text)
├─ Damage (Button)
└─ Heal (Button)
```

Os seis Images ficam sobrepostos em pares. Ao esconder Heart2, Empty2 continua desenhado na mesma posição. Use Panel com layout manual aqui; esconder filhos diretos de HBox pode reorganizar a fileira. A ordem é relevante: vazio primeiro, cheio depois.

<figure class="astra-hud-figure"><div><img src="/examples/heart-hud/Images/heart-full.png" width="48" height="48" alt="Coração cheio" /><img src="/examples/heart-hud/Images/heart-full.png" width="48" height="48" alt="Coração cheio" /><img src="/examples/heart-hud/Images/heart-empty.png" width="48" height="48" alt="Coração vazio" /></div><figcaption>Vida 2/3: ilustração com os recursos do tutorial. A execução real ocorre na Astra em Play.</figcaption></figure>

## 1. Prepare os recursos

Adicione **Images/heart-full.png** e **Images/heart-empty.png** dentro do projeto. Use duas imagens 64 × 64 com alpha; ambas precisam existir e ser legíveis. [Baixe o pacote do tutorial](/examples/heart-hud/Astra-Heart-Hud.zip): inclui **UI/hud.aeui**, PNGs, scripts e [instruções](/examples/heart-hud/README.txt), para integrar num projeto existente. Abra e salve o .aeui pela área Interface para registrá-lo como recurso, ou siga a autoria manual abaixo. As duas imagens já aparecem no documento autoral, então o atlas conhece os dois recursos antes de esconder uma camada.

## 2. Crie o documento e preencha o layout

Siga [o caminho de autoria](/pt-br/snapshot-2026-10-06/ui/comece-aqui/) e salve **UI/hud.aeui**. Crie Panel e renomeie para **Hearts**. Selecionar Panel antes de criar Image faz os filhos pertencerem a ele. Todos usam âncoras inicial e final **(0,0)**.

| Elemento | Pai | Bordas: esquerda, topo, direita, base | Recurso / texto |
|---|---|---|---|
| Hearts, Panel | raiz | 24,24,184,72 | Desenhar fundo desligado |
| Empty1, Image | Hearts | 0,0,48,48 | Images/heart-empty.png |
| Heart1, Image | Hearts | 0,0,48,48 | Images/heart-full.png |
| Empty2, Image | Hearts | 56,0,104,48 | Images/heart-empty.png |
| Heart2, Image | Hearts | 56,0,104,48 | Images/heart-full.png |
| Empty3, Image | Hearts | 112,0,160,48 | Images/heart-empty.png |
| Heart3, Image | Hearts | 112,0,160,48 | Images/heart-full.png |
| Status, Text | raiz | 24,80,320,116 | Vida: 3/3 |
| Damage, Button | raiz | 24,124,124,168 | Dano |
| Heal, Button | raiz | 136,124,236,168 | Cura |

Para os Images, use **Ajuste = Conter**, **Tinta = branco**, **Visível = ligado**, **Clicável = desligado** e sem animação. Panel Hearts deve ter fundo transparente. Damage e Heal usam ação **Notificar**; não os configure para alterar Value do Image. Após criar os filhos, selecione a raiz/limpe a seleção antes de criar Status e os botões. Salve UI.

## 3. Configure a cena

1. Crie **HUD**, adicione **Canvas UI**, atribua **UI/hud.aeui** em **Documento UI**, use **Tela** e Habilitado.
2. Crie ou escolha **Jogador**. Ele pode ser só um objeto vazio para a demonstração por botão; física não é necessária nessa etapa.
3. Adicione os scripts abaixo na área de código, compile e anexe **PlayerHealth** a Jogador e **HeartHud** a HUD.
4. No Inspector do HeartHud, campo **Player**, escolha o objeto Jogador. Não escolha um Image da árvore UI: o campo é uma referência a objeto da cena.
5. Salve a cena e a UI. Receptor/câmera de entrada do Canvas podem ficar sem atribuição nesta demonstração visual.

## 4. Regra de vida: PlayerHealth.cs

[Baixar PlayerHealth.cs](/examples/heart-hud/PlayerHealth.cs)

```csharp
using System;
using Astra;

[ComponentId("docs.player-health")]
public sealed class PlayerHealth : Behavior
{
    public const int Capacity = 3;
    public int Current { get; private set; }
    public bool IsDead => Current == 0;

    public override void Awake() => Current = Capacity;

    public void TakeDamage(int amount)
    {
        Current = Math.Max(0, Current - Math.Clamp(amount, 0, Capacity));
    }

    public void Heal(int amount)
    {
        Current = Math.Min(Capacity, Current + Math.Clamp(amount, 0, Capacity));
    }
}
```

Awake começa com três corações. TakeDamage e Heal aceitam quantidades não negativas, limitadas à capacidade. Zero vida apenas muda o estado **IsDead**; este exemplo não inventa morte, respawn, animação ou persistência de save.

## 5. Ligar o estado às imagens: HeartHud.cs

[Baixar HeartHud.cs](/examples/heart-hud/HeartHud.cs)

```csharp
using System;
using Astra;

[ComponentId("docs.heart-hud")]
public sealed class HeartHud : Behavior
{
    [PropertyId("player")]
    public ObjectReference Player;

    private GuiAccess hud = null!;
    private PlayerHealth health = null!;
    private readonly GuiElement[] hearts = new GuiElement[PlayerHealth.Capacity];
    private GuiElement status;
    private int lastHealth = -1;

    public override void Start()
    {
        var player = Resolve(Player)
            ?? throw new InvalidOperationException("Atribua Jogador ao campo Player do HeartHud.");
        health = player.GetBehavior<PlayerHealth>()
            ?? throw new InvalidOperationException("Jogador precisa de PlayerHealth.");
        hud = Gui.ForCanvas(Object);
        for (int i = 0; i < hearts.Length; ++i)
        {
            hearts[i] = hud.Find($"Heart{i + 1}");
            if (hearts[i].Kind != GuiKind.Image)
                throw new InvalidOperationException($"Heart{i + 1} precisa ser Image.");
        }
        status = hud.Find("Status");
        hud.Find("Damage");
        hud.Find("Heal");
        Refresh();
    }

    public override void Update(float deltaTime)
    {
        // Este script é o consumidor da fila deste Canvas.
        while (hud.Poll(out var message))
        {
            if (message.Kind != GuiEventKind.Click) continue;
            if (message.Element.Name == "Damage") health.TakeDamage(1);
            else if (message.Element.Name == "Heal") health.Heal(1);
        }
        if (lastHealth != health.Current) Refresh();
    }

    private void Refresh()
    {
        lastHealth = health.Current;
        for (int i = 0; i < hearts.Length; ++i)
            hearts[i].Visible = i < lastHealth;
        status.Text = $"Vida: {lastHealth}/{PlayerHealth.Capacity}"
            + (health.IsDead ? " | Sem vida" : "");
    }
}
```

Gui.ForCanvas(Object) escolhe o Canvas do objeto HUD. Start resolve nomes e conserva handles somente desta execução. O script verifica os tipos dos corações e falha com mensagem quando Player/PlayerHealth estão ausentes. Update consome os botões e só escreve as imagens quando a vida muda. Não precisa procurar Heart1–3 a cada frame.

## 6. Dano vindo do gameplay

Outro Behavior pode resolver o jogador e chamar `player.GetBehavior<PlayerHealth>()?.TakeDamage(1)` no momento real de um ataque. Para uma zona de dano, o arquivo abaixo usa **TriggerEnter**, uma vez por entrada, não TriggerStay a cada passo:

```csharp
using Astra;

[ComponentId("docs.heart-damage-trigger")]
public sealed class HeartDamageTrigger : Behavior
{
    public override void TriggerEnter(ObjectReference other)
    {
        Resolve(other)?.GetBehavior<PlayerHealth>()?.TakeDamage(1);
    }
}
```

[Baixar HeartDamageTrigger.cs](/examples/heart-hud/HeartDamageTrigger.cs). Anexe à zona com corpo/colisor 3D em modo sensor. O outro objeto precisa participar da física 3D e carregar PlayerHealth. Consulte [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/), [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/) e [eventos físicos](/pt-br/snapshot-2026-10-06/sistemas/fisica-3d/). Eventos 2D têm contrato próprio; não substitua assinaturas por suposição. O script não define cooldown nem identifica filhos sem PlayerHealth: coloque o Behavior no objeto resolvido pelo evento ou adapte a busca explicitamente.

## 7. Conferir o resultado

| Ação em Play | Vida esperada | HUD esperado |
|---|---|---|
| Iniciar | 3 | três cheios, texto Vida: 3/3 |
| Dano | 2 | dois cheios e um vazio |
| Dano duas vezes | 0 | três vazios, texto Sem vida |
| Dano em zero | 0 | continua zero |
| Cura | 1 | um cheio e dois vazios |
| Cura até o máximo | 3 | não ultrapassa três |
| Parar e reabrir Play | 3 | reinicia, documento autoral preservado |

**Interagir não executa esses scripts.** Use Play para validar a ligação com a vida. Se a fonte recarregar durante Play, resolva novos handles ou reinicie.

Os três scripts deste tutorial compilaram sem erros contra o SDK do APK publicado. O documento do pacote foi gravado e relido pelo serializador nativo: formato AEUI 5, dez elementos. Isso verifica contratos e formato; o roteiro acima ainda precisa de aceite no Play e no aparelho. Consulte o [manifesto de exemplos](/snapshot-2026-10-06/examples.json) para a evidência de compilação.

## Responsividade, limite e roadmap

Os corações usam 160 × 48 px e margem 24 px no viewport Tela. Eles conservam tamanho e posição no canto superior esquerdo, sem assumir escala por resolução de referência. Confira landscape pequeno e tablet, notch/área segura, contraste e espaço da cena. Safe area automática e escala responsiva completa continuam em R5. Para fileira flexível, use HBox com **slots Panel** de tamanho preferido 48 × 48 e as duas Images dentro de cada slot.

Meios corações podem ser autorados com imagens adicionais e regra de meio ponto; nine-slice, fill radial, binding automático, timeline e templates completos continuam no [roadmap](/pt-br/snapshot-2026-10-06/ui/roadmap/). Vida persistente entre sessões pede SaveStore e regra explícita de save/load; não é consequência de salvar UI. Para erros, veja [diagnóstico de Image e HUD](/pt-br/snapshot-2026-10-06/ui/diagnostico/).


---

---
title: "Mapa de acesso: encontre a função antes de programar"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/
---

# Mapa de acesso: encontre a função antes de programar

Caminhos do editor, elementos UI, APIs e roadmap, começando pela intenção do usuário.

## Quero criar um HUD

Use [UI de jogo: onde fica](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). O componente é Canvas UI; Image, Text, Button e containers ficam no documento .aeui. [Corações com dano/cura](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) inclui campos, árvore, recursos e scripts.

## Quero editar um campo de componente

Hierarquia → objeto → Inspector → componente → grupo → campo. O [catálogo](/pt-br/snapshot-2026-10-06/componentes/) busca também nomes e IDs de propriedades. Cada tabela liga a uma explicação com caminho, efeito, valor inicial, domínio, unidade e condições. Escolha o slot quando o campo é por recurso/parte.

## Quero chamar uma função C#

Área de código → Behavior → compile → anexe ao objeto. Abra a [referência C#](/pt-br/snapshot-2026-10-06/api/), encontre o tipo e o membro; leia Onde acessar este tipo, Caminho, Uso, argumentos e Roadmap. Métodos de física exigem composição; tipos de valor/enums não criam componentes pelo nome.

## Objeto, componente ou elemento UI?

- **Objeto:** entidade da Hierarquia da cena, com pose e componentes.
- **Componente:** função anexada ao objeto, como Corpo físico ou Canvas UI.
- **Recurso:** arquivo registrado, como Documento UI, clipe ou textura.
- **Elemento UI:** nó dentro do documento, como Image; GuiElement identifica a cópia runtime da instância.
- **API/runtime:** acesso do script ao consumidor no Play. [Conceitos de composição](/pt-br/snapshot-2026-10-06/conceitos/composicao-de-componentes/).

## Quero saber se é possível hoje

Consulte a função e seus limites antes de implementar. [Roadmap UI](/pt-br/snapshot-2026-10-06/ui/roadmap/), [renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/) e [91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) registram estados diferentes. Não há plano individual datado para todos os getters/setters. A referência mantém explícitos os membros cuja explicação especializada ainda está em revisão.

## Exemplos para usar

O [pacote de corações](/examples/heart-hud/Astra-Heart-Hud.zip) contém UI/hud.aeui, imagens e scripts para integrar num projeto existente. Não é uma cena completa por importação automática. O tutorial também ensina a autoria manual. Os [manifestos](/snapshot-2026-10-06/examples.json) distinguem compilação e execução.


---

---
title: "Roadmap: Restrições e molas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/
---

# Roadmap: Restrições e molas

Caminho atual, componentes e fechamento pendente de restrições e molas.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Mola de posição](/pt-br/snapshot-2026-10-06/componentes/astra-spring-position/) | Segue fonte com velocidade e amortecimento persistentes no runtime | 9 |
| [Mola de rotação](/pt-br/snapshot-2026-10-06/componentes/astra-spring-rotation/) | Segue orientação por quaternion com amortecimento e caminho curto | 9 |
| [Mola de escala](/pt-br/snapshot-2026-10-06/componentes/astra-spring-scale/) | Segue escala positiva sem publicar escala singular | 9 |
| [Position Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/) | Restrição de mundo com uma fonte | 9 |
| [Rotation Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-rotation/) | Restrição de mundo com uma fonte | 9 |
| [Scale Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-scale/) | Restrição de mundo com uma fonte | 9 |
| [Aim Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-aim/) | Restrição de mundo com uma fonte | 11 |
| [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/) | Segue posição e rotação da fonte sem herdar escala | 15 |
| [Look At Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-look-at/) | Orienta +Z para a fonte com vertical e roll | 8 |

## Caminho de uso

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Cenário concreto

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.

## Próximo trabalho e limitações

Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Tempo, eventos e tweens"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/
---

# Roadmap: Tempo, eventos e tweens

Caminho atual, componentes e fechamento pendente de tempo, eventos e tweens.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Transform Tween](/pt-br/snapshot-2026-10-06/componentes/astra-tween-transform/) | Interpola canais locais com espera, curva e repetição | 23 |
| [Timer](/pt-br/snapshot-2026-10-06/componentes/astra-time-timer/) | Dispara eventos temporizados e ações persistentes de ativação de objetos | 7 |
| [Conexão de evento](/pt-br/snapshot-2026-10-06/componentes/astra-logic-event-connection/) | Evento deste objeto aciona objetos ou métodos, sem script | 8 |

## Caminho de uso

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

## Cenário concreto

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.

## Próximo trabalho e limitações

Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Renderização e materiais"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/
---

# Roadmap: Renderização e materiais

Caminho atual, componentes e fechamento pendente de renderização e materiais.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Malha](/pt-br/snapshot-2026-10-06/componentes/astra-render-mesh/) | Geometria e material | 80 |
| [LOD Group](/pt-br/snapshot-2026-10-06/componentes/astra-render-lod-group/) | Nível de detalhe pela altura na tela | 18 |
| [Ambiente](/pt-br/snapshot-2026-10-06/componentes/astra-render-environment/) | Céu, atmosfera, neblina e pós globais ou por volume | 77 |
| [Luz](/pt-br/snapshot-2026-10-06/componentes/astra-render-light/) | Direcional, pontual ou spot | 18 |

## Caminho de uso

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Cenário concreto

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.

## Próximo trabalho e limitações

Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Capacidade efetiva do renderer

[Leia as 41 capacidades registradas](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/), incluindo itens planejados e limitados pelo backend.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Câmera e navegação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/
---

# Roadmap: Câmera e navegação

Caminho atual, componentes e fechamento pendente de câmera e navegação.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Câmera](/pt-br/snapshot-2026-10-06/componentes/astra-camera/) | Projeção e enquadramento | 8 |
| [Olhar](/pt-br/snapshot-2026-10-06/componentes/astra-camera-look/) | Rotação local da câmera por entrada ou script | 4 |
| [Acompanhar alvo](/pt-br/snapshot-2026-10-06/componentes/astra-camera-follow/) | Posiciona a câmera após física e animação | 6 |

## Caminho de uso

Crie uma câmera ativa; escolha projeção e planos. Olhar recebe entrada e Acompanhar alvo recebe uma referência. Não use a pose da câmera como fonte implícita de física do jogador.

## Cenário concreto

Atribua um alvo a Acompanhar alvo e mova-o. Compare Damping 0 com um tempo maior. Teste perspectiva/ortográfica com a mesma malha enquadrada.

## Próximo trabalho e limitações

Consolidar composição de rigs, apresentação e aceite de input/viewports. Pareamento geral de jogadores/câmeras pertence também ao roadmap UI R4/R9; não há data por método.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Física 3D e motores"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/
---

# Roadmap: Física 3D e motores

Caminho atual, componentes e fechamento pendente de física 3d e motores.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Receita de colisão](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collision-recipe/) | Fontes e base das partes para regeneração explícita preservando edições | 128 |
| [Campo de gravidade](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-gravity/) | Gravidade local em volume sobre corpos dinâmicos | 16 |
| [Campo de vento](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-wind/) | Arrasto para velocidade local do ar, dependente da massa | 16 |
| [Campo de arrasto](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-drag/) | Amortecimento linear e angular local | 14 |
| [Campo radial](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-radial/) | Atração, repulsão e vórtice ao redor do centro | 14 |
| [Conexão física 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-event-connection/) | Evento de sensor/contato altera a ativação de um receptor | 5 |
| [Força constante](/pt-br/snapshot-2026-10-06/componentes/astra-physics-constant-force/) | Força e torque contínuos sobre corpo dinâmico | 13 |
| [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/) | Massa e resposta física | 25 |
| [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/) | Locomoção com cápsula | 10 |
| [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/) | Volume de contato | 20 |
| [Junta](/pt-br/snapshot-2026-10-06/componentes/astra-physics-joint/) | Nove mecanismos Jolt com limites, referenciais e motores | 93 |
| [Motor dinâmico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/) | Locomoção por força e salto com apoio sobre Corpo físico dinâmico | 12 |

## Caminho de uso

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Cenário concreto

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.

## Próximo trabalho e limitações

Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Física 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/
---

# Roadmap: Física 2D

Caminho atual, componentes e fechamento pendente de física 2d.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Campo de gravidade 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-gravity/) | Gravidade XY em área sobre corpos dinâmicos 2D | 13 |
| [Campo de vento 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-wind/) | Acoplamento XY à velocidade do ar com massa real | 13 |
| [Campo de arrasto 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-drag/) | Amortecimento linear XY e angular de Body2D | 12 |
| [Campo radial 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-radial/) | Atração, repulsão e vórtice no plano XY | 12 |
| [Conexão física 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-event-connection/) | Evento real de sensor/contato 2D altera ativação do receptor | 5 |
| [Força constante 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-constant-force/) | Força XY e torque contínuos sobre Body2D dinâmico | 6 |
| [Junta 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-joint/) | Fixed/Weld, Revolute, Prismatic ou Distance reais | 31 |
| [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/) | Corpo XY independente de física 3D | 10 |
| [Colisor 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-collider/) | Caixa, círculo ou cápsula; sensor real | 10 |

## Caminho de uso

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Cenário concreto

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.

## Próximo trabalho e limitações

Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Áudio"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/audio/
---

# Roadmap: Áudio

Caminho atual, componentes e fechamento pendente de áudio.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Audio Source](/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/) | Clipe de projeto com reprodução e espaço acústico | 17 |
| [Audio Listener](/pt-br/snapshot-2026-10-06/componentes/astra-audio-listener/) | Pose e volume de escuta escolhidos por prioridade | 3 |
| [Audio Bus](/pt-br/snapshot-2026-10-06/componentes/astra-audio-bus/) | Roteamento de ganho, mute e solo até Master | 5 |

## Caminho de uso

Atribua um clipe do projeto ao Audio Source e confira reprodução, volume, mute e bus. Escolha escuta e espacialização; prioridade decide o listener efetivo.

## Cenário concreto

Um Audio Source e um Audio Listener: toque um clipe, altere volume/mute e depois compare estéreo com 3D movendo a fonte.

## Próximo trabalho e limitações

Ampliar transporte, formatos, mixer e diagnóstico de backend. Seek não deve ser presumido como disponível porque há cursor de reprodução. Conferir saída física no aparelho é uma evidência separada.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Animação e deformação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/animacao/
---

# Roadmap: Animação e deformação

Caminho atual, componentes e fechamento pendente de animação e deformação.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Malha deformável](/pt-br/snapshot-2026-10-06/componentes/astra-render-skinned-mesh/) | Esqueleto e blend shapes da Malha | 3 |
| [Animação](/pt-br/snapshot-2026-10-06/componentes/astra-animation/) | Clipes tocados e misturados no Play | 5 |

## Caminho de uso

Atribua clipes/recursos e escolha reprodução. SkinnedMesh precisa dos dados de deformação compatíveis; um nome de clip ou blend shape não cria esse recurso.

## Cenário concreto

Use um recurso com clipe real, compare Speed 0/1 e modos de repetição; confira deformação e bounds antes de usar culling.

## Próximo trabalho e limitações

Ampliar importação, composição, edição de clipes e aceite de deformação/motion vectors. Timeline de UI é outro sistema e continua parcial. Não pressupõe Animator completo.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Caminhos e seguidores"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/caminhos/
---

# Roadmap: Caminhos e seguidores

Caminho atual, componentes e fechamento pendente de caminhos e seguidores.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Path](/pt-br/snapshot-2026-10-06/componentes/astra-path/) | Curva Bézier local com pontos persistentes | 14 |
| [Path Follow](/pt-br/snapshot-2026-10-06/componentes/astra-path-follow/) | Percorre curva em distância mundial e orienta +Z | 13 |

## Caminho de uso

Crie Path com pontos/tangentes persistentes e atribua o objeto ao Path Follow. Distância e orientação dependem da curva e da pose mundial.

## Cenário concreto

Autore uma curva com três pontos, atribua o alvo e percorra em velocidade constante; salve/reabra os pontos e compare orientação +Z e direção reversa.

## Próximo trabalho e limitações

Aprofundar ferramentas de pontos/tangentes, visualização e cenários de escala/lifecycle. Path não é navmesh, pathfinding ou spline universal importada.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: Objetos, Behaviors e composição"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/
---

# Roadmap: Objetos, Behaviors e composição

Caminho atual, componentes e fechamento pendente de objetos, behaviors e composição.

## Estado deste recorte

Os registros abaixo existem no contrato compilado do snapshot. Esta página organiza o uso e o trabalho de fechamento; não declara toda a família funcionalmente concluída. [Registro de 91 famílias](/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/) preserva estados e dependências do inventário base de 01/10. UI e controles têm [revisão específica mais recente](/pt-br/snapshot-2026-10-06/ui/roadmap/).

## Funções e componentes

| Componente | Função | Campos documentados |
|---|---|---|
| [Comportamento](/pt-br/snapshot-2026-10-06/componentes/astra-script-behavior/) | Código C# do projeto | 1 |

## Caminho de uso

Crie um Behavior C# com ComponentId estável, compile o projeto e anexe ao objeto. Campos públicos suportados e PropertyId aparecem no Inspector; callbacks recebem o mundo do Play.

## Cenário concreto

Anexe PlayerHealth ao Jogador e HeartHud ao HUD; atribua a referência Player, compile e entre em Play.

## Próximo trabalho e limitações

Consolidar cenas, prefabs, contratos de scripts e mensagens, com referência remapeada e lifecycle correto. Contagem de APIs não mede fechamento funcional. Comportamento não validado deve permanecer explicitamente sem aceite.

Este fechamento é orientação de documentação e aceitação. Não é uma nova promessa de implementação nem uma data de entrega de cada getter/setter. Quando não há tarefa individual registrada para um membro, a referência informa esse fato e o relaciona à família.

## Critério de fechamento

Resolver dependências → criar pelo editor/API → alterar propriedade com efeito observável → salvar/reabrir dados autorais → executar lifecycle → remover sem handle pendente → registrar resultado no host e no dispositivo quando aplicável. Código, compilação, pacote e execução física são evidências distintas.

## Navegar até uma função

Abra o componente, siga a fachada C# e escolha o membro pelo índice. Cada membro mostra o acesso, uso e este vínculo de roadmap; os campos do componente têm links próprios. Para exemplos de projeto, veja [HUD funcional](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) e [receitas](/pt-br/snapshot-2026-10-06/receitas/mover-em-espaco-local/).


---

---
title: "Roadmap: registro de 91 famílias"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/registro-de-familias/
---

# Roadmap: registro de 91 famílias

Estados do inventário base, requisitos e dependências, sem confundir pesquisa com capacidade pronta.

## Data e significado dos estados

Inventário base **2026-10-01**, lido para esta publicação em **2026-10-06**. Uma linha é uma capacidade/família, não um tipo, API ou propriedade. Auditar não significa ausência de código.

“Concluída no registro de origem” preserva a declaração daquele registro com seus limites. “Auditar” não significa ausência de implementação: exige reconciliar código, propriedade, persistência, criação e aceite. O registro base não incorpora automaticamente todas as continuações posteriores, como a UI de 04–06/10; leia o [roadmap UI atualizado](/pt-br/snapshot-2026-10-06/ui/roadmap/) e a página da capacidade antes de decidir suporte. Não há datas de entrega por função publicadas.

## Índice

| ID | Capacidade pesquisada | Estado do registro |
|---|---|---|
| [F001](#f001) | B Objeto / Unity GameObject, Godot Node | Concluída no registro de origem |
| [F002](#f002) | B Transform 3D / Transform, Node3D | Concluída no registro de origem |
| [F003](#f003) | B Transform 2D / RectTransform/Transform, Node2D | Auditar |
| [F004](#f004) | R/S Cena / Scene, PackedScene/SceneTree | Auditar |
| [F005](#f005) | R Prefab/subcena / Prefab, PackedScene | Parcial |
| [F006](#f006) | R Receita/preset | Concluída no registro de origem |
| [F007](#f007) | C Comportamento / MonoBehaviour, script em Node | Concluída no registro de origem |
| [F008](#f008) | S Eventos/conexões / UnityEvent, signals | Auditar |
| [F009](#f009) | C/S Timer / timers de gameplay, Timer | Concluída no registro de origem |
| [F010](#f010) | R/S Tween / animação de propriedades, Tween | Parcial |
| [F011](#f011) | S Grupos/tags/consultas | Concluída no registro de origem |
| [F012](#f012) | R Mesh / Mesh, ArrayMesh | Auditar |
| [F013](#f013) | C MeshRenderer / MeshFilter+MeshRenderer, MeshInstance3D | Auditar |
| [F014](#f014) | C SkinnedMesh / SkinnedMeshRenderer, MeshInstance3D+Skin+Skeleton3D | Auditar |
| [F015](#f015) | C InstancedRenderer / instancing Unity, MultiMeshInstance3D | Auditar |
| [F016](#f016) | C LODGroup / LODGroup, visibility ranges | Auditar |
| [F017](#f017) | R Shader | Auditar |
| [F018](#f018) | R Material / Material, ShaderMaterial | Auditar |
| [F019](#f019) | R Texture / Texture, Texture2D | Auditar |
| [F020](#f020) | R Sampler/binding | Auditar |
| [F021](#f021) | R RenderTarget / RenderTexture, ViewportTexture | Auditar |
| [F022](#f022) | C Camera / Camera, Camera3D | Auditar |
| [F023](#f023) | C CameraRig / Cinemachine, composição Camera3D+SpringArm3D | Auditar |
| [F024](#f024) | C Decal / URP DecalProjector, Decal | Auditar |
| [F025](#f025) | C Line/Trail / LineRenderer/TrailRenderer, Line2D | Auditar |
| [F026](#f026) | C Light / Light; DirectionalLight3D, OmniLight3D, SpotLight3D | Auditar |
| [F027](#f027) | Configuração de sombra | Auditar |
| [F028](#f028) | C/R Ambiente / Volume, WorldEnvironment | Auditar |
| [F029](#f029) | R Céu/atmosfera | Auditar |
| [F030](#f030) | C ReflectionProbe | Auditar |
| [F031](#f031) | C Irradiance/LightProbe volume | Auditar |
| [F032](#f032) | R Lightmap/bake settings | Auditar |
| [F033](#f033) | C Fog volume | Auditar |
| [F034](#f034) | C/R WaterBody/WaterWorld | Auditar |
| [F035](#f035) | C Corpo 3D / Rigidbody, RigidBody3D/StaticBody3D/AnimatableBody3D | Auditar |
| [F036](#f036) | C Collider box/sphere/capsule | Auditar |
| [F037](#f037) | C Collider convex/mesh/heightfield | Auditar |
| [F038](#f038) | C Composição de colisores | Auditar |
| [F039](#f039) | R PhysicsMaterial | Auditar |
| [F040](#f040) | C Sensor/Area | Auditar |
| [F041](#f041) | C Joint fixo/hinge/slider/spring/6DOF | Auditar |
| [F042](#f042) | C CharacterMotor / CharacterController, CharacterBody3D | Auditar |
| [F043](#f043) | S Physics queries | Auditar |
| [F044](#f044) | C/R Ragdoll | Auditar |
| [F045](#f045) | C/S Physics2D | Auditar |
| [F046](#f046) | R/S ActionMap/InputContext | Auditar |
| [F047](#f047) | C/R Canvas/root UI | Auditar |
| [F048](#f048) | C Rect/layout | Auditar |
| [F049](#f049) | C Containers row/column/grid/flow | Auditar |
| [F050](#f050) | C Image/NineSlice | Auditar |
| [F051](#f051) | C Text/RichText | Auditar |
| [F052](#f052) | C Button/Toggle/Radio | Auditar |
| [F053](#f053) | C Slider/Range/Progress | Auditar |
| [F054](#f054) | C Scroll/List/Tree/Dropdown | Auditar |
| [F055](#f055) | C TextInput | Auditar |
| [F056](#f056) | R Theme/Style | Auditar |
| [F057](#f057) | S Accessibility/Localization | Auditar |
| [F058](#f058) | R AudioClip/Stream | Parcial |
| [F059](#f059) | C AudioSource 2D/3D | Parcial |
| [F060](#f060) | C AudioListener | Concluída no registro de origem |
| [F061](#f061) | R/S Mixer/buses/effects | Parcial |
| [F062](#f062) | R AnimationClip | Auditar |
| [F063](#f063) | C AnimationPlayer | Auditar |
| [F064](#f064) | R Animator graph | Auditar |
| [F065](#f065) | C/R Rig/IK/constraints | Auditar |
| [F066](#f066) | R/C Timeline | Auditar |
| [F067](#f067) | C NavigationRegion/Surface | Auditar |
| [F068](#f068) | C NavigationAgent | Auditar |
| [F069](#f069) | C NavigationObstacle/Link | Auditar |
| [F070](#f070) | C Perception/state logic | Auditar |
| [F071](#f071) | C Sprite/AnimatedSprite | Auditar |
| [F072](#f072) | R TileSet / C TileMapLayer | Auditar |
| [F073](#f073) | C Camera2D/Parallax | Auditar |
| [F074](#f074) | C Light2D/Occluder2D | Auditar |
| [F075](#f075) | C/R ParticleEmitter | Auditar |
| [F076](#f076) | R Curve/Gradient | Concluída no registro de origem |
| [F077](#f077) | R Spline / C Path | Concluída no registro de origem |
| [F078](#f078) | C PathFollower | Concluída no registro de origem |
| [F079](#f079) | C Terrain | Auditar |
| [F080](#f080) | C Foliage/scatter | Auditar |
| [F081](#f081) | S World streaming | Auditar |
| [F082](#f082) | S SaveGame | Auditar |
| [F083](#f083) | E Import profiles | Auditar |
| [F084](#f084) | E Inspector extensions | Auditar |
| [F085](#f085) | E Code/graph workspace | Auditar |
| [F086](#f086) | E Profiler/debug overlays | Auditar |
| [F087](#f087) | S Build/export profiles | Auditar |
| [F088](#f088) | C/S Network identity/replication | condicional |
| [F089](#f089) | C XR origin/controller/AR data | condicional |
| [F090](#f090) | C VideoPlayer | condicional |
| [F091](#f091) | C Vehicle/Cloth/SoftBody | condicional |

<h2 id="f001">F001 · B Objeto / Unity GameObject, Godot Node</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** ID, nome, ativo próprio/efetivo, pai, ordem, grupos, layer; criar/destruir/duplicar/consultar

**Dependências e riscos:** Mundo+geração; nome não é identidade; ciclo rejeitado; filhos e referências remapeados em duplicação

**Limites do aceite registrado:** Revisão ABI34 não instalada/executada no aparelho; captura é do executável host, não Vulkan Android.


<h2 id="f002">F002 · B Transform 3D / Transform, Node3D</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Posição/rotação/escala local, pose mundial, pivô/convenções, reparent com preservar local ou mundo, conversão de ponto/vetor/direção

**Dependências e riscos:** Um escritor de pose por fase; shear e escala negativa têm política; invalidar descendentes/bounds

**Limites do aceite registrado:** Revisão ABI34 não instalada/executada no aparelho; captura é do executável host, não Vulkan Android.


<h2 id="f003">F003 · B Transform 2D / RectTransform/Transform, Node2D</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Posição, ângulo, escala, skew/pivô se suportado, z/sorting, local/mundo

**Dependências e riscos:** Não misturar ângulo em radianos/graus; 2D não herda automaticamente física 3D


<h2 id="f004">F004 · R/S Cena / Scene, PackedScene/SceneTree</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Recurso, raiz, cenas aditivas, load/unload, progresso, cancelamento, cena ativa

**Dependências e riscos:** Dependências de assets; publication atômica; IDs persistentes versus handles de execução


<h2 id="f005">F005 · R Prefab/subcena / Prefab, PackedScene</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Parcial.

**O que a função precisa entregar:** Raiz e filhos, overrides por PropertyId, elementos adicionados/removidos, variantes, apply/revert, instanciar

**Dependências e riscos:** Grafo acíclico de dependências; contexto de edição; propagação não apaga overrides

**Lacunas registradas:** Reconciliar adição/remoção/reparent de objetos da árvore.; Nested prefabs e variantes com dependências acíclicas.

**Limites do aceite registrado:** Sem execução física Android desta revisão.


<h2 id="f006">F006 · R Receita/preset</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Componentes iniciais, defaults, requisitos, referências externas, remapeamento

**Dependências e riscos:** Cria composição via resolvedor; não acrescenta classes especiais por demo

**Limites do aceite registrado:** Sem instalacao/execucao fisica Android desta revisao. UI e runtime verificados no host; arquivo de receita v3, ABI34 no APK.


<h2 id="f007">F007 · C Comportamento / MonoBehaviour, script em Node</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Fonte/tipo/instância, ativação, propriedades expostas, ordem, callbacks, erros

**Dependências e riscos:** Compilação + mundo; múltiplas instâncias por contrato; referência desconhecida preservada

**Limites do aceite registrado:** Cenarios e capturas historicos reconciliados; nao reexecutados nesta revisao. Sem instalacao/execucao fisica nova da ABI34.


<h2 id="f008">F008 · S Eventos/conexões / UnityEvent, signals</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Assinatura, emissor/receptor, método/ação, payload, prioridade, conexão/desconexão, sinal único

**Dependências e riscos:** Tipagem, lifetime, reentrância, ownership e despacho em thread definida


<h2 id="f009">F009 · C/S Timer / timers de gameplay, Timer</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Intervalo, repetição, ativação, autostart e escolha de relógio; início/parada/pausa e restante pelo scheduler real

**Dependências e riscos:** Scheduler do Play, evento ABI/C#, cancelamento em Stop/destruição; controles na Inspeção durante Play

**Limites do aceite registrado:** Reconciliacao atual usa cenarios host e capturas existentes; nao reexecutados nesta revisao. Pacote ABI34 conferido; sem execucao fisica Android nova.


<h2 id="f010">F010 · R/S Tween / animação de propriedades, Tween</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Parcial.

**O que a função precisa entregar:** Alvo, PropertyId, origem/destino, duração, easing, sequência/paralelo, loop

**Dependências e riscos:** Propriedade elegível; cancelamento e concorrência com física/animação definidos

**Lacunas registradas:** Sequencia/paralelo compostos ainda sem contrato persistente e scheduler; TransformTween e NumberTween isolados funcionam.


<h2 id="f011">F011 · S Grupos/tags/consultas</h2>

**Família:** Identidade, cenas, composição e execução — P01–P06. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Membership múltipla, consulta, escopo de mundo, layers separados

**Dependências e riscos:** Grupos de organização não viram máscara física automaticamente

**Limites do aceite registrado:** Reconciliacao atual usa cenarios host e capturas existentes; nao reexecutados nesta revisao. Pacote ABI34 conferido; sem execucao fisica Android nova.


<h2 id="f012">F012 · R Mesh / Mesh, ArrayMesh</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Vértices/índices, atributos, topologia, submeshes, bounds, derivados, flags de leitura

**Dependências e riscos:** Importador/cooker, buffers RHI; preservação de fonte e GUID


<h2 id="f013">F013 · C MeshRenderer / MeshFilter+MeshRenderer, MeshInstance3D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Mesh, slots de material, enabled, shadows, visibility/layers, sorting, bounds override

**Dependências e riscos:** Mesh renderizável, material compatível; colisor independente


<h2 id="f014">F014 · C SkinnedMesh / SkinnedMeshRenderer, MeshInstance3D+Skin+Skeleton3D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Skin, root/bones, bind poses, pesos, quality, bounds, morph weights

**Dependências e riscos:** Mesh/skin, alvos válidos e backend de deformação; limite reportado


<h2 id="f015">F015 · C InstancedRenderer / instancing Unity, MultiMeshInstance3D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Recurso mesh, transforms/cores por instância, custom data, bounds, culling

**Dependências e riscos:** Buffers/instâncias; compartilhamento sem alias indevido


<h2 id="f016">F016 · C LODGroup / LODGroup, visibility ranges</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Níveis, renderers, limiares, fade, referência de tamanho, culling

**Dependências e riscos:** Objetos descendentes/alvos válidos; recursos e política por vista


<h2 id="f017">F017 · R Shader</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Parâmetros tipados, passes, variantes, keywords/perfil, tipos de textura e bindings

**Dependências e riscos:** Compilação/reflexão, pipeline RHI; mensagens de erro apontam fonte


<h2 id="f018">F018 · R Material / Material, ShaderMaterial</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Shader, parâmetros escalares/vetores/cores/texturas, blend/cull/depth conforme shader

**Dependências e riscos:** Shader + recursos; material compartilhado versus override de instância


<h2 id="f019">F019 · R Texture / Texture, Texture2D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Fonte, espaço de cor, formato, dimensões, mipmaps, compressão, streaming

**Dependências e riscos:** Decode/cooker/residência; importação distinta de edição de sampler


<h2 id="f020">F020 · R Sampler/binding</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Wrap U/V/W, filtro min/mag/mip, anisotropia, UV set/transform por binding

**Dependências e riscos:** Imagem/view/sampler separados; capacidade de aparelho explícita


<h2 id="f021">F021 · R RenderTarget / RenderTexture, ViewportTexture</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tamanho/escala, cor/depth, formato, MSAA, lifetime e resize

**Dependências e riscos:** View/render graph; não pode ler/escrever recurso em conflito


<h2 id="f022">F022 · C Camera / Camera, Camera3D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Perspective/ortho, FOV/tamanho, near/far, aspect/viewport, priority/main, mask, target, clear, exposure

**Dependências e riscos:** Transform completo, view; câmera editor separada; roll preservado


<h2 id="f023">F023 · C CameraRig / Cinemachine, composição Camera3D+SpringArm3D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Follow de posição, offset e damping implementados; look-at, limites, colisão, blend pendentes

**Dependências e riscos:** `astra.camera.follow` requer Camera e alvo por referência; executa após física


<h2 id="f024">F024 · C Decal / URP DecalProjector, Decal</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Material, box size, normal/angle fade, distância, mask, ordem

**Dependências e riscos:** Passe/backend decal, render layers; sem equivalência a mesh decal automática


<h2 id="f025">F025 · C Line/Trail / LineRenderer/TrailRenderer, Line2D</h2>

**Família:** Recursos, geometria, materiais e câmeras — P05/P08. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Pontos, largura por curva, material, cor/gradient, duração, caps/joins, espaço

**Dependências e riscos:** Recurso curva/material, renderer de linha; dimensionalidade explícita


<h2 id="f026">F026 · C Light / Light; DirectionalLight3D, OmniLight3D, SpotLight3D</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tipo, cor/temperatura, unidade/intensidade, alcance, cone, layers, enable

**Dependências e riscos:** Renderer/light cluster, pose; unidade por tipo e conversões documentadas


<h2 id="f027">F027 · Configuração de sombra</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Cast, bias/normal bias, resolution/budget, distance, cascades/faces, filtering

**Dependências e riscos:** Shadow passes reais, atlas, backend/aparelho


<h2 id="f028">F028 · C/R Ambiente / Volume, WorldEnvironment</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Sky, exposure, tone map, ambient, fog, effects/profile, prioridade, blend

**Dependências e riscos:** Perfis tipados, consumidor de render; global versus local


<h2 id="f029">F029 · R Céu/atmosfera</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** HDRI, orientação, sol, intensidade, turbidez/parâmetros físicos pertinentes

**Dependências e riscos:** Atmosfera/env map existentes; iluminação e fundo separados


<h2 id="f030">F030 · C ReflectionProbe</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Shape/extents, offset, capture/baked data, resolution, layers, refresh, blend

**Dependências e riscos:** Captura, cubemap/atlas e seleção por instância


<h2 id="f031">F031 · C Irradiance/LightProbe volume</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Distribuição, bake data, bounds, interpolation, atualização

**Dependências e riscos:** Bake e amostragem indireta real


<h2 id="f032">F032 · R Lightmap/bake settings</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** UV set, texel density, charts, atlas, output, quality, cancel/progress

**Dependências e riscos:** Geometria/material/luz estáticos, bake job e renderer


<h2 id="f033">F033 · C Fog volume</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Forma, densidade, albedo/emissão, anisotropia se implementada, falloff

**Dependências e riscos:** Integração volumétrica; neblina simples não equivale a volume


<h2 id="f034">F034 · C/R WaterBody/WaterWorld</h2>

**Família:** Luz, ambiente e volumes — P08/P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Forma/limites, material, ondas, corrente, profundidade, buoyancy/queries

**Dependências e riscos:** Sistema de água já existente, renderer e física sincronizados


<h2 id="f035">F035 · C Corpo 3D / Rigidbody, RigidBody3D/StaticBody3D/AnimatableBody3D</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tipo de movimento, massa/densidade se suportada, gravidade, damping, COM/inércia, velocities, forças/impulsos/torques, sleep, CCD/interpolation, locks

**Dependências e riscos:** Mundo Jolt, shapes pertinentes; modo determina escritor da pose


<h2 id="f036">F036 · C Collider box/sphere/capsule</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tamanho/raio/altura, centro/rotação local, enabled, sensor, material, layers/masks

**Dependências e riscos:** Forma independente da mesh; corpo estático implícito ou relação explícita definida


<h2 id="f037">F037 · C Collider convex/mesh/heightfield</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Fonte geométrica própria, convex/decomposition, cooking, scale, margin

**Dependências e riscos:** Cooked data; restrições de corpo dinâmico do backend; sem fallback silencioso


<h2 id="f038">F038 · C Composição de colisores</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Lista/filhos shapes, IDs, pose e material por shape

**Dependências e riscos:** Agregação em corpo proprietário; remover filho invalida composição


<h2 id="f039">F039 · R PhysicsMaterial</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Friction, restitution, combine policy, surface data

**Dependências e riscos:** Propriedade suportada no backend; compartilhado/override explícito


<h2 id="f040">F040 · C Sensor/Area</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Shape, monitoring, monitorable, layers, enter/stay/exit

**Dependências e riscos:** Consulta de contatos; referência ao objeto/shape; sem obrigar renderer


<h2 id="f041">F041 · C Joint fixo/hinge/slider/spring/6DOF</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Corpos A/B, frames/anchors, eixos, limits, motor, força/torque, damping, break threshold

**Dependências e riscos:** Pelo menos corpo proprietário; segundo corpo ou world anchor; validação de frames


<h2 id="f042">F042 · C CharacterMotor / CharacterController, CharacterBody3D</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Shape, speed, slope, step, skin margin, gravity, floor snap, platform velocity, up direction, jump

**Dependências e riscos:** Backend CharacterVirtual; conflicts atuais com Body/Collider devem evoluir com migração


<h2 id="f043">F043 · S Physics queries</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Ray/shape casts, overlaps, filters, triggers, max distance, initial overlap

**Dependências e riscos:** Mundo, alocação/buffer e truncamento explícitos; hits com IDs válidos


<h2 id="f044">F044 · C/R Ragdoll</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Corpos/joints por osso, blend, limites, transição animated/dynamic

**Dependências e riscos:** Skeleton + physics; uma autoridade final por osso


<h2 id="f045">F045 · C/S Physics2D</h2>

**Família:** Física e personagem — P07/P12. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Bodies, circle/box/capsule/polygon/edge, sensors, joints, character e queries

**Dependências e riscos:** Backend escolhido, mundo 2D, unidade; não colidir implicitamente com 3D


<h2 id="f046">F046 · R/S ActionMap/InputContext</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Actions, bindings, interactions, deadzones, axes, device groups, enabled, rebind

**Dependências e riscos:** Entrada plataforma + foco; contexto de editor/Play separado


<h2 id="f047">F047 · C/R Canvas/root UI</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Screen/world space, escala, viewport/target, sorting, safe area

**Dependências e riscos:** Runtime UI, transform/layout, renderer


<h2 id="f048">F048 · C Rect/layout</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Anchors, offsets, pivot, min/preferred/max, stretch, alignment, aspect

**Dependências e riscos:** Parent layout, política de medida/arranjo; não expor valores sem efeito


<h2 id="f049">F049 · C Containers row/column/grid/flow</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Gap, padding, alignment, wrap, sizing

**Dependências e riscos:** Filhos UI; layout controla posição, não script concorrente


<h2 id="f050">F050 · C Image/NineSlice</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Texture/region, tint, borders, fill/mode, aspect

**Dependências e riscos:** Texture e sampler; atlas/pivô


<h2 id="f051">F051 · C Text/RichText</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** String/localization key, font, size, wrap, alignment, spans, ellipsis, selection

**Dependências e riscos:** Font/shaping/fallback; rich text com marcação definida


<h2 id="f052">F052 · C Button/Toggle/Radio</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Text/icon, interactable, pressed/checked, group, transitions, click/change

**Dependências e riscos:** Foco e input, tema; Radio precisa de grupo explícito


<h2 id="f053">F053 · C Slider/Range/Progress</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Min/max/value/step, orientation, format, change event

**Dependências e riscos:** Validação de domínio; Progress pode ser read-only na entrada


<h2 id="f054">F054 · C Scroll/List/Tree/Dropdown</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Scroll, selection, item source, virtualization, expansion, clipping

**Dependências e riscos:** Layout, input/capture e item IDs; dado separado do widget


<h2 id="f055">F055 · C TextInput</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Value, placeholder, multiline, selection/caret, validation, keyboard type, submit

**Dependências e riscos:** IME/clipboard/foco Android; dado sensível não entra em logs


<h2 id="f056">F056 · R Theme/Style</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tokens, estados, fonts, colors, sizes, variants

**Dependências e riscos:** Herança de recurso; alteração invalida layout/draw conforme efeito


<h2 id="f057">F057 · S Accessibility/Localization</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Nome/role/state, foco/ordem, locale, fontes substitutas, RTL, contraste

**Dependências e riscos:** Semântica de UI e plataforma; leitura de tela não depende só de cor


<h2 id="f058">F058 · R AudioClip/Stream</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Parcial.

**O que a função precisa entregar:** Fonte, formato, sample rate/channels, duração, import/streaming, loop points

**Dependências e riscos:** Decode, cache e threads de áudio; GUID durável

**Lacunas registradas:** Streaming de clipe e pontos de loop autorados nao implementados; WAV decodificado/cached e loop inteiro funcionam.


<h2 id="f059">F059 · C AudioSource 2D/3D</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Parcial.

**O que a função precisa entregar:** Clip/stream, bus, volume, pitch, loop, autoplay, priority, spatial blend/range/cone

**Dependências e riscos:** Audio world; Transform para 3D; não exigir renderer

**Lacunas registradas:** Prioridade/preempcao de fontes e mistura espacial continua ainda nao implementadas; dimensao plana/espacial e demais propriedades possuem consumidor.


<h2 id="f060">F060 · C AudioListener</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Enabled, priority, orientação, seleção de listener de jogo

**Dependências e riscos:** Audio world; câmera é relação opcional

**Limites do aceite registrado:** Captura e cenarios executados no host. APK conferido; revisao nao instalada/executada fisicamente no Android.


<h2 id="f061">F061 · R/S Mixer/buses/effects</h2>

**Família:** Input, UI de jogo, texto e áudio — P06/P09/P10. **Escopo:** obrigatorio. **Estado base:** Parcial.

**O que a função precisa entregar:** Gain, mute/solo, sends, effects/params, snapshots

**Dependências e riscos:** Grafo sem ciclos não suportados; DSP real; lifecycle da plataforma

**Lacunas registradas:** Sends, efeitos DSP/parametros e snapshots ainda nao implementados; buses atuais executam apenas encadeamento de ganho, mute/solo.


<h2 id="f062">F062 · R AnimationClip</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tracks, target IDs, keyframes, interpolation, duration, loop, events

**Dependências e riscos:** Recursos importados/autorais; curvas e propriedades animáveis


<h2 id="f063">F063 · C AnimationPlayer</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Clips, default, autoplay, speed, play/stop/seek/blend e estado transitório

**Dependências e riscos:** Clips/alvos; não persistir tempo de Play por acidente


<h2 id="f064">F064 · R Animator graph</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** States, transitions, conditions, parameters, blend spaces, layers, masks

**Dependências e riscos:** Clip evaluator; árvore/grafo validado; máquina de estados salva em resource


<h2 id="f065">F065 · C/R Rig/IK/constraints</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Targets, chains, poles, limits, weights, solver order

**Dependências e riscos:** Skeleton; targets válidos; controle de pose por fase


<h2 id="f066">F066 · R/C Timeline</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tracks, bindings, clips, markers, ranges, preview/record

**Dependências e riscos:** Tempo, animation/audio/camera/events; update determinístico do editor


<h2 id="f067">F067 · C NavigationRegion/Surface</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Geometry source, bounds, layers, cell size, radius/height/step/slope, bake data

**Dependências e riscos:** Bake/cooker + recurso navmesh


<h2 id="f068">F068 · C NavigationAgent</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Destination, speed/accel, radius, avoidance, path state, stop distance, masks

**Dependências e riscos:** Nav world + motor de movimento; não exigir Rigidbody automaticamente


<h2 id="f069">F069 · C NavigationObstacle/Link</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Shape/radius/velocity; start/end, cost, direction, enabled

**Dependências e riscos:** Nav world; dynamic obstacle não equivale a rebake global


<h2 id="f070">F070 · C Perception/state logic</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Sensors/queries, memory, state/action graph, timers, events

**Dependências e riscos:** Capacidade composta de gameplay; sem `EnemyAI` especial no núcleo


<h2 id="f071">F071 · C Sprite/AnimatedSprite</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Texture/frames, region, pivot, tint, flip, sorting, fps/playback

**Dependências e riscos:** Atlas/material 2D; frame IDs duráveis


<h2 id="f072">F072 · R TileSet / C TileMapLayer</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Tiles, atlas, cells, terrain/autotile, metadata, collisions, nav, animation

**Dependências e riscos:** Painting, chunk bounds, física/nav 2D opcionais


<h2 id="f073">F073 · C Camera2D/Parallax</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Zoom, offset, limits, smoothing, follow, repeats

**Dependências e riscos:** Transform2D e view; game camera independente do editor


<h2 id="f074">F074 · C Light2D/Occluder2D</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Type, color/energy, texture, masks, shape, shadow params

**Dependências e riscos:** Renderer 2D e occlusion; não reusar sombras 3D semanticamente


<h2 id="f075">F075 · C/R ParticleEmitter</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Rate/bursts, shape, lifetime, seed, local/world, velocity, color/size curves, collision

**Dependências e riscos:** Simulation CPU/GPU declarada, material e bounds


<h2 id="f076">F076 · R Curve/Gradient</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Keys/stops, interpolation, tangent/mode, extrapolation, colorspace

**Dependências e riscos:** Identidade de key se referenciada; edição agrupada em Undo

**Limites do aceite registrado:** Captura e cenarios executados no host. APK conferido; revisao nao instalada/executada fisicamente no Android.


<h2 id="f077">F077 · R Spline / C Path</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Points, tangents, closed, up/roll, sampling, length

**Dependências e riscos:** Geometry resource e ferramentas de edição

**Limites do aceite registrado:** Host e pacote ABI35; revisao nao instalada/executada fisicamente no Android.


<h2 id="f078">F078 · C PathFollower</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Concluída no registro de origem.

**O que a função precisa entregar:** Path ref, offset/distance, speed, orientation, loop

**Dependências e riscos:** Path + Transform; física tem autoridade se usada

**Limites do aceite registrado:** Aceite P15a anterior reconciliado; nao reexecutado. Pacote ABI34 conferido, sem execucao fisica desta revisao.


<h2 id="f079">F079 · C Terrain</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Heightfield/tiles, size/resolution, material layers, holes, normals, collision

**Dependências e riscos:** Streaming/cooking, mesh/render e física; brush transacional


<h2 id="f080">F080 · C Foliage/scatter</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Source meshes, seed, density, masks, slope/height, scale/rotation range, LOD

**Dependências e riscos:** Instancing e terreno/surface; instâncias derivadas versus autorais


<h2 id="f081">F081 · S World streaming</h2>

**Família:** Animação, navegação, 2D, efeitos e mundo — P11–P16. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Regions, budgets, load radius/priorities, async progress, rebasing policy

**Dependências e riscos:** Scenes/assets, handle invalidation, GPU/CPU lifetime


<h2 id="f082">F082 · S SaveGame</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Schema/version, slot, timestamp, data/ref mapping, migration

**Dependências e riscos:** Storage e dados de gameplay, não cópia do EditorDocument


<h2 id="f083">F083 · E Import profiles</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Scale/axes, geometry, material/textures, animation, collisions, exclusions

**Dependências e riscos:** Importador, fonte, reconciliação e jobs


<h2 id="f084">F084 · E Inspector extensions</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Widget por tipo, group, conditions, custom renderer validado

**Dependências e riscos:** Schema/commands/Undo, não mutação direta


<h2 id="f085">F085 · E Code/graph workspace</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Diagnostics, help, completion, graph nodes/ports, debug

**Dependências e riscos:** Compiler/Flow/API/metadata reais


<h2 id="f086">F086 · E Profiler/debug overlays</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Frame/sample, CPU/GPU/mem, draw/physics/navigation overlays

**Dependências e riscos:** Profiler e medições reais, ativação explícita


<h2 id="f087">F087 · S Build/export profiles</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** obrigatorio. **Estado base:** Auditar.

**O que a função precisa entregar:** Startup scene, target, assets, quality/input/physics, modules

**Dependências e riscos:** Cooker/runtime/bootstrap; assinatura separada


<h2 id="f088">F088 · C/S Network identity/replication</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** condicional-P19. **Estado base:** condicional.

**O que a função precisa entregar:** Authority, ID, ownership, properties, RPC policy, spawn, interpolation

**Dependências e riscos:** Transport + serialization + scenes + time


<h2 id="f089">F089 · C XR origin/controller/AR data</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** condicional-P19. **Estado base:** condicional.

**O que a função precisa entregar:** Tracking origin, poses/actions, anchors/planes opcionais

**Dependências e riscos:** Runtime e hardware específicos


<h2 id="f090">F090 · C VideoPlayer</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** condicional-P19. **Estado base:** condicional.

**O que a função precisa entregar:** Source, loop, speed, seek, audio/target, aspect

**Dependências e riscos:** Decode/plataforma, texture e áudio


<h2 id="f091">F091 · C Vehicle/Cloth/SoftBody</h2>

**Família:** Projeto, ferramentas e módulos condicionais — P17–P20. **Escopo:** condicional-P19. **Estado base:** condicional.

**O que a função precisa entregar:** Parâmetros de solver e autoria pertinentes à família

**Dependências e riscos:** Física, mesh/skin, orçamento e backend




---

---
title: "Renderer: 41 capacidades e seus limites"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/
---

# Renderer: 41 capacidades e seus limites

Consumo implementado, backend limitado ou planejamento sem consumidor.

## Estado de código

Registro de capacidades da engine revisado em 2026-10-06. Consumidor implementado não comprova execução em todos os aparelhos; limitado por backend pode recusar e reportar degradação; planejado significa sem consumidor. Uma propriedade autoral não pode depender silenciosamente de um recurso planejado.

| Capacidade | Estado | Limite registrado |
|---|---|---|
| **Sol direcional**<br/>`render.light.directional` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Luzes pontuais e spot**<br/>`render.light.punctual` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Temperatura de cor em kelvin**<br/>`render.light.temperature` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Unidades fotométricas (lux, lumen, candela)**<br/>`render.light.photometric` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Máscara projetada (cookie)**<br/>`render.light.cookie` | Planejado; sem consumidor | Sem amostragem de textura por luz no shader de fragmento |
| **Luz de área**<br/>`render.light.area` | Planejado; sem consumidor | Sem integração de fonte com extensão |
| **Sombra do sol em cascatas**<br/>`render.shadow.directional` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Sombra de luz pontual ou spot**<br/>`render.shadow.punctual` | Consumidor implementado | Atlas em quadtree: spot ocupa um mapa, pontual seis faces |
| **Ambiente hemisférico céu/chão**<br/>`render.ambient.hemispheric` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Reflexo especular do ambiente**<br/>`render.ambient.specular` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Lightmap indireto externo por submalha**<br/>`render.gi.lightmap` | Limitado por backend/aparelho | RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes |
| **Sonda de irradiância por objeto**<br/>`render.probe.irradiance` | Planejado; sem consumidor | Sem recurso de sonda nem amostragem por instância |
| **Sonda de reflexão local**<br/>`render.probe.reflection` | Planejado; sem consumidor | Sem captura local, atlas nem blend por volume |
| **Superfície PBR metálico/rugosidade**<br/>`render.material.pbr` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Recorte por alfa, inclusive na sombra**<br/>`render.material.alpha_mask` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Transparência com mistura**<br/>`render.material.alpha_blend` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Desenho de face dupla**<br/>`render.material.double_sided` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Conjunto de UV e transformação por binding**<br/>`render.material.uv_transform` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Especialização de pipeline por material**<br/>`render.material.variants` | Limitado por backend/aparelho | Drivers móveis podem regredir com muitos pipelines pequenos |
| **Camada de verniz e transmissão**<br/>`render.material.clearcoat` | Planejado; sem consumidor | Sem variante de BRDF com camada adicional |
| **Filtragem anisotrópica**<br/>`render.texture.anisotropy` | Limitado por backend/aparelho | Depende da GPU expor samplerAnisotropy |
| **Indexação sem limite de descritor**<br/>`render.texture.bindless` | Limitado por backend/aparelho | Depende de descriptor indexing no backend |
| **Níveis de detalhe do pacote de mapa**<br/>`render.lod.package` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Grupo de LOD autoral por objeto**<br/>`render.lod.group` | Consumidor implementado | Níveis são objetos do autor ou da convenção _LOD&lt;n&gt;; simplificação automática de malha ainda não existe |
| **Oclusão por pirâmide de profundidade**<br/>`render.visibility.hzb` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Culling e compactação de desenho em GPU**<br/>`render.instancing.gpu` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Vetores de movimento por pixel**<br/>`render.motion_vectors` | Consumidor implementado | Transparência e água usam as máscaras de reatividade/composição, não vetor próprio |
| **Malha deformada por esqueleto**<br/>`render.skinning` | Consumidor implementado | Até 4 influências por vértice e 256 juntas por skin; morph targets não são importados |
| **Céu atmosférico**<br/>`render.environment.atmosphere` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Céu físico Rayleigh/Mie**<br/>`render.environment.physical_atmosphere` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Neblina por profundidade**<br/>`render.environment.fog` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Volumes de ambiente por câmera**<br/>`render.environment.volumes` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Exposição e mapeamento de tom**<br/>`render.post.tonemap` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Exposição automática por histograma**<br/>`render.post.auto_exposure` | Consumidor implementado | Histograma e adaptação por vista; o EV fica restrito à faixa autoral |
| **Brilho estourado**<br/>`render.post.bloom` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Grão de filme**<br/>`render.post.film_grain` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Oclusão ambiente em tela**<br/>`render.post.ambient_occlusion` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Antisserrilhado espacial**<br/>`render.aa.fxaa` | Consumidor implementado | Sem ressalva adicional neste registro; validar contexto/backend. |
| **Antisserrilhado temporal**<br/>`render.aa.temporal` | Limitado por backend/aparelho | Exige histórico e profundidade alocáveis no backend |
| **Ampliação temporal Arm ASR / AMD FSR 2**<br/>`render.upscale.temporal` | Limitado por backend/aparelho | Exige float16/int16, formatos de storage e subgrupos no aparelho; recusa com motivo quando falta |
| **Clipe de animação por nós**<br/>`animation.clip` | Consumidor implementado | Translação, rotação e escala; pesos de morph não; sem mistura entre clipes |

Lightmap externo, sombras locais, AO e HDRI têm contratos distintos; não use AO ou textura pintada como prova de GI bake. O quadro atual de luzes pontuais/spot tem orçamento de 8 por frame. Consulte [materiais/luzes/ambiente](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/) e a política gráfica resolvida no aparelho.


---

---
title: "Astra.AnimationClipEntry"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationclipentry/
---

# Astra.AnimationClipEntry

Entrada autoral da lista de clipes. ElementId permanece igual ao reordenar a lista.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.AnimationClipEntry
```

Entrada autoral da lista de clipes. ElementId permanece igual ao reordenar a lista.

**Interfaces:** `System.IEquatable<Astra.AnimationClipEntry>`.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-993fc5e6c8be5ae1) | Method |
| [Clip](#member-93b4206300eca8ed) | Property |
| [ElementId](#member-f57be4275d001227) | Property |
| [Name](#member-93edeb67a2bcfa65) | Property |

<h3 id="member-993fc5e6c8be5ae1" class="astra-member">.ctor</h3>

```csharp
public AnimationClipEntry(ulong ElementId, Astra.AssetGuid Clip, string Name)
```

Entrada autoral da lista de clipes. ElementId permanece igual ao reordenar a lista.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `ElementId` | `ulong` |  |
| `Clip` | `Astra.AssetGuid` |  |
| `Name` | `string` |  |

<h3 id="member-93b4206300eca8ed" class="astra-member">Clip</h3>

```csharp
public Astra.AssetGuid Clip { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f57be4275d001227" class="astra-member">ElementId</h3>

```csharp
public ulong ElementId { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-93edeb67a2bcfa65" class="astra-member">Name</h3>

```csharp
public string Name { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationCurve"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationcurve/
---

# Astra.AnimationCurve

Curva de valores (Unity: AnimationCurve), editada no Inspector pelo editor de curvas. Astra.AnimationCurve.Evaluate(System.Single) segue a mesma regra do editor: Hermite entre chaves, Constant segura o valor, Clamp/Loop/PingPong fora.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.AnimationCurve
```

Curva de valores (Unity: AnimationCurve), editada no Inspector pelo editor de curvas. Astra.AnimationCurve.Evaluate(System.Single) segue a mesma regra do editor: Hermite entre chaves, Constant segura o valor, Clamp/Loop/PingPong fora.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Constant](#member-a36fb986e630b720) | Method |
| [Evaluate](#member-3e421f4685a90578) | Method |
| [Linear](#member-9147386e9b99e35a) | Method |
| [Keys](#member-7db1b7f871c10454) | Property |
| [Length](#member-ae4e01672c5cf43a) | Property |
| [PostWrapMode](#member-31cc0566b2fd2bb3) | Property |
| [PreWrapMode](#member-8344d94de7f46593) | Property |

<h3 id="member-a36fb986e630b720" class="astra-member">Constant</h3>

```csharp
public static Astra.AnimationCurve Constant(float timeStart, float timeEnd, float value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timeStart` | `float` |  |
| `timeEnd` | `float` |  |
| `value` | `float` |  |

<h3 id="member-3e421f4685a90578" class="astra-member">Evaluate</h3>

```csharp
public float Evaluate(float time)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `time` | `float` |  |

<h3 id="member-9147386e9b99e35a" class="astra-member">Linear</h3>

```csharp
public static Astra.AnimationCurve Linear(float timeStart, float valueStart, float timeEnd, float valueEnd)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timeStart` | `float` |  |
| `valueStart` | `float` |  |
| `timeEnd` | `float` |  |
| `valueEnd` | `float` |  |

<h3 id="member-7db1b7f871c10454" class="astra-member">Keys</h3>

```csharp
public Astra.Keyframe[] Keys { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae4e01672c5cf43a" class="astra-member">Length</h3>

```csharp
public int Length { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-31cc0566b2fd2bb3" class="astra-member">PostWrapMode</h3>

```csharp
public Astra.CurveWrapMode PostWrapMode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8344d94de7f46593" class="astra-member">PreWrapMode</h3>

```csharp
public Astra.CurveWrapMode PreWrapMode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationPlayMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationplaymode/
---

# Astra.AnimationPlayMode

PlayMode da Unity: parar os clipes da mesma camada ou todos.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.AnimationPlayMode
```

PlayMode da Unity: parar os clipes da mesma camada ou todos.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [StopAll](#member-ebe928bf2ce5e808) | Field |
| [StopSameLayer](#member-766508dcc60f1903) | Field |

<h3 id="member-ebe928bf2ce5e808" class="astra-member">StopAll</h3>

```csharp
StopAll = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-766508dcc60f1903" class="astra-member">StopSameLayer</h3>

```csharp
StopSameLayer = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationPlayer"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationplayer/
---

# Astra.AnimationPlayer

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.AnimationPlayer
```

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-73564b1b094d2cce) | Method |
| [AddClip](#member-ff97a4216f599e44) | Method |
| [Blend](#member-afda1905ba5a443e) | Method |
| [Clip](#member-a055ab61e428d438) | Method |
| [CrossFade](#member-cb588b0d998f2071) | Method |
| [IsClipPlaying](#member-895ec5978a3be8f2) | Method |
| [MoveClip](#member-c0f46374e88c38ff) | Method |
| [Play](#member-1a64eb6036da1362) | Method |
| [Play](#member-6b4cd297e84aa5dd) | Method |
| [RemoveClip](#member-430d6c18e5bd8519) | Method |
| [Rewind](#member-74ac2a5c16b49f40) | Method |
| [Rewind](#member-121f3df392feb4de) | Method |
| [SetClip](#member-5e22da2a2cc9780b) | Method |
| [Stop](#member-7cd7c17e81705f2d) | Method |
| [Stop](#member-9f3291056c3dbb02) | Method |
| [ClipEntries](#member-bc33f5a2b97040d5) | Property |
| [ClipNames](#member-f648d53b1cce504c) | Property |
| [Component](#member-3a90cfe35d6a4fe0) | Property |
| [IsPlaying](#member-874b5ffe2e849d8c) | Property |
| [this[]](#member-305b9ddfc3b32028) | Property |
| [PlayAutomatically](#member-3b7613cd9c035f98) | Property |
| [WrapMode](#member-ab2a54af7a300880) | Property |

<h3 id="member-73564b1b094d2cce" class="astra-member">.ctor</h3>

```csharp
public AnimationPlayer(Astra.Component component)
```

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-ff97a4216f599e44" class="astra-member">AddClip</h3>

```csharp
public ulong AddClip(Astra.AssetGuid clip)
```

Adiciona um clipe resolvido à lista desta sessão de Play e devolve o ID da entrada.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Adiciona um clipe resolvido à lista desta sessão de Play e devolve o ID da entrada.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `Astra.AssetGuid` |  |

<h3 id="member-afda1905ba5a443e" class="astra-member">Blend</h3>

```csharp
public void Blend(string clip, float targetWeight = 1, float seconds = 0.3)
```

Leva o peso do clipe até targetWeight sem mexer nos outros.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Leva o peso do clipe até targetWeight sem mexer nos outros.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |
| `targetWeight` | `float` |  · Opcional: `1` |
| `seconds` | `float` |  · Opcional: `0.3` |

<h3 id="member-a055ab61e428d438" class="astra-member">Clip</h3>

```csharp
public Astra.AssetGuid Clip(string name)
```

Identidade do clipe pelo nome; lança quando o componente não lista o nome.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Identidade do clipe pelo nome; lança quando o componente não lista o nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-cb588b0d998f2071" class="astra-member">CrossFade</h3>

```csharp
public void CrossFade(string clip, float seconds = 0.3, Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

Entra no clipe em seconds enquanto os outros da camada saem.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Entra no clipe em seconds enquanto os outros da camada saem.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |
| `seconds` | `float` |  · Opcional: `0.3` |
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-895ec5978a3be8f2" class="astra-member">IsClipPlaying</h3>

```csharp
public bool IsClipPlaying(string clip)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-c0f46374e88c38ff" class="astra-member">MoveClip</h3>

```csharp
public void MoveClip(ulong elementId, uint targetIndex)
```

Move a entrada para o índice indicado sem alterar seu ID.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Move a entrada para o índice indicado sem alterar seu ID.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `elementId` | `ulong` |  |
| `targetIndex` | `uint` |  |

<h3 id="member-1a64eb6036da1362" class="astra-member">Play</h3>

```csharp
public void Play(Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

Toca o clipe padrão, parando os outros da mesma camada. Não rebobina um clipe que já toca.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Toca o clipe padrão, parando os outros da mesma camada. Não rebobina um clipe que já toca.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-6b4cd297e84aa5dd" class="astra-member">Play</h3>

```csharp
public void Play(string clip, Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-430d6c18e5bd8519" class="astra-member">RemoveClip</h3>

```csharp
public void RemoveClip(ulong elementId)
```

Remove uma entrada por ID. Um clipe sem outra entrada e sem ser padrão para no próximo passo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Remove uma entrada por ID. Um clipe sem outra entrada e sem ser padrão para no próximo passo.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `elementId` | `ulong` |  |

<h3 id="member-74ac2a5c16b49f40" class="astra-member">Rewind</h3>

```csharp
public void Rewind()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-121f3df392feb4de" class="astra-member">Rewind</h3>

```csharp
public void Rewind(string clip)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-5e22da2a2cc9780b" class="astra-member">SetClip</h3>

```csharp
public void SetClip(ulong elementId, Astra.AssetGuid clip)
```

Troca o recurso da entrada por ID; a posição atual da entrada não importa.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Troca o recurso da entrada por ID; a posição atual da entrada não importa.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `elementId` | `ulong` |  |
| `clip` | `Astra.AssetGuid` |  |

<h3 id="member-7cd7c17e81705f2d" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Para e rebobina todos os clipes, como Animation.Stop da Unity. A pose atual fica.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Para e rebobina todos os clipes, como Animation.Stop da Unity. A pose atual fica.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f3291056c3dbb02" class="astra-member">Stop</h3>

```csharp
public void Stop(string clip)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-bc33f5a2b97040d5" class="astra-member">ClipEntries</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<Astra.AnimationClipEntry> ClipEntries { get; }
```

Clipes e identidades persistentes da lista, na ordem atual.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Clipes e identidades persistentes da lista, na ordem atual.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f648d53b1cce504c" class="astra-member">ClipNames</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<string> ClipNames { get; }
```

Nomes dos clipes do componente, na ordem da lista.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Nomes dos clipes do componente, na ordem da lista.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3a90cfe35d6a4fe0" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-874b5ffe2e849d8c" class="astra-member">IsPlaying</h3>

```csharp
public bool IsPlaying { get; }
```

Algum clipe tocando.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Algum clipe tocando.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-305b9ddfc3b32028" class="astra-member">this[]</h3>

```csharp
public Astra.AnimationState this[string clip] { get; }
```

AnimationState do clipe (animation["nome"] na Unity).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** AnimationState do clipe (animation["nome"] na Unity).

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3b7613cd9c035f98" class="astra-member">PlayAutomatically</h3>

```csharp
public bool PlayAutomatically { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab2a54af7a300880" class="astra-member">WrapMode</h3>

```csharp
public Astra.AnimationWrapMode WrapMode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationstate/
---

# Astra.AnimationState

Um clipe dentro de um componente Animation: tempo, velocidade, peso, camada e repetição.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.AnimationState
```

Um clipe dentro de um componente Animation: tempo, velocidade, peso, camada e repetição.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Clip](#member-6d9abe2056c4513e) | Property |
| [Enabled](#member-8ae74e1fc47c64f3) | Property |
| [Layer](#member-4f56cd21f696853c) | Property |
| [Length](#member-f5090e7f0ca13f06) | Property |
| [NormalizedTime](#member-db9121d7c172b43c) | Property |
| [Speed](#member-5a54504535a944fe) | Property |
| [Time](#member-2ba672fcc37b4f92) | Property |
| [Weight](#member-708a1a52c4b195c0) | Property |
| [WrapMode](#member-1d84b1027fd3e71b) | Property |

<h3 id="member-6d9abe2056c4513e" class="astra-member">Clip</h3>

```csharp
public Astra.AssetGuid Clip { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8ae74e1fc47c64f3" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f56cd21f696853c" class="astra-member">Layer</h3>

```csharp
public uint Layer { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f5090e7f0ca13f06" class="astra-member">Length</h3>

```csharp
public float Length { get; }
```

Duração do clipe em segundos.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Duração do clipe em segundos.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db9121d7c172b43c" class="astra-member">NormalizedTime</h3>

```csharp
public float NormalizedTime { get; set; }
```

Tempo sobre a duração (AnimationState.normalizedTime).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Tempo sobre a duração (AnimationState.normalizedTime).

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5a54504535a944fe" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ba672fcc37b4f92" class="astra-member">Time</h3>

```csharp
public float Time { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-708a1a52c4b195c0" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1d84b1027fd3e71b" class="astra-member">WrapMode</h3>

```csharp
public Astra.AnimationWrapMode WrapMode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationStateValue"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationstatevalue/
---

# Astra.AnimationStateValue

Estado de um clipe num componente (AnimationState da Unity), como a ABI o transporta.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.AnimationStateValue
```

Estado de um clipe num componente (AnimationState da Unity), como a ABI o transporta.

**Interfaces:** `System.IEquatable<Astra.AnimationStateValue>`.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-80a0b14c8e63ace8) | Method |
| [Clip](#member-7dcc1d0f50197993) | Property |
| [Enabled](#member-5badde889f03db53) | Property |
| [Layer](#member-8522dbf9a25a82a6) | Property |
| [Length](#member-9720767d5ba6309a) | Property |
| [Speed](#member-366f63c79b9c9670) | Property |
| [Time](#member-247c8ed87335fafc) | Property |
| [Weight](#member-004857beb36b0aa8) | Property |
| [WrapMode](#member-a52b2e9795fefa8f) | Property |

<h3 id="member-80a0b14c8e63ace8" class="astra-member">.ctor</h3>

```csharp
public AnimationStateValue(Astra.AssetGuid Clip, bool Enabled, float Time, float Speed, float Weight, float Length, uint Layer, Astra.AnimationWrapMode WrapMode)
```

Estado de um clipe num componente (AnimationState da Unity), como a ABI o transporta.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Clip` | `Astra.AssetGuid` |  |
| `Enabled` | `bool` |  |
| `Time` | `float` |  |
| `Speed` | `float` |  |
| `Weight` | `float` |  |
| `Length` | `float` |  |
| `Layer` | `uint` |  |
| `WrapMode` | `Astra.AnimationWrapMode` |  |

<h3 id="member-7dcc1d0f50197993" class="astra-member">Clip</h3>

```csharp
public Astra.AssetGuid Clip { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5badde889f03db53" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8522dbf9a25a82a6" class="astra-member">Layer</h3>

```csharp
public uint Layer { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9720767d5ba6309a" class="astra-member">Length</h3>

```csharp
public float Length { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-366f63c79b9c9670" class="astra-member">Speed</h3>

```csharp
public float Speed { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-247c8ed87335fafc" class="astra-member">Time</h3>

```csharp
public float Time { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-004857beb36b0aa8" class="astra-member">Weight</h3>

```csharp
public float Weight { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a52b2e9795fefa8f" class="astra-member">WrapMode</h3>

```csharp
public Astra.AnimationWrapMode WrapMode { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AnimationWrapMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-animationwrapmode/
---

# Astra.AnimationWrapMode

Wrap Mode do clipe, na ordem do componente nativo `astra.animation`.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.AnimationWrapMode
```

Wrap Mode do clipe, na ordem do componente nativo `astra.animation`.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ClampForever](#member-f8c89dc3966fa848) | Field |
| [Loop](#member-176bff98055054b2) | Field |
| [Once](#member-78e520521978f5ec) | Field |
| [PingPong](#member-63246cd5031a2d63) | Field |

<h3 id="member-f8c89dc3966fa848" class="astra-member">ClampForever</h3>

```csharp
ClampForever = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-176bff98055054b2" class="astra-member">Loop</h3>

```csharp
Loop = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-78e520521978f5ec" class="astra-member">Once</h3>

```csharp
Once = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-63246cd5031a2d63" class="astra-member">PingPong</h3>

```csharp
PingPong = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AssetGuid"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-assetguid/
---

# Astra.AssetGuid

Struct da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.AssetGuid
```

**Interfaces:** `System.IEquatable<Astra.AssetGuid>`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-5b920254136d621d) | Method |
| [Parse](#member-ee045a8d688b750c) | Method |
| [TryParse](#member-f181ba318a481e8e) | Method |
| [High](#member-cfa0292dba2665b4) | Property |
| [IsValid](#member-c770afa86d6af79d) | Property |
| [Low](#member-44b7a4c6bb916615) | Property |

<h3 id="member-5b920254136d621d" class="astra-member">.ctor</h3>

```csharp
public AssetGuid(ulong High, ulong Low)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `High` | `ulong` |  |
| `Low` | `ulong` |  |

<h3 id="member-ee045a8d688b750c" class="astra-member">Parse</h3>

```csharp
public static Astra.AssetGuid Parse(string text)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `text` | `string` |  |

<h3 id="member-f181ba318a481e8e" class="astra-member">TryParse</h3>

```csharp
public static bool TryParse(string? text, out Astra.AssetGuid value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `text` | `string?` |  |
| `value` | `Astra.AssetGuid` |  · Out |

<h3 id="member-cfa0292dba2665b4" class="astra-member">High</h3>

```csharp
public ulong High { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c770afa86d6af79d" class="astra-member">IsValid</h3>

```csharp
public bool IsValid { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-44b7a4c6bb916615" class="astra-member">Low</h3>

```csharp
public ulong Low { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AssetReference"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-assetreference/
---

# Astra.AssetReference

Struct da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.AssetReference
```

**Interfaces:** `System.IEquatable<Astra.AssetReference>`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-1e24f0c3757b8e10) | Method |
| [AssetId](#member-385110d5e4349c3f) | Property |

<h3 id="member-1e24f0c3757b8e10" class="astra-member">.ctor</h3>

```csharp
public AssetReference(string AssetId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `AssetId` | `string` |  |

<h3 id="member-385110d5e4349c3f" class="astra-member">AssetId</h3>

```csharp
public string AssetId { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AudioVoice"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-audiovoice/
---

# Astra.AudioVoice

Controls the actual native voice. Play restarts; Resume preserves a paused cursor. Seek is applied by the mixer; its pending target may already appear in Snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.AudioVoice
```

Controls the actual native voice. Play restarts; Resume preserves a paused cursor. Seek is applied by the mixer; its pending target may already appear in Snapshot.

## Onde acessar este tipo

Adicione Audio Source/Listener/Bus no objeto e atribua clipe do projeto. Obtenha o transporte AudioVoice pela API do componente existente; veja Component e AudioSource.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-11e353c679b3cf5b) | Method |
| [Pause](#member-248600cec67fe588) | Method |
| [Play](#member-1ec3cdd2b59b4098) | Method |
| [Resume](#member-4f6fadd8d7ea8cd6) | Method |
| [Seek](#member-e748f52f0241ca40) | Method |
| [Stop](#member-88da5eca6ff4d84c) | Method |
| [Snapshot](#member-08d9d599fc2f6a2f) | Property |

<h3 id="member-11e353c679b3cf5b" class="astra-member">.ctor</h3>

```csharp
public AudioVoice(Astra.Component component)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-248600cec67fe588" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1ec3cdd2b59b4098" class="astra-member">Play</h3>

```csharp
public void Play()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f6fadd8d7ea8cd6" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e748f52f0241ca40" class="astra-member">Seek</h3>

```csharp
public void Seek(double seconds)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |

<h3 id="member-88da5eca6ff4d84c" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08d9d599fc2f6a2f" class="astra-member">Snapshot</h3>

```csharp
public Astra.AudioVoiceSnapshot Snapshot { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AudioVoiceSnapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-audiovoicesnapshot/
---

# Astra.AudioVoiceSnapshot

Backend cursor in seconds, including pending seeks. OutputRunning describes the device gate, never audibility.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.AudioVoiceSnapshot
```

Backend cursor in seconds, including pending seeks. OutputRunning describes the device gate, never audibility.

**Interfaces:** `System.IEquatable<Astra.AudioVoiceSnapshot>`.

## Onde acessar este tipo

Adicione Audio Source/Listener/Bus no objeto e atribua clipe do projeto. Obtenha o transporte AudioVoice pela API do componente existente; veja Component e AudioSource.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-03ce22944f0dea94) | Method |
| [Cursor](#member-bb5cadd18d118171) | Property |
| [OutputRunning](#member-0b6bf6ec7d08c55b) | Property |
| [State](#member-6da84fe4dac9a57c) | Property |

<h3 id="member-03ce22944f0dea94" class="astra-member">.ctor</h3>

```csharp
public AudioVoiceSnapshot(Astra.AudioVoiceState State, double Cursor, bool OutputRunning)
```

Backend cursor in seconds, including pending seeks. OutputRunning describes the device gate, never audibility.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `State` | `Astra.AudioVoiceState` |  |
| `Cursor` | `double` |  |
| `OutputRunning` | `bool` |  |

<h3 id="member-bb5cadd18d118171" class="astra-member">Cursor</h3>

```csharp
public double Cursor { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0b6bf6ec7d08c55b" class="astra-member">OutputRunning</h3>

```csharp
public bool OutputRunning { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6da84fe4dac9a57c" class="astra-member">State</h3>

```csharp
public Astra.AudioVoiceState State { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.AudioVoiceState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-audiovoicestate/
---

# Astra.AudioVoiceState

Enum da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.AudioVoiceState
```

## Onde acessar este tipo

Adicione Audio Source/Listener/Bus no objeto e atribua clipe do projeto. Obtenha o transporte AudioVoice pela API do componente existente; veja Component e AudioSource.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DeviceError](#member-d6183ff9765c5489) | Field |
| [InvalidBus](#member-375a690c558cf010) | Field |
| [InvalidPose](#member-552346479edb02ff) | Field |
| [Limit](#member-fbf448b24c57bc48) | Field |
| [MissingClip](#member-a2b6db6c8c452159) | Field |
| [MissingListener](#member-ba9d241b2df05049) | Field |
| [Paused](#member-d73e3aa68281774f) | Field |
| [Playing](#member-ca7cc80782c37e45) | Field |
| [Stopped](#member-3f232d9ba8e43a08) | Field |

<h3 id="member-d6183ff9765c5489" class="astra-member">DeviceError</h3>

```csharp
DeviceError = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-375a690c558cf010" class="astra-member">InvalidBus</h3>

```csharp
InvalidBus = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-552346479edb02ff" class="astra-member">InvalidPose</h3>

```csharp
InvalidPose = 8
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fbf448b24c57bc48" class="astra-member">Limit</h3>

```csharp
Limit = 6
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a2b6db6c8c452159" class="astra-member">MissingClip</h3>

```csharp
MissingClip = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba9d241b2df05049" class="astra-member">MissingListener</h3>

```csharp
MissingListener = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d73e3aa68281774f" class="astra-member">Paused</h3>

```csharp
Paused = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ca7cc80782c37e45" class="astra-member">Playing</h3>

```csharp
Playing = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f232d9ba8e43a08" class="astra-member">Stopped</h3>

```csharp
Stopped = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Behavior"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-behavior/
---

# Astra.Behavior

Class da API C# da Astra. 48 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Behavior
```

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ApplicationFocus](#member-136f88610f2a8731) | Method |
| [ApplicationPause](#member-3412d028ff4d2742) | Method |
| [Awake](#member-595e915a5adac284) | Method |
| [ChildrenChanged](#member-8a4f79998a6c96b6) | Method |
| [CollisionEnter](#member-0e0cfdab6f1328e8) | Method |
| [CollisionExit](#member-9068e2218083370c) | Method |
| [CollisionStay](#member-d9aa3d6b3929e082) | Method |
| [Connect](#member-1a3db625c4b1e8ba) | Method |
| [Destroy](#member-d8eb22d35f04d36e) | Method |
| [Disable](#member-2c3ec57c5fdeff5c) | Method |
| [Enable](#member-57bcc678922a4709) | Method |
| [FindBehavior](#member-ac46fe9d6f2312da) | Method |
| [FindBehaviors](#member-a9be5d54f730fa6b) | Method |
| [FixedUpdate](#member-768a449e84724f51) | Method |
| [LateUpdate](#member-f094ed65d5a6d17c) | Method |
| [ParentChanged](#member-38118f1956620d52) | Method |
| [Remove](#member-1f5c4e34209197fa) | Method |
| [Resolve](#member-7ca6b50bc0ffc1d8) | Method |
| [Start](#member-7c0ad18a4fec7545) | Method |
| [StartAsync](#member-6d39b252b371a079) | Method |
| [StartCoroutine](#member-f915add142584a58) | Method |
| [Stop](#member-37828dd1a75cc4cd) | Method |
| [StopAllCoroutines](#member-0a62f9adde30d20e) | Method |
| [StopCoroutine](#member-507332d7f00f7ae4) | Method |
| [StopCoroutine](#member-baac3630b4b15aaa) | Method |
| [TimerElapsed](#member-f4502cdc48ee2168) | Method |
| [TriggerEnter](#member-9c9babdbe59fb30b) | Method |
| [TriggerExit](#member-f3bfa114a15bf817) | Method |
| [TriggerStay](#member-d759f0768aceaa6b) | Method |
| [Update](#member-1d14c999c421146e) | Method |
| [Awaitable](#member-9c33ec8ace32e769) | Property |
| [Debug](#member-d44701695d8e0cf1) | Property |
| [Enabled](#member-46af2c4ab24afa90) | Property |
| [Gui](#member-c4dc88bd0b9860ab) | Property |
| [Haptics](#member-d0cda12a6ac66b75) | Property |
| [Input](#member-b1ccdf202b2a558e) | Property |
| [InstanceId](#member-9f70f5844e82fc69) | Property |
| [IsAlive](#member-02073bdd9721312c) | Property |
| [Object](#member-f332e25f95cf0982) | Property |
| [ObjectId](#member-c3bdf2baa9b981f9) | Property |
| [Physics](#member-b866bb75729dc323) | Property |
| [Physics2D](#member-404894160094aad5) | Property |
| [Save](#member-e37909d7c24d3753) | Property |
| [Scene](#member-5c6d65b04aef033f) | Property |
| [Scenes](#member-6a21da8cfbab46c5) | Property |
| [Time](#member-40405df27fa1c414) | Property |
| [Transform](#member-e39078dcbaa811d2) | Property |
| [View](#member-f1c7d8d630953a93) | Property |

<h3 id="member-136f88610f2a8731" class="astra-member">ApplicationFocus</h3>

```csharp
public virtual void ApplicationFocus(bool focused)
```

A janela do aplicativo ganhou (true) ou perdeu (false) o foco.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** A janela do aplicativo ganhou (true) ou perdeu (false) o foco.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `focused` | `bool` |  |

<h3 id="member-3412d028ff4d2742" class="astra-member">ApplicationPause</h3>

```csharp
public virtual void ApplicationPause(bool paused)
```

O aplicativo foi para segundo plano (true) ou voltou (false).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** O aplicativo foi para segundo plano (true) ou voltou (false).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `paused` | `bool` |  |

<h3 id="member-595e915a5adac284" class="astra-member">Awake</h3>

```csharp
public virtual void Awake()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8a4f79998a6c96b6" class="astra-member">ChildrenChanged</h3>

```csharp
public virtual void ChildrenChanged()
```

A lista direta de filhos deste objeto mudou: criação, remoção, reparent ou reordenação (Unity 6000.0 OnTransformChildrenChanged).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** A lista direta de filhos deste objeto mudou: criação, remoção, reparent ou reordenação (Unity 6000.0 OnTransformChildrenChanged).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e0cfdab6f1328e8" class="astra-member">CollisionEnter</h3>

```csharp
public virtual void CollisionEnter(Astra.Collision collision)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `collision` | `Astra.Collision` |  |

<h3 id="member-9068e2218083370c" class="astra-member">CollisionExit</h3>

```csharp
public virtual void CollisionExit(Astra.Collision collision)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `collision` | `Astra.Collision` |  |

<h3 id="member-d9aa3d6b3929e082" class="astra-member">CollisionStay</h3>

```csharp
public virtual void CollisionStay(Astra.Collision collision)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `collision` | `Astra.Collision` |  |

<h3 id="member-1a3db625c4b1e8ba" class="astra-member">Connect</h3>

```csharp
public Astra.ComponentSubscription Connect(Astra.Component source, string eventId, System.Action<Astra.ComponentEventArgs> handler)
```

O comportamento de target que cumpre o contrato , ou null. `T` pode ser uma interface: é assim que um objeto interage com outro sem conhecer o tipo concreto dele.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** O comportamento de target que cumpre o contrato , ou null. `T` pode ser uma interface: é assim que um objeto interage com outro sem conhecer o tipo concreto dele.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `source` | `Astra.Component` |  |
| `eventId` | `string` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-d8eb22d35f04d36e" class="astra-member">Destroy</h3>

```csharp
public virtual void Destroy()
```

Uma vez ao remover uma instância que recebeu Awake, inclusive ao encerrar Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Uma vez ao remover uma instância que recebeu Awake, inclusive ao encerrar Play.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2c3ec57c5fdeff5c" class="astra-member">Disable</h3>

```csharp
public virtual void Disable()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57bcc678922a4709" class="astra-member">Enable</h3>

```csharp
public virtual void Enable()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac46fe9d6f2312da" class="astra-member">FindBehavior</h3>

```csharp
protected T? FindBehavior<T>(Astra.GameObject? target) where T : class
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `target` | `Astra.GameObject?` |  |

<h3 id="member-a9be5d54f730fa6b" class="astra-member">FindBehaviors</h3>

```csharp
protected System.Collections.Generic.IEnumerable<T> FindBehaviors<T>(Astra.GameObject? target) where T : class
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `target` | `Astra.GameObject?` |  |

<h3 id="member-768a449e84724f51" class="astra-member">FixedUpdate</h3>

```csharp
public virtual void FixedUpdate(float deltaTime)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `deltaTime` | `float` |  |

<h3 id="member-f094ed65d5a6d17c" class="astra-member">LateUpdate</h3>

```csharp
public virtual void LateUpdate(float deltaTime)
```

Depois de animação e física no mesmo quadro: pose final dos objetos para câmeras e ajustes que dependem dela.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Depois de animação e física no mesmo quadro: pose final dos objetos para câmeras e ajustes que dependem dela.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `deltaTime` | `float` |  |

<h3 id="member-38118f1956620d52" class="astra-member">ParentChanged</h3>

```csharp
public virtual void ParentChanged()
```

O pai deste objeto ou de um ancestral mudou (Unity 6000.0 OnTransformParentChanged). Entregue no despacho seguinte ao ponto seguro.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** O pai deste objeto ou de um ancestral mudou (Unity 6000.0 OnTransformParentChanged). Entregue no despacho seguinte ao ponto seguro.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f5c4e34209197fa" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7ca6b50bc0ffc1d8" class="astra-member">Resolve</h3>

```csharp
protected Astra.GameObject? Resolve(Astra.ObjectReference reference)
```

Resolve uma referência autorada no inspetor para um objeto vivo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Resolve uma referência autorada no inspetor para um objeto vivo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `reference` | `Astra.ObjectReference` |  |

<h3 id="member-7c0ad18a4fec7545" class="astra-member">Start</h3>

```csharp
public virtual void Start()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d39b252b371a079" class="astra-member">StartAsync</h3>

```csharp
public Astra.Coroutine StartAsync(System.Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> work)
```

Runs an async Task with owner-bound lifecycle and observed errors. Pass its token to each Awaitable call so stopping the returned coroutine cancels suspended work.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Runs an async Task with owner-bound lifecycle and observed errors. Pass its token to each Awaitable call so stopping the returned coroutine cancels suspended work.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `work` | `System.Func&lt;System.Threading.CancellationToken, System.Threading.Tasks.Task&gt;` |  |

<h3 id="member-f915add142584a58" class="astra-member">StartCoroutine</h3>

```csharp
public Astra.Coroutine StartCoroutine(System.Collections.IEnumerator routine)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `routine` | `System.Collections.IEnumerator` |  |

<h3 id="member-37828dd1a75cc4cd" class="astra-member">Stop</h3>

```csharp
public virtual void Stop()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0a62f9adde30d20e" class="astra-member">StopAllCoroutines</h3>

```csharp
public void StopAllCoroutines()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-507332d7f00f7ae4" class="astra-member">StopCoroutine</h3>

```csharp
public void StopCoroutine(Astra.Coroutine coroutine)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `coroutine` | `Astra.Coroutine` |  |

<h3 id="member-baac3630b4b15aaa" class="astra-member">StopCoroutine</h3>

```csharp
public void StopCoroutine(System.Collections.IEnumerator routine)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `routine` | `System.Collections.IEnumerator` |  |

<h3 id="member-f4502cdc48ee2168" class="astra-member">TimerElapsed</h3>

```csharp
public virtual void TimerElapsed(ulong timerInstanceId, uint count)
```

Called when a Timer on this object expires. Multiple expirations in one frame are delivered together. The ID distinguishes Timer instances.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Called when a Timer on this object expires. Multiple expirations in one frame are delivered together. The ID distinguishes Timer instances.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timerInstanceId` | `ulong` |  |
| `count` | `uint` |  |

<h3 id="member-9c9babdbe59fb30b" class="astra-member">TriggerEnter</h3>

```csharp
public virtual void TriggerEnter(Astra.ObjectReference other)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `other` | `Astra.ObjectReference` |  |

<h3 id="member-f3bfa114a15bf817" class="astra-member">TriggerExit</h3>

```csharp
public virtual void TriggerExit(Astra.ObjectReference other)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `other` | `Astra.ObjectReference` |  |

<h3 id="member-d759f0768aceaa6b" class="astra-member">TriggerStay</h3>

```csharp
public virtual void TriggerStay(Astra.ObjectReference other)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `other` | `Astra.ObjectReference` |  |

<h3 id="member-1d14c999c421146e" class="astra-member">Update</h3>

```csharp
public virtual void Update(float deltaTime)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `deltaTime` | `float` |  |

<h3 id="member-9c33ec8ace32e769" class="astra-member">Awaitable</h3>

```csharp
protected Astra.BehaviorAwaitables Awaitable { get; }
```

Owner-bound awaits. All continuations run on the script dispatch thread.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Owner-bound awaits. All continuations run on the script dispatch thread.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d44701695d8e0cf1" class="astra-member">Debug</h3>

```csharp
protected Astra.DebugDraw Debug { get; }
```

Linhas de depuração visíveis no Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Linhas de depuração visíveis no Play.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-46af2c4ab24afa90" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Estado local; no hospedeiro nativo lê/escreve o mesmo componente do Inspector.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Estado local; no hospedeiro nativo lê/escreve o mesmo componente do Inspector.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4dc88bd0b9860ab" class="astra-member">Gui</h3>

```csharp
protected Astra.GuiAccess Gui { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d0cda12a6ac66b75" class="astra-member">Haptics</h3>

```csharp
protected Astra.HapticsAccess Haptics { get; }
```

Vibração do aparelho, quando a plataforma oferece.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Vibração do aparelho, quando a plataforma oferece.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b1ccdf202b2a558e" class="astra-member">Input</h3>

```csharp
protected Astra.InputAccess Input { get; }
```

As ações de entrada configuradas no projeto.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** As ações de entrada configuradas no projeto.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f70f5844e82fc69" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; private set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-02073bdd9721312c" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f332e25f95cf0982" class="astra-member">Object</h3>

```csharp
protected Astra.GameObject Object { get; }
```

O objeto a que este comportamento está anexado. Resolvido uma vez: um `Object` novo a cada quadro seria lixo alocado por comportamento e por quadro, e o handle não muda enquanto o comportamento existe.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** O objeto a que este comportamento está anexado. Resolvido uma vez: um `Object` novo a cada quadro seria lixo alocado por comportamento e por quadro, e o handle não muda enquanto o comportamento existe.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c3bdf2baa9b981f9" class="astra-member">ObjectId</h3>

```csharp
public ulong ObjectId { get; private set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b866bb75729dc323" class="astra-member">Physics</h3>

```csharp
protected Astra.PhysicsAccess Physics { get; }
```

As consultas físicas do mundo de execução.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** As consultas físicas do mundo de execução.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-404894160094aad5" class="astra-member">Physics2D</h3>

```csharp
protected Astra.Physics2DAccess Physics2D { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e37909d7c24d3753" class="astra-member">Save</h3>

```csharp
public Astra.SaveStore Save { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c6d65b04aef033f" class="astra-member">Scene</h3>

```csharp
protected Astra.ISceneAccess Scene { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a21da8cfbab46c5" class="astra-member">Scenes</h3>

```csharp
protected Astra.ScenesAccess Scenes { get; }
```

Cenas do projeto: ativa, lista, troca e carga aditiva.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Cenas do projeto: ativa, lista, troca e carga aditiva.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-40405df27fa1c414" class="astra-member">Time</h3>

```csharp
public Astra.TimeAccess Time { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e39078dcbaa811d2" class="astra-member">Transform</h3>

```csharp
protected Astra.TransformValue Transform { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f1c7d8d630953a93" class="astra-member">View</h3>

```csharp
protected Astra.GameViewAccess View { get; }
```

Tamanho, DPI, área segura e conversões tela/mundo da vista de jogo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Tamanho, DPI, área segura e conversões tela/mundo da vista de jogo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.BehaviorAwaitable"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitable/
---

# Astra.BehaviorAwaitable

Single-consumer await operation. Completion drops its continuation so handles do not retain scripts.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.BehaviorAwaitable
```

Single-consumer await operation. Completion drops its continuation so handles do not retain scripts.

**Interfaces:** `System.Runtime.CompilerServices.INotifyCompletion`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [GetAwaiter](#member-a40bca132184caf3) | Method |
| [GetResult](#member-4bb0005da06c2454) | Method |
| [OnCompleted](#member-f6a6584b5ca38c95) | Method |
| [IsCompleted](#member-586dd8ec4ee9cfc7) | Property |

<h3 id="member-a40bca132184caf3" class="astra-member">GetAwaiter</h3>

```csharp
public Astra.BehaviorAwaitable GetAwaiter()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4bb0005da06c2454" class="astra-member">GetResult</h3>

```csharp
public void GetResult()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f6a6584b5ca38c95" class="astra-member">OnCompleted</h3>

```csharp
public void OnCompleted(System.Action continuation)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `continuation` | `System.Action` |  |

<h3 id="member-586dd8ec4ee9cfc7" class="astra-member">IsCompleted</h3>

```csharp
public bool IsCompleted { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.BehaviorAwaitables"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitables/
---

# Astra.BehaviorAwaitables

Awaitable routes bound to one Behavior. The provided waits resume on the script dispatch thread. Arbitrary Tasks (Task.Run/Delay/network) do not acquire that guarantee.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.BehaviorAwaitables
```

Awaitable routes bound to one Behavior. The provided waits resume on the script dispatch thread. Arbitrary Tasks (Task.Run/Delay/network) do not acquire that guarantee.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [FixedUpdate](#member-a4f4f638b52b3030) | Method |
| [NextFrame](#member-2a885b1b101cae5d) | Method |
| [Seconds](#member-d7a2f4643cd596d3) | Method |
| [SecondsRealtime](#member-d72f3cb41ae046ae) | Method |

<h3 id="member-a4f4f638b52b3030" class="astra-member">FixedUpdate</h3>

```csharp
public Astra.BehaviorAwaitable FixedUpdate(System.Threading.CancellationToken cancellation = default(System.Threading.CancellationToken))
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `cancellation` | `System.Threading.CancellationToken` |  · Opcional: `` |

<h3 id="member-2a885b1b101cae5d" class="astra-member">NextFrame</h3>

```csharp
public Astra.BehaviorAwaitable NextFrame(System.Threading.CancellationToken cancellation = default(System.Threading.CancellationToken))
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `cancellation` | `System.Threading.CancellationToken` |  · Opcional: `` |

<h3 id="member-d7a2f4643cd596d3" class="astra-member">Seconds</h3>

```csharp
public Astra.BehaviorAwaitable Seconds(double seconds, System.Threading.CancellationToken cancellation = default(System.Threading.CancellationToken))
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |
| `cancellation` | `System.Threading.CancellationToken` |  · Opcional: `` |

<h3 id="member-d72f3cb41ae046ae" class="astra-member">SecondsRealtime</h3>

```csharp
public Astra.BehaviorAwaitable SecondsRealtime(double seconds, System.Threading.CancellationToken cancellation = default(System.Threading.CancellationToken))
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |
| `cancellation` | `System.Threading.CancellationToken` |  · Opcional: `` |


---

---
title: "Astra.Body2DAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-body2daccess/
---

# Astra.Body2DAccess

Struct da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Body2DAccess
```

## Onde acessar este tipo

No Behavior, use **Physics2D** para consultas ou a fachada Body2D/Collider2D do objeto. O plano é XY e os contratos de graus/radianos são explícitos.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AddAngularImpulse](#member-8eebf49ca9a4b75a) | Method |
| [AddForce](#member-eaae2bf23dc03ec4) | Method |
| [AddImpulse](#member-947c0986d88067c3) | Method |
| [AddTorque](#member-94cd4d057333e96f) | Method |
| [MoveKinematic](#member-e35e0c1928d4edf9) | Method |
| [Velocity](#member-1ced70d8c5524f7b) | Property |

<h3 id="member-8eebf49ca9a4b75a" class="astra-member">AddAngularImpulse</h3>

```csharp
public void AddAngularImpulse(float impulse)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `impulse` | `float` |  |

<h3 id="member-eaae2bf23dc03ec4" class="astra-member">AddForce</h3>

```csharp
public void AddForce(System.Numerics.Vector2 force)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `force` | `System.Numerics.Vector2` |  |

<h3 id="member-947c0986d88067c3" class="astra-member">AddImpulse</h3>

```csharp
public void AddImpulse(System.Numerics.Vector2 impulse)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `impulse` | `System.Numerics.Vector2` |  |

<h3 id="member-94cd4d057333e96f" class="astra-member">AddTorque</h3>

```csharp
public void AddTorque(float torque)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `torque` | `float` |  |

<h3 id="member-e35e0c1928d4edf9" class="astra-member">MoveKinematic</h3>

```csharp
public void MoveKinematic(System.Numerics.Vector2 position, float rotationDegrees)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `position` | `System.Numerics.Vector2` |  |
| `rotationDegrees` | `float` |  |

<h3 id="member-1ced70d8c5524f7b" class="astra-member">Velocity</h3>

```csharp
public Astra.BodyVelocity2D Velocity { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.BodyVelocity2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-bodyvelocity2d/
---

# Astra.BodyVelocity2D

Struct da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.BodyVelocity2D
```

**Interfaces:** `System.IEquatable<Astra.BodyVelocity2D>`.

## Onde acessar este tipo

No Behavior, use **Physics2D** para consultas ou a fachada Body2D/Collider2D do objeto. O plano é XY e os contratos de graus/radianos são explícitos.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-401227b4b65cb3bc) | Method |
| [AngularDegrees](#member-0575c64148aaf409) | Property |
| [Linear](#member-73a1611252403f2d) | Property |

<h3 id="member-401227b4b65cb3bc" class="astra-member">.ctor</h3>

```csharp
public BodyVelocity2D(System.Numerics.Vector2 Linear, float AngularDegrees)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Linear` | `System.Numerics.Vector2` |  |
| `AngularDegrees` | `float` |  |

<h3 id="member-0575c64148aaf409" class="astra-member">AngularDegrees</h3>

```csharp
public float AngularDegrees { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-73a1611252403f2d" class="astra-member">Linear</h3>

```csharp
public System.Numerics.Vector2 Linear { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CameraFollowRig"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-camerafollowrig/
---

# Astra.CameraFollowRig

Position-only follow behavior evaluated after animation and physics. Camera rotation remains under authoring, CameraLook, or scripts.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.CameraFollowRig
```

Position-only follow behavior evaluated after animation and physics. Camera rotation remains under authoring, CameraLook, or scripts.

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-887dd214c4198239) | Method |
| [DampingSeconds](#member-520970953713557c) | Property |
| [Enabled](#member-3df0d1c4dbf3c23f) | Property |
| [Offset](#member-3a53d76805aa347a) | Property |
| [Target](#member-0746fb2febf3eec1) | Property |

<h3 id="member-887dd214c4198239" class="astra-member">.ctor</h3>

```csharp
public CameraFollowRig(Astra.Component component)
```

Position-only follow behavior evaluated after animation and physics. Camera rotation remains under authoring, CameraLook, or scripts.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-520970953713557c" class="astra-member">DampingSeconds</h3>

```csharp
public float DampingSeconds { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3df0d1c4dbf3c23f" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3a53d76805aa347a" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0746fb2febf3eec1" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CharacterGroundState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-charactergroundstate/
---

# Astra.CharacterGroundState

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.CharacterGroundState
```

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [InAir](#member-d4eb6016a05ef470) | Field |
| [NotSupported](#member-76a16901af434866) | Field |
| [OnGround](#member-6cf4fa9de6bfe8d6) | Field |
| [OnSteepGround](#member-1bf16258bbfc197d) | Field |

<h3 id="member-d4eb6016a05ef470" class="astra-member">InAir</h3>

```csharp
InAir = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-76a16901af434866" class="astra-member">NotSupported</h3>

```csharp
NotSupported = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6cf4fa9de6bfe8d6" class="astra-member">OnGround</h3>

```csharp
OnGround = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bf16258bbfc197d" class="astra-member">OnSteepGround</h3>

```csharp
OnSteepGround = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CharacterRuntimeState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-characterruntimestate/
---

# Astra.CharacterRuntimeState

Velocity is displacement resolved during the last fixed step; MotorVelocity is the Jolt motor input. Position is the capsule foot in world space. Runtime only.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.CharacterRuntimeState
```

Velocity is displacement resolved during the last fixed step; MotorVelocity is the Jolt motor input. Position is the capsule foot in world space. Runtime only.

**Interfaces:** `System.IEquatable<Astra.CharacterRuntimeState>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-c019569ed3ea2ee0) | Method |
| [GroundNormal](#member-cd1b9fd270270e95) | Property |
| [GroundState](#member-6fd26501394affc0) | Property |
| [GroundVelocity](#member-37ebd0ceb0c64a25) | Property |
| [HasMeasuredStep](#member-8cce59365945f036) | Property |
| [IsGrounded](#member-8a77c4420900d613) | Property |
| [MotorVelocity](#member-4425ac1c3e5ff749) | Property |
| [Position](#member-0689da89b6819aa5) | Property |
| [Velocity](#member-e6a2ce8dba27a0ac) | Property |

<h3 id="member-c019569ed3ea2ee0" class="astra-member">.ctor</h3>

```csharp
public CharacterRuntimeState(Astra.CharacterGroundState GroundState, bool HasMeasuredStep, System.Numerics.Vector3 Position, System.Numerics.Vector3 Velocity, System.Numerics.Vector3 MotorVelocity, System.Numerics.Vector3 GroundVelocity, System.Numerics.Vector3 GroundNormal)
```

Velocity is displacement resolved during the last fixed step; MotorVelocity is the Jolt motor input. Position is the capsule foot in world space. Runtime only.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `GroundState` | `Astra.CharacterGroundState` |  |
| `HasMeasuredStep` | `bool` |  |
| `Position` | `System.Numerics.Vector3` |  |
| `Velocity` | `System.Numerics.Vector3` |  |
| `MotorVelocity` | `System.Numerics.Vector3` |  |
| `GroundVelocity` | `System.Numerics.Vector3` |  |
| `GroundNormal` | `System.Numerics.Vector3` |  |

<h3 id="member-cd1b9fd270270e95" class="astra-member">GroundNormal</h3>

```csharp
public System.Numerics.Vector3 GroundNormal { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6fd26501394affc0" class="astra-member">GroundState</h3>

```csharp
public Astra.CharacterGroundState GroundState { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-37ebd0ceb0c64a25" class="astra-member">GroundVelocity</h3>

```csharp
public System.Numerics.Vector3 GroundVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8cce59365945f036" class="astra-member">HasMeasuredStep</h3>

```csharp
public bool HasMeasuredStep { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8a77c4420900d613" class="astra-member">IsGrounded</h3>

```csharp
public bool IsGrounded { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4425ac1c3e5ff749" class="astra-member">MotorVelocity</h3>

```csharp
public System.Numerics.Vector3 MotorVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0689da89b6819aa5" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6a2ce8dba27a0ac" class="astra-member">Velocity</h3>

```csharp
public System.Numerics.Vector3 Velocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Collision"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-collision/
---

# Astra.Collision

Um contato sólido entregue a um comportamento. Chega aos DOIS objetos do par, cada um recebendo o outro.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.Collision
```

Um contato sólido entregue a um comportamento. Chega aos DOIS objetos do par, cada um recebendo o outro.

**Interfaces:** `System.IEquatable<Astra.Collision>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e75fd3c8dffe9460) | Method |
| [Normal](#member-65b6dcddc10fa957) | Property |
| [Other](#member-5a5431706ed3b57c) | Property |

<h3 id="member-e75fd3c8dffe9460" class="astra-member">.ctor</h3>

```csharp
public Collision(Astra.ObjectReference Other, System.Numerics.Vector3? Normal)
```

Um contato sólido entregue a um comportamento. Chega aos DOIS objetos do par, cada um recebendo o outro.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Other` | `Astra.ObjectReference` |  |
| `Normal` | `System.Numerics.Vector3?` |  |

<h3 id="member-65b6dcddc10fa957" class="astra-member">Normal</h3>

```csharp
public System.Numerics.Vector3? Normal { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5a5431706ed3b57c" class="astra-member">Other</h3>

```csharp
public Astra.ObjectReference Other { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Color"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-color/
---

# Astra.Color

Cor em RGB linear com alfa (Unity: Color). Canais acima de 1 só em campos HDR; o Inspector edita pela janela de cor.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.Color
```

Cor em RGB linear com alfa (Unity: Color). Canais acima de 1 só em campos HDR; o Inspector edita pela janela de cor.

**Interfaces:** `System.IEquatable<Astra.Color>`.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [A](#member-fc9046235b95513f) | Field |
| [B](#member-3236218f8d1df27f) | Field |
| [G](#member-c653e07380acb3c2) | Field |
| [R](#member-ab657e95af618639) | Field |
| [.ctor](#member-b52e3b92dd39ea76) | Method |
| [Equals](#member-6bd075a249b9444d) | Method |
| [Equals](#member-48cee32f36e72059) | Method |
| [GetHashCode](#member-bce8cb6beaa85cb4) | Method |
| [Lerp](#member-8370b083c30a1a3b) | Method |
| [ToString](#member-3f88611a868b318a) | Method |
| [op_Equality](#member-8ba41f1ae0ddb086) | Method |
| [op_Inequality](#member-99105933592b90fa) | Method |
| [op_Multiply](#member-28e4a500ee8b49b3) | Method |
| [Black](#member-40a203239465013e) | Property |
| [Clear](#member-e2d3f1850e2410bd) | Property |
| [White](#member-0277456430a59f19) | Property |

<h3 id="member-fc9046235b95513f" class="astra-member">A</h3>

```csharp
public float A
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3236218f8d1df27f" class="astra-member">B</h3>

```csharp
public float B
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c653e07380acb3c2" class="astra-member">G</h3>

```csharp
public float G
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab657e95af618639" class="astra-member">R</h3>

```csharp
public float R
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b52e3b92dd39ea76" class="astra-member">.ctor</h3>

```csharp
public Color(float r, float g, float b, float a = 1)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `r` | `float` |  |
| `g` | `float` |  |
| `b` | `float` |  |
| `a` | `float` |  · Opcional: `1` |

<h3 id="member-6bd075a249b9444d" class="astra-member">Equals</h3>

```csharp
public bool Equals(Astra.Color other)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `other` | `Astra.Color` |  |

<h3 id="member-48cee32f36e72059" class="astra-member">Equals</h3>

```csharp
public override bool Equals(object? obj)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `obj` | `object?` |  |

<h3 id="member-bce8cb6beaa85cb4" class="astra-member">GetHashCode</h3>

```csharp
public override int GetHashCode()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8370b083c30a1a3b" class="astra-member">Lerp</h3>

```csharp
public static Astra.Color Lerp(Astra.Color a, Astra.Color b, float t)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `a` | `Astra.Color` |  |
| `b` | `Astra.Color` |  |
| `t` | `float` |  |

<h3 id="member-3f88611a868b318a" class="astra-member">ToString</h3>

```csharp
public override string ToString()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8ba41f1ae0ddb086" class="astra-member">op_Equality</h3>

```csharp
public static bool operator ==(Astra.Color a, Astra.Color b)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `a` | `Astra.Color` |  |
| `b` | `Astra.Color` |  |

<h3 id="member-99105933592b90fa" class="astra-member">op_Inequality</h3>

```csharp
public static bool operator !=(Astra.Color a, Astra.Color b)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `a` | `Astra.Color` |  |
| `b` | `Astra.Color` |  |

<h3 id="member-28e4a500ee8b49b3" class="astra-member">op_Multiply</h3>

```csharp
public static Astra.Color operator *(Astra.Color c, float s)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `c` | `Astra.Color` |  |
| `s` | `float` |  |

<h3 id="member-40a203239465013e" class="astra-member">Black</h3>

```csharp
public static Astra.Color Black { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2d3f1850e2410bd" class="astra-member">Clear</h3>

```csharp
public static Astra.Color Clear { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0277456430a59f19" class="astra-member">White</h3>

```csharp
public static Astra.Color White { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ColorUsageAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-colorusageattribute/
---

# Astra.ColorUsageAttribute

Como o Inspector mostra um campo Astra.Color (Unity: [ColorUsage]): sem alfa e/ou com intensidade HDR.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.ColorUsageAttribute
```

Como o Inspector mostra um campo Astra.Color (Unity: [ColorUsage]): sem alfa e/ou com intensidade HDR.

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-7ee74a9de28e1ee0) | Method |
| [Hdr](#member-3f2344355c03bdf5) | Property |
| [ShowAlpha](#member-01b821752430e4fc) | Property |

<h3 id="member-7ee74a9de28e1ee0" class="astra-member">.ctor</h3>

```csharp
public ColorUsageAttribute(bool showAlpha, bool hdr = false)
```

Como o Inspector mostra um campo Astra.Color (Unity: [ColorUsage]): sem alfa e/ou com intensidade HDR.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `showAlpha` | `bool` |  |
| `hdr` | `bool` |  · Opcional: `False` |

<h3 id="member-3f2344355c03bdf5" class="astra-member">Hdr</h3>

```csharp
public bool Hdr { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01b821752430e4fc" class="astra-member">ShowAlpha</h3>

```csharp
public bool ShowAlpha { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Component"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-component/
---

# Astra.Component

Uma instância de componente endereçada por objeto + instanceId. Componentes repetíveis (colisor, junta, comportamento) têm cada instância endereçável.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Component
```

Uma instância de componente endereçada por objeto + instanceId. Componentes repetíveis (colisor, junta, comportamento) têm cada instância endereçável.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Animation](#member-51feb8531564c66f) | Method |
| [CameraFollow](#member-281d8cf1015c49e5) | Method |
| [Curve](#member-e4b925a8fc8b0eb1) | Method |
| [DeformableMesh](#member-315241d4dc1af3b6) | Method |
| [FollowPath](#member-541e4e43ece32524) | Method |
| [GetBool](#member-d8ce49c3543f6163) | Method |
| [GetEnum](#member-5802309f73ecd9a6) | Method |
| [GetFloat](#member-bb0467a075ccea49) | Method |
| [GetReference](#member-675d3bfbf3b7ed04) | Method |
| [GetResource](#member-6de2a4c83554b914) | Method |
| [GetResourceByElementId](#member-38033c9253d872b8) | Method |
| [GetSlotEnum](#member-631347eb118b9233) | Method |
| [GetSlotFloat](#member-ed5fe2862aea45eb) | Method |
| [Invoke](#member-e947c2a49f4a23bf) | Method |
| [Invoke](#member-06d17814817ad30f) | Method |
| [Material](#member-77cafbda1faa2642) | Method |
| [Remove](#member-87fd215fbb2ae06f) | Method |
| [RemoveTracked](#member-f050cc60e3b30a94) | Method |
| [ResourceElementId](#member-6f07c1994ea6c72e) | Method |
| [SetBool](#member-bb51bed5e5516d1a) | Method |
| [SetEnum](#member-f6c53e850d0131a4) | Method |
| [SetFloat](#member-aa5d138b4dc8ae43) | Method |
| [SetReference](#member-ee839c7d93276e46) | Method |
| [SetReference](#member-be54b0f56cbff06d) | Method |
| [SetResource](#member-17100154b95a706a) | Method |
| [SetResourceByElementId](#member-7f13d580cb6019d9) | Method |
| [SetSlotEnum](#member-39ab72b7c4ef2030) | Method |
| [SetSlotFloat](#member-f5555aaed8fde14e) | Method |
| [SetVector2](#member-37597e3f1f810748) | Method |
| [SetVector3](#member-2dd3c08ab759dfb2) | Method |
| [Timer](#member-4127dbaa98a6e8fc) | Method |
| [ToString](#member-313fae6f476997af) | Method |
| [Enabled](#member-7cffb69755f94e6d) | Property |
| [InstanceId](#member-6b21952f1605a169) | Property |
| [IsAlive](#member-6aa9f7c7a3309650) | Property |
| [Object](#member-c8e25fb5d14fd04d) | Property |
| [TypeId](#member-565d7c3e8b714e8a) | Property |

<h3 id="member-51feb8531564c66f" class="astra-member">Animation</h3>

```csharp
public Astra.AnimationPlayer Animation()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-281d8cf1015c49e5" class="astra-member">CameraFollow</h3>

```csharp
public Astra.CameraFollowRig CameraFollow()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e4b925a8fc8b0eb1" class="astra-member">Curve</h3>

```csharp
public Astra.CurvePath Curve()
```

Stable point identities, Bézier handles and world distance sampling.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Stable point identities, Bézier handles and world distance sampling.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-315241d4dc1af3b6" class="astra-member">DeformableMesh</h3>

```csharp
public Astra.DeformableMesh DeformableMesh()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-541e4e43ece32524" class="astra-member">FollowPath</h3>

```csharp
public Astra.PathFollower FollowPath()
```

Control the real path follower in the current Play world.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Control the real path follower in the current Play world.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8ce49c3543f6163" class="astra-member">GetBool</h3>

```csharp
public bool GetBool(string propertyId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |

<h3 id="member-5802309f73ecd9a6" class="astra-member">GetEnum</h3>

```csharp
public uint GetEnum(string propertyId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |

<h3 id="member-bb0467a075ccea49" class="astra-member">GetFloat</h3>

```csharp
public float GetFloat(string propertyId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |

<h3 id="member-675d3bfbf3b7ed04" class="astra-member">GetReference</h3>

```csharp
public Astra.ObjectReference GetReference(string propertyId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |

<h3 id="member-6de2a4c83554b914" class="astra-member">GetResource</h3>

```csharp
public Astra.AssetGuid GetResource(string propertyId, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-38033c9253d872b8" class="astra-member">GetResourceByElementId</h3>

```csharp
public Astra.AssetGuid GetResourceByElementId(string propertyId, ulong elementId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `elementId` | `ulong` |  |

<h3 id="member-631347eb118b9233" class="astra-member">GetSlotEnum</h3>

```csharp
public uint GetSlotEnum(string propertyId, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-ed5fe2862aea45eb" class="astra-member">GetSlotFloat</h3>

```csharp
public float GetSlotFloat(string propertyId, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-e947c2a49f4a23bf" class="astra-member">Invoke</h3>

```csharp
public Astra.ComponentValue Invoke(string method, params Astra.ComponentValue[] arguments)
```

Executa um método declarado pelo tipo do componente no mundo de Play, com os argumentos tipados do descritor nativo. Host sem a família astra.component.operations lança System.NotSupportedException.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Executa um método declarado pelo tipo do componente no mundo de Play, com os argumentos tipados do descritor nativo. Host sem a família astra.component.operations lança System.NotSupportedException.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `arguments` | `Astra.ComponentValue[]` |  |

<h3 id="member-06d17814817ad30f" class="astra-member">Invoke</h3>

```csharp
public Astra.ComponentValue Invoke(string method, System.ReadOnlySpan<Astra.ComponentValue> arguments)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `arguments` | `System.ReadOnlySpan&lt;Astra.ComponentValue&gt;` |  |

<h3 id="member-77cafbda1faa2642" class="astra-member">Material</h3>

```csharp
public Astra.MaterialSlot Material(uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-87fd215fbb2ae06f" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remoção aplicada no próximo ponto seguro do mundo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Remoção aplicada no próximo ponto seguro do mundo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f050cc60e3b30a94" class="astra-member">RemoveTracked</h3>

```csharp
public Astra.WorldOperation RemoveTracked()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f07c1994ea6c72e" class="astra-member">ResourceElementId</h3>

```csharp
public ulong ResourceElementId(string propertyId, uint slot)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `slot` | `uint` |  |

<h3 id="member-bb51bed5e5516d1a" class="astra-member">SetBool</h3>

```csharp
public void SetBool(string propertyId, bool value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `bool` |  |

<h3 id="member-f6c53e850d0131a4" class="astra-member">SetEnum</h3>

```csharp
public void SetEnum(string propertyId, uint value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `uint` |  |

<h3 id="member-aa5d138b4dc8ae43" class="astra-member">SetFloat</h3>

```csharp
public void SetFloat(string propertyId, float value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `float` |  |

<h3 id="member-ee839c7d93276e46" class="astra-member">SetReference</h3>

```csharp
public void SetReference(string propertyId, Astra.GameObject? value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `Astra.GameObject?` |  |

<h3 id="member-be54b0f56cbff06d" class="astra-member">SetReference</h3>

```csharp
public void SetReference(string propertyId, Astra.ObjectReference value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `Astra.ObjectReference` |  |

<h3 id="member-17100154b95a706a" class="astra-member">SetResource</h3>

```csharp
public void SetResource(string propertyId, Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-7f13d580cb6019d9" class="astra-member">SetResourceByElementId</h3>

```csharp
public void SetResourceByElementId(string propertyId, ulong elementId, Astra.AssetGuid value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `elementId` | `ulong` |  |
| `value` | `Astra.AssetGuid` |  |

<h3 id="member-39ab72b7c4ef2030" class="astra-member">SetSlotEnum</h3>

```csharp
public void SetSlotEnum(string propertyId, uint value, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `uint` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-f5555aaed8fde14e" class="astra-member">SetSlotFloat</h3>

```csharp
public void SetSlotFloat(string propertyId, float value, uint slot = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `float` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-37597e3f1f810748" class="astra-member">SetVector2</h3>

```csharp
public void SetVector2(string propertyId, System.Numerics.Vector2 value)
```

Writes the two persisted channels atomically; transport padding is zero.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Writes the two persisted channels atomically; transport padding is zero.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `System.Numerics.Vector2` |  |

<h3 id="member-2dd3c08ab759dfb2" class="astra-member">SetVector3</h3>

```csharp
public void SetVector3(string propertyId, System.Numerics.Vector3 value)
```

Valida e publica os três canais refletidos como uma única atribuição.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Valida e publica os três canais refletidos como uma única atribuição.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `propertyId` | `string` |  |
| `value` | `System.Numerics.Vector3` |  |

<h3 id="member-4127dbaa98a6e8fc" class="astra-member">Timer</h3>

```csharp
public Astra.Components.GameTimer Timer()
```

Fachada gerada do schema (`Astra.Components.GameTimer`).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Fachada gerada do schema (`Astra.Components.GameTimer`).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-313fae6f476997af" class="astra-member">ToString</h3>

```csharp
public override string ToString()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7cffb69755f94e6d" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Estado local dos tipos que declaram a propriedade enabled no schema. Tipos sem essa capacidade recusam a operação; não desativa o objeto.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Estado local dos tipos que declaram a propriedade enabled no schema. Tipos sem essa capacidade recusam a operação; não desativa o objeto.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b21952f1605a169" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6aa9f7c7a3309650" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c8e25fb5d14fd04d" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-565d7c3e8b714e8a" class="astra-member">TypeId</h3>

```csharp
public string TypeId { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentEventArgs"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componenteventargs/
---

# Astra.ComponentEventArgs

Evento recebido por uma assinatura de componente.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.ComponentEventArgs
```

Evento recebido por uma assinatura de componente.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [GetObject](#member-dc536871e8c4679b) | Method |
| [Count](#member-6dbf11d74aa06cf3) | Property |
| [EmitterInstanceId](#member-d542d87e6dfd6028) | Property |
| [EventId](#member-e936c0e527770831) | Property |
| [this[]](#member-e55e65b70a7184ed) | Property |
| [Lost](#member-bfd4ce0aacf70088) | Property |
| [Source](#member-5994fc2153f30a58) | Property |

<h3 id="member-dc536871e8c4679b" class="astra-member">GetObject</h3>

```csharp
public Astra.ObjectReference GetObject(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-6dbf11d74aa06cf3" class="astra-member">Count</h3>

```csharp
public int Count { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d542d87e6dfd6028" class="astra-member">EmitterInstanceId</h3>

```csharp
public ulong EmitterInstanceId { get; }
```

Instância que emitiu; zero quando o backend identifica só o objeto (física 3D).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Instância que emitiu; zero quando o backend identifica só o objeto (física 3D).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e936c0e527770831" class="astra-member">EventId</h3>

```csharp
public string EventId { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e55e65b70a7184ed" class="astra-member">this[]</h3>

```csharp
public Astra.ComponentValue this[int index] { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bfd4ce0aacf70088" class="astra-member">Lost</h3>

```csharp
public uint Lost { get; }
```

Eventos descartados por estouro da fila antes deste.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Eventos descartados por estouro da fila antes deste.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5994fc2153f30a58" class="astra-member">Source</h3>

```csharp
public Astra.Component Source { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentIdAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componentidattribute/
---

# Astra.ComponentIdAttribute

Class da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.ComponentIdAttribute
```

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-1552ad9ce99be171) | Method |
| [Id](#member-256ee3d5180a2675) | Property |

<h3 id="member-1552ad9ce99be171" class="astra-member">.ctor</h3>

```csharp
public ComponentIdAttribute(string id)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `string` |  |

<h3 id="member-256ee3d5180a2675" class="astra-member">Id</h3>

```csharp
public string Id { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentIds"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componentids/
---

# Astra.ComponentIds

Os identificadores dos componentes nativos anexáveis.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.ComponentIds
```

Os identificadores dos componentes nativos anexáveis.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Animation](#member-e36f102f4e6a388f) | Field |
| [Camera](#member-ecf068f62a3cb6ca) | Field |
| [CameraFollow](#member-ceefdd1e303b5d58) | Field |
| [CameraLook](#member-d767a08433d03d44) | Field |
| [Character](#member-00704fc8662fb91b) | Field |
| [Collider](#member-34a85dabdcc30429) | Field |
| [Environment](#member-dd215ec959346dc0) | Field |
| [Joint](#member-cc3fe132a2f4b73c) | Field |
| [Light](#member-a0685b03b484c3e6) | Field |
| [LodGroup](#member-93f117a387516e2f) | Field |
| [MeshRenderer](#member-e7662097f3aa326c) | Field |
| [Path](#member-5471b0eaf9c9bfeb) | Field |
| [PathFollow](#member-fc7dd0df74495292) | Field |
| [PhysicsBody](#member-5beb6baf1ce66d79) | Field |
| [ScriptBehavior](#member-553c7c4c731936d9) | Field |
| [SkinnedMesh](#member-573a94938c439c7d) | Field |
| [Timer](#member-6c4f08a2df231499) | Field |

<h3 id="member-e36f102f4e6a388f" class="astra-member">Animation</h3>

```csharp
public const string Animation = astra.animation
```

Animação: recursos `clip` (padrão) e `clips` (lista), `clip_count`, `play_automatically`, `wrap_mode` e `speed`. Tocar e misturar: Astra.Component.Animation.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Animação: recursos `clip` (padrão) e `clips` (lista), `clip_count`, `play_automatically`, `wrap_mode` e `speed`. Tocar e misturar: Astra.Component.Animation.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ecf068f62a3cb6ca" class="astra-member">Camera</h3>

```csharp
public const string Camera = astra.camera
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ceefdd1e303b5d58" class="astra-member">CameraFollow</h3>

```csharp
public const string CameraFollow = astra.camera.follow
```

Follow target and damping for a Camera; only position is driven in Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Follow target and damping for a Camera; only position is driven in Play.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d767a08433d03d44" class="astra-member">CameraLook</h3>

```csharp
public const string CameraLook = astra.camera.look
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00704fc8662fb91b" class="astra-member">Character</h3>

```csharp
public const string Character = astra.physics.character
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-34a85dabdcc30429" class="astra-member">Collider</h3>

```csharp
public const string Collider = astra.physics.collider
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd215ec959346dc0" class="astra-member">Environment</h3>

```csharp
public const string Environment = astra.render.environment
```

Ambiente autoral da cena: céu, atmosfera, neblina e pós.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Ambiente autoral da cena: céu, atmosfera, neblina e pós.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc3fe132a2f4b73c" class="astra-member">Joint</h3>

```csharp
public const string Joint = astra.physics.joint
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0685b03b484c3e6" class="astra-member">Light</h3>

```csharp
public const string Light = astra.render.light
```

Luz: `kind`, `enabled`, `color`, `intensity`, `range`, `inner_angle`, `outer_angle`, `unit` (0 escala legada, 1 lux/candela, 2 lux/lúmen), `use_color_temperature` e `color_temperature` em kelvin.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Luz: `kind`, `enabled`, `color`, `intensity`, `range`, `inner_angle`, `outer_angle`, `unit` (0 escala legada, 1 lux/candela, 2 lux/lúmen), `use_color_temperature` e `color_temperature` em kelvin.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-93f117a387516e2f" class="astra-member">LodGroup</h3>

```csharp
public const string LodGroup = astra.render.lod_group
```

LOD Group: `level_count`, `transition_0..3` (% da altura da tela), `level_0..3` (objeto do nível), `size`, `fade_mode` (0 nenhum, 1 cross-fade), `animate_cross_fading`, `fade_width_0..3` e `force_level` (ForceLOD da Unity: 0 automático, n força o LOD n-1; estado de execução, não vai para o arquivo).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** LOD Group: `level_count`, `transition_0..3` (% da altura da tela), `level_0..3` (objeto do nível), `size`, `fade_mode` (0 nenhum, 1 cross-fade), `animate_cross_fading`, `fade_width_0..3` e `force_level` (ForceLOD da Unity: 0 automático, n força o LOD n-1; estado de execução, não vai para o arquivo).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e7662097f3aa326c" class="astra-member">MeshRenderer</h3>

```csharp
public const string MeshRenderer = astra.render.mesh
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5471b0eaf9c9bfeb" class="astra-member">Path</h3>

```csharp
public const string Path = astra.path
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fc7dd0df74495292" class="astra-member">PathFollow</h3>

```csharp
public const string PathFollow = astra.path.follow
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5beb6baf1ce66d79" class="astra-member">PhysicsBody</h3>

```csharp
public const string PhysicsBody = astra.physics.body
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-553c7c4c731936d9" class="astra-member">ScriptBehavior</h3>

```csharp
public const string ScriptBehavior = astra.script.behavior
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-573a94938c439c7d" class="astra-member">SkinnedMesh</h3>

```csharp
public const string SkinnedMesh = astra.render.skinned_mesh
```

Malha deformável: `quality` (0 automática, 1, 2 ou 4 influências), `skinned_motion_vectors` e `blend_shape_weight` por slot (0..100). Os ossos são ligados pela importação. Use Astra.Component.DeformableMesh.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Malha deformável: `quality` (0 automática, 1, 2 ou 4 influências), `skinned_motion_vectors` e `blend_shape_weight` por slot (0..100). Os ossos são ligados pela importação. Use Astra.Component.DeformableMesh.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6c4f08a2df231499" class="astra-member">Timer</h3>

```csharp
public const string Timer = astra.time.timer
```

Timer do mundo de Play. O evento chega em Astra.Behavior.TimerElapsed(System.UInt64,System.UInt32).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Timer do mundo de Play. O evento chega em Astra.Behavior.TimerElapsed(System.UInt64,System.UInt32).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentSubscription"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componentsubscription/
---

# Astra.ComponentSubscription

Assinatura de um evento. Termina com Dispose, ao retirar o comportamento dono ou no fim do Play.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.ComponentSubscription
```

Assinatura de um evento. Termina com Dispose, ao retirar o comportamento dono ou no fim do Play.

**Interfaces:** `System.IDisposable`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Dispose](#member-3bfce06142b971b5) | Method |
| [Active](#member-2c722e5ddff6d7ee) | Property |
| [EventId](#member-42e8a7adfe91d44a) | Property |
| [Source](#member-0aea4aacc105c395) | Property |

<h3 id="member-3bfce06142b971b5" class="astra-member">Dispose</h3>

```csharp
public void Dispose()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2c722e5ddff6d7ee" class="astra-member">Active</h3>

```csharp
public bool Active { get; internal set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42e8a7adfe91d44a" class="astra-member">EventId</h3>

```csharp
public string EventId { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0aea4aacc105c395" class="astra-member">Source</h3>

```csharp
public Astra.Component Source { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentValue"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componentvalue/
---

# Astra.ComponentValue

Valor de argumento, retorno ou payload. Layout de 24 bytes idêntico a ae::scene::ComponentOperationValue (implementação da engine).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.ComponentValue
```

Valor de argumento, retorno ou payload. Layout de 24 bytes idêntico a ae::scene::ComponentOperationValue (implementação da engine).

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AsBoolean](#member-51831111a2480c10) | Method |
| [AsInteger](#member-a78fdb0bc8b7a4e3) | Method |
| [AsNumber](#member-f3025914f13c442b) | Method |
| [AsObjectId](#member-5ab2a8e9aa776322) | Method |
| [AsVector3](#member-70113f270d689dcb) | Method |
| [Boolean](#member-57cefdb1552ee5bf) | Method |
| [Integer](#member-3f2f372ed597a1a2) | Method |
| [Number](#member-dba709f47cb93ba3) | Method |
| [Object](#member-2eda03563123251e) | Method |
| [Object](#member-c8af291f21233b4a) | Method |
| [ToString](#member-01c1505a38a71144) | Method |
| [Vector](#member-7913119d67501584) | Method |
| [Kind](#member-7eb0da291dc8f04b) | Property |

<h3 id="member-51831111a2480c10" class="astra-member">AsBoolean</h3>

```csharp
public bool AsBoolean()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a78fdb0bc8b7a4e3" class="astra-member">AsInteger</h3>

```csharp
public long AsInteger()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f3025914f13c442b" class="astra-member">AsNumber</h3>

```csharp
public double AsNumber()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ab2a8e9aa776322" class="astra-member">AsObjectId</h3>

```csharp
public ulong AsObjectId()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-70113f270d689dcb" class="astra-member">AsVector3</h3>

```csharp
public System.Numerics.Vector3 AsVector3()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57cefdb1552ee5bf" class="astra-member">Boolean</h3>

```csharp
public static Astra.ComponentValue Boolean(bool value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `bool` |  |

<h3 id="member-3f2f372ed597a1a2" class="astra-member">Integer</h3>

```csharp
public static Astra.ComponentValue Integer(long value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `long` |  |

<h3 id="member-dba709f47cb93ba3" class="astra-member">Number</h3>

```csharp
public static Astra.ComponentValue Number(double value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `double` |  |

<h3 id="member-2eda03563123251e" class="astra-member">Object</h3>

```csharp
public static Astra.ComponentValue Object(Astra.ObjectReference reference)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `reference` | `Astra.ObjectReference` |  |

<h3 id="member-c8af291f21233b4a" class="astra-member">Object</h3>

```csharp
public static Astra.ComponentValue Object(ulong objectId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `objectId` | `ulong` |  |

<h3 id="member-01c1505a38a71144" class="astra-member">ToString</h3>

```csharp
public override string ToString()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7913119d67501584" class="astra-member">Vector</h3>

```csharp
public static Astra.ComponentValue Vector(System.Numerics.Vector3 value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `System.Numerics.Vector3` |  |

<h3 id="member-7eb0da291dc8f04b" class="astra-member">Kind</h3>

```csharp
public Astra.ComponentValueKind Kind { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ComponentValueKind"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-componentvaluekind/
---

# Astra.ComponentValueKind

Tipos que atravessam métodos e eventos de componente. Espelha ae::scene::ComponentValueKind; não reordenar.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.ComponentValueKind
```

Tipos que atravessam métodos e eventos de componente. Espelha ae::scene::ComponentValueKind; não reordenar.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Boolean](#member-97e31e623a05b056) | Field |
| [Integer](#member-4c072bb1d4ab60db) | Field |
| [None](#member-7a64451215d64c21) | Field |
| [Number](#member-0a91128afdbcf290) | Field |
| [Object](#member-d9f973e6eb1cb772) | Field |
| [Vector3](#member-fbc6fcf17d2f31eb) | Field |

<h3 id="member-97e31e623a05b056" class="astra-member">Boolean</h3>

```csharp
Boolean = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4c072bb1d4ab60db" class="astra-member">Integer</h3>

```csharp
Integer = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a64451215d64c21" class="astra-member">None</h3>

```csharp
None = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0a91128afdbcf290" class="astra-member">Number</h3>

```csharp
Number = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9f973e6eb1cb772" class="astra-member">Object</h3>

```csharp
Object = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fbc6fcf17d2f31eb" class="astra-member">Vector3</h3>

```csharp
Vector3 = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AimConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint/
---

# Astra.Components.AimConstraint

Aim Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.AimConstraint
```

Aim Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-AimConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.AimConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Aim Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AimConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AimConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Aim Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-aim/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-13c7d6e3cb1ad507) | Method |
| [Remove](#member-19bfc8a546053b45) | Method |
| [Wrap](#member-84d237f87e633293) | Method |
| [AimAxis](#member-37b62e4f02e073f6) | Property |
| [AxisX](#member-b9c7497a342a152f) | Property |
| [AxisY](#member-9e6cdaf1da732b85) | Property |
| [AxisZ](#member-4d28cbcc7d2978e8) | Property |
| [Component](#member-a23ab307b3680160) | Property |
| [Enabled](#member-14de8a2606f1b904) | Property |
| [InstanceId](#member-444f4659bb5b0e56) | Property |
| [IsAlive](#member-58598a2893f3fca8) | Property |
| [Object](#member-317b6565bc8b7c2b) | Property |
| [Offset](#member-a990cdea843c9a36) | Property |
| [Target](#member-6c5a9845c9e25b50) | Property |
| [TypeId](#member-2e9e8efd5d9cff90) | Property |
| [UpAxis](#member-995bebd477274ca2) | Property |
| [Weight](#member-68e6ffaaaaa24489) | Property |

<h3 id="member-13c7d6e3cb1ad507" class="astra-member">.ctor</h3>

```csharp
public AimConstraint(Astra.Component component)
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-19bfc8a546053b45" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84d237f87e633293" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.AimConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-37b62e4f02e073f6" class="astra-member">AimAxis</h3>

```csharp
public Astra.Components.AimConstraint.AimAxisOption AimAxis { get; set; }
```

Eixo de mira

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Eixo de mira:** Escolhe o eixo local alinhado à direção do alvo.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b9c7497a342a152f" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9e6cdaf1da732b85" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d28cbcc7d2978e8" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a23ab307b3680160" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14de8a2606f1b904" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Aim Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-444f4659bb5b0e56" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58598a2893f3fca8" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-317b6565bc8b7c2b" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a990cdea843c9a36" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Deslocamento X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Deslocamento Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Deslocamento Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6c5a9845c9e25b50" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Aim Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2e9e8efd5d9cff90" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-995bebd477274ca2" class="astra-member">UpAxis</h3>

```csharp
public Astra.Components.AimConstraint.UpAxisOption UpAxis { get; set; }
```

Vertical de mundo

**Caminho:** Inspector → Aim Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Vertical de mundo:** Define a convenção de vertical da orientação; evite direção degenerada.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68e6ffaaaaa24489" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Aim Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AimConstraint.AimAxisOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint-aimaxisoption/
---

# Astra.Components.AimConstraint.AimAxisOption

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.AimConstraint.AimAxisOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Aim Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AimConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AimConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [X](#member-684c022867770723) | Field |
| [X3](#member-927107bbace68aef) | Field |
| [Y](#member-fedc4078a79a5725) | Field |
| [Y4](#member-aacd8c8e0000e115) | Field |
| [Z](#member-d1fd3fae57449eb8) | Field |
| [Z5](#member-4a9c4ee9b86c4ef5) | Field |

<h3 id="member-684c022867770723" class="astra-member">X</h3>

```csharp
X = 0
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-927107bbace68aef" class="astra-member">X3</h3>

```csharp
X3 = 3
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fedc4078a79a5725" class="astra-member">Y</h3>

```csharp
Y = 1
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aacd8c8e0000e115" class="astra-member">Y4</h3>

```csharp
Y4 = 4
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1fd3fae57449eb8" class="astra-member">Z</h3>

```csharp
Z = 2
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a9c4ee9b86c4ef5" class="astra-member">Z5</h3>

```csharp
Z5 = 5
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AimConstraint.UpAxisOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint-upaxisoption/
---

# Astra.Components.AimConstraint.UpAxisOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.AimConstraint.UpAxisOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Aim Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AimConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AimConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [X](#member-1d9246e029262bb0) | Field |
| [Y](#member-05f4565d54df9641) | Field |
| [Z](#member-09ec0356c8345cba) | Field |

<h3 id="member-1d9246e029262bb0" class="astra-member">X</h3>

```csharp
X = 2
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-05f4565d54df9641" class="astra-member">Y</h3>

```csharp
Y = 0
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-09ec0356c8345cba" class="astra-member">Z</h3>

```csharp
Z = 1
```

**Caminho:** Inspector → Aim Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Animation"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-animation/
---

# Astra.Components.Animation

Animação: Clipes tocados e misturados no Play. Família Animação · Clipes.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Animation
```

Animação: Clipes tocados e misturados no Play. Família Animação · Clipes.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-Animation.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Animation>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Animação** / **Clipes** → **Animação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Animation>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Animation(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Animação](/pt-br/snapshot-2026-10-06/componentes/astra-animation/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a26c9236ed5c12fc) | Method |
| [GetClip](#member-f41227c7a5dfdd56) | Method |
| [GetClips](#member-beadebf64ac1e10d) | Method |
| [Remove](#member-74cfd4c57fedab62) | Method |
| [SetClip](#member-d88b47058ff70133) | Method |
| [SetClips](#member-dbbc4ac3bee568c9) | Method |
| [Wrap](#member-d0f07fcf61228c4e) | Method |
| [ClipCount](#member-1a2b5a4b4cd68102) | Property |
| [Component](#member-65c2f6321d843544) | Property |
| [Enabled](#member-be3e2170c635524f) | Property |
| [InstanceId](#member-2e0bfbf24949cc92) | Property |
| [IsAlive](#member-4f8a97b6999b5aff) | Property |
| [Object](#member-7da19c252919c765) | Property |
| [PlayAutomatically](#member-aa0aa08e758aaed7) | Property |
| [Speed](#member-c318cb0e899c0183) | Property |
| [TypeId](#member-c76451dfffa42597) | Property |
| [WrapMode](#member-76f7fb3d57df75ab) | Property |

<h3 id="member-a26c9236ed5c12fc" class="astra-member">.ctor</h3>

```csharp
public Animation(Astra.Component component)
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f41227c7a5dfdd56" class="astra-member">GetClip</h3>

```csharp
public Astra.AssetGuid GetClip(uint slot = 0)
```

Clipe padrão. Recurso do projeto por slot

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Clipe padrão. Recurso do projeto por slot

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-beadebf64ac1e10d" class="astra-member">GetClips</h3>

```csharp
public Astra.AssetGuid GetClips(uint slot = 0)
```

Clipe. Recurso do projeto por slot

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Clipe. Recurso do projeto por slot

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-74cfd4c57fedab62" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d88b47058ff70133" class="astra-member">SetClip</h3>

```csharp
public void SetClip(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-dbbc4ac3bee568c9" class="astra-member">SetClips</h3>

```csharp
public void SetClips(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-d0f07fcf61228c4e" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Animation Wrap(Astra.Component component)
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1a2b5a4b4cd68102" class="astra-member">ClipCount</h3>

```csharp
public Astra.Components.Animation.ClipCountOption ClipCount { get; set; }
```

Quantidade de clipes

**Caminho:** Inspector → Animação → Clipes; ou fachada C# em um Behavior.

**Uso:** **Quantidade de clipes:** Quantidade de entradas de clipe autoradas; recurso e estado de reprodução são separados.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-65c2f6321d843544" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-be3e2170c635524f" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativa. Desligar suspende tempo e avaliação; religar retoma os estados

**Caminho:** Inspector → Animação → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Ativa:** Desligar suspende tempo e avaliação; religar retoma os estados

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2e0bfbf24949cc92" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f8a97b6999b5aff" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7da19c252919c765" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa0aa08e758aaed7" class="astra-member">PlayAutomatically</h3>

```csharp
public bool PlayAutomatically { get; set; }
```

Tocar ao iniciar. Play Automatically: o clipe padrão começa a tocar quando o Play inicia

**Caminho:** Inspector → Animação → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Tocar ao iniciar:** Play Automatically: o clipe padrão começa a tocar quando o Play inicia

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c318cb0e899c0183" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (x). Velocidade inicial de cada clipe (AnimationState.speed); negativo toca de trás para frente

Faixa válida: -10 a 10.

**Caminho:** Inspector → Animação → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Multiplica a velocidade de reprodução dos clipes; exige estado/recurso de animação válido.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c76451dfffa42597" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-76f7fb3d57df75ab" class="astra-member">WrapMode</h3>

```csharp
public Astra.Components.Animation.WrapModeOption WrapMode { get; set; }
```

Repetição. Wrap Mode padrão dos clipes: o que acontece depois do fim

**Caminho:** Inspector → Animação → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Repetição:** Wrap Mode padrão dos clipes: o que acontece depois do fim

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Animation.ClipCountOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-animation-clipcountoption/
---

# Astra.Components.Animation.ClipCountOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Animation.ClipCountOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Animação** / **Clipes** → **Animação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Animation>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Animation(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [V0](#member-06a7533ef217eb5e) | Field |
| [V1](#member-d296eeac28e91eee) | Field |
| [V10](#member-8c2afcf4f93f486f) | Field |
| [V11](#member-88704b15c19ea9d5) | Field |
| [V12](#member-8df1fde1632039cb) | Field |
| [V13](#member-b553bcd268b41bb3) | Field |
| [V14](#member-b361853b42b493f6) | Field |
| [V15](#member-f957910e2cf93f49) | Field |
| [V16](#member-031a15bcc5e6f209) | Field |
| [V17](#member-bde410e98cbcd401) | Field |
| [V18](#member-500b6d858daf01c3) | Field |
| [V19](#member-e79da27c860ba2fd) | Field |
| [V2](#member-146055a1f204fe45) | Field |
| [V20](#member-84476ac6cae9e570) | Field |
| [V21](#member-e52d1c605217ba68) | Field |
| [V22](#member-bad86a559e148ce3) | Field |
| [V23](#member-24e2de18ca461e81) | Field |
| [V24](#member-6a07d6910aaceb43) | Field |
| [V25](#member-5401fed9bf5fe4fe) | Field |
| [V26](#member-98124d29145a7662) | Field |
| [V27](#member-df720ccad7a87d94) | Field |
| [V28](#member-2bb539480d851c43) | Field |
| [V29](#member-4fb9009dcad8077b) | Field |
| [V3](#member-5d89ed15da03e39e) | Field |
| [V30](#member-3f81d6a60f9ca3fe) | Field |
| [V31](#member-a191618326d1fb63) | Field |
| [V32](#member-5ef6abf08f535fde) | Field |
| [V4](#member-b593928fad328f9f) | Field |
| [V5](#member-3dd40c3cc35df9ad) | Field |
| [V6](#member-5ee454ad90745d30) | Field |
| [V7](#member-ff7b442be119ac25) | Field |
| [V8](#member-8f2220aa38f56d68) | Field |
| [V9](#member-948f0c4292e245f8) | Field |

<h3 id="member-06a7533ef217eb5e" class="astra-member">V0</h3>

```csharp
V0 = 0
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d296eeac28e91eee" class="astra-member">V1</h3>

```csharp
V1 = 1
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c2afcf4f93f486f" class="astra-member">V10</h3>

```csharp
V10 = 10
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-88704b15c19ea9d5" class="astra-member">V11</h3>

```csharp
V11 = 11
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8df1fde1632039cb" class="astra-member">V12</h3>

```csharp
V12 = 12
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b553bcd268b41bb3" class="astra-member">V13</h3>

```csharp
V13 = 13
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b361853b42b493f6" class="astra-member">V14</h3>

```csharp
V14 = 14
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f957910e2cf93f49" class="astra-member">V15</h3>

```csharp
V15 = 15
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-031a15bcc5e6f209" class="astra-member">V16</h3>

```csharp
V16 = 16
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bde410e98cbcd401" class="astra-member">V17</h3>

```csharp
V17 = 17
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-500b6d858daf01c3" class="astra-member">V18</h3>

```csharp
V18 = 18
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e79da27c860ba2fd" class="astra-member">V19</h3>

```csharp
V19 = 19
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-146055a1f204fe45" class="astra-member">V2</h3>

```csharp
V2 = 2
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84476ac6cae9e570" class="astra-member">V20</h3>

```csharp
V20 = 20
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e52d1c605217ba68" class="astra-member">V21</h3>

```csharp
V21 = 21
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bad86a559e148ce3" class="astra-member">V22</h3>

```csharp
V22 = 22
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-24e2de18ca461e81" class="astra-member">V23</h3>

```csharp
V23 = 23
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a07d6910aaceb43" class="astra-member">V24</h3>

```csharp
V24 = 24
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5401fed9bf5fe4fe" class="astra-member">V25</h3>

```csharp
V25 = 25
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98124d29145a7662" class="astra-member">V26</h3>

```csharp
V26 = 26
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-df720ccad7a87d94" class="astra-member">V27</h3>

```csharp
V27 = 27
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2bb539480d851c43" class="astra-member">V28</h3>

```csharp
V28 = 28
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4fb9009dcad8077b" class="astra-member">V29</h3>

```csharp
V29 = 29
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d89ed15da03e39e" class="astra-member">V3</h3>

```csharp
V3 = 3
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f81d6a60f9ca3fe" class="astra-member">V30</h3>

```csharp
V30 = 30
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a191618326d1fb63" class="astra-member">V31</h3>

```csharp
V31 = 31
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ef6abf08f535fde" class="astra-member">V32</h3>

```csharp
V32 = 32
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b593928fad328f9f" class="astra-member">V4</h3>

```csharp
V4 = 4
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3dd40c3cc35df9ad" class="astra-member">V5</h3>

```csharp
V5 = 5
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ee454ad90745d30" class="astra-member">V6</h3>

```csharp
V6 = 6
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff7b442be119ac25" class="astra-member">V7</h3>

```csharp
V7 = 7
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8f2220aa38f56d68" class="astra-member">V8</h3>

```csharp
V8 = 8
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-948f0c4292e245f8" class="astra-member">V9</h3>

```csharp
V9 = 9
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Animation.WrapModeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-animation-wrapmodeoption/
---

# Astra.Components.Animation.WrapModeOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Animation.WrapModeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Animação** / **Clipes** → **Animação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Animation>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Animation(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Repetir](#member-f2bd209f0a56bc7c) | Field |
| [SegurarNoFim](#member-eb5258e0f7ccba23) | Field |
| [UmaVez](#member-343170a79a053a07) | Field |
| [VaiEVolta](#member-dfb1e1e2e6a8dc07) | Field |

<h3 id="member-f2bd209f0a56bc7c" class="astra-member">Repetir</h3>

```csharp
Repetir = 1
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb5258e0f7ccba23" class="astra-member">SegurarNoFim</h3>

```csharp
SegurarNoFim = 3
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-343170a79a053a07" class="astra-member">UmaVez</h3>

```csharp
UmaVez = 0
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dfb1e1e2e6a8dc07" class="astra-member">VaiEVolta</h3>

```csharp
VaiEVolta = 2
```

**Caminho:** Inspector → Animação; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioBus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiobus/
---

# Astra.Components.AudioBus

Audio Bus: Roteamento de ganho, mute e solo até Master. Família Áudio · Mixer.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.AudioBus
```

Audio Bus: Roteamento de ganho, mute e solo até Master. Família Áudio · Mixer.

Referência estudada: https://docs.godotengine.org/en/4.5/tutorials/audio/audio_buses.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.AudioBus>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Mixer** → **Audio Bus**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioBus>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioBus(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Audio Bus](/pt-br/snapshot-2026-10-06/componentes/astra-audio-bus/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-62ef916f0fff9721) | Method |
| [Remove](#member-a831166d2ca7cad5) | Method |
| [Wrap](#member-7ff7c8f93b8a5e89) | Method |
| [Component](#member-8b84e8c78b760467) | Property |
| [Enabled](#member-669bbdd58db3f31a) | Property |
| [InstanceId](#member-4786a53345051641) | Property |
| [IsAlive](#member-c6453562ca99ba03) | Property |
| [Mute](#member-570a03a097ef97a0) | Property |
| [Object](#member-5fe67f2356ef33d5) | Property |
| [Output](#member-c02c8a562f5669a5) | Property |
| [Solo](#member-7819f3b685a19ea8) | Property |
| [TypeId](#member-bc4646b4729c075e) | Property |
| [Volume](#member-15d2fcf016daa3d0) | Property |

<h3 id="member-62ef916f0fff9721" class="astra-member">.ctor</h3>

```csharp
public AudioBus(Astra.Component component)
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a831166d2ca7cad5" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7ff7c8f93b8a5e89" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.AudioBus Wrap(Astra.Component component)
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-8b84e8c78b760467" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-669bbdd58db3f31a" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Audio Bus → Mixer; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4786a53345051641" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6453562ca99ba03" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-570a03a097ef97a0" class="astra-member">Mute</h3>

```csharp
public bool Mute { get; set; }
```

Silenciar

**Caminho:** Inspector → Audio Bus → Mixer; ou fachada C# em um Behavior.

**Uso:** **Silenciar:** Silencia sem remover o componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5fe67f2356ef33d5" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c02c8a562f5669a5" class="astra-member">Output</h3>

```csharp
public Astra.ObjectReference Output { get; set; }
```

Saída

**Caminho:** Inspector → Audio Bus → Mixer; ou fachada C# em um Behavior.

**Uso:** **Saída:** Bus de saída; confira ciclos e destino Master.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7819f3b685a19ea8" class="astra-member">Solo</h3>

```csharp
public bool Solo { get; set; }
```

Solo

**Caminho:** Inspector → Audio Bus → Mixer; ou fachada C# em um Behavior.

**Uso:** **Solo:** Isola esse bus conforme o roteamento do mixer.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc4646b4729c075e" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Audio Bus; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15d2fcf016daa3d0" class="astra-member">Volume</h3>

```csharp
public float Volume { get; set; }
```

Ganho

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Bus → Mixer; ou fachada C# em um Behavior.

**Uso:** **Ganho:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioListener"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiolistener/
---

# Astra.Components.AudioListener

Audio Listener: Pose e volume de escuta escolhidos por prioridade. Família Áudio · Escuta.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.AudioListener
```

Audio Listener: Pose e volume de escuta escolhidos por prioridade. Família Áudio · Escuta.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-AudioListener.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.AudioListener>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Escuta** → **Audio Listener**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioListener>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioListener(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Audio Listener](/pt-br/snapshot-2026-10-06/componentes/astra-audio-listener/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-f32712e31858d01a) | Method |
| [Remove](#member-6a9f1d1acfa109a5) | Method |
| [Wrap](#member-5159053a14a099e0) | Method |
| [Component](#member-ee133f299b5c044a) | Property |
| [Enabled](#member-176ce863b473aa18) | Property |
| [InstanceId](#member-9a7214cc79495234) | Property |
| [IsAlive](#member-b7744b84500d786b) | Property |
| [Object](#member-ddab14fa7e144bd0) | Property |
| [Priority](#member-d2d7ea6a73aa30c6) | Property |
| [TypeId](#member-55af7f076594b4ff) | Property |
| [Volume](#member-b881b5f5b73553ab) | Property |

<h3 id="member-f32712e31858d01a" class="astra-member">.ctor</h3>

```csharp
public AudioListener(Astra.Component component)
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-6a9f1d1acfa109a5" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5159053a14a099e0" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.AudioListener Wrap(Astra.Component component)
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-ee133f299b5c044a" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-176ce863b473aa18" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Audio Listener → Escuta; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9a7214cc79495234" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b7744b84500d786b" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ddab14fa7e144bd0" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d2d7ea6a73aa30c6" class="astra-member">Priority</h3>

```csharp
public float Priority { get; set; }
```

Prioridade

Faixa válida: 0 a 255.

**Caminho:** Inspector → Audio Listener → Escuta; ou fachada C# em um Behavior.

**Uso:** **Prioridade:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55af7f076594b4ff" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Audio Listener; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b881b5f5b73553ab" class="astra-member">Volume</h3>

```csharp
public float Volume { get; set; }
```

Volume global

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Listener → Escuta; ou fachada C# em um Behavior.

**Uso:** **Volume global:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioSource"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/
---

# Astra.Components.AudioSource

Audio Source: Clipe de projeto com reprodução e espaço acústico. Família Áudio · Reprodução.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.AudioSource
```

Audio Source: Clipe de projeto com reprodução e espaço acústico. Família Áudio · Reprodução.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-AudioSource.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.AudioSource>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioSource>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioSource(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Audio Source](/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-64a7cce5115a4063) | Method |
| [GetClip](#member-4cc200665aa0662b) | Method |
| [Pause](#member-acdc7c1ffbb8a79d) | Method |
| [Play](#member-d5033b287ae87cea) | Method |
| [Remove](#member-dfa11ef77970bbab) | Method |
| [Resume](#member-3f8f1332205a9e7c) | Method |
| [Seek](#member-1a89f061f5f2259f) | Method |
| [SetClip](#member-9479efa6769c8342) | Method |
| [Stop](#member-c75ec25b3b002f1d) | Method |
| [Wrap](#member-4642b1dda31b40c8) | Method |
| [Bus](#member-f62ff8c2f1f6f33c) | Property |
| [Component](#member-c7cfa368440a7849) | Property |
| [ConeGain](#member-192a42485edea585) | Property |
| [ConeInner](#member-08e4d53131546af5) | Property |
| [ConeOuter](#member-f9b07e0f6ead1d10) | Property |
| [Dimension](#member-e3a834e7f469d4d6) | Property |
| [Doppler](#member-0bb0d6a843dc2d64) | Property |
| [Enabled](#member-da72fe7b179df126) | Property |
| [InstanceId](#member-4c8850733a37007a) | Property |
| [IsAlive](#member-857f2eccad39bb1d) | Property |
| [Loop](#member-f70847c16296d7f0) | Property |
| [MaxDistance](#member-16651eb308e9b70e) | Property |
| [MinDistance](#member-3e83663bc12fd956) | Property |
| [Mute](#member-feeed6940b37bbe6) | Property |
| [Object](#member-a34257e27ea43300) | Property |
| [Pan](#member-701c2073845dbd69) | Property |
| [Pitch](#member-6a922d79961f02dc) | Property |
| [Playback](#member-32f5f6b72587bbd6) | Property |
| [Rolloff](#member-4b9a5348a30db581) | Property |
| [RolloffFactor](#member-4d4587cecb3b2632) | Property |
| [TypeId](#member-1ea08d176dfd3f96) | Property |
| [Volume](#member-5d62b270c01990bb) | Property |

<h3 id="member-64a7cce5115a4063" class="astra-member">.ctor</h3>

```csharp
public AudioSource(Astra.Component component)
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-4cc200665aa0662b" class="astra-member">GetClip</h3>

```csharp
public Astra.AssetGuid GetClip(uint slot = 0)
```

Clipe WAV. Recurso do projeto por slot

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Clipe WAV. Recurso do projeto por slot

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-acdc7c1ffbb8a79d" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

Pausar. Congela o cursor

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Pausar. Congela o cursor

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d5033b287ae87cea" class="astra-member">Play</h3>

```csharp
public void Play()
```

Tocar. Recomeça do início

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Tocar. Recomeça do início

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dfa11ef77970bbab" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f8f1332205a9e7c" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

Retomar. Continua do cursor pausado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Retomar. Continua do cursor pausado

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1a89f061f5f2259f" class="astra-member">Seek</h3>

```csharp
public void Seek(double seconds)
```

Posicionar. Move o cursor; aplicado pelo mixer

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Posicionar. Move o cursor; aplicado pelo mixer

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |

<h3 id="member-9479efa6769c8342" class="astra-member">SetClip</h3>

```csharp
public void SetClip(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-c75ec25b3b002f1d" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Interrompe e libera a voz

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Parar. Interrompe e libera a voz

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4642b1dda31b40c8" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.AudioSource Wrap(Astra.Component component)
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f62ff8c2f1f6f33c" class="astra-member">Bus</h3>

```csharp
public Astra.ObjectReference Bus { get; set; }
```

Bus

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Bus:** Destino de mixer da fonte.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c7cfa368440a7849" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-192a42485edea585" class="astra-member">ConeGain</h3>

```csharp
public float ConeGain { get; set; }
```

Ganho fora do cone

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

**Uso:** **Ganho fora do cone:** Ganho fora da região interna do cone.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08e4d53131546af5" class="astra-member">ConeInner</h3>

```csharp
public float ConeInner { get; set; }
```

Cone interno (°)

Faixa válida: 0 a 360.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

**Uso:** **Cone interno:** Ângulo interno do cone acústico.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f9b07e0f6ead1d10" class="astra-member">ConeOuter</h3>

```csharp
public float ConeOuter { get; set; }
```

Cone externo (°)

Faixa válida: 0 a 360.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

**Uso:** **Cone externo:** Ângulo externo do cone acústico.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e3a834e7f469d4d6" class="astra-member">Dimension</h3>

```csharp
public Astra.Components.AudioSource.DimensionOption Dimension { get; set; }
```

Dimensão

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Dimensão:** Seleciona áudio estéreo ou espacial conforme o domínio.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0bb0d6a843dc2d64" class="astra-member">Doppler</h3>

```csharp
public float Doppler { get; set; }
```

Doppler (×)

Faixa válida: 0 a 4.

**Caminho:** Inspector → Audio Source → Emissão; ou fachada C# em um Behavior.

**Uso:** **Doppler:** Fator do efeito Doppler.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-da72fe7b179df126" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4c8850733a37007a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-857f2eccad39bb1d" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f70847c16296d7f0" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; set; }
```

Repetir

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Repetir:** Repete a reprodução/percurso no fim.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16651eb308e9b70e" class="astra-member">MaxDistance</h3>

```csharp
public float MaxDistance { get; set; }
```

Distância máxima (m)

Faixa válida: 0.02 a 100001.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Distância máxima:** Distância máxima de referência da atenuação 3D.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e83663bc12fd956" class="astra-member">MinDistance</h3>

```csharp
public float MinDistance { get; set; }
```

Distância mínima (m)

Faixa válida: 0.01 a 100000.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Distância mínima:** Distância próxima de referência da atenuação 3D.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-feeed6940b37bbe6" class="astra-member">Mute</h3>

```csharp
public bool Mute { get; set; }
```

Silenciar

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Silenciar:** Silencia sem remover o componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a34257e27ea43300" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-701c2073845dbd69" class="astra-member">Pan</h3>

```csharp
public float Pan { get; set; }
```

Pan estéreo

Faixa válida: -1 a 1.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Pan estéreo:** Pan estéreo, de esquerda a direita; é condicional à espacialização.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a922d79961f02dc" class="astra-member">Pitch</h3>

```csharp
public float Pitch { get; set; }
```

Velocidade / pitch (×)

Faixa válida: 0.1 a 4.

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Velocidade / pitch:** Velocidade/pitch da reprodução; não altera o arquivo original.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-32f5f6b72587bbd6" class="astra-member">Playback</h3>

```csharp
public Astra.Components.AudioSource.PlaybackOption Playback { get; set; }
```

Pedido. Pedido persistido; consulte o estado real na nota do componente.

**Caminho:** Inspector → Audio Source → Reprodução; ou fachada C# em um Behavior.

**Uso:** **Pedido:** Pedido persistido; consulte o estado real na nota do componente.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4b9a5348a30db581" class="astra-member">Rolloff</h3>

```csharp
public Astra.Components.AudioSource.RolloffOption Rolloff { get; set; }
```

Atenuação

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Atenuação:** Modelo de atenuação por distância.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d4587cecb3b2632" class="astra-member">RolloffFactor</h3>

```csharp
public float RolloffFactor { get; set; }
```

Decaimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Audio Source → Espaço; ou fachada C# em um Behavior.

**Uso:** **Decaimento:** Fator de queda de ganho do modelo de atenuação.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1ea08d176dfd3f96" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d62b270c01990bb" class="astra-member">Volume</h3>

```csharp
public float Volume { get; set; }
```

Volume

Faixa válida: 0 a 1.

**Caminho:** Inspector → Audio Source → Som; ou fachada C# em um Behavior.

**Uso:** **Volume:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioSource.DimensionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-dimensionoption/
---

# Astra.Components.AudioSource.DimensionOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.AudioSource.DimensionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioSource>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioSource(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [V2DEstereo](#member-9c2a10d9438dbd2b) | Field |
| [V3DEspacial](#member-4069a71e2e521bf2) | Field |

<h3 id="member-9c2a10d9438dbd2b" class="astra-member">V2DEstereo</h3>

```csharp
V2DEstereo = 0
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4069a71e2e521bf2" class="astra-member">V3DEspacial</h3>

```csharp
V3DEspacial = 1
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioSource.PlaybackOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-playbackoption/
---

# Astra.Components.AudioSource.PlaybackOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.AudioSource.PlaybackOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioSource>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioSource(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Parar](#member-73bc18f296960417) | Field |
| [Pausar](#member-f62e0e9df04b9e59) | Field |
| [Tocar](#member-900d4b241ee58cf7) | Field |

<h3 id="member-73bc18f296960417" class="astra-member">Parar</h3>

```csharp
Parar = 0
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f62e0e9df04b9e59" class="astra-member">Pausar</h3>

```csharp
Pausar = 2
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-900d4b241ee58cf7" class="astra-member">Tocar</h3>

```csharp
Tocar = 1
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.AudioSource.RolloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-rolloffoption/
---

# Astra.Components.AudioSource.RolloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.AudioSource.RolloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<AudioSource>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new AudioSource(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Exponencial](#member-122c7309ad7dcd6e) | Field |
| [Inverso](#member-c24d4fbc990c0b3d) | Field |
| [Linear](#member-11eb533185b19444) | Field |

<h3 id="member-122c7309ad7dcd6e" class="astra-member">Exponencial</h3>

```csharp
Exponencial = 2
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c24d4fbc990c0b3d" class="astra-member">Inverso</h3>

```csharp
Inverso = 1
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-11eb533185b19444" class="astra-member">Linear</h3>

```csharp
Linear = 0
```

**Caminho:** Inspector → Audio Source; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Body2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-body2d/
---

# Astra.Components.Body2D

Corpo 2D: Corpo XY independente de física 3D. Família Física 2D · Corpos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Body2D
```

Corpo 2D: Corpo XY independente de física 3D. Família Física 2D · Corpos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_rigidbody2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Body2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Corpos** → **Corpo 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Body2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Body2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-3de9403985957f68) | Method |
| [Remove](#member-3c7718f7de902bc1) | Method |
| [Wrap](#member-67d1a25944e0cc44) | Method |
| [AllowSleep](#member-a14f731d9683d7bd) | Property |
| [AngularDamping](#member-cb077534e8d0c137) | Property |
| [AngularVelocityDegrees](#member-57bdcfca38460865) | Property |
| [Component](#member-e0ea2ab1d8c6778f) | Property |
| [FixedRotation](#member-ddbf48b7d9196bc8) | Property |
| [GravityScale](#member-90bd995defea434f) | Property |
| [InstanceId](#member-55c357bc98ac6762) | Property |
| [IsAlive](#member-f7a8681f29f55ce9) | Property |
| [LinearDamping](#member-329df4fcadb4f88c) | Property |
| [Mass](#member-bf66b91ce31e9b1c) | Property |
| [Motion](#member-9b3fad0dc187c6d4) | Property |
| [Object](#member-14583ddbbab3515c) | Property |
| [TypeId](#member-ac4c1e3ab3afaf46) | Property |
| [VelocityX](#member-0a99db31a030d5ef) | Property |
| [VelocityY](#member-f29720f98fad9c71) | Property |

<h3 id="member-3de9403985957f68" class="astra-member">.ctor</h3>

```csharp
public Body2D(Astra.Component component)
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3c7718f7de902bc1" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-67d1a25944e0cc44" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Body2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a14f731d9683d7bd" class="astra-member">AllowSleep</h3>

```csharp
public bool AllowSleep { get; set; }
```

Permitir repouso

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Permitir repouso:** Permite dormir quando o corpo pode ficar em repouso.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb077534e8d0c137" class="astra-member">AngularDamping</h3>

```csharp
public float AngularDamping { get; set; }
```

Arrasto angular

Faixa válida: 0 a 100.

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Arrasto angular:** Amortecimento de velocidade angular.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57bdcfca38460865" class="astra-member">AngularVelocityDegrees</h3>

```csharp
public float AngularVelocityDegrees { get; set; }
```

Velocidade angular (graus/s)

Faixa válida: -36000 a 36000.

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Velocidade angular:** Velocidade angular 2D em graus/s; não confundir com rad/s da API matemática.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e0ea2ab1d8c6778f" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ddbf48b7d9196bc8" class="astra-member">FixedRotation</h3>

```csharp
public bool FixedRotation { get; set; }
```

Fixar rotação

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Fixar rotação:** Trava a rotação física do Body2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-90bd995defea434f" class="astra-member">GravityScale</h3>

```csharp
public float GravityScale { get; set; }
```

Escala gravidade

Faixa válida: -100 a 100.

**Caminho:** Inspector → Corpo 2D → Corpo; ou fachada C# em um Behavior.

**Uso:** **Escala gravidade:** Multiplica gravidade mundial deste corpo 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55c357bc98ac6762" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f7a8681f29f55ce9" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-329df4fcadb4f88c" class="astra-member">LinearDamping</h3>

```csharp
public float LinearDamping { get; set; }
```

Arrasto linear

Faixa válida: 0 a 100.

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Arrasto linear:** Amortecimento de velocidade linear.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bf66b91ce31e9b1c" class="astra-member">Mass</h3>

```csharp
public float Mass { get; set; }
```

Massa (kg)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Corpo 2D → Corpo; ou fachada C# em um Behavior.

**Uso:** **Massa:** Massa do corpo dinâmico em kg; influencia resposta a força/impulso.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b3fad0dc187c6d4" class="astra-member">Motion</h3>

```csharp
public Astra.Components.Body2D.MotionOption Motion { get; set; }
```

Movimento

**Caminho:** Inspector → Corpo 2D → Corpo; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Escolhe autoridade estática/cinemática/dinâmica no domínio do corpo.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14583ddbbab3515c" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac4c1e3ab3afaf46" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0a99db31a030d5ef" class="astra-member">VelocityX</h3>

```csharp
public float VelocityX { get; set; }
```

Velocidade X (m/s)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Velocidade X:** Velocidade linear inicial/autorada do corpo, eixo X.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f29720f98fad9c71" class="astra-member">VelocityY</h3>

```csharp
public float VelocityY { get; set; }
```

Velocidade Y (m/s)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Corpo 2D → Movimento; ou fachada C# em um Behavior.

**Uso:** **Velocidade Y:** Velocidade linear inicial/autorada do corpo, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Body2D.MotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-body2d-motionoption/
---

# Astra.Components.Body2D.MotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Body2D.MotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Corpos** → **Corpo 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Body2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Body2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cinematico](#member-4efdb6eac2a0fbe6) | Field |
| [Dinamico](#member-2e32b78485e89693) | Field |
| [Estatico](#member-1844916584d460d7) | Field |

<h3 id="member-4efdb6eac2a0fbe6" class="astra-member">Cinematico</h3>

```csharp
Cinematico = 1
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2e32b78485e89693" class="astra-member">Dinamico</h3>

```csharp
Dinamico = 2
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1844916584d460d7" class="astra-member">Estatico</h3>

```csharp
Estatico = 0
```

**Caminho:** Inspector → Corpo 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Camera"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-camera/
---

# Astra.Components.Camera

Câmera: Projeção e enquadramento. Família Câmera · Projeção.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Camera
```

Câmera: Projeção e enquadramento. Família Câmera · Projeção.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-Camera.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Camera>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Projeção** → **Câmera**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Camera>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Camera(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Câmera](/pt-br/snapshot-2026-10-06/componentes/astra-camera/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-328db0ec78429e5b) | Method |
| [Remove](#member-1ce49e54808597ea) | Method |
| [Wrap](#member-ab7c07ece42e67ce) | Method |
| [Component](#member-fe05aacbfef0273a) | Property |
| [Enabled](#member-9d89c0a8e1293b7f) | Property |
| [EnvironmentMask](#member-6542bd843325e272) | Property |
| [FarPlane](#member-66ddf057bfcae722) | Property |
| [InstanceId](#member-c3f11be04ce380c3) | Property |
| [IsAlive](#member-d775f62a8a411a31) | Property |
| [NearPlane](#member-022bf2984f8e0888) | Property |
| [Object](#member-6091d19345d88d9d) | Property |
| [OrthographicHalfHeight](#member-ed070f92d2065016) | Property |
| [Priority](#member-74470d44266369fa) | Property |
| [Projection](#member-14a0256b2e5cd8d2) | Property |
| [TypeId](#member-d12ffafe37775378) | Property |
| [VerticalFov](#member-04d82a46cd800721) | Property |

<h3 id="member-328db0ec78429e5b" class="astra-member">.ctor</h3>

```csharp
public Camera(Astra.Component component)
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1ce49e54808597ea" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab7c07ece42e67ce" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Camera Wrap(Astra.Component component)
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-fe05aacbfef0273a" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9d89c0a8e1293b7f" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Usar no Play

**Caminho:** Inspector → Câmera → Saída; ou fachada C# em um Behavior.

**Uso:** **Usar no Play:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6542bd843325e272" class="astra-member">EnvironmentMask</h3>

```csharp
public Astra.Components.Camera.EnvironmentMaskOption EnvironmentMask { get; set; }
```

Ambientes. Volumes que esta câmera consulta

**Caminho:** Inspector → Câmera → Saída; ou fachada C# em um Behavior.

**Uso:** **Ambientes:** Volumes que esta câmera consulta

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66ddf057bfcae722" class="astra-member">FarPlane</h3>

```csharp
public float FarPlane { get; set; }
```

Distante (m)

Faixa válida: 0.01 a 1000000.

**Caminho:** Inspector → Câmera → Lente; ou fachada C# em um Behavior.

**Uso:** **Distante:** Plano de corte distante; objetos além ficam cortados.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c3f11be04ce380c3" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d775f62a8a411a31" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-022bf2984f8e0888" class="astra-member">NearPlane</h3>

```csharp
public float NearPlane { get; set; }
```

Próximo (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Câmera → Lente; ou fachada C# em um Behavior.

**Uso:** **Próximo:** Plano de corte próximo; valor exageradamente baixo reduz precisão de depth.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6091d19345d88d9d" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed070f92d2065016" class="astra-member">OrthographicHalfHeight</h3>

```csharp
public float OrthographicHalfHeight { get; set; }
```

Meia altura (m). Metade da altura visível. Zoom altera esta extensão.

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Câmera → Lente; ou fachada C# em um Behavior.

**Uso:** **Meia altura:** Metade da altura visível. Zoom altera esta extensão.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74470d44266369fa" class="astra-member">Priority</h3>

```csharp
public float Priority { get; set; }
```

Prioridade

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Câmera → Saída; ou fachada C# em um Behavior.

**Uso:** **Prioridade:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14a0256b2e5cd8d2" class="astra-member">Projection</h3>

```csharp
public Astra.Components.Camera.ProjectionOption Projection { get; set; }
```

Projeção

**Caminho:** Inspector → Câmera → Lente; ou fachada C# em um Behavior.

**Uso:** **Projeção:** Seleciona perspectiva ou ortográfica.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d12ffafe37775378" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-04d82a46cd800721" class="astra-member">VerticalFov</h3>

```csharp
public float VerticalFov { get; set; }
```

Campo vertical (°)

Faixa válida: 1 a 170.

**Caminho:** Inspector → Câmera → Lente; ou fachada C# em um Behavior.

**Uso:** **Campo vertical:** Campo de visão vertical da perspectiva, em graus.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Camera.EnvironmentMaskOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-camera-environmentmaskoption/
---

# Astra.Components.Camera.EnvironmentMaskOption

Enum da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Camera.EnvironmentMaskOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Projeção** → **Câmera**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Camera>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Camera(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Ambiente0](#member-41eddca5ae08c1bb) | Field |
| [Ambiente1](#member-a1aff615381f89ad) | Field |
| [Ambiente2](#member-5769ef0f5d073a80) | Field |
| [Ambiente3](#member-9b278e3c68f743b6) | Field |
| [Ambiente4](#member-e514dba1199b7ca4) | Field |
| [Ambiente5](#member-8e8e628dea704e3c) | Field |
| [Ambiente6](#member-1f952f6fa724a6d3) | Field |
| [Ambiente7](#member-d4a18b55b4ec2006) | Field |
| [TodosOsAmbientes](#member-50db538f5d78c4ca) | Field |

<h3 id="member-41eddca5ae08c1bb" class="astra-member">Ambiente0</h3>

```csharp
Ambiente0 = 1
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a1aff615381f89ad" class="astra-member">Ambiente1</h3>

```csharp
Ambiente1 = 2
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5769ef0f5d073a80" class="astra-member">Ambiente2</h3>

```csharp
Ambiente2 = 4
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b278e3c68f743b6" class="astra-member">Ambiente3</h3>

```csharp
Ambiente3 = 8
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e514dba1199b7ca4" class="astra-member">Ambiente4</h3>

```csharp
Ambiente4 = 16
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8e8e628dea704e3c" class="astra-member">Ambiente5</h3>

```csharp
Ambiente5 = 32
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f952f6fa724a6d3" class="astra-member">Ambiente6</h3>

```csharp
Ambiente6 = 64
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d4a18b55b4ec2006" class="astra-member">Ambiente7</h3>

```csharp
Ambiente7 = 128
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50db538f5d78c4ca" class="astra-member">TodosOsAmbientes</h3>

```csharp
TodosOsAmbientes = 4294967295
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Camera.ProjectionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-camera-projectionoption/
---

# Astra.Components.Camera.ProjectionOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Camera.ProjectionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Projeção** → **Câmera**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Camera>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Camera(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Ortografica](#member-931e847a33e9f02a) | Field |
| [Perspectiva](#member-38d218fa18765d2a) | Field |

<h3 id="member-931e847a33e9f02a" class="astra-member">Ortografica</h3>

```csharp
Ortografica = 1
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38d218fa18765d2a" class="astra-member">Perspectiva</h3>

```csharp
Perspectiva = 0
```

**Caminho:** Inspector → Câmera; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.CameraFollow"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-camerafollow/
---

# Astra.Components.CameraFollow

Acompanhar alvo: Posiciona a câmera após física e animação. Família Câmera · Controle.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.CameraFollow
```

Acompanhar alvo: Posiciona a câmera após física e animação. Família Câmera · Controle.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.cinemachine@3.1/manual/CinemachineFollow.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.CameraFollow>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Controle** → **Acompanhar alvo**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<CameraFollow>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new CameraFollow(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Acompanhar alvo](/pt-br/snapshot-2026-10-06/componentes/astra-camera-follow/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-5891cd5d9ff872b0) | Method |
| [Remove](#member-81f34da749cfe10b) | Method |
| [Wrap](#member-b428452fbf261d2b) | Method |
| [Component](#member-f30f52029a10642c) | Property |
| [DampingSeconds](#member-3424a9ea69e860dd) | Property |
| [Enabled](#member-b1f41dea4701458b) | Property |
| [InstanceId](#member-88b89da622be907c) | Property |
| [IsAlive](#member-a75962d731badd3c) | Property |
| [Object](#member-6b027ea37b048bb9) | Property |
| [Offset](#member-fc80bcc620df5739) | Property |
| [Target](#member-7cd53252d6ff3a46) | Property |
| [TypeId](#member-d1f200e864c1fce8) | Property |

<h3 id="member-5891cd5d9ff872b0" class="astra-member">.ctor</h3>

```csharp
public CameraFollow(Astra.Component component)
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-81f34da749cfe10b" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b428452fbf261d2b" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.CameraFollow Wrap(Astra.Component component)
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f30f52029a10642c" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3424a9ea69e860dd" class="astra-member">DampingSeconds</h3>

```csharp
public float DampingSeconds { get; set; }
```

Amortecimento (s)

Faixa válida: 0 a 30.

**Caminho:** Inspector → Acompanhar alvo → Resposta; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Tempo de suavização da aproximação da câmera ao alvo.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b1f41dea4701458b" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Acompanhar alvo → Resposta; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-88b89da622be907c" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a75962d731badd3c" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b027ea37b048bb9" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fc80bcc620df5739" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento

**Caminho:** Inspector → Acompanhar alvo → Posição; ou fachada C# em um Behavior.

**Uso:** **Deslocamento X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Deslocamento Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Deslocamento Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7cd53252d6ff3a46" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Alvo

**Caminho:** Inspector → Acompanhar alvo → Posição; ou fachada C# em um Behavior.

**Uso:** **Alvo:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1f200e864c1fce8" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Acompanhar alvo; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.CameraLook"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-cameralook/
---

# Astra.Components.CameraLook

Olhar: Rotação local da câmera por entrada ou script. Família Câmera · Controle.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.CameraLook
```

Olhar: Rotação local da câmera por entrada ou script. Família Câmera · Controle.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.cinemachine@3.1/manual/CinemachinePanTilt.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.CameraLook>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Controle** → **Olhar**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<CameraLook>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new CameraLook(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Olhar](/pt-br/snapshot-2026-10-06/componentes/astra-camera-look/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-46f002e6ad154fb6) | Method |
| [Remove](#member-2cbd93b75b70f1e7) | Method |
| [Wrap](#member-d61c690b2c47fd92) | Method |
| [Component](#member-6497f528732cc95b) | Property |
| [Enabled](#member-726f36d2c14d3428) | Property |
| [InstanceId](#member-f28b2123fc7c202a) | Property |
| [IsAlive](#member-54dd36c4d1462d1a) | Property |
| [Object](#member-ee27cd102aa25bda) | Property |
| [PitchLimit](#member-19e15081e90ba37c) | Property |
| [PitchSensitivity](#member-a5820331eef4c6ce) | Property |
| [TypeId](#member-4e2a5127afa2536c) | Property |
| [YawSensitivity](#member-cdc4d79080e4f4f0) | Property |

<h3 id="member-46f002e6ad154fb6" class="astra-member">.ctor</h3>

```csharp
public CameraLook(Astra.Component component)
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-2cbd93b75b70f1e7" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d61c690b2c47fd92" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.CameraLook Wrap(Astra.Component component)
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-6497f528732cc95b" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-726f36d2c14d3428" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Olhar → Controle; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f28b2123fc7c202a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-54dd36c4d1462d1a" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee27cd102aa25bda" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-19e15081e90ba37c" class="astra-member">PitchLimit</h3>

```csharp
public float PitchLimit { get; set; }
```

Limite vertical graus (°)

Faixa válida: 1 a 89.

**Caminho:** Inspector → Olhar → Limites; ou fachada C# em um Behavior.

**Uso:** **Limite vertical graus:** Limita inclinação vertical da câmera.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a5820331eef4c6ce" class="astra-member">PitchSensitivity</h3>

```csharp
public float PitchSensitivity { get; set; }
```

Sensibilidade vertical graus/tela (°)

Faixa válida: 0 a 720.

**Caminho:** Inspector → Olhar → Sensibilidade; ou fachada C# em um Behavior.

**Uso:** **Sensibilidade vertical graus/tela:** Ganho vertical do olhar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4e2a5127afa2536c" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Olhar; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cdc4d79080e4f4f0" class="astra-member">YawSensitivity</h3>

```csharp
public float YawSensitivity { get; set; }
```

Sensibilidade horizontal graus/tela (°)

Faixa válida: 0 a 720.

**Caminho:** Inspector → Olhar → Sensibilidade; ou fachada C# em um Behavior.

**Uso:** **Sensibilidade horizontal graus/tela:** Ganho horizontal do olhar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Character"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-character/
---

# Astra.Components.Character

Personagem: Locomoção com cápsula. Família Física 3D · Corpos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Character
```

Personagem: Locomoção com cápsula. Família Física 3D · Corpos.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-CharacterController.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Character>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Personagem**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Character>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Character(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a75c148e0a75f221) | Method |
| [Remove](#member-433ec21fa2c16244) | Method |
| [Wrap](#member-955d3ec2708cc01c) | Method |
| [Component](#member-bd6571619858feab) | Property |
| [EyeHeight](#member-4a4fceb19d2ceb07) | Property |
| [FloorSnapLength](#member-786d72bf1374067b) | Property |
| [Gravity](#member-930adbcb73b7fb78) | Property |
| [HalfHeight](#member-50eb69664530da7d) | Property |
| [InheritPlatformHorizontal](#member-a87aee23e7ed7cef) | Property |
| [InstanceId](#member-fa8b8c1a9a46c540) | Property |
| [IsAlive](#member-6f9667035bce485c) | Property |
| [JumpSpeed](#member-ad5c271211c919ea) | Property |
| [Object](#member-83d2aef57d4cb4d5) | Property |
| [Radius](#member-75a41f0070ef375d) | Property |
| [SlopeDegrees](#member-fc08217d789b2743) | Property |
| [Speed](#member-ad532a4c9b080c49) | Property |
| [StepHeight](#member-4e30119a66aa6f01) | Property |
| [TypeId](#member-dd48c710ebb36691) | Property |

<h3 id="member-a75c148e0a75f221" class="astra-member">.ctor</h3>

```csharp
public Character(Astra.Component component)
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-433ec21fa2c16244" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-955d3ec2708cc01c" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Character Wrap(Astra.Component component)
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-bd6571619858feab" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a4fceb19d2ceb07" class="astra-member">EyeHeight</h3>

```csharp
public float EyeHeight { get; set; }
```

Altura dos olhos m (m)

Faixa válida: 0.02 a 20.

**Caminho:** Inspector → Personagem → Cápsula; ou fachada C# em um Behavior.

**Uso:** **Altura dos olhos m:** Altura de referência dos olhos do Character.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-786d72bf1374067b" class="astra-member">FloorSnapLength</h3>

```csharp
public float FloorSnapLength { get; set; }
```

Aderência ao chão (m)

Faixa válida: 0 a 10.

**Caminho:** Inspector → Personagem → Chão; ou fachada C# em um Behavior.

**Uso:** **Aderência ao chão:** Distância de snap ao chão; confira degraus e bordas.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-930adbcb73b7fb78" class="astra-member">Gravity</h3>

```csharp
public float Gravity { get; set; }
```

Gravidade (m/s²)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Personagem → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Gravidade:** Aceleração de gravidade do Character.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50eb69664530da7d" class="astra-member">HalfHeight</h3>

```csharp
public float HalfHeight { get; set; }
```

Meia altura do cilindro m (m)

Faixa válida: 0.01 a 10.

**Caminho:** Inspector → Personagem → Cápsula; ou fachada C# em um Behavior.

**Uso:** **Meia altura do cilindro m:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a87aee23e7ed7cef" class="astra-member">InheritPlatformHorizontal</h3>

```csharp
public bool InheritPlatformHorizontal { get; set; }
```

Impulso ao sair. Conserva X/Z da superfície no ar; desligar remove apenas esse impulso, sem recriar a cápsula.

**Caminho:** Inspector → Personagem → Chão; ou fachada C# em um Behavior.

**Uso:** **Impulso ao sair:** Conserva X/Z da superfície no ar; desligar remove apenas esse impulso, sem recriar a cápsula.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fa8b8c1a9a46c540" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f9667035bce485c" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ad5c271211c919ea" class="astra-member">JumpSpeed</h3>

```csharp
public float JumpSpeed { get; set; }
```

Velocidade do salto m/s (m/s)

Faixa válida: 0 a 100.

**Caminho:** Inspector → Personagem → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Velocidade do salto m/s:** Velocidade alvo inicial de salto.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-83d2aef57d4cb4d5" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75a41f0070ef375d" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio m (m)

Faixa válida: 0.01 a 10.

**Caminho:** Inspector → Personagem → Cápsula; ou fachada C# em um Behavior.

**Uso:** **Raio m:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fc08217d789b2743" class="astra-member">SlopeDegrees</h3>

```csharp
public float SlopeDegrees { get; set; }
```

Inclinação máxima graus (°)

Faixa válida: 1 a 89.

**Caminho:** Inspector → Personagem → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Inclinação máxima graus:** Inclinação máxima de apoio do Character.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ad532a4c9b080c49" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade m/s (m/s)

Faixa válida: 0.01 a 100.

**Caminho:** Inspector → Personagem → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Velocidade m/s:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4e30119a66aa6f01" class="astra-member">StepHeight</h3>

```csharp
public float StepHeight { get; set; }
```

Altura do degrau (m)

Faixa válida: 0 a 10.

**Caminho:** Inspector → Personagem → Chão; ou fachada C# em um Behavior.

**Uso:** **Altura do degrau:** Altura de degrau que o Character pode transpor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd48c710ebb36691" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Personagem; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Collider"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-collider/
---

# Astra.Components.Collider

Colisor 3D: Volume de contato. Família Física 3D · Formas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Collider
```

Colisor 3D: Volume de contato. Família Física 3D · Formas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-BoxCollider.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Collider>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Formas** → **Colisor 3D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Collider>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Collider(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-690724be9126c371) | Method |
| [GetCollisionMesh](#member-09d983e04152ca09) | Method |
| [OnCollisionEnter](#member-a2fc8b0fbc9ca6a5) | Method |
| [OnCollisionExit](#member-5bbe06c8a0eb039a) | Method |
| [OnTriggerEnter](#member-c314388bf002cc40) | Method |
| [OnTriggerExit](#member-eccadf83e403abc9) | Method |
| [Remove](#member-178679bfe0310ffc) | Method |
| [SetCollisionMesh](#member-da5de8e7433ab86f) | Method |
| [Wrap](#member-8f4e79f0f39a779b) | Method |
| [ActiveEdgeAngle](#member-1b6a284e722c7698) | Property |
| [Center](#member-899e46de39fa12fb) | Property |
| [Component](#member-5d9d0ccda8cc8d4f) | Property |
| [Convex](#member-c582a7ed9c6ac9a7) | Property |
| [Enabled](#member-3c8e782693cb1f0b) | Property |
| [HalfExtents](#member-2f23e0e8a1a2ecb6) | Property |
| [HalfHeight](#member-b1cbd82f912e1a41) | Property |
| [HullTolerance](#member-58638d4db4147e69) | Property |
| [InstanceId](#member-d673d33d01d78683) | Property |
| [IsAlive](#member-42814b9a138603e4) | Property |
| [MeshLocalPose](#member-a6dee9fbba9674d1) | Property |
| [Object](#member-53be6b39675bba8f) | Property |
| [OptimizeCooking](#member-3016a5a25af55e4e) | Property |
| [Owner](#member-89b86235e04f61c7) | Property |
| [Radius](#member-4d7bd17bde9b61e1) | Property |
| [Rotation](#member-69fd5c64202397e9) | Property |
| [Shape](#member-dc1cfa0e30cfd4f1) | Property |
| [TypeId](#member-492dbc701b4e02fc) | Property |
| [WeldVertices](#member-f6a57db86437f488) | Property |

<h3 id="member-690724be9126c371" class="astra-member">.ctor</h3>

```csharp
public Collider(Astra.Component component)
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-09d983e04152ca09" class="astra-member">GetCollisionMesh</h3>

```csharp
public Astra.AssetGuid GetCollisionMesh(uint slot = 0)
```

Malha de colisão. Recurso do projeto por slot

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Malha de colisão. Recurso do projeto por slot

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a2fc8b0fbc9ca6a5" class="astra-member">OnCollisionEnter</h3>

```csharp
public Astra.ComponentSubscription OnCollisionEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: começou. Contato sólido começou; entregue aos dois objetos. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Colisão: começou. Contato sólido começou; entregue aos dois objetos. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-5bbe06c8a0eb039a" class="astra-member">OnCollisionExit</h3>

```csharp
public Astra.ComponentSubscription OnCollisionExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: terminou. Contato sólido terminou; entregue aos dois objetos. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Colisão: terminou. Contato sólido terminou; entregue aos dois objetos. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-c314388bf002cc40" class="astra-member">OnTriggerEnter</h3>

```csharp
public Astra.ComponentSubscription OnTriggerEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-eccadf83e403abc9" class="astra-member">OnTriggerExit</h3>

```csharp
public Astra.ComponentSubscription OnTriggerExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-178679bfe0310ffc" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-da5de8e7433ab86f" class="astra-member">SetCollisionMesh</h3>

```csharp
public void SetCollisionMesh(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-8f4e79f0f39a779b" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Collider Wrap(Astra.Component component)
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1b6a284e722c7698" class="astra-member">ActiveEdgeAngle</h3>

```csharp
public float ActiveEdgeAngle { get; set; }
```

Ângulo de aresta ativa (°). Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

Faixa válida: 0 a 90.

**Caminho:** Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

**Uso:** **Ângulo de aresta ativa:** Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-899e46de39fa12fb" class="astra-member">Center</h3>

```csharp
public System.Numerics.Vector3 Center { get; set; }
```

Centro

**Caminho:** Inspector → Colisor 3D → Pose; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Centro local da forma de colisão, eixo X. **Centro Y:** Centro local da forma de colisão, eixo Y. **Centro Z:** Centro local da forma de colisão, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d9d0ccda8cc8d4f" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c582a7ed9c6ac9a7" class="astra-member">Convex</h3>

```csharp
public bool Convex { get; set; }
```

Convexo. Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Convexo:** Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3c8e782693cb1f0b" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Colisor 3D → Geral; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f23e0e8a1a2ecb6" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meia extensão

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Z:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b1cbd82f912e1a41" class="astra-member">HalfHeight</h3>

```csharp
public float HalfHeight { get; set; }
```

Meia altura cilíndrica

Faixa válida: 0.01 a 10000.

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Meia altura cilíndrica:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58638d4db4147e69" class="astra-member">HullTolerance</h3>

```csharp
public float HullTolerance { get; set; }
```

Tolerância do casco (u). Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

Faixa válida: 0.00001 a 1.

**Caminho:** Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

**Uso:** **Tolerância do casco:** Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d673d33d01d78683" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42814b9a138603e4" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a6dee9fbba9674d1" class="astra-member">MeshLocalPose</h3>

```csharp
public bool MeshLocalPose { get; set; }
```

Pose local da malha. Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Pose local da malha:** Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53be6b39675bba8f" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3016a5a25af55e4e" class="astra-member">OptimizeCooking</h3>

```csharp
public bool OptimizeCooking { get; set; }
```

Otimizar para o jogo. Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

**Caminho:** Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

**Uso:** **Otimizar para o jogo:** Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-89b86235e04f61c7" class="astra-member">Owner</h3>

```csharp
public Astra.ObjectReference Owner { get; set; }
```

Corpo proprietário

**Caminho:** Inspector → Colisor 3D → Vínculo; ou fachada C# em um Behavior.

**Uso:** **Corpo proprietário:** Escolhe o dono do corpo/forma no domínio do colisor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d7bd17bde9b61e1" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio

Faixa válida: 0.01 a 10000.

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-69fd5c64202397e9" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Vector3 Rotation { get; set; }
```

Rotação

**Caminho:** Inspector → Colisor 3D → Pose; ou fachada C# em um Behavior.

**Uso:** **Rotação local X:** Rotação autorada do sistema na unidade indicada, eixo X. **Rotação local Y:** Rotação autorada do sistema na unidade indicada, eixo Y. **Rotação local Z:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dc1cfa0e30cfd4f1" class="astra-member">Shape</h3>

```csharp
public Astra.Components.Collider.ShapeOption Shape { get; set; }
```

Forma

**Caminho:** Inspector → Colisor 3D → Forma; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escolhe a geometria do colisor/campo no domínio indicado; os campos relevantes mudam por forma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-492dbc701b4e02fc" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f6a57db86437f488" class="astra-member">WeldVertices</h3>

```csharp
public bool WeldVertices { get; set; }
```

Soldar vértices iguais. Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.

**Caminho:** Inspector → Colisor 3D → Cozimento; ou fachada C# em um Behavior.

**Uso:** **Soldar vértices iguais:** Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Collider.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-collider-shapeoption/
---

# Astra.Components.Collider.ShapeOption

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Collider.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Formas** → **Colisor 3D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Collider>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Collider(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-45a3775c355a756d) | Field |
| [Capsula](#member-8d038f457c465e66) | Field |
| [Cilindro](#member-b60a44d1323d0aa7) | Field |
| [Esfera](#member-66cf3dda94813a20) | Field |
| [Malha](#member-0f47d7553c66d46c) | Field |

<h3 id="member-45a3775c355a756d" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d038f457c465e66" class="astra-member">Capsula</h3>

```csharp
Capsula = 2
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b60a44d1323d0aa7" class="astra-member">Cilindro</h3>

```csharp
Cilindro = 4
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66cf3dda94813a20" class="astra-member">Esfera</h3>

```csharp
Esfera = 1
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f47d7553c66d46c" class="astra-member">Malha</h3>

```csharp
Malha = 3
```

**Caminho:** Inspector → Colisor 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Collider2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-collider2d/
---

# Astra.Components.Collider2D

Colisor 2D: Caixa, círculo ou cápsula; sensor real. Família Física 2D · Formas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Collider2D
```

Colisor 2D: Caixa, círculo ou cápsula; sensor real. Família Física 2D · Formas.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_collisionshape2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Collider2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Formas** → **Colisor 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Collider2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Collider2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Colisor 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-collider/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-fa8699942fb6bec5) | Method |
| [OnCollisionEnter](#member-080a942c56439f6e) | Method |
| [OnCollisionExit](#member-6b7cfaeb3a20e4bf) | Method |
| [OnTriggerEnter](#member-59ba6d0803c0b8dc) | Method |
| [OnTriggerExit](#member-46d6771f2dc2f130) | Method |
| [Remove](#member-6b2920f5b5fa3da9) | Method |
| [Wrap](#member-6d4ac87b3c636943) | Method |
| [CapsuleHalfLength](#member-b1a23fa1689470c0) | Property |
| [Component](#member-68e3cb2dd6423b94) | Property |
| [Friction](#member-41fefd37b03c26a0) | Property |
| [HalfX](#member-3f2d0f34a9037f01) | Property |
| [HalfY](#member-542fdbfb787dfe2e) | Property |
| [InstanceId](#member-5c643f12b0845aed) | Property |
| [IsAlive](#member-cb56bbab0cd88ac2) | Property |
| [Object](#member-e7fcb39fd5927316) | Property |
| [OffsetX](#member-a01ef04d166db02e) | Property |
| [OffsetY](#member-91b36fe569bef360) | Property |
| [Radius](#member-12e6d6ad780a3517) | Property |
| [Restitution](#member-ad7a7b4366f743c5) | Property |
| [Sensor](#member-0fb764e9d2baca4d) | Property |
| [Shape](#member-fdbd59a1e3d3bc95) | Property |
| [TypeId](#member-40b07d8ef60e2bf5) | Property |

<h3 id="member-fa8699942fb6bec5" class="astra-member">.ctor</h3>

```csharp
public Collider2D(Astra.Component component)
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-080a942c56439f6e" class="astra-member">OnCollisionEnter</h3>

```csharp
public Astra.ComponentSubscription OnCollisionEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: começou. Contato sólido começou; entregue aos dois colisores. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Colisão: começou. Contato sólido começou; entregue aos dois colisores. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-6b7cfaeb3a20e4bf" class="astra-member">OnCollisionExit</h3>

```csharp
public Astra.ComponentSubscription OnCollisionExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Colisão: terminou. Contato sólido terminou; entregue aos dois colisores. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Colisão: terminou. Contato sólido terminou; entregue aos dois colisores. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-59ba6d0803c0b8dc" class="astra-member">OnTriggerEnter</h3>

```csharp
public Astra.ComponentSubscription OnTriggerEnter(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Sensor: entrou. Outro corpo começou a sobrepor este sensor. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-46d6771f2dc2f130" class="astra-member">OnTriggerExit</h3>

```csharp
public Astra.ComponentSubscription OnTriggerExit(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Sensor: saiu. Outro corpo deixou de sobrepor este sensor. Payload: Outro objeto: objeto

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-6b2920f5b5fa3da9" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d4ac87b3c636943" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Collider2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b1a23fa1689470c0" class="astra-member">CapsuleHalfLength</h3>

```csharp
public float CapsuleHalfLength { get; set; }
```

Meia distância centros (m)

Faixa válida: 0.005 a 500.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Meia distância centros:** Metade da distância entre centros da cápsula 2D; raio é configurado separadamente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68e3cb2dd6423b94" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-41fefd37b03c26a0" class="astra-member">Friction</h3>

```csharp
public float Friction { get; set; }
```

Atrito

Faixa válida: 0 a 1.

**Caminho:** Inspector → Colisor 2D → Contato; ou fachada C# em um Behavior.

**Uso:** **Atrito:** Atrito nos contatos; compare deslizamento com o mesmo par de superfícies.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f2d0f34a9037f01" class="astra-member">HalfX</h3>

```csharp
public float HalfX { get; set; }
```

Meia largura (m)

Faixa válida: 0.005 a 500.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Meia largura:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-542fdbfb787dfe2e" class="astra-member">HalfY</h3>

```csharp
public float HalfY { get; set; }
```

Meia altura (m)

Faixa válida: 0.005 a 500.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Meia altura:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c643f12b0845aed" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb56bbab0cd88ac2" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e7fcb39fd5927316" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a01ef04d166db02e" class="astra-member">OffsetX</h3>

```csharp
public float OffsetX { get; set; }
```

Centro X (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-91b36fe569bef360" class="astra-member">OffsetY</h3>

```csharp
public float OffsetY { get; set; }
```

Centro Y (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-12e6d6ad780a3517" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.005 a 500.

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ad7a7b4366f743c5" class="astra-member">Restitution</h3>

```csharp
public float Restitution { get; set; }
```

Restituição

Faixa válida: 0 a 1.

**Caminho:** Inspector → Colisor 2D → Contato; ou fachada C# em um Behavior.

**Uso:** **Restituição:** Restituição nos contatos; controla ressalto conforme a combinação física.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0fb764e9d2baca4d" class="astra-member">Sensor</h3>

```csharp
public bool Sensor { get; set; }
```

Sensor sem resposta

**Caminho:** Inspector → Colisor 2D → Contato; ou fachada C# em um Behavior.

**Uso:** **Sensor sem resposta:** Participa como sensor/sobreposição; não é uma superfície sólida de contato.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fdbd59a1e3d3bc95" class="astra-member">Shape</h3>

```csharp
public Astra.Components.Collider2D.ShapeOption Shape { get; set; }
```

Forma

**Caminho:** Inspector → Colisor 2D → Forma; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escolhe a geometria do colisor/campo no domínio indicado; os campos relevantes mudam por forma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-40b07d8ef60e2bf5" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Collider2D.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-collider2d-shapeoption/
---

# Astra.Components.Collider2D.ShapeOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Collider2D.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Formas** → **Colisor 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Collider2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Collider2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-91b46ae7e096d25b) | Field |
| [CapsulaY](#member-1116ccc91bf730a4) | Field |
| [Circulo](#member-c290278e67893252) | Field |

<h3 id="member-91b46ae7e096d25b" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1116ccc91bf730a4" class="astra-member">CapsulaY</h3>

```csharp
CapsulaY = 2
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c290278e67893252" class="astra-member">Circulo</h3>

```csharp
Circulo = 1
```

**Caminho:** Inspector → Colisor 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.ComponentFacadeExtensions"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-componentfacadeextensions/
---

# Astra.Components.ComponentFacadeExtensions

Acesso tipado a partir do objeto: obj.GetComponent<PhysicsBody>().

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Components.ComponentFacadeExtensions
```

Acesso tipado a partir do objeto: obj.GetComponent&lt;PhysicsBody>().

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AddComponent](#member-a15aa8676781d341) | Method |
| [GetComponent](#member-addff634d5b39ca8) | Method |
| [HasComponent](#member-a2dd18f5e35b1890) | Method |

<h3 id="member-a15aa8676781d341" class="astra-member">AddComponent</h3>

```csharp
public static T AddComponent<T>(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |

<h3 id="member-addff634d5b39ca8" class="astra-member">GetComponent</h3>

```csharp
public static T? GetComponent<T>(Astra.GameObject owner, int ordinal = 0) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `ordinal` | `int` |  · Opcional: `0` |

<h3 id="member-a2dd18f5e35b1890" class="astra-member">HasComponent</h3>

```csharp
public static bool HasComponent<T>(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |


---

---
title: "Astra.Components.ComponentQueries"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-componentqueries/
---

# Astra.Components.ComponentQueries

Queries over real native component instances; ordinal order is preserved. Unity 6000.0 GetComponentsInChildren/GetComponentsInParent are the reference contracts.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Components.ComponentQueries
```

Queries over real native component instances; ordinal order is preserved. Unity 6000.0 GetComponentsInChildren/GetComponentsInParent are the reference contracts.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [GetComponentsInChildren](#member-45108e918bb3bf7a) | Method |
| [GetComponentsInChildren](#member-e47464d52b4e5625) | Method |
| [GetComponentsInParent](#member-dfa9096a1caf64f4) | Method |
| [GetComponents](#member-275806c5c87462a4) | Method |
| [GetComponents](#member-5249e5a09a3b452b) | Method |
| [TryGetComponent](#member-ebaee0f791e4a617) | Method |

<h3 id="member-45108e918bb3bf7a" class="astra-member">GetComponentsInChildren</h3>

```csharp
public static T[] GetComponentsInChildren<T>(Astra.GameObject owner, bool includeInactive = false) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  · Opcional: `False` |

<h3 id="member-e47464d52b4e5625" class="astra-member">GetComponentsInChildren</h3>

```csharp
public static void GetComponentsInChildren<T>(Astra.GameObject owner, bool includeInactive, System.Collections.Generic.List<T> results) where T : struct, Astra.Components.IComponentFacade<T>
```

Depth-first, self first, child order preserved. Self is searched even when inactive; inactive descendants are excluded by default. Disabled components remain discoverable.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Depth-first, self first, child order preserved. Self is searched even when inactive; inactive descendants are excluded by default. Disabled components remain discoverable.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  |
| `results` | `System.Collections.Generic.List&lt;T&gt;` |  |

<h3 id="member-dfa9096a1caf64f4" class="astra-member">GetComponentsInParent</h3>

```csharp
public static T[] GetComponentsInParent<T>(Astra.GameObject owner, bool includeInactive = false) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  · Opcional: `False` |

<h3 id="member-275806c5c87462a4" class="astra-member">GetComponents</h3>

```csharp
public static T[] GetComponents<T>(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |

<h3 id="member-5249e5a09a3b452b" class="astra-member">GetComponents</h3>

```csharp
public static void GetComponents<T>(Astra.GameObject owner, System.Collections.Generic.List<T> results) where T : struct, Astra.Components.IComponentFacade<T>
```

Writes into caller-owned storage without allocating a result array.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Writes into caller-owned storage without allocating a result array.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `results` | `System.Collections.Generic.List&lt;T&gt;` |  |

<h3 id="member-ebaee0f791e4a617" class="astra-member">TryGetComponent</h3>

```csharp
public static bool TryGetComponent<T>(Astra.GameObject owner, out T component) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `component` | `T` |  · Out |


---

---
title: "Astra.Components.ConstantForce"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-constantforce/
---

# Astra.Components.ConstantForce

Força constante: Força e torque contínuos sobre corpo dinâmico. Família Física 3D · Forças.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.ConstantForce
```

Força constante: Força e torque contínuos sobre corpo dinâmico. Família Física 3D · Forças.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ConstantForce.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.ConstantForce>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Forças** → **Força constante**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<ConstantForce>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new ConstantForce(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Força constante](/pt-br/snapshot-2026-10-06/componentes/astra-physics-constant-force/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a9735dc5cf15e132) | Method |
| [Remove](#member-172708bbd3672a19) | Method |
| [Wrap](#member-597fef5095e4d8a8) | Method |
| [Component](#member-d6c14ad656486b10) | Property |
| [Enabled](#member-cd04c3247565dbb3) | Property |
| [Force](#member-85f42a1e956d058e) | Property |
| [InstanceId](#member-57e14acb3d53a0aa) | Property |
| [IsAlive](#member-b01cb01e08b0e7cb) | Property |
| [Object](#member-c817ed874668c92f) | Property |
| [RelativeForce](#member-f294467e2da81f25) | Property |
| [RelativeTorque](#member-c77b407ac16cb799) | Property |
| [Torque](#member-46c57035544f0e83) | Property |
| [TypeId](#member-03dafae6973ecdf7) | Property |

<h3 id="member-a9735dc5cf15e132" class="astra-member">.ctor</h3>

```csharp
public ConstantForce(Astra.Component component)
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-172708bbd3672a19" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-597fef5095e4d8a8" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.ConstantForce Wrap(Astra.Component component)
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-d6c14ad656486b10" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cd04c3247565dbb3" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo. Requer Corpo físico dinâmico no mesmo objeto; desligado permite configurar sem aplicar.

**Caminho:** Inspector → Força constante → Força mundo; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Requer Corpo físico dinâmico no mesmo objeto; desligado permite configurar sem aplicar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85f42a1e956d058e" class="astra-member">Force</h3>

```csharp
public System.Numerics.Vector3 Force { get; set; }
```

Força mundo

**Caminho:** Inspector → Força constante → Força mundo; ou fachada C# em um Behavior.

**Uso:** **Força X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força Z:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57e14acb3d53a0aa" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b01cb01e08b0e7cb" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c817ed874668c92f" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f294467e2da81f25" class="astra-member">RelativeForce</h3>

```csharp
public System.Numerics.Vector3 RelativeForce { get; set; }
```

Força local

**Caminho:** Inspector → Força constante → Força local; ou fachada C# em um Behavior.

**Uso:** **Força local X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força local Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Força local Z:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c77b407ac16cb799" class="astra-member">RelativeTorque</h3>

```csharp
public System.Numerics.Vector3 RelativeTorque { get; set; }
```

Torque local

**Caminho:** Inspector → Força constante → Torque local; ou fachada C# em um Behavior.

**Uso:** **Torque local X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque local Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque local Z:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-46c57035544f0e83" class="astra-member">Torque</h3>

```csharp
public System.Numerics.Vector3 Torque { get; set; }
```

Torque mundo

**Caminho:** Inspector → Força constante → Torque mundo; ou fachada C# em um Behavior.

**Uso:** **Torque X:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque Y:** Aplicado a cada passo físico; não multiplique pelo tempo. **Torque Z:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03dafae6973ecdf7" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Força constante; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.ConstantForce2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-constantforce2d/
---

# Astra.Components.ConstantForce2D

Força constante 2D: Força XY e torque contínuos sobre Body2D dinâmico. Família Física 2D · Forças.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.ConstantForce2D
```

Força constante 2D: Força XY e torque contínuos sobre Body2D dinâmico. Família Física 2D · Forças.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/ConstantForce2D.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.ConstantForce2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Forças** → **Força constante 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<ConstantForce2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new ConstantForce2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Força constante 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-constant-force/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e43b069c809c47f8) | Method |
| [Remove](#member-20e534616997c008) | Method |
| [Wrap](#member-910dd24ccee10026) | Method |
| [Component](#member-2420f2b6416a3bf5) | Property |
| [Enabled](#member-fc482c93e5390ac1) | Property |
| [ForceX](#member-11247047861f9e8d) | Property |
| [ForceY](#member-aa438828693398ff) | Property |
| [InstanceId](#member-39b0085c58d6dc48) | Property |
| [IsAlive](#member-1e1ed1ea0d5d4c12) | Property |
| [Object](#member-c138c51f2e51d29a) | Property |
| [RelativeForceX](#member-4f193c55b0988772) | Property |
| [RelativeForceY](#member-994ebfd8976ff389) | Property |
| [Torque](#member-00993beef9012b53) | Property |
| [TypeId](#member-1152874fed98d2eb) | Property |

<h3 id="member-e43b069c809c47f8" class="astra-member">.ctor</h3>

```csharp
public ConstantForce2D(Astra.Component component)
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-20e534616997c008" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-910dd24ccee10026" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.ConstantForce2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-2420f2b6416a3bf5" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fc482c93e5390ac1" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-11247047861f9e8d" class="astra-member">ForceX</h3>

```csharp
public float ForceX { get; set; }
```

Força X (N)

Faixa válida: -1000000 a 1000000.

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Força X:** Força contínua em espaço mundial, eixo X.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa438828693398ff" class="astra-member">ForceY</h3>

```csharp
public float ForceY { get; set; }
```

Força Y (N)

Faixa válida: -1000000 a 1000000.

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Força Y:** Força contínua em espaço mundial, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-39b0085c58d6dc48" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1e1ed1ea0d5d4c12" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c138c51f2e51d29a" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f193c55b0988772" class="astra-member">RelativeForceX</h3>

```csharp
public float RelativeForceX { get; set; }
```

Força local X (N)

Faixa válida: -1000000 a 1000000.

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Força local X:** Força contínua no espaço local do objeto, eixo X.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-994ebfd8976ff389" class="astra-member">RelativeForceY</h3>

```csharp
public float RelativeForceY { get; set; }
```

Força local Y (N)

Faixa válida: -1000000 a 1000000.

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Força local Y:** Força contínua no espaço local do objeto, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00993beef9012b53" class="astra-member">Torque</h3>

```csharp
public float Torque { get; set; }
```

Torque (N m)

Faixa válida: -1000000 a 1000000.

**Caminho:** Inspector → Força constante 2D → Propulsão; ou fachada C# em um Behavior.

**Uso:** **Torque:** Torque contínuo sobre o Body2D dinâmico; não é orientação autoral.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1152874fed98d2eb" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Força constante 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield/
---

# Astra.Components.DragField

Campo de arrasto: Amortecimento linear e angular local. Família Física 3D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.DragField
```

Campo de arrasto: Amortecimento linear e angular local. Família Física 3D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.DragField>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de arrasto**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de arrasto](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-drag/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-830dbbf8aeec5e8f) | Method |
| [Remove](#member-08400fe2967347ba) | Method |
| [Wrap](#member-7c2657f608c009c9) | Method |
| [AffectedLayer](#member-3a6aaec52296886b) | Property |
| [AngularDrag](#member-70782aee485328eb) | Property |
| [Component](#member-2c7c4f5ed8e021e2) | Property |
| [Enabled](#member-f6269d1d722de3b7) | Property |
| [Falloff](#member-80a9e0663bbdb4e8) | Property |
| [HalfExtents](#member-e2f795dbc76b5199) | Property |
| [InstanceId](#member-5de103a95fbaaeb5) | Property |
| [IsAlive](#member-d4bbbbb591b69158) | Property |
| [LinearDrag](#member-1db8b6ece2a86d5a) | Property |
| [Object](#member-a138f920d2864b1b) | Property |
| [Offset](#member-719a0f0864d2e8b7) | Property |
| [Radius](#member-fd5566dbd6daa993) | Property |
| [Shape](#member-7c4fc90df9de7cea) | Property |
| [TypeId](#member-18515dc6f6a738e2) | Property |
| [WakeBodies](#member-b0901a85e13c629c) | Property |

<h3 id="member-830dbbf8aeec5e8f" class="astra-member">.ctor</h3>

```csharp
public DragField(Astra.Component component)
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-08400fe2967347ba" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c2657f608c009c9" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.DragField Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3a6aaec52296886b" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.DragField.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de arrasto → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-70782aee485328eb" class="astra-member">AngularDrag</h3>

```csharp
public float AngularDrag { get; set; }
```

Arrasto angular (1/s)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Campo de arrasto → Efeito; ou fachada C# em um Behavior.

**Uso:** **Arrasto angular:** Arrasto angular aplicado pelo campo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2c7c4f5ed8e021e2" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f6269d1d722de3b7" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de arrasto → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-80a9e0663bbdb4e8" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.DragField.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de arrasto → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2f795dbc76b5199" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meias XYZ

**Caminho:** Inspector → Campo de arrasto → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Z:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5de103a95fbaaeb5" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d4bbbbb591b69158" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1db8b6ece2a86d5a" class="astra-member">LinearDrag</h3>

```csharp
public float LinearDrag { get; set; }
```

Arrasto linear (1/s)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Campo de arrasto → Efeito; ou fachada C# em um Behavior.

**Uso:** **Arrasto linear:** Arrasto linear aplicado pelo campo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a138f920d2864b1b" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-719a0f0864d2e8b7" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de arrasto → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Centro Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd5566dbd6daa993" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de arrasto → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c4fc90df9de7cea" class="astra-member">Shape</h3>

```csharp
public Astra.Components.DragField.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de arrasto → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-18515dc6f6a738e2" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0901a85e13c629c" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de arrasto → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-affectedlayeroption/
---

# Astra.Components.DragField.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de arrasto**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-dffb72c4a0d9c296) | Field |
| [Camada1](#member-b2d894f522545867) | Field |
| [Camada10](#member-2b8ab56c397a96c6) | Field |
| [Camada11](#member-ed5d108779966a1d) | Field |
| [Camada12](#member-b7b122002c6a66ff) | Field |
| [Camada13](#member-f29c5c3d7e0d0af4) | Field |
| [Camada14](#member-e2d131701938985e) | Field |
| [Camada15](#member-6717ee8da3456253) | Field |
| [Camada16](#member-4cdf35535280beae) | Field |
| [Camada17](#member-33673e1db6c85864) | Field |
| [Camada18](#member-908287a93affcd8c) | Field |
| [Camada19](#member-983a023d584b2a46) | Field |
| [Camada2](#member-762703e92ca131f7) | Field |
| [Camada20](#member-56c6280ff30d2bdf) | Field |
| [Camada21](#member-4a229b6e5ecb2ef4) | Field |
| [Camada22](#member-c9399771cb1240a3) | Field |
| [Camada23](#member-5ec849db383d499b) | Field |
| [Camada24](#member-ab5d20d4f3ab998c) | Field |
| [Camada25](#member-e384d2d6740d9d88) | Field |
| [Camada26](#member-aed64620ecb1c2e3) | Field |
| [Camada27](#member-9860aa3f6cafa2a7) | Field |
| [Camada28](#member-78435c2bba927cee) | Field |
| [Camada29](#member-1b67821eb05caa7d) | Field |
| [Camada3](#member-5e7c1de9550374d9) | Field |
| [Camada30](#member-03fba2a0fa4d394f) | Field |
| [Camada31](#member-d22014da0ef5e758) | Field |
| [Camada4](#member-027fef9b1027c0ba) | Field |
| [Camada5](#member-b20a60e9f7192984) | Field |
| [Camada6](#member-5d96cb4ead5c5d9a) | Field |
| [Camada7](#member-6185d46eb71d53ef) | Field |
| [Camada8](#member-802c38afbe35e44e) | Field |
| [Camada9](#member-82ac1520091d1f35) | Field |
| [Todas](#member-7d0349277f34a2e8) | Field |

<h3 id="member-dffb72c4a0d9c296" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b2d894f522545867" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b8ab56c397a96c6" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed5d108779966a1d" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b7b122002c6a66ff" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f29c5c3d7e0d0af4" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2d131701938985e" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6717ee8da3456253" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4cdf35535280beae" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-33673e1db6c85864" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-908287a93affcd8c" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-983a023d584b2a46" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-762703e92ca131f7" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-56c6280ff30d2bdf" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a229b6e5ecb2ef4" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9399771cb1240a3" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ec849db383d499b" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab5d20d4f3ab998c" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e384d2d6740d9d88" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aed64620ecb1c2e3" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9860aa3f6cafa2a7" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-78435c2bba927cee" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1b67821eb05caa7d" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e7c1de9550374d9" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03fba2a0fa4d394f" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d22014da0ef5e758" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-027fef9b1027c0ba" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b20a60e9f7192984" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d96cb4ead5c5d9a" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6185d46eb71d53ef" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-802c38afbe35e44e" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-82ac1520091d1f35" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d0349277f34a2e8" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-falloffoption/
---

# Astra.Components.DragField.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de arrasto**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-cd59964cbaf9fc6b) | Field |
| [Suave](#member-0e854eb71dae241f) | Field |
| [Uniforme](#member-4d439108fe64478c) | Field |

<h3 id="member-cd59964cbaf9fc6b" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e854eb71dae241f" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d439108fe64478c" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-shapeoption/
---

# Astra.Components.DragField.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de arrasto**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-51719026a0f7858a) | Field |
| [Esfera](#member-49944cd4d016e8c1) | Field |

<h3 id="member-51719026a0f7858a" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-49944cd4d016e8c1" class="astra-member">Esfera</h3>

```csharp
Esfera = 1
```

**Caminho:** Inspector → Campo de arrasto; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d/
---

# Astra.Components.DragField2D

Campo de arrasto 2D: Amortecimento linear XY e angular de Body2D. Família Física 2D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.DragField2D
```

Campo de arrasto 2D: Amortecimento linear XY e angular de Body2D. Família Física 2D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.DragField2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de arrasto 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de arrasto 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-drag/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ce91ea297c054854) | Method |
| [Remove](#member-3e27043984145f30) | Method |
| [Wrap](#member-4327d582c05e20bf) | Method |
| [AffectedLayer](#member-4cf0af971e585905) | Property |
| [AngularDrag](#member-f4918d1b0154314d) | Property |
| [Component](#member-471012f7d886f372) | Property |
| [Enabled](#member-f741a2d945636cf6) | Property |
| [Falloff](#member-0ea7944c33c1897b) | Property |
| [HalfExtents](#member-a4314a71c1af34f1) | Property |
| [InstanceId](#member-b44586357d405bd2) | Property |
| [IsAlive](#member-61537fe03656d878) | Property |
| [LinearDrag](#member-a9605c2ee30308ec) | Property |
| [Object](#member-f0ebe1f8286324f2) | Property |
| [Offset](#member-343e2ea81ea736ed) | Property |
| [Radius](#member-7143c00105ab217d) | Property |
| [Shape](#member-0999fc596b4bea37) | Property |
| [TypeId](#member-b85eb7e6ae91228d) | Property |
| [WakeBodies](#member-1b8884686e5903c0) | Property |

<h3 id="member-ce91ea297c054854" class="astra-member">.ctor</h3>

```csharp
public DragField2D(Astra.Component component)
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3e27043984145f30" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4327d582c05e20bf" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.DragField2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-4cf0af971e585905" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.DragField2D.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de arrasto 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f4918d1b0154314d" class="astra-member">AngularDrag</h3>

```csharp
public float AngularDrag { get; set; }
```

Arrasto angular (1/s)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Campo de arrasto 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Arrasto angular:** Arrasto angular aplicado pelo campo.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-471012f7d886f372" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f741a2d945636cf6" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de arrasto 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ea7944c33c1897b" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.DragField2D.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de arrasto 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a4314a71c1af34f1" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector2 HalfExtents { get; set; }
```

Meias XY

**Caminho:** Inspector → Campo de arrasto 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b44586357d405bd2" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61537fe03656d878" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9605c2ee30308ec" class="astra-member">LinearDrag</h3>

```csharp
public float LinearDrag { get; set; }
```

Arrasto linear (1/s)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Campo de arrasto 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Arrasto linear:** Arrasto linear aplicado pelo campo.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0ebe1f8286324f2" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-343e2ea81ea736ed" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de arrasto 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7143c00105ab217d" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de arrasto 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0999fc596b4bea37" class="astra-member">Shape</h3>

```csharp
public Astra.Components.DragField2D.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de arrasto 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b85eb7e6ae91228d" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1b8884686e5903c0" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de arrasto 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField2D.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-affectedlayeroption/
---

# Astra.Components.DragField2D.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField2D.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de arrasto 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-a3ffe34f84567e6c) | Field |
| [Camada1](#member-1c4f0eafdb7a9623) | Field |
| [Camada10](#member-c1ed481e2a55ef66) | Field |
| [Camada11](#member-185772397e22e826) | Field |
| [Camada12](#member-8c5810ec7b0805c4) | Field |
| [Camada13](#member-2b08e9b4383880c2) | Field |
| [Camada14](#member-75a321628cff3e10) | Field |
| [Camada15](#member-77290efc54a63a19) | Field |
| [Camada16](#member-fafb4d75cb78ed5b) | Field |
| [Camada17](#member-7d5765be292b14a1) | Field |
| [Camada18](#member-071ab81c4d368266) | Field |
| [Camada19](#member-dceade8582118381) | Field |
| [Camada2](#member-72c1881f3cee6aa7) | Field |
| [Camada20](#member-9f3ac4beb92feadb) | Field |
| [Camada21](#member-afea4364e23a30cd) | Field |
| [Camada22](#member-d536148decd25bdf) | Field |
| [Camada23](#member-19f1aa027f06a09b) | Field |
| [Camada24](#member-0c0a74e973cf0735) | Field |
| [Camada25](#member-eb750f45a9445e5c) | Field |
| [Camada26](#member-ff664717e34ac746) | Field |
| [Camada27](#member-714ccb13152e1f61) | Field |
| [Camada28](#member-d8ba773a74972a6d) | Field |
| [Camada29](#member-7e7d88d8c04d214b) | Field |
| [Camada3](#member-9a46f549251e7aa9) | Field |
| [Camada30](#member-94ddc9db580ab706) | Field |
| [Camada31](#member-f42888df50cbe013) | Field |
| [Camada4](#member-e97660d37b41467f) | Field |
| [Camada5](#member-21e182ba864c2af0) | Field |
| [Camada6](#member-8bfa757fe7af8694) | Field |
| [Camada7](#member-00c8a8a6e849d74a) | Field |
| [Camada8](#member-7e555aa3abc90534) | Field |
| [Camada9](#member-0676d2909eda5a41) | Field |
| [Todas](#member-73263b64e1a86974) | Field |

<h3 id="member-a3ffe34f84567e6c" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1c4f0eafdb7a9623" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c1ed481e2a55ef66" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-185772397e22e826" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c5810ec7b0805c4" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b08e9b4383880c2" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75a321628cff3e10" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-77290efc54a63a19" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fafb4d75cb78ed5b" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d5765be292b14a1" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-071ab81c4d368266" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dceade8582118381" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-72c1881f3cee6aa7" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f3ac4beb92feadb" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-afea4364e23a30cd" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d536148decd25bdf" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-19f1aa027f06a09b" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0c0a74e973cf0735" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb750f45a9445e5c" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff664717e34ac746" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-714ccb13152e1f61" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8ba773a74972a6d" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e7d88d8c04d214b" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9a46f549251e7aa9" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-94ddc9db580ab706" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f42888df50cbe013" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e97660d37b41467f" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-21e182ba864c2af0" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8bfa757fe7af8694" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00c8a8a6e849d74a" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e555aa3abc90534" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0676d2909eda5a41" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-73263b64e1a86974" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField2D.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-falloffoption/
---

# Astra.Components.DragField2D.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField2D.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de arrasto 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-d7785c1e198b1862) | Field |
| [Suave](#member-5ad25b33f2d168d4) | Field |
| [Uniforme](#member-e375a882216cc4f3) | Field |

<h3 id="member-d7785c1e198b1862" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ad25b33f2d168d4" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e375a882216cc4f3" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DragField2D.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-shapeoption/
---

# Astra.Components.DragField2D.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.DragField2D.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de arrasto 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DragField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DragField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Circulo](#member-4859a0fe069aef51) | Field |
| [Retangulo](#member-af54e0c9e12a3f52) | Field |

<h3 id="member-4859a0fe069aef51" class="astra-member">Circulo</h3>

```csharp
Circulo = 1
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af54e0c9e12a3f52" class="astra-member">Retangulo</h3>

```csharp
Retangulo = 0
```

**Caminho:** Inspector → Campo de arrasto 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.DynamicBodyMotor"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dynamicbodymotor/
---

# Astra.Components.DynamicBodyMotor

Motor dinâmico: Locomoção por força e salto com apoio sobre Corpo físico dinâmico. Família Física 3D · Corpos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.DynamicBodyMotor
```

Motor dinâmico: Locomoção por força e salto com apoio sobre Corpo físico dinâmico. Família Física 3D · Corpos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_rigidbody3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.DynamicBodyMotor>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Motor dinâmico**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<DynamicBodyMotor>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new DynamicBodyMotor(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Motor dinâmico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e7a02c47b5be980f) | Method |
| [Remove](#member-21f4dbc8c842b060) | Method |
| [Wrap](#member-8085fc8bfc3f8f02) | Method |
| [Acceleration](#member-3bb4447857462658) | Property |
| [AirControl](#member-dea85d7c0a92204f) | Property |
| [AutomaticSupport](#member-a06cdcdc623d7830) | Property |
| [Braking](#member-83da6d5345ffa8f6) | Property |
| [Component](#member-7b236d73a334579a) | Property |
| [Enabled](#member-2990b77d9e7cede9) | Property |
| [InheritPlatformVelocity](#member-9136b1bd9135aa52) | Property |
| [InstanceId](#member-a065251ccc14a61e) | Property |
| [IsAlive](#member-c9fe9db480a29164) | Property |
| [JumpSpeed](#member-0c8dcdd8af197f57) | Property |
| [MaxSlope](#member-ff64a29ef5fad1bf) | Property |
| [Object](#member-ebad482915ad55c8) | Property |
| [ProbeDistance](#member-0f55a19bec09ddce) | Property |
| [ProbeHeight](#member-70c066d2b93c5e0f) | Property |
| [Speed](#member-ba8c2dfcaf1ba89d) | Property |
| [SupportRadius](#member-629925a74107b497) | Property |
| [TypeId](#member-a26bba12a78da02c) | Property |

<h3 id="member-e7a02c47b5be980f" class="astra-member">.ctor</h3>

```csharp
public DynamicBodyMotor(Astra.Component component)
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-21f4dbc8c842b060" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8085fc8bfc3f8f02" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.DynamicBodyMotor Wrap(Astra.Component component)
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3bb4447857462658" class="astra-member">Acceleration</h3>

```csharp
public float Acceleration { get; set; }
```

Aceleração (m/s²)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Aceleração:** Limita a força de correção para atingir a velocidade alvo; usa a massa real, sem escrever Transform diretamente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dea85d7c0a92204f" class="astra-member">AirControl</h3>

```csharp
public float AirControl { get; set; }
```

Controle no ar

Faixa válida: 0 a 1.

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Controle no ar:** Multiplicador de controle enquanto sem apoio.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a06cdcdc623d7830" class="astra-member">AutomaticSupport</h3>

```csharp
public bool AutomaticSupport { get; set; }
```

Apoio pela colisão. Sonda a superfície real do colisor do solver, com escala, rotação e partes compostas. Cinco amostras; alcance abaixo da forma em metros.

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Apoio pela colisão:** Sonda a superfície real do colisor do solver, com escala, rotação e partes compostas. Cinco amostras; alcance abaixo da forma em metros.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-83da6d5345ffa8f6" class="astra-member">Braking</h3>

```csharp
public float Braking { get; set; }
```

Frenagem (m/s²)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Frenagem:** Limita a correção da velocidade quando não há comando de movimento.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7b236d73a334579a" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2990b77d9e7cede9" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Habilitado

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Habilitado:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9136b1bd9135aa52" class="astra-member">InheritPlatformVelocity</h3>

```csharp
public bool InheritPlatformVelocity { get; set; }
```

Acompanhar plataforma

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Acompanhar plataforma:** Herda velocidade da plataforma de apoio quando permitido.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a065251ccc14a61e" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9fe9db480a29164" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0c8dcdd8af197f57" class="astra-member">JumpSpeed</h3>

```csharp
public float JumpSpeed { get; set; }
```

Velocidade do salto (m/s)

Faixa válida: 0 a 100.

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Velocidade do salto:** Velocidade alvo inicial de salto.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff64a29ef5fad1bf" class="astra-member">MaxSlope</h3>

```csharp
public float MaxSlope { get; set; }
```

Rampa máxima (°)

Faixa válida: 0 a 89.

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Rampa máxima:** Inclinação máxima de apoio do motor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ebad482915ad55c8" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f55a19bec09ddce" class="astra-member">ProbeDistance</h3>

```csharp
public float ProbeDistance { get; set; }
```

Alcance abaixo dos pés (m)

Faixa válida: 0.001 a 2.

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Alcance abaixo dos pés:** Alcance da consulta de apoio.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-70c066d2b93c5e0f" class="astra-member">ProbeHeight</h3>

```csharp
public float ProbeHeight { get; set; }
```

Centro até os pés (m). Usado somente quando Apoio pela colisão está desligado.

Faixa válida: 0.01 a 100.

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Centro até os pés:** Usado somente quando Apoio pela colisão está desligado.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba8c2dfcaf1ba89d" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (m/s)

Faixa válida: 0 a 100.

**Caminho:** Inspector → Motor dinâmico → Locomoção; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-629925a74107b497" class="astra-member">SupportRadius</h3>

```csharp
public float SupportRadius { get; set; }
```

Raio de sondagem (m). Usado somente quando Apoio pela colisão está desligado.

Faixa válida: 0 a 10.

**Caminho:** Inspector → Motor dinâmico → Chão; ou fachada C# em um Behavior.

**Uso:** **Raio de sondagem:** Usado somente quando Apoio pela colisão está desligado.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a26bba12a78da02c" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Motor dinâmico; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EnvironmentVolume"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume/
---

# Astra.Components.EnvironmentVolume

Ambiente: Céu, atmosfera, neblina e pós globais ou por volume. Família Renderização · Ambiente.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.EnvironmentVolume
```

Ambiente: Céu, atmosfera, neblina e pós globais ou por volume. Família Renderização · Ambiente.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/Volumes.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.EnvironmentVolume>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EnvironmentVolume>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EnvironmentVolume(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Ambiente](/pt-br/snapshot-2026-10-06/componentes/astra-render-environment/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-aae0b35a18d8b573) | Method |
| [GetEnvironmentMap](#member-96a33bec6af52dba) | Method |
| [GetProfile](#member-a8b1c6156a07f971) | Method |
| [Remove](#member-a1b7feb7117bb023) | Method |
| [SetEnvironmentMap](#member-28b9144f5d83ffbb) | Method |
| [SetProfile](#member-b3fa3c3110ca5f88) | Method |
| [Wrap](#member-fc5bc45909f9d41d) | Method |
| [AerosolAnisotropy](#member-bb4a646483156225) | Property |
| [AerosolDensity](#member-68b1583ede542771) | Property |
| [AerosolScaleHeightKm](#member-a5c7b75141d05f32) | Property |
| [AirDensity](#member-9cac01a3e1cd01cc) | Property |
| [AmbientOcclusion](#member-b2a2e4f02cb74905) | Property |
| [AmbientOcclusionBias](#member-b7bcfa37ec84603b) | Property |
| [AmbientOcclusionIntensity](#member-19bc66877c6085bd) | Property |
| [AmbientOcclusionPower](#member-6a55125d30ddf785) | Property |
| [AmbientOcclusionRadius](#member-0a86b7c337f3e965) | Property |
| [Atmosphere](#member-f85e71c09c41bafe) | Property |
| [AtmosphereHeightKm](#member-3dd232b321e23dfb) | Property |
| [AutoExposure](#member-150bf6d11ef79fce) | Property |
| [AutoExposureCenterWeighted](#member-612e575638dc7369) | Property |
| [AutoExposureHighPercent](#member-2af33b9297bfb3fb) | Property |
| [AutoExposureLowPercent](#member-d108c7bc9a9dfdba) | Property |
| [AutoExposureMaxEv](#member-a75643116f8ef2b8) | Property |
| [AutoExposureMinEv](#member-c2728fe7cc1228c8) | Property |
| [AutoExposureSpeedDown](#member-06572cfcbfc3c6b7) | Property |
| [AutoExposureSpeedUp](#member-f77281681da15bc8) | Property |
| [AutoExposureTargetGrey](#member-b5a47e0f12934eb6) | Property |
| [BlendDistance](#member-37b62604fddf72b0) | Property |
| [Bloom](#member-47417c9cffa0b261) | Property |
| [BloomIntensity](#member-cc2de476e2c64750) | Property |
| [BloomThreshold](#member-64b19e98d6b94632) | Property |
| [BoxSize](#member-a9b22b99816e4192) | Property |
| [Component](#member-38faac38a83fed68) | Property |
| [Contrast](#member-345b6b409a5f219c) | Property |
| [Enabled](#member-1f9919dcf8b4ba51) | Property |
| [ExposureEv](#member-f722e055dc2aec13) | Property |
| [FilmGrain](#member-fe6326087f429cef) | Property |
| [FilmGrainIntensity](#member-53adf0ae46a23144) | Property |
| [Fog](#member-3a9aad49bca28179) | Property |
| [FogBaseHeight](#member-6d9eb7f566b5a906) | Property |
| [FogColor](#member-a971b3cf6b51a2f4) | Property |
| [FogDensity](#member-27294c3b79b9ccd1) | Property |
| [FogHeightFalloff](#member-eb88c8a8ad7fbc88) | Property |
| [FogLightEnergy](#member-b26369556c404ded) | Property |
| [FogStart](#member-63c05a0aa816018d) | Property |
| [Ground](#member-3d15e698631b75ed) | Property |
| [GroundAlbedo](#member-145d862725eb16dc) | Property |
| [HdriExposureEv](#member-eec4341df306dec8) | Property |
| [HdriRotationDegrees](#member-db8969a304c65eeb) | Property |
| [IndirectDiffuse](#member-13ce96dcf3bacc04) | Property |
| [IndirectSpecular](#member-d0cf7fcbd3cc8c76) | Property |
| [InstanceId](#member-d1884675ad7191ae) | Property |
| [IsAlive](#member-9b8addbd989eda6a) | Property |
| [Object](#member-b09c8f0635398642) | Property |
| [ObserverHeightKm](#member-10a09fa306fc42e2) | Property |
| [OverrideFog](#member-27930a5f2c190742) | Property |
| [OverrideIndirect](#member-609aa3a23eefffc4) | Property |
| [OverridePost](#member-3e9334ba6a90f868) | Property |
| [OverrideSky](#member-de5165cee458794c) | Property |
| [PhysicalAtmosphereHighQuality](#member-05d8decd832634dc) | Property |
| [PhysicalSkyIntensity](#member-dadda510f8663cea) | Property |
| [PlanetRadiusKm](#member-bfffb47e1c0d2089) | Property |
| [Post](#member-9f2a65a67dfe3fd8) | Property |
| [Priority](#member-0b6aae482eb04408) | Property |
| [RayleighScaleHeightKm](#member-3022153199a71b0e) | Property |
| [Saturation](#member-74ffff1493f5af84) | Property |
| [Sky](#member-75855762525493eb) | Property |
| [SkyHorizon](#member-0859d4067c8ffb99) | Property |
| [SkyZenith](#member-d66ab0280d022744) | Property |
| [SphereRadius](#member-5a8b5278453379d3) | Property |
| [SunDiskDegrees](#member-c0241ffc4e16d4c0) | Property |
| [SunDiskIntensity](#member-57fef3399132e5c8) | Property |
| [ToneMapper](#member-121948131c8bfa60) | Property |
| [TypeId](#member-5531f76dd6844b1d) | Property |
| [Vignette](#member-4a1d03589141bf13) | Property |
| [VignetteIntensity](#member-c63ff4eb5341b28b) | Property |
| [VolumeLayer](#member-f279314125f2bdc0) | Property |
| [VolumeShape](#member-717d7fa80220c5a5) | Property |
| [Weight](#member-a71c8a464e8c25b5) | Property |

<h3 id="member-aae0b35a18d8b573" class="astra-member">.ctor</h3>

```csharp
public EnvironmentVolume(Astra.Component component)
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-96a33bec6af52dba" class="astra-member">GetEnvironmentMap</h3>

```csharp
public Astra.AssetGuid GetEnvironmentMap(uint slot = 0)
```

Mapa HDRI. Recurso do projeto por slot

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Mapa HDRI. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a8b1c6156a07f971" class="astra-member">GetProfile</h3>

```csharp
public Astra.AssetGuid GetProfile(uint slot = 0)
```

Perfil. Recurso do projeto por slot

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Perfil. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a1b7feb7117bb023" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-28b9144f5d83ffbb" class="astra-member">SetEnvironmentMap</h3>

```csharp
public void SetEnvironmentMap(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-b3fa3c3110ca5f88" class="astra-member">SetProfile</h3>

```csharp
public void SetProfile(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-fc5bc45909f9d41d" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.EnvironmentVolume Wrap(Astra.Component component)
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-bb4a646483156225" class="astra-member">AerosolAnisotropy</h3>

```csharp
public float AerosolAnisotropy { get; set; }
```

Anisotropia dos aerossóis (g)

Faixa válida: 0 a 0.95.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Anisotropia dos aerossóis:** Anisotropia da dispersão de aerosol.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68b1583ede542771" class="astra-member">AerosolDensity</h3>

```csharp
public float AerosolDensity { get; set; }
```

Densidade de aerossóis (×)

Faixa válida: 0 a 8.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Densidade de aerossóis:** Densidade do aerosol usada pelo céu físico.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a5c7b75141d05f32" class="astra-member">AerosolScaleHeightKm</h3>

```csharp
public float AerosolScaleHeightKm { get; set; }
```

Escala de aerossóis (km)

Faixa válida: 0.05 a 50.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Escala de aerossóis:** Altura característica do aerosol.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9cac01a3e1cd01cc" class="astra-member">AirDensity</h3>

```csharp
public float AirDensity { get; set; }
```

Densidade do ar (×)

Faixa válida: 0 a 8.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Densidade do ar:** Densidade do ar usada pelo céu físico.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b2a2e4f02cb74905" class="astra-member">AmbientOcclusion</h3>

```csharp
public bool AmbientOcclusion { get; set; }
```

Oclusão ambiente. Escurece contatos e concavidades a partir da profundidade da câmera

**Caminho:** Inspector → Ambiente → Oclusão ambiente; ou fachada C# em um Behavior.

**Uso:** **Oclusão ambiente:** Escurece contatos e concavidades a partir da profundidade da câmera

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b7bcfa37ec84603b" class="astra-member">AmbientOcclusionBias</h3>

```csharp
public float AmbientOcclusionBias { get; set; }
```

Viés (m)

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Oclusão ambiente; ou fachada C# em um Behavior.

**Uso:** **Viés:** Bias para evitar auto oclusão excessiva.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-19bc66877c6085bd" class="astra-member">AmbientOcclusionIntensity</h3>

```csharp
public float AmbientOcclusionIntensity { get; set; }
```

Intensidade

Faixa válida: 0 a 4.

**Caminho:** Inspector → Ambiente → Oclusão ambiente; ou fachada C# em um Behavior.

**Uso:** **Intensidade:** Peso visual do AO global.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a55125d30ddf785" class="astra-member">AmbientOcclusionPower</h3>

```csharp
public float AmbientOcclusionPower { get; set; }
```

Potência

Faixa válida: 0.1 a 4.

**Caminho:** Inspector → Ambiente → Oclusão ambiente; ou fachada C# em um Behavior.

**Uso:** **Potência:** Curva de contraste do AO.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0a86b7c337f3e965" class="astra-member">AmbientOcclusionRadius</h3>

```csharp
public float AmbientOcclusionRadius { get; set; }
```

Raio (m)

Faixa válida: 0.05 a 10.

**Caminho:** Inspector → Ambiente → Oclusão ambiente; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio de amostragem do AO global.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f85e71c09c41bafe" class="astra-member">Atmosphere</h3>

```csharp
public float Atmosphere { get; set; }
```

Força atmosférica

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Força atmosférica:** Quantidade da contribuição atmosférica no modelo de céu selecionado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3dd232b321e23dfb" class="astra-member">AtmosphereHeightKm</h3>

```csharp
public float AtmosphereHeightKm { get; set; }
```

Altura da atmosfera (km)

Faixa válida: 1 a 1000.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Altura da atmosfera:** Espessura da atmosfera do modelo.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-150bf6d11ef79fce" class="astra-member">AutoExposure</h3>

```csharp
public bool AutoExposure { get; set; }
```

Exposição automática. Mede luminância HDR e adapta a exposição por câmera

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Exposição automática:** Mede luminância HDR e adapta a exposição por câmera

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-612e575638dc7369" class="astra-member">AutoExposureCenterWeighted</h3>

```csharp
public bool AutoExposureCenterWeighted { get; set; }
```

Peso central. Prioriza o centro da imagem na medição

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Peso central:** Prioriza o centro da imagem na medição

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2af33b9297bfb3fb" class="astra-member">AutoExposureHighPercent</h3>

```csharp
public float AutoExposureHighPercent { get; set; }
```

Corte alto

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Corte alto:** Percentil superior do histograma para auto exposição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d108c7bc9a9dfdba" class="astra-member">AutoExposureLowPercent</h3>

```csharp
public float AutoExposureLowPercent { get; set; }
```

Corte baixo

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Corte baixo:** Percentil inferior do histograma para auto exposição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a75643116f8ef2b8" class="astra-member">AutoExposureMaxEv</h3>

```csharp
public float AutoExposureMaxEv { get; set; }
```

EV máximo (EV)

Faixa válida: -16 a 16.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **EV máximo:** Limite superior de exposição automática.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2728fe7cc1228c8" class="astra-member">AutoExposureMinEv</h3>

```csharp
public float AutoExposureMinEv { get; set; }
```

EV mínimo (EV)

Faixa válida: -16 a 16.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **EV mínimo:** Limite inferior de exposição automática.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-06572cfcbfc3c6b7" class="astra-member">AutoExposureSpeedDown</h3>

```csharp
public float AutoExposureSpeedDown { get; set; }
```

Velocidade ao clarear (EV/s)

Faixa válida: 0.01 a 20.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Velocidade ao clarear:** Velocidade de adaptação ao reduzir exposição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f77281681da15bc8" class="astra-member">AutoExposureSpeedUp</h3>

```csharp
public float AutoExposureSpeedUp { get; set; }
```

Velocidade ao escurecer (EV/s)

Faixa válida: 0.01 a 20.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Velocidade ao escurecer:** Velocidade de adaptação ao elevar exposição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5a47e0f12934eb6" class="astra-member">AutoExposureTargetGrey</h3>

```csharp
public float AutoExposureTargetGrey { get; set; }
```

Cinza alvo

Faixa válida: 0.01 a 1.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Cinza alvo:** Nível cinza alvo da medição automática.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-37b62604fddf72b0" class="astra-member">BlendDistance</h3>

```csharp
public float BlendDistance { get; set; }
```

Distância de mistura (m)

Faixa válida: 0 a 100000.

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Distância de mistura:** Distância de mistura na borda do volume de ambiente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47417c9cffa0b261" class="astra-member">Bloom</h3>

```csharp
public bool Bloom { get; set; }
```

Bloom. Espalha altas luzes antes do tonemap

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Bloom:** Espalha altas luzes antes do tonemap

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc2de476e2c64750" class="astra-member">BloomIntensity</h3>

```csharp
public float BloomIntensity { get; set; }
```

Intensidade do bloom

Faixa válida: 0 a 2.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Intensidade do bloom:** Intensidade do bloom habilitado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-64b19e98d6b94632" class="astra-member">BloomThreshold</h3>

```csharp
public float BloomThreshold { get; set; }
```

Limiar do bloom

Faixa válida: 0 a 64.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Limiar do bloom:** Limiar de brilho que participa do bloom.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9b22b99816e4192" class="astra-member">BoxSize</h3>

```csharp
public System.Numerics.Vector3 BoxSize { get; set; }
```

Tamanho da caixa

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Tamanho X:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente. **Tamanho Y:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente. **Tamanho Z:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38faac38a83fed68" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-345b6b409a5f219c" class="astra-member">Contrast</h3>

```csharp
public float Contrast { get; set; }
```

Contraste

Faixa válida: 0.5 a 2.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Contraste:** Contraste do pós-processamento.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f9919dcf8b4ba51" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo. Participa da seleção por prioridade

**Caminho:** Inspector → Ambiente → Geral; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Participa da seleção por prioridade

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f722e055dc2aec13" class="astra-member">ExposureEv</h3>

```csharp
public float ExposureEv { get; set; }
```

Compensação (EV)

Faixa válida: -16 a 16.

**Caminho:** Inspector → Ambiente → Exposição; ou fachada C# em um Behavior.

**Uso:** **Compensação:** Exposição manual em EV antes do tonemapping; compare com auto exposição desligada.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fe6326087f429cef" class="astra-member">FilmGrain</h3>

```csharp
public bool FilmGrain { get; set; }
```

Grão de filme. Adiciona grão sensível à luminância depois da resolução temporal

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Grão de filme:** Adiciona grão sensível à luminância depois da resolução temporal

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53adf0ae46a23144" class="astra-member">FilmGrainIntensity</h3>

```csharp
public float FilmGrainIntensity { get; set; }
```

Intensidade do grão

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Intensidade do grão:** Força do grain habilitado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3a9aad49bca28179" class="astra-member">Fog</h3>

```csharp
public bool Fog { get; set; }
```

Neblina. Aplica neblina exponencial uniforme ou com decaimento por altura

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Neblina:** Aplica neblina exponencial uniforme ou com decaimento por altura

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d9eb7f566b5a906" class="astra-member">FogBaseHeight</h3>

```csharp
public float FogBaseHeight { get; set; }
```

Altura base (m)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Altura base:** Altura de referência da neblina de altura.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a971b3cf6b51a2f4" class="astra-member">FogColor</h3>

```csharp
public System.Numerics.Vector3 FogColor { get; set; }
```

Cor da neblina. Cor linear RGB

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Neblina R:** Canal R da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente. **Neblina G:** Canal G da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente. **Neblina B:** Canal B da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-27294c3b79b9ccd1" class="astra-member">FogDensity</h3>

```csharp
public float FogDensity { get; set; }
```

Densidade (1/m)

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Densidade:** Densidade da neblina; aumentar reduz visibilidade ao longo do percurso.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb88c8a8ad7fbc88" class="astra-member">FogHeightFalloff</h3>

```csharp
public float FogHeightFalloff { get; set; }
```

Decaimento por altura (1/m)

Faixa válida: 0 a 10.

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Decaimento por altura:** Queda da densidade conforme altura.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b26369556c404ded" class="astra-member">FogLightEnergy</h3>

```csharp
public float FogLightEnergy { get; set; }
```

Energia da neblina (×)

Faixa válida: 0 a 65504.

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Energia da neblina:** Energia de luz na neblina conforme o modelo de fog.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-63c05a0aa816018d" class="astra-member">FogStart</h3>

```csharp
public float FogStart { get; set; }
```

Início (m)

Faixa válida: 0 a 10000.

**Caminho:** Inspector → Ambiente → Neblina; ou fachada C# em um Behavior.

**Uso:** **Início:** Distância a partir da qual a neblina começa.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d15e698631b75ed" class="astra-member">Ground</h3>

```csharp
public System.Numerics.Vector3 Ground { get; set; }
```

Cor do chão. Cor linear RGB

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Chão R:** Canal R da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente. **Chão G:** Canal G da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente. **Chão B:** Canal B da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-145d862725eb16dc" class="astra-member">GroundAlbedo</h3>

```csharp
public float GroundAlbedo { get; set; }
```

Albedo médio do solo

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Albedo médio do solo:** Refletância do chão do céu físico.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eec4341df306dec8" class="astra-member">HdriExposureEv</h3>

```csharp
public float HdriExposureEv { get; set; }
```

Exposição HDRI (EV)

Faixa válida: -16 a 16.

**Caminho:** Inspector → Ambiente → HDRI; ou fachada C# em um Behavior.

**Uso:** **Exposição HDRI:** Exposição do recurso HDRI em EV.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db8969a304c65eeb" class="astra-member">HdriRotationDegrees</h3>

```csharp
public float HdriRotationDegrees { get; set; }
```

Rotação HDRI (°)

Faixa válida: -360 a 360.

**Caminho:** Inspector → Ambiente → HDRI; ou fachada C# em um Behavior.

**Uso:** **Rotação HDRI:** Gira a orientação do ambiente HDRI em graus.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-13ce96dcf3bacc04" class="astra-member">IndirectDiffuse</h3>

```csharp
public float IndirectDiffuse { get; set; }
```

Difuso indireto (×)

Faixa válida: 0 a 4.

**Caminho:** Inspector → Ambiente → Luz indireta; ou fachada C# em um Behavior.

**Uso:** **Difuso indireto:** Escala da iluminação indireta difusa disponível; não calcula GI bake.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d0cf7fcbd3cc8c76" class="astra-member">IndirectSpecular</h3>

```csharp
public float IndirectSpecular { get; set; }
```

Reflexo indireto (×)

Faixa válida: 0 a 4.

**Caminho:** Inspector → Ambiente → Luz indireta; ou fachada C# em um Behavior.

**Uso:** **Reflexo indireto:** Escala do reflexo especular do ambiente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1884675ad7191ae" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b8addbd989eda6a" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b09c8f0635398642" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10a09fa306fc42e2" class="astra-member">ObserverHeightKm</h3>

```csharp
public float ObserverHeightKm { get; set; }
```

Altura do observador (km)

Faixa válida: 0 a 1000.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Altura do observador:** Altura do observador atmosférico em km.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-27930a5f2c190742" class="astra-member">OverrideFog</h3>

```csharp
public bool OverrideFog { get; set; }
```

Sobrescrever neblina. Participa da mistura de neblina

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Sobrescrever neblina:** Participa da mistura de neblina

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-609aa3a23eefffc4" class="astra-member">OverrideIndirect</h3>

```csharp
public bool OverrideIndirect { get; set; }
```

Sobrescrever luz indireta. Participa da mistura de difuso e reflexo indiretos

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Sobrescrever luz indireta:** Participa da mistura de difuso e reflexo indiretos

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e9334ba6a90f868" class="astra-member">OverridePost</h3>

```csharp
public bool OverridePost { get; set; }
```

Sobrescrever pós. Participa da mistura de exposição e pós

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Sobrescrever pós:** Participa da mistura de exposição e pós

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-de5165cee458794c" class="astra-member">OverrideSky</h3>

```csharp
public bool OverrideSky { get; set; }
```

Sobrescrever céu. Participa da mistura de céu e atmosfera

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Sobrescrever céu:** Participa da mistura de céu e atmosfera

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-05d8decd832634dc" class="astra-member">PhysicalAtmosphereHighQuality</h3>

```csharp
public bool PhysicalAtmosphereHighQuality { get; set; }
```

Alta qualidade. Aumenta as amostras de vista e luz; custa mais GPU

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Alta qualidade:** Aumenta as amostras de vista e luz; custa mais GPU

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dadda510f8663cea" class="astra-member">PhysicalSkyIntensity</h3>

```csharp
public float PhysicalSkyIntensity { get; set; }
```

Intensidade (×)

Faixa válida: 0 a 16.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Intensidade:** Multiplica a energia do céu físico.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bfffb47e1c0d2089" class="astra-member">PlanetRadiusKm</h3>

```csharp
public float PlanetRadiusKm { get; set; }
```

Raio do planeta (km)

Faixa válida: 1 a 100000.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Raio do planeta:** Raio do planeta do modelo atmosférico em km.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f2a65a67dfe3fd8" class="astra-member">Post</h3>

```csharp
public bool Post { get; set; }
```

Pós-processamento. Ativa os overrides autorais desta cena

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Pós-processamento:** Ativa os overrides autorais desta cena

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0b6aae482eb04408" class="astra-member">Priority</h3>

```csharp
public float Priority { get; set; }
```

Prioridade

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Ambiente → Geral; ou fachada C# em um Behavior.

**Uso:** **Prioridade:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3022153199a71b0e" class="astra-member">RayleighScaleHeightKm</h3>

```csharp
public float RayleighScaleHeightKm { get; set; }
```

Escala Rayleigh (km)

Faixa válida: 0.1 a 100.

**Caminho:** Inspector → Ambiente → Atmosfera física; ou fachada C# em um Behavior.

**Uso:** **Escala Rayleigh:** Altura característica da dispersão Rayleigh.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74ffff1493f5af84" class="astra-member">Saturation</h3>

```csharp
public float Saturation { get; set; }
```

Saturação

Faixa válida: 0 a 2.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Saturação:** Saturação do pós-processamento.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75855762525493eb" class="astra-member">Sky</h3>

```csharp
public Astra.Components.EnvironmentVolume.SkyOption Sky { get; set; }
```

Céu. Fonte visual do céu

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Céu:** Fonte visual do céu

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0859d4067c8ffb99" class="astra-member">SkyHorizon</h3>

```csharp
public System.Numerics.Vector3 SkyHorizon { get; set; }
```

Cor do horizonte. Cor linear RGB

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Horizonte R:** Canal R da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente. **Horizonte G:** Canal G da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente. **Horizonte B:** Canal B da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d66ab0280d022744" class="astra-member">SkyZenith</h3>

```csharp
public System.Numerics.Vector3 SkyZenith { get; set; }
```

Cor do zênite. Cor linear RGB

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Zênite R:** Canal R da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente. **Zênite G:** Canal G da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente. **Zênite B:** Canal B da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5a8b5278453379d3" class="astra-member">SphereRadius</h3>

```csharp
public float SphereRadius { get; set; }
```

Raio (m)

Faixa válida: 0.01 a 100000.

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio do volume esférico, quando esse shape está selecionado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c0241ffc4e16d4c0" class="astra-member">SunDiskDegrees</h3>

```csharp
public float SunDiskDegrees { get; set; }
```

Diâmetro do sol (°)

Faixa válida: 0.05 a 10.

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Diâmetro do sol:** Tamanho angular do disco solar desenhado no céu.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57fef3399132e5c8" class="astra-member">SunDiskIntensity</h3>

```csharp
public float SunDiskIntensity { get; set; }
```

Brilho do disco solar

Faixa válida: 0 a 100.

**Caminho:** Inspector → Ambiente → Atmosfera; ou fachada C# em um Behavior.

**Uso:** **Brilho do disco solar:** Brilho do disco solar; não substitui a intensidade de uma luz direcional.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-121948131c8bfa60" class="astra-member">ToneMapper</h3>

```csharp
public Astra.Components.EnvironmentVolume.ToneMapperOption ToneMapper { get; set; }
```

Tonemapping. Curva aplicada ao HDR antes da saída

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Tonemapping:** Curva aplicada ao HDR antes da saída

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5531f76dd6844b1d" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a1d03589141bf13" class="astra-member">Vignette</h3>

```csharp
public bool Vignette { get; set; }
```

Vinheta. Escurece gradualmente as bordas

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Vinheta:** Escurece gradualmente as bordas

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c63ff4eb5341b28b" class="astra-member">VignetteIntensity</h3>

```csharp
public float VignetteIntensity { get; set; }
```

Intensidade da vinheta

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Pós; ou fachada C# em um Behavior.

**Uso:** **Intensidade da vinheta:** Força da vinheta habilitada.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f279314125f2bdc0" class="astra-member">VolumeLayer</h3>

```csharp
public Astra.Components.EnvironmentVolume.VolumeLayerOption VolumeLayer { get; set; }
```

Camada. Filtro consultado pela câmera

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Camada:** Filtro consultado pela câmera

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-717d7fa80220c5a5" class="astra-member">VolumeShape</h3>

```csharp
public Astra.Components.EnvironmentVolume.VolumeShapeOption VolumeShape { get; set; }
```

Modo. Global afeta toda vista; formas usam o Transform do objeto

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Modo:** Global afeta toda vista; formas usam o Transform do objeto

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a71c8a464e8c25b5" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Ambiente → Volume; ou fachada C# em um Behavior.

**Uso:** **Peso:** Peso da mistura do volume, combinado com shape, distância e prioridade.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EnvironmentVolume.SkyOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-skyoption/
---

# Astra.Components.EnvironmentVolume.SkyOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EnvironmentVolume.SkyOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EnvironmentVolume>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EnvironmentVolume(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Atmosfera](#member-b9b7f52f243c4619) | Field |
| [AtmosferaFisica](#member-d38c6a35866c2d14) | Field |
| [HDRI](#member-0703094f278dab99) | Field |

<h3 id="member-b9b7f52f243c4619" class="astra-member">Atmosfera</h3>

```csharp
Atmosfera = 1
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d38c6a35866c2d14" class="astra-member">AtmosferaFisica</h3>

```csharp
AtmosferaFisica = 2
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0703094f278dab99" class="astra-member">HDRI</h3>

```csharp
HDRI = 0
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EnvironmentVolume.ToneMapperOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-tonemapperoption/
---

# Astra.Components.EnvironmentVolume.ToneMapperOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EnvironmentVolume.ToneMapperOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EnvironmentVolume>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EnvironmentVolume(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ACES](#member-d6708e1ac1a61800) | Field |
| [AgX](#member-8b41198faefe0f38) | Field |
| [Reinhard](#member-6c9331cac1c4fa55) | Field |

<h3 id="member-d6708e1ac1a61800" class="astra-member">ACES</h3>

```csharp
ACES = 1
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8b41198faefe0f38" class="astra-member">AgX</h3>

```csharp
AgX = 2
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6c9331cac1c4fa55" class="astra-member">Reinhard</h3>

```csharp
Reinhard = 0
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EnvironmentVolume.VolumeLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-volumelayeroption/
---

# Astra.Components.EnvironmentVolume.VolumeLayerOption

Enum da API C# da Astra. 8 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EnvironmentVolume.VolumeLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EnvironmentVolume>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EnvironmentVolume(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Ambiente0](#member-ca68c634324f2555) | Field |
| [Ambiente1](#member-66cffcb83579c03b) | Field |
| [Ambiente2](#member-1f05cd2f81564011) | Field |
| [Ambiente3](#member-ebb63ecd640ac88f) | Field |
| [Ambiente4](#member-b8e30cde840d1e9c) | Field |
| [Ambiente5](#member-6c5e430ee44ea2d5) | Field |
| [Ambiente6](#member-32ad8c227caa5bee) | Field |
| [Ambiente7](#member-3158e56e8fe98af6) | Field |

<h3 id="member-ca68c634324f2555" class="astra-member">Ambiente0</h3>

```csharp
Ambiente0 = 0
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66cffcb83579c03b" class="astra-member">Ambiente1</h3>

```csharp
Ambiente1 = 1
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f05cd2f81564011" class="astra-member">Ambiente2</h3>

```csharp
Ambiente2 = 2
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ebb63ecd640ac88f" class="astra-member">Ambiente3</h3>

```csharp
Ambiente3 = 3
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b8e30cde840d1e9c" class="astra-member">Ambiente4</h3>

```csharp
Ambiente4 = 4
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6c5e430ee44ea2d5" class="astra-member">Ambiente5</h3>

```csharp
Ambiente5 = 5
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-32ad8c227caa5bee" class="astra-member">Ambiente6</h3>

```csharp
Ambiente6 = 6
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3158e56e8fe98af6" class="astra-member">Ambiente7</h3>

```csharp
Ambiente7 = 7
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EnvironmentVolume.VolumeShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-volumeshapeoption/
---

# Astra.Components.EnvironmentVolume.VolumeShapeOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EnvironmentVolume.VolumeShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EnvironmentVolume>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EnvironmentVolume(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-b3228cd9d7d1c6e5) | Field |
| [Esfera](#member-e15c5dbc803dc06e) | Field |
| [Global](#member-996175f673e9e0a9) | Field |

<h3 id="member-b3228cd9d7d1c6e5" class="astra-member">Caixa</h3>

```csharp
Caixa = 1
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e15c5dbc803dc06e" class="astra-member">Esfera</h3>

```csharp
Esfera = 2
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-996175f673e9e0a9" class="astra-member">Global</h3>

```csharp
Global = 0
```

**Caminho:** Inspector → Ambiente; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EventConnection"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection/
---

# Astra.Components.EventConnection

Conexão de evento: Evento deste objeto aciona objetos ou métodos, sem script. Família Lógica · Eventos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.EventConnection
```

Conexão de evento: Evento deste objeto aciona objetos ou métodos, sem script. Família Lógica · Eventos.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Events.UnityEvent.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.EventConnection>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Eventos** → **Conexão de evento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EventConnection>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EventConnection(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Conexão de evento](/pt-br/snapshot-2026-10-06/componentes/astra-logic-event-connection/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-8d0beb9b8222dcf1) | Method |
| [Remove](#member-327a3a9bf1a07477) | Method |
| [Wrap](#member-c1bb822174b4516a) | Method |
| [Action](#member-7affb2398b90de51) | Property |
| [Argument](#member-8fd6b6d68b86c7cf) | Property |
| [Component](#member-8ca39f5fd200533d) | Property |
| [Enabled](#member-55f3e3a981c9b959) | Property |
| [Event](#member-400ce82a7d89bd0d) | Property |
| [InstanceId](#member-0ee502b31fb1692a) | Property |
| [IsAlive](#member-1500962dbec6d137) | Property |
| [Method](#member-e4e761da48d99c4d) | Property |
| [Object](#member-42ccd9b5a249d7c1) | Property |
| [Once](#member-e91ed1e0f30bd272) | Property |
| [OtherFilter](#member-2716c46bc99b2b93) | Property |
| [Receiver](#member-9315d8ba906081f2) | Property |
| [TypeId](#member-b86b04b006156d1b) | Property |

<h3 id="member-8d0beb9b8222dcf1" class="astra-member">.ctor</h3>

```csharp
public EventConnection(Astra.Component component)
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-327a3a9bf1a07477" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c1bb822174b4516a" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.EventConnection Wrap(Astra.Component component)
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-7affb2398b90de51" class="astra-member">Action</h3>

```csharp
public Astra.Components.EventConnection.ActionOption Action { get; set; }
```

Ação. Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

**Caminho:** Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

**Uso:** **Ação:** Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8fd6b6d68b86c7cf" class="astra-member">Argument</h3>

```csharp
public float Argument { get; set; }
```

Valor (s). Timer: intervalo (zero usa o autorado). Áudio: posição do cursor

Faixa válida: 0 a 3600.

**Caminho:** Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

**Uso:** **Valor:** Timer: intervalo (zero usa o autorado). Áudio: posição do cursor

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8ca39f5fd200533d" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55f3e3a981c9b959" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativa. Desligada não reage a eventos; a configuração é preservada

**Caminho:** Inspector → Conexão de evento → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ativa:** Desligada não reage a eventos; a configuração é preservada

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-400ce82a7d89bd0d" class="astra-member">Event</h3>

```csharp
public Astra.Components.EventConnection.EventOption Event { get; set; }
```

Evento. Emitido por um componente deste objeto; sem o componente, a conexão não dispara

**Caminho:** Inspector → Conexão de evento → Quando; ou fachada C# em um Behavior.

**Uso:** **Evento:** Emitido por um componente deste objeto; sem o componente, a conexão não dispara

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ee502b31fb1692a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1500962dbec6d137" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e4e761da48d99c4d" class="astra-member">Method</h3>

```csharp
public Astra.Components.EventConnection.MethodOption Method { get; set; }
```

Método. Chamado no primeiro componente do tipo correspondente no receptor

**Caminho:** Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

**Uso:** **Método:** Chamado no primeiro componente do tipo correspondente no receptor

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42ccd9b5a249d7c1" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e91ed1e0f30bd272" class="astra-member">Once</h3>

```csharp
public bool Once { get; set; }
```

Uma vez. Reage só ao primeiro evento de cada execução de Play

**Caminho:** Inspector → Conexão de evento → Conexão; ou fachada C# em um Behavior.

**Uso:** **Uma vez:** Reage só ao primeiro evento de cada execução de Play

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2716c46bc99b2b93" class="astra-member">OtherFilter</h3>

```csharp
public Astra.ObjectReference OtherFilter { get; set; }
```

Outro objeto. Opcional: só contatos com este outro objeto

**Caminho:** Inspector → Conexão de evento → Quando; ou fachada C# em um Behavior.

**Uso:** **Outro objeto:** Opcional: só contatos com este outro objeto

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9315d8ba906081f2" class="astra-member">Receiver</h3>

```csharp
public Astra.ObjectReference Receiver { get; set; }
```

Receptor. Objeto ativado ou dono do componente chamado; vazio usa o próprio emissor

**Caminho:** Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

**Uso:** **Receptor:** Objeto ativado ou dono do componente chamado; vazio usa o próprio emissor

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b86b04b006156d1b" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EventConnection.ActionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-actionoption/
---

# Astra.Components.EventConnection.ActionOption

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EventConnection.ActionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Eventos** → **Conexão de evento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EventConnection>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EventConnection(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlternarObjeto](#member-4fdb98a58a8a2f47) | Field |
| [AtivarObjeto](#member-b772cac0b3611aff) | Field |
| [ChamarMetodo](#member-31d7e55b7e0e4a6b) | Field |
| [DesativarObjeto](#member-9dff749eebd78c6d) | Field |
| [Desconectado](#member-4413e54f4e2564a8) | Field |

<h3 id="member-4fdb98a58a8a2f47" class="astra-member">AlternarObjeto</h3>

```csharp
AlternarObjeto = 3
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b772cac0b3611aff" class="astra-member">AtivarObjeto</h3>

```csharp
AtivarObjeto = 1
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-31d7e55b7e0e4a6b" class="astra-member">ChamarMetodo</h3>

```csharp
ChamarMetodo = 4
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9dff749eebd78c6d" class="astra-member">DesativarObjeto</h3>

```csharp
DesativarObjeto = 2
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4413e54f4e2564a8" class="astra-member">Desconectado</h3>

```csharp
Desconectado = 0
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EventConnection.EventOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-eventoption/
---

# Astra.Components.EventConnection.EventOption

Enum da API C# da Astra. 11 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EventConnection.EventOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Eventos** → **Conexão de evento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EventConnection>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EventConnection(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Colisao2DComecou](#member-7f166881e0f26631) | Field |
| [Colisao2DTerminou](#member-38281b2bfc56d0df) | Field |
| [Colisao3DComecou](#member-7c1507ae57c936df) | Field |
| [Colisao3DTerminou](#member-7239d36158e379e1) | Field |
| [Nenhum](#member-0fb23f349ebe6c5a) | Field |
| [Sensor2DEntrou](#member-de71ee5f77f02fff) | Field |
| [Sensor2DSaiu](#member-75e047467e49da64) | Field |
| [Sensor3DEntrou](#member-146e9aaf7419b270) | Field |
| [Sensor3DSaiu](#member-3139635b58d1ae36) | Field |
| [TimerDisparou](#member-b51def407379056a) | Field |
| [TweenConcluiu](#member-50e5240e37289091) | Field |

<h3 id="member-7f166881e0f26631" class="astra-member">Colisao2DComecou</h3>

```csharp
Colisao2DComecou = 9
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38281b2bfc56d0df" class="astra-member">Colisao2DTerminou</h3>

```csharp
Colisao2DTerminou = 10
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c1507ae57c936df" class="astra-member">Colisao3DComecou</h3>

```csharp
Colisao3DComecou = 5
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7239d36158e379e1" class="astra-member">Colisao3DTerminou</h3>

```csharp
Colisao3DTerminou = 6
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0fb23f349ebe6c5a" class="astra-member">Nenhum</h3>

```csharp
Nenhum = 0
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-de71ee5f77f02fff" class="astra-member">Sensor2DEntrou</h3>

```csharp
Sensor2DEntrou = 7
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75e047467e49da64" class="astra-member">Sensor2DSaiu</h3>

```csharp
Sensor2DSaiu = 8
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-146e9aaf7419b270" class="astra-member">Sensor3DEntrou</h3>

```csharp
Sensor3DEntrou = 3
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3139635b58d1ae36" class="astra-member">Sensor3DSaiu</h3>

```csharp
Sensor3DSaiu = 4
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b51def407379056a" class="astra-member">TimerDisparou</h3>

```csharp
TimerDisparou = 1
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50e5240e37289091" class="astra-member">TweenConcluiu</h3>

```csharp
TweenConcluiu = 2
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.EventConnection.MethodOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-methodoption/
---

# Astra.Components.EventConnection.MethodOption

Enum da API C# da Astra. 16 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.EventConnection.MethodOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Eventos** → **Conexão de evento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<EventConnection>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new EventConnection(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AudioParar](#member-7c95caf26409c255) | Field |
| [AudioPausar](#member-1b72e2684a881a30) | Field |
| [AudioPosicionar](#member-df2980d8bb78678b) | Field |
| [AudioRetomar](#member-ba0da0a64206147e) | Field |
| [AudioTocar](#member-68d678f5553de84c) | Field |
| [Nenhum](#member-ecf6ea410a36d8f7) | Field |
| [PercursoParar](#member-52c2d73ef4025d1f) | Field |
| [PercursoReiniciar](#member-dc9efaf0ba1e9e97) | Field |
| [TimerIniciar](#member-8bbe06072ee038a0) | Field |
| [TimerParar](#member-e76d43c5aaca4ae7) | Field |
| [TimerPausar](#member-52a101e5ef3dee1c) | Field |
| [TimerRetomar](#member-319c8b6f48f53fd3) | Field |
| [TweenCancelar](#member-260a0f0f9acc1210) | Field |
| [TweenPausar](#member-6b511dffcd353fc6) | Field |
| [TweenReiniciar](#member-30fc2df833ef23ff) | Field |
| [TweenRetomar](#member-e239031e71ea9213) | Field |

<h3 id="member-7c95caf26409c255" class="astra-member">AudioParar</h3>

```csharp
AudioParar = 2
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1b72e2684a881a30" class="astra-member">AudioPausar</h3>

```csharp
AudioPausar = 3
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-df2980d8bb78678b" class="astra-member">AudioPosicionar</h3>

```csharp
AudioPosicionar = 5
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba0da0a64206147e" class="astra-member">AudioRetomar</h3>

```csharp
AudioRetomar = 4
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68d678f5553de84c" class="astra-member">AudioTocar</h3>

```csharp
AudioTocar = 1
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ecf6ea410a36d8f7" class="astra-member">Nenhum</h3>

```csharp
Nenhum = 0
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-52c2d73ef4025d1f" class="astra-member">PercursoParar</h3>

```csharp
PercursoParar = 15
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dc9efaf0ba1e9e97" class="astra-member">PercursoReiniciar</h3>

```csharp
PercursoReiniciar = 14
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8bbe06072ee038a0" class="astra-member">TimerIniciar</h3>

```csharp
TimerIniciar = 6
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e76d43c5aaca4ae7" class="astra-member">TimerParar</h3>

```csharp
TimerParar = 7
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-52a101e5ef3dee1c" class="astra-member">TimerPausar</h3>

```csharp
TimerPausar = 8
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-319c8b6f48f53fd3" class="astra-member">TimerRetomar</h3>

```csharp
TimerRetomar = 9
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-260a0f0f9acc1210" class="astra-member">TweenCancelar</h3>

```csharp
TweenCancelar = 11
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b511dffcd353fc6" class="astra-member">TweenPausar</h3>

```csharp
TweenPausar = 12
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-30fc2df833ef23ff" class="astra-member">TweenReiniciar</h3>

```csharp
TweenReiniciar = 10
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e239031e71ea9213" class="astra-member">TweenRetomar</h3>

```csharp
TweenRetomar = 13
```

**Caminho:** Inspector → Conexão de evento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GameTimer"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gametimer/
---

# Astra.Components.GameTimer

Timer: Dispara eventos temporizados e ações persistentes de ativação de objetos. Família Lógica · Tempo.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.GameTimer
```

Timer: Dispara eventos temporizados e ações persistentes de ativação de objetos. Família Lógica · Tempo.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_timer.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.GameTimer>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Timer**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GameTimer>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GameTimer(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Timer](/pt-br/snapshot-2026-10-06/componentes/astra-time-timer/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-9f8fa4c1fb910bb9) | Method |
| [OnElapsed](#member-993c4a6049890a01) | Method |
| [Pause](#member-9126daa86f6a27b7) | Method |
| [Remaining](#member-01357d174095e663) | Method |
| [Remove](#member-e80e786edb8e6ef7) | Method |
| [Resume](#member-af66a3e0b0712a6e) | Method |
| [Running](#member-9f821f5e033bc17d) | Method |
| [Start](#member-6e77bba7b6e953c1) | Method |
| [Stop](#member-6528deec4b8349eb) | Method |
| [Wrap](#member-bea5dab047433ffb) | Method |
| [AutoStart](#member-f0b60fbfcbd244dc) | Property |
| [Component](#member-42deb015c0dbaf87) | Property |
| [ElapsedAction](#member-e5dbce47b41c29b3) | Property |
| [ElapsedTarget](#member-785a84f42e6a3e78) | Property |
| [Enabled](#member-1bb8e29d7fced339) | Property |
| [IgnoreTimeScale](#member-0ef98182d38a1f26) | Property |
| [InstanceId](#member-d16aa8696140d16a) | Property |
| [IntervalSeconds](#member-c7f6cc07daf42406) | Property |
| [IsAlive](#member-10bec31cd0a04f6f) | Property |
| [Object](#member-055dc8cd3b87fe08) | Property |
| [Repeat](#member-c930592c536ad1ee) | Property |
| [TypeId](#member-ba88184c1edf2ebf) | Property |

<h3 id="member-9f8fa4c1fb910bb9" class="astra-member">.ctor</h3>

```csharp
public GameTimer(Astra.Component component)
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-993c4a6049890a01" class="astra-member">OnElapsed</h3>

```csharp
public Astra.ComponentSubscription OnElapsed(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Disparou. Um evento por quadro; Disparos conta intervalos vencidos no quadro. Payload: Disparos: inteiro

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Disparou. Um evento por quadro; Disparos conta intervalos vencidos no quadro. Payload: Disparos: inteiro

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-9126daa86f6a27b7" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

Pausar. Congela a contagem sem perder o restante

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Pausar. Congela a contagem sem perder o restante

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01357d174095e663" class="astra-member">Remaining</h3>

```csharp
public double Remaining()
```

Restante. Segundos até o próximo disparo; zero quando parado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Restante. Segundos até o próximo disparo; zero quando parado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e80e786edb8e6ef7" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af66a3e0b0712a6e" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

Retomar. Continua a contagem pausada

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Retomar. Continua a contagem pausada

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f821f5e033bc17d" class="astra-member">Running</h3>

```csharp
public bool Running()
```

Em execução. Verdadeiro enquanto conta, inclusive pausado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Em execução. Verdadeiro enquanto conta, inclusive pausado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6e77bba7b6e953c1" class="astra-member">Start</h3>

```csharp
public void Start(double interval)
```

Iniciar. Reinicia a contagem; intervalo zero usa o autorado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Iniciar. Reinicia a contagem; intervalo zero usa o autorado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `interval` | `double` |  |

<h3 id="member-6528deec4b8349eb" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Interrompe e zera a contagem

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Parar. Interrompe e zera a contagem

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bea5dab047433ffb" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.GameTimer Wrap(Astra.Component component)
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f0b60fbfcbd244dc" class="astra-member">AutoStart</h3>

```csharp
public bool AutoStart { get; set; }
```

Iniciar automaticamente. Inicia ao entrar em Play ou criar a instância; desligado exige Start. Alteração não reinicia timer já criado

**Caminho:** Inspector → Timer → Disparo; ou fachada C# em um Behavior.

**Uso:** **Iniciar automaticamente:** Inicia ao entrar em Play ou criar a instância; desligado exige Start. Alteração não reinicia timer já criado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42deb015c0dbaf87" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e5dbce47b41c29b3" class="astra-member">ElapsedAction</h3>

```csharp
public Astra.Components.GameTimer.ElapsedActionOption ElapsedAction { get; set; }
```

Ao disparar. Executa uma ação no alvo antes de entregar TimerElapsed; alternar preserva a paridade dos disparos agregados

**Caminho:** Inspector → Timer → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ao disparar:** Executa uma ação no alvo antes de entregar TimerElapsed; alternar preserva a paridade dos disparos agregados

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-785a84f42e6a3e78" class="astra-member">ElapsedTarget</h3>

```csharp
public Astra.ObjectReference ElapsedTarget { get; set; }
```

Receptor. Alvo da ação; usa referência persistente remapeada por clone/prefab

**Caminho:** Inspector → Timer → Conexão; ou fachada C# em um Behavior.

**Uso:** **Receptor:** Alvo da ação; usa referência persistente remapeada por clone/prefab

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bb8e29d7fced339" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Timer → Disparo; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ef98182d38a1f26" class="astra-member">IgnoreTimeScale</h3>

```csharp
public bool IgnoreTimeScale { get; set; }
```

Ignorar escala de tempo. Usa o intervalo não escalado aceito do quadro; a pausa do editor interrompe ambos os relógios

**Caminho:** Inspector → Timer → Disparo; ou fachada C# em um Behavior.

**Uso:** **Ignorar escala de tempo:** Usa o intervalo não escalado aceito do quadro; a pausa do editor interrompe ambos os relógios

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d16aa8696140d16a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c7f6cc07daf42406" class="astra-member">IntervalSeconds</h3>

```csharp
public float IntervalSeconds { get; set; }
```

Intervalo (s). Tempo entre disparos; uma vez quando Repetir está desligado

Faixa válida: 0.05 a 3600.

**Caminho:** Inspector → Timer → Disparo; ou fachada C# em um Behavior.

**Uso:** **Intervalo:** Tempo entre disparos; uma vez quando Repetir está desligado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10bec31cd0a04f6f" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-055dc8cd3b87fe08" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c930592c536ad1ee" class="astra-member">Repeat</h3>

```csharp
public bool Repeat { get; set; }
```

Repetir

**Caminho:** Inspector → Timer → Disparo; ou fachada C# em um Behavior.

**Uso:** **Repetir:** Repete o intervalo; desligado produz um disparo e termina.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba88184c1edf2ebf" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GameTimer.ElapsedActionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gametimer-elapsedactionoption/
---

# Astra.Components.GameTimer.ElapsedActionOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GameTimer.ElapsedActionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Timer**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GameTimer>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GameTimer(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlternarObjeto](#member-dab5c681f461d782) | Field |
| [AtivarObjeto](#member-c177230a9d19d63e) | Field |
| [DesativarObjeto](#member-4429b92d1908170b) | Field |
| [Desconectado](#member-bf7d7522bd18dcce) | Field |

<h3 id="member-dab5c681f461d782" class="astra-member">AlternarObjeto</h3>

```csharp
AlternarObjeto = 3
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c177230a9d19d63e" class="astra-member">AtivarObjeto</h3>

```csharp
AtivarObjeto = 1
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4429b92d1908170b" class="astra-member">DesativarObjeto</h3>

```csharp
DesativarObjeto = 2
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bf7d7522bd18dcce" class="astra-member">Desconectado</h3>

```csharp
Desconectado = 0
```

**Caminho:** Inspector → Timer; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield/
---

# Astra.Components.GravityField

Campo de gravidade: Gravidade local em volume sobre corpos dinâmicos. Família Física 3D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.GravityField
```

Campo de gravidade: Gravidade local em volume sobre corpos dinâmicos. Família Física 3D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.GravityField>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de gravidade**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de gravidade](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-gravity/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-4a36a6daf203b5b8) | Method |
| [Remove](#member-ea48d18756968f3a) | Method |
| [Wrap](#member-b9d018915d1df864) | Method |
| [AffectedLayer](#member-6001aa883f076cc2) | Property |
| [Component](#member-f17ac0fd2ae6767d) | Property |
| [Enabled](#member-63abbf0d39088382) | Property |
| [Falloff](#member-d441295e8608dd1a) | Property |
| [HalfExtents](#member-a4e332c3da07e953) | Property |
| [InstanceId](#member-e21caa527786a19c) | Property |
| [IsAlive](#member-1641136af1e04ca1) | Property |
| [Object](#member-a2566ff9b198e4e3) | Property |
| [Offset](#member-b413cbdf70609a04) | Property |
| [Radius](#member-d95359908a197c1a) | Property |
| [ReplaceWorldGravity](#member-919f33140a3d906f) | Property |
| [Shape](#member-ace65e1bb679acfc) | Property |
| [TypeId](#member-dd99ab511b3c24c3) | Property |
| [Vector](#member-9af0331419b7c56f) | Property |
| [WakeBodies](#member-220c4ba71b8731a3) | Property |

<h3 id="member-4a36a6daf203b5b8" class="astra-member">.ctor</h3>

```csharp
public GravityField(Astra.Component component)
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-ea48d18756968f3a" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b9d018915d1df864" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.GravityField Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-6001aa883f076cc2" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.GravityField.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de gravidade → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f17ac0fd2ae6767d" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-63abbf0d39088382" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de gravidade → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d441295e8608dd1a" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.GravityField.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de gravidade → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a4e332c3da07e953" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meias XYZ

**Caminho:** Inspector → Campo de gravidade → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Z:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e21caa527786a19c" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1641136af1e04ca1" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a2566ff9b198e4e3" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b413cbdf70609a04" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de gravidade → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Centro Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d95359908a197c1a" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de gravidade → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-919f33140a3d906f" class="astra-member">ReplaceWorldGravity</h3>

```csharp
public bool ReplaceWorldGravity { get; set; }
```

Substituir gravidade do mundo. Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Caminho:** Inspector → Campo de gravidade → Efeito; ou fachada C# em um Behavior.

**Uso:** **Substituir gravidade do mundo:** Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ace65e1bb679acfc" class="astra-member">Shape</h3>

```csharp
public Astra.Components.GravityField.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de gravidade → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd99ab511b3c24c3" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9af0331419b7c56f" class="astra-member">Vector</h3>

```csharp
public System.Numerics.Vector3 Vector { get; set; }
```

Gravidade local

**Caminho:** Inspector → Campo de gravidade → Efeito; ou fachada C# em um Behavior.

**Uso:** **Vetor X:** Componente do vetor de contribuição do campo, eixo X. **Vetor Y:** Componente do vetor de contribuição do campo, eixo Y. **Vetor Z:** Componente do vetor de contribuição do campo, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-220c4ba71b8731a3" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de gravidade → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-affectedlayeroption/
---

# Astra.Components.GravityField.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de gravidade**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-4354066067d2ae69) | Field |
| [Camada1](#member-f32cd92daf64b0d7) | Field |
| [Camada10](#member-7950ac2c13af21d1) | Field |
| [Camada11](#member-72fbcaf0acb89572) | Field |
| [Camada12](#member-ddef4e988e501235) | Field |
| [Camada13](#member-5ff86cb0eb0e5ac3) | Field |
| [Camada14](#member-3960e90ae5fec344) | Field |
| [Camada15](#member-bcd649cf5e359bd1) | Field |
| [Camada16](#member-b0c3a19c7113ffcb) | Field |
| [Camada17](#member-c6ea0c75cd267cbb) | Field |
| [Camada18](#member-c8de1458f34d1ba4) | Field |
| [Camada19](#member-35a7f66036602677) | Field |
| [Camada2](#member-85d7c80d53d145dc) | Field |
| [Camada20](#member-d13a701ccc047e77) | Field |
| [Camada21](#member-4de75f8efd8be627) | Field |
| [Camada22](#member-ce1d3f4995a21096) | Field |
| [Camada23](#member-2be5dc2ff1e2f1fe) | Field |
| [Camada24](#member-a92665625f6e0aa2) | Field |
| [Camada25](#member-6dcdb43959d762cb) | Field |
| [Camada26](#member-043f0b9f6e90125e) | Field |
| [Camada27](#member-5edcbaee16ba22c2) | Field |
| [Camada28](#member-5766914687d49200) | Field |
| [Camada29](#member-92c1f3ef44f4269f) | Field |
| [Camada3](#member-840497c8caeaf91f) | Field |
| [Camada30](#member-0be0d97d6ba6acde) | Field |
| [Camada31](#member-342dc15b53adf51d) | Field |
| [Camada4](#member-04c0b32f0c597582) | Field |
| [Camada5](#member-b3942dd6f5c6cf3a) | Field |
| [Camada6](#member-6afa12f7e8eb26ad) | Field |
| [Camada7](#member-3db43838107ddf52) | Field |
| [Camada8](#member-16403bc5d3b2fa88) | Field |
| [Camada9](#member-e041f6af79b327d5) | Field |
| [Todas](#member-03d51b444986690c) | Field |

<h3 id="member-4354066067d2ae69" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f32cd92daf64b0d7" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7950ac2c13af21d1" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-72fbcaf0acb89572" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ddef4e988e501235" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ff86cb0eb0e5ac3" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3960e90ae5fec344" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bcd649cf5e359bd1" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0c3a19c7113ffcb" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6ea0c75cd267cbb" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c8de1458f34d1ba4" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-35a7f66036602677" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85d7c80d53d145dc" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d13a701ccc047e77" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4de75f8efd8be627" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ce1d3f4995a21096" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2be5dc2ff1e2f1fe" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a92665625f6e0aa2" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6dcdb43959d762cb" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-043f0b9f6e90125e" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5edcbaee16ba22c2" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5766914687d49200" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-92c1f3ef44f4269f" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-840497c8caeaf91f" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0be0d97d6ba6acde" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-342dc15b53adf51d" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-04c0b32f0c597582" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b3942dd6f5c6cf3a" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6afa12f7e8eb26ad" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3db43838107ddf52" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16403bc5d3b2fa88" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e041f6af79b327d5" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03d51b444986690c" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-falloffoption/
---

# Astra.Components.GravityField.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de gravidade**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-427bf8f49abf62a7) | Field |
| [Suave](#member-3958e44bdff7ca2f) | Field |
| [Uniforme](#member-8224717c3f3ab4c6) | Field |

<h3 id="member-427bf8f49abf62a7" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3958e44bdff7ca2f" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8224717c3f3ab4c6" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-shapeoption/
---

# Astra.Components.GravityField.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de gravidade**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-fc8ff93ed967b70e) | Field |
| [Esfera](#member-726ddf22763858fa) | Field |

<h3 id="member-fc8ff93ed967b70e" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-726ddf22763858fa" class="astra-member">Esfera</h3>

```csharp
Esfera = 1
```

**Caminho:** Inspector → Campo de gravidade; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d/
---

# Astra.Components.GravityField2D

Campo de gravidade 2D: Gravidade XY em área sobre corpos dinâmicos 2D. Família Física 2D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.GravityField2D
```

Campo de gravidade 2D: Gravidade XY em área sobre corpos dinâmicos 2D. Família Física 2D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.GravityField2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de gravidade 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de gravidade 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-gravity/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-4fc11300a1cecc4d) | Method |
| [Remove](#member-827c733b377ebaf7) | Method |
| [Wrap](#member-9f24d1edfc7c0fbf) | Method |
| [AffectedLayer](#member-2524192ecabeb4cf) | Property |
| [Component](#member-9ae84cb8f2e96681) | Property |
| [Enabled](#member-a8d348ee84d824dc) | Property |
| [Falloff](#member-4f034f610a7e77de) | Property |
| [HalfExtents](#member-060934d05afc0b88) | Property |
| [InstanceId](#member-e8fcc7f21bf77975) | Property |
| [IsAlive](#member-d774fac15b3416af) | Property |
| [Object](#member-b144a94b529bc794) | Property |
| [Offset](#member-c84d2523b4057dc4) | Property |
| [Radius](#member-ba0e48178374f4e6) | Property |
| [ReplaceWorldGravity](#member-13e8f04a6b3c77a3) | Property |
| [Shape](#member-dd75cb66820fcbb0) | Property |
| [TypeId](#member-10e6b411474e2e17) | Property |
| [Vector](#member-48dc3fb02e0517de) | Property |
| [WakeBodies](#member-a4e65e097f68da82) | Property |

<h3 id="member-4fc11300a1cecc4d" class="astra-member">.ctor</h3>

```csharp
public GravityField2D(Astra.Component component)
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-827c733b377ebaf7" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f24d1edfc7c0fbf" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.GravityField2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-2524192ecabeb4cf" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.GravityField2D.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de gravidade 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9ae84cb8f2e96681" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a8d348ee84d824dc" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de gravidade 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f034f610a7e77de" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.GravityField2D.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de gravidade 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-060934d05afc0b88" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector2 HalfExtents { get; set; }
```

Meias XY

**Caminho:** Inspector → Campo de gravidade 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e8fcc7f21bf77975" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d774fac15b3416af" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b144a94b529bc794" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c84d2523b4057dc4" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de gravidade 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba0e48178374f4e6" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de gravidade 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-13e8f04a6b3c77a3" class="astra-member">ReplaceWorldGravity</h3>

```csharp
public bool ReplaceWorldGravity { get; set; }
```

Substituir gravidade do mundo. Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Caminho:** Inspector → Campo de gravidade 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Substituir gravidade do mundo:** Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd75cb66820fcbb0" class="astra-member">Shape</h3>

```csharp
public Astra.Components.GravityField2D.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de gravidade 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10e6b411474e2e17" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-48dc3fb02e0517de" class="astra-member">Vector</h3>

```csharp
public System.Numerics.Vector2 Vector { get; set; }
```

Gravidade local

**Caminho:** Inspector → Campo de gravidade 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Vetor X:** Componente do vetor de contribuição do campo, eixo X. **Vetor Y:** Componente do vetor de contribuição do campo, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a4e65e097f68da82" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de gravidade 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField2D.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-affectedlayeroption/
---

# Astra.Components.GravityField2D.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField2D.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de gravidade 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-f15dcda7c4078cfa) | Field |
| [Camada1](#member-389f8a91dfb23dea) | Field |
| [Camada10](#member-ec8a7ced3de534dd) | Field |
| [Camada11](#member-ede9a861dcd252e5) | Field |
| [Camada12](#member-b2f8d84b0ae38d7e) | Field |
| [Camada13](#member-bf4dba3b56b0e9de) | Field |
| [Camada14](#member-1555a467a0d8d39a) | Field |
| [Camada15](#member-bc76463ec315559a) | Field |
| [Camada16](#member-906798e5453ed903) | Field |
| [Camada17](#member-fdff9e7636316d6f) | Field |
| [Camada18](#member-fc2988ed7606e052) | Field |
| [Camada19](#member-ef5f59189d5231eb) | Field |
| [Camada2](#member-3466f99bf80419b4) | Field |
| [Camada20](#member-ff323d6989f218f4) | Field |
| [Camada21](#member-0fcab29775828b4f) | Field |
| [Camada22](#member-6f739d2c010535d9) | Field |
| [Camada23](#member-ab6c7962d145b75c) | Field |
| [Camada24](#member-1e488ae640627e0f) | Field |
| [Camada25](#member-2fb24c55b725c25e) | Field |
| [Camada26](#member-5e8f5a0da0957d1e) | Field |
| [Camada27](#member-6b04b1b03118e0ca) | Field |
| [Camada28](#member-d94d244b9c90be9c) | Field |
| [Camada29](#member-4735b1f15e6a684b) | Field |
| [Camada3](#member-7a173775d86e9509) | Field |
| [Camada30](#member-67580f9bf52c98d6) | Field |
| [Camada31](#member-01fa4d7acacba3e7) | Field |
| [Camada4](#member-2f5fdf26b61d602d) | Field |
| [Camada5](#member-311499b89cb0720c) | Field |
| [Camada6](#member-adea52c5a3f1f6d8) | Field |
| [Camada7](#member-eada50583c9b80f4) | Field |
| [Camada8](#member-ef043d74ea0a9b8d) | Field |
| [Camada9](#member-858b58d928e44a56) | Field |
| [Todas](#member-7d15a3601bf99665) | Field |

<h3 id="member-f15dcda7c4078cfa" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-389f8a91dfb23dea" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ec8a7ced3de534dd" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ede9a861dcd252e5" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b2f8d84b0ae38d7e" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bf4dba3b56b0e9de" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1555a467a0d8d39a" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc76463ec315559a" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-906798e5453ed903" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fdff9e7636316d6f" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fc2988ed7606e052" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef5f59189d5231eb" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3466f99bf80419b4" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff323d6989f218f4" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0fcab29775828b4f" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f739d2c010535d9" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab6c7962d145b75c" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1e488ae640627e0f" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2fb24c55b725c25e" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e8f5a0da0957d1e" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b04b1b03118e0ca" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d94d244b9c90be9c" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4735b1f15e6a684b" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a173775d86e9509" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-67580f9bf52c98d6" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01fa4d7acacba3e7" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f5fdf26b61d602d" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-311499b89cb0720c" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-adea52c5a3f1f6d8" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eada50583c9b80f4" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef043d74ea0a9b8d" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-858b58d928e44a56" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d15a3601bf99665" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField2D.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-falloffoption/
---

# Astra.Components.GravityField2D.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField2D.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de gravidade 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-31bef7c6abd142a6) | Field |
| [Suave](#member-1cb415ed99476b2c) | Field |
| [Uniforme](#member-722fe323453e5b25) | Field |

<h3 id="member-31bef7c6abd142a6" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1cb415ed99476b2c" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-722fe323453e5b25" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.GravityField2D.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-shapeoption/
---

# Astra.Components.GravityField2D.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.GravityField2D.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de gravidade 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<GravityField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new GravityField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Circulo](#member-9d00a5a9e6f8f590) | Field |
| [Retangulo](#member-190fb3cacdabfdde) | Field |

<h3 id="member-9d00a5a9e6f8f590" class="astra-member">Circulo</h3>

```csharp
Circulo = 1
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-190fb3cacdabfdde" class="astra-member">Retangulo</h3>

```csharp
Retangulo = 0
```

**Caminho:** Inspector → Campo de gravidade 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint/
---

# Astra.Components.Joint

Junta: Nove mecanismos Jolt com limites, referenciais e motores. Família Física 3D · Juntas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Joint
```

Junta: Nove mecanismos Jolt com limites, referenciais e motores. Família Física 3D · Juntas.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_generic6dofjoint3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Joint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Junta](/pt-br/snapshot-2026-10-06/componentes/astra-physics-joint/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-4d58ee9d9e665983) | Method |
| [Remove](#member-a261baf5d01bf8c3) | Method |
| [Wrap](#member-3e950e2fe3ce5d24) | Method |
| [AnchorA](#member-768f060de6f86f6a) | Property |
| [AnchorB](#member-53c99070930f571d) | Property |
| [AngularXDamping](#member-b5bb11065983e930) | Property |
| [AngularXForce](#member-d4860b9c9feed8e9) | Property |
| [AngularXFrequency](#member-0f1f1991b69a41b9) | Property |
| [AngularXFriction](#member-c45511b993253a12) | Property |
| [AngularXMaximum](#member-df1d869d8ca7b7fc) | Property |
| [AngularXMinimum](#member-7df5616d9928c0d8) | Property |
| [AngularXMotion](#member-edd44a46c7df403a) | Property |
| [AngularXMotor](#member-63122adf26e48375) | Property |
| [AngularXPosition](#member-d15c55ef480e91cb) | Property |
| [AngularXVelocity](#member-bcf2add9a9b5cff0) | Property |
| [AngularYDamping](#member-42ae932409de23e0) | Property |
| [AngularYForce](#member-ea511bcd3b46c0f1) | Property |
| [AngularYFrequency](#member-7f82d1501328c7ee) | Property |
| [AngularYFriction](#member-7c376ce462e0dce0) | Property |
| [AngularYMaximum](#member-5b6342d8e1864849) | Property |
| [AngularYMinimum](#member-6bd8a05831805985) | Property |
| [AngularYMotion](#member-6349de21037b7960) | Property |
| [AngularYMotor](#member-4081ae7dfc2f5bf0) | Property |
| [AngularYPosition](#member-34e5b9b15926734b) | Property |
| [AngularYVelocity](#member-58bbe19c35caea91) | Property |
| [AngularZDamping](#member-43934211a3e7bf74) | Property |
| [AngularZForce](#member-52d3808b0cf1eccc) | Property |
| [AngularZFrequency](#member-b5fd4341f612f245) | Property |
| [AngularZFriction](#member-536ae2887337fcf6) | Property |
| [AngularZMaximum](#member-5bc6a81452cd8d98) | Property |
| [AngularZMinimum](#member-3cf4d468cea6edfb) | Property |
| [AngularZMotion](#member-b07aaeb08e2bdf55) | Property |
| [AngularZMotor](#member-6d050734e3ece2d9) | Property |
| [AngularZPosition](#member-d8bbc65a23ff3e96) | Property |
| [AngularZVelocity](#member-e73f53dde861e675) | Property |
| [AxisA](#member-2c165b08815fcbbc) | Property |
| [AxisB](#member-65aa5eff87b6e40e) | Property |
| [Component](#member-ba08fc4bbed52629) | Property |
| [ConnectedBody](#member-ab06028acb481f93) | Property |
| [Enabled](#member-47e42a126ef17a1d) | Property |
| [InstanceId](#member-c6c880e45cfe7438) | Property |
| [IsAlive](#member-3dcdedff719c1646) | Property |
| [Kind](#member-61cdf35ff968c6c4) | Property |
| [LimitMax](#member-b5d34d9cc0d4b8c3) | Property |
| [LimitMin](#member-dd090b29f65bdd53) | Property |
| [LinearXDamping](#member-914953afbc3a6477) | Property |
| [LinearXForce](#member-8851f51e7739c866) | Property |
| [LinearXFrequency](#member-b36d1458fc130d39) | Property |
| [LinearXFriction](#member-7b08f84011d2e185) | Property |
| [LinearXMaximum](#member-7424c7815cc11682) | Property |
| [LinearXMinimum](#member-fec148243b7a6427) | Property |
| [LinearXMotion](#member-b84ad531d6d9a7b8) | Property |
| [LinearXMotor](#member-951c71150ccca4c7) | Property |
| [LinearXPosition](#member-1144c874261d0e7a) | Property |
| [LinearXVelocity](#member-0db26866f0e346c4) | Property |
| [LinearYDamping](#member-f16c22b6b7a0ad76) | Property |
| [LinearYForce](#member-746c6a56daee2606) | Property |
| [LinearYFrequency](#member-197f82ed03bc285a) | Property |
| [LinearYFriction](#member-776d30ee51c9e9f0) | Property |
| [LinearYMaximum](#member-b73ed47d1f559511) | Property |
| [LinearYMinimum](#member-845382a31a8531b7) | Property |
| [LinearYMotion](#member-f0bfd83c83d886e3) | Property |
| [LinearYMotor](#member-032f8aae5a081108) | Property |
| [LinearYPosition](#member-9c1c6d9a3e4f3d5d) | Property |
| [LinearYVelocity](#member-b6b1100559957d3a) | Property |
| [LinearZDamping](#member-b2bcff0803730d46) | Property |
| [LinearZForce](#member-7e561d2b26ae0f51) | Property |
| [LinearZFrequency](#member-34ae6156038bed96) | Property |
| [LinearZFriction](#member-af09b024354cd10d) | Property |
| [LinearZMaximum](#member-ac55f7f6cb1fa885) | Property |
| [LinearZMinimum](#member-fb420d5ff98422fc) | Property |
| [LinearZMotion](#member-9c57617406a8056e) | Property |
| [LinearZMotor](#member-2749582f77ef927a) | Property |
| [LinearZPosition](#member-22701b7718198af6) | Property |
| [LinearZVelocity](#member-eef2c183cd61054d) | Property |
| [Motor](#member-98c95368f844f4d6) | Property |
| [MotorForce](#member-9d6c2453223ad388) | Property |
| [MotorPosition](#member-97ab41fe62747929) | Property |
| [MotorVelocity](#member-652c7510727f348c) | Property |
| [NormalA](#member-26aa8600134b0c2a) | Property |
| [NormalB](#member-d854902f15a38b56) | Property |
| [Object](#member-bf5144ae86251347) | Property |
| [SpringDamping](#member-5bea658036c1ac9d) | Property |
| [SpringFrequency](#member-de3fdd100216ab96) | Property |
| [SwingY](#member-6222219e1bbac5ef) | Property |
| [SwingZ](#member-afeafd60061a22e2) | Property |
| [TwistMax](#member-08dd518a895e3f83) | Property |
| [TwistMin](#member-c0de2dc103aaa366) | Property |
| [TypeId](#member-d9c2d044f8037b66) | Property |

<h3 id="member-4d58ee9d9e665983" class="astra-member">.ctor</h3>

```csharp
public Joint(Astra.Component component)
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a261baf5d01bf8c3" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e950e2fe3ce5d24" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Joint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-768f060de6f86f6a" class="astra-member">AnchorA</h3>

```csharp
public System.Numerics.Vector3 AnchorA { get; set; }
```

Âncora A

**Caminho:** Inspector → Junta → Âncoras; ou fachada C# em um Behavior.

**Uso:** **Âncora A · X:** Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis. **Âncora A · Y:** Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis. **Âncora A · Z:** Posição da âncora no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53c99070930f571d" class="astra-member">AnchorB</h3>

```csharp
public System.Numerics.Vector3 AnchorB { get; set; }
```

Âncora B

**Caminho:** Inspector → Junta → Âncoras; ou fachada C# em um Behavior.

**Uso:** **Âncora B · X:** Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis. **Âncora B · Y:** Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis. **Âncora B · Z:** Posição da âncora no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5bb11065983e930" class="astra-member">AngularXDamping</h3>

```csharp
public float AngularXDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d4860b9c9feed8e9" class="astra-member">AngularXForce</h3>

```csharp
public float AngularXForce { get; set; }
```

Força máxima (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f1f1991b69a41b9" class="astra-member">AngularXFrequency</h3>

```csharp
public float AngularXFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c45511b993253a12" class="astra-member">AngularXFriction</h3>

```csharp
public float AngularXFriction { get; set; }
```

Atrito máximo (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-df1d869d8ca7b7fc" class="astra-member">AngularXMaximum</h3>

```csharp
public float AngularXMaximum { get; set; }
```

Limite máximo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7df5616d9928c0d8" class="astra-member">AngularXMinimum</h3>

```csharp
public float AngularXMinimum { get; set; }
```

Limite mínimo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-edd44a46c7df403a" class="astra-member">AngularXMotion</h3>

```csharp
public Astra.Components.Joint.AngularXMotionOption AngularXMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-63122adf26e48375" class="astra-member">AngularXMotor</h3>

```csharp
public Astra.Components.Joint.AngularXMotorOption AngularXMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d15c55ef480e91cb" class="astra-member">AngularXPosition</h3>

```csharp
public float AngularXPosition { get; set; }
```

Posição alvo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bcf2add9a9b5cff0" class="astra-member">AngularXVelocity</h3>

```csharp
public float AngularXVelocity { get; set; }
```

Velocidade alvo (°/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Rotação X; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42ae932409de23e0" class="astra-member">AngularYDamping</h3>

```csharp
public float AngularYDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ea511bcd3b46c0f1" class="astra-member">AngularYForce</h3>

```csharp
public float AngularYForce { get; set; }
```

Força máxima (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7f82d1501328c7ee" class="astra-member">AngularYFrequency</h3>

```csharp
public float AngularYFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c376ce462e0dce0" class="astra-member">AngularYFriction</h3>

```csharp
public float AngularYFriction { get; set; }
```

Atrito máximo (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b6342d8e1864849" class="astra-member">AngularYMaximum</h3>

```csharp
public float AngularYMaximum { get; set; }
```

Limite máximo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6bd8a05831805985" class="astra-member">AngularYMinimum</h3>

```csharp
public float AngularYMinimum { get; set; }
```

Limite mínimo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6349de21037b7960" class="astra-member">AngularYMotion</h3>

```csharp
public Astra.Components.Joint.AngularYMotionOption AngularYMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4081ae7dfc2f5bf0" class="astra-member">AngularYMotor</h3>

```csharp
public Astra.Components.Joint.AngularYMotorOption AngularYMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-34e5b9b15926734b" class="astra-member">AngularYPosition</h3>

```csharp
public float AngularYPosition { get; set; }
```

Posição alvo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58bbe19c35caea91" class="astra-member">AngularYVelocity</h3>

```csharp
public float AngularYVelocity { get; set; }
```

Velocidade alvo (°/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Rotação Y; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-43934211a3e7bf74" class="astra-member">AngularZDamping</h3>

```csharp
public float AngularZDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-52d3808b0cf1eccc" class="astra-member">AngularZForce</h3>

```csharp
public float AngularZForce { get; set; }
```

Força máxima (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5fd4341f612f245" class="astra-member">AngularZFrequency</h3>

```csharp
public float AngularZFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-536ae2887337fcf6" class="astra-member">AngularZFriction</h3>

```csharp
public float AngularZFriction { get; set; }
```

Atrito máximo (Nm)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5bc6a81452cd8d98" class="astra-member">AngularZMaximum</h3>

```csharp
public float AngularZMaximum { get; set; }
```

Limite máximo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3cf4d468cea6edfb" class="astra-member">AngularZMinimum</h3>

```csharp
public float AngularZMinimum { get; set; }
```

Limite mínimo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b07aaeb08e2bdf55" class="astra-member">AngularZMotion</h3>

```csharp
public Astra.Components.Joint.AngularZMotionOption AngularZMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d050734e3ece2d9" class="astra-member">AngularZMotor</h3>

```csharp
public Astra.Components.Joint.AngularZMotorOption AngularZMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8bbc65a23ff3e96" class="astra-member">AngularZPosition</h3>

```csharp
public float AngularZPosition { get; set; }
```

Posição alvo (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e73f53dde861e675" class="astra-member">AngularZVelocity</h3>

```csharp
public float AngularZVelocity { get; set; }
```

Velocidade alvo (°/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Rotação Z; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2c165b08815fcbbc" class="astra-member">AxisA</h3>

```csharp
public System.Numerics.Vector3 AxisA { get; set; }
```

Eixo A

**Caminho:** Inspector → Junta → Eixos; ou fachada C# em um Behavior.

**Uso:** **Eixo A · X:** Direção do eixo no frame do corpo A, componente X. Configure os dois frames compatíveis. **Eixo A · Y:** Direção do eixo no frame do corpo A, componente Y. Configure os dois frames compatíveis. **Eixo A · Z:** Direção do eixo no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-65aa5eff87b6e40e" class="astra-member">AxisB</h3>

```csharp
public System.Numerics.Vector3 AxisB { get; set; }
```

Eixo B

**Caminho:** Inspector → Junta → Eixos; ou fachada C# em um Behavior.

**Uso:** **Eixo B · X:** Direção do eixo no frame do corpo B, componente X. Configure os dois frames compatíveis. **Eixo B · Y:** Direção do eixo no frame do corpo B, componente Y. Configure os dois frames compatíveis. **Eixo B · Z:** Direção do eixo no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba08fc4bbed52629" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab06028acb481f93" class="astra-member">ConnectedBody</h3>

```csharp
public Astra.ObjectReference ConnectedBody { get; set; }
```

Conectar corpo

**Caminho:** Inspector → Junta → Âncoras; ou fachada C# em um Behavior.

**Uso:** **Conectar corpo:** Objeto com o corpo conectado; confira a cadeia de dependências.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47e42a126ef17a1d" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativa

**Caminho:** Inspector → Junta → Geral; ou fachada C# em um Behavior.

**Uso:** **Ativa:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6c880e45cfe7438" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3dcdedff719c1646" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61cdf35ff968c6c4" class="astra-member">Kind</h3>

```csharp
public Astra.Components.Joint.KindOption Kind { get; set; }
```

Tipo

**Caminho:** Inspector → Junta → Geral; ou fachada C# em um Behavior.

**Uso:** **Tipo:** Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5d34d9cc0d4b8c3" class="astra-member">LimitMax</h3>

```csharp
public float LimitMax { get; set; }
```

Limite máximo

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Movimento; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Limite superior da junta na unidade do tipo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd090b29f65bdd53" class="astra-member">LimitMin</h3>

```csharp
public float LimitMin { get; set; }
```

Limite mínimo

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Movimento; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Limite inferior da junta na unidade do tipo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-914953afbc3a6477" class="astra-member">LinearXDamping</h3>

```csharp
public float LinearXDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8851f51e7739c866" class="astra-member">LinearXForce</h3>

```csharp
public float LinearXForce { get; set; }
```

Força máxima (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b36d1458fc130d39" class="astra-member">LinearXFrequency</h3>

```csharp
public float LinearXFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7b08f84011d2e185" class="astra-member">LinearXFriction</h3>

```csharp
public float LinearXFriction { get; set; }
```

Atrito máximo (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7424c7815cc11682" class="astra-member">LinearXMaximum</h3>

```csharp
public float LinearXMaximum { get; set; }
```

Limite máximo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fec148243b7a6427" class="astra-member">LinearXMinimum</h3>

```csharp
public float LinearXMinimum { get; set; }
```

Limite mínimo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b84ad531d6d9a7b8" class="astra-member">LinearXMotion</h3>

```csharp
public Astra.Components.Joint.LinearXMotionOption LinearXMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-951c71150ccca4c7" class="astra-member">LinearXMotor</h3>

```csharp
public Astra.Components.Joint.LinearXMotorOption LinearXMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1144c874261d0e7a" class="astra-member">LinearXPosition</h3>

```csharp
public float LinearXPosition { get; set; }
```

Posição alvo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0db26866f0e346c4" class="astra-member">LinearXVelocity</h3>

```csharp
public float LinearXVelocity { get; set; }
```

Velocidade alvo (u/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Translação X; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f16c22b6b7a0ad76" class="astra-member">LinearYDamping</h3>

```csharp
public float LinearYDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-746c6a56daee2606" class="astra-member">LinearYForce</h3>

```csharp
public float LinearYForce { get; set; }
```

Força máxima (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-197f82ed03bc285a" class="astra-member">LinearYFrequency</h3>

```csharp
public float LinearYFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-776d30ee51c9e9f0" class="astra-member">LinearYFriction</h3>

```csharp
public float LinearYFriction { get; set; }
```

Atrito máximo (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b73ed47d1f559511" class="astra-member">LinearYMaximum</h3>

```csharp
public float LinearYMaximum { get; set; }
```

Limite máximo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-845382a31a8531b7" class="astra-member">LinearYMinimum</h3>

```csharp
public float LinearYMinimum { get; set; }
```

Limite mínimo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0bfd83c83d886e3" class="astra-member">LinearYMotion</h3>

```csharp
public Astra.Components.Joint.LinearYMotionOption LinearYMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-032f8aae5a081108" class="astra-member">LinearYMotor</h3>

```csharp
public Astra.Components.Joint.LinearYMotorOption LinearYMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c1c6d9a3e4f3d5d" class="astra-member">LinearYPosition</h3>

```csharp
public float LinearYPosition { get; set; }
```

Posição alvo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b6b1100559957d3a" class="astra-member">LinearYVelocity</h3>

```csharp
public float LinearYVelocity { get; set; }
```

Velocidade alvo (u/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Translação Y; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b2bcff0803730d46" class="astra-member">LinearZDamping</h3>

```csharp
public float LinearZDamping { get; set; }
```

Amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Amortecimento:** Junta: amortecimento da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e561d2b26ae0f51" class="astra-member">LinearZForce</h3>

```csharp
public float LinearZForce { get; set; }
```

Força máxima (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Força máxima:** Junta: força/torque máximo do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-34ae6156038bed96" class="astra-member">LinearZFrequency</h3>

```csharp
public float LinearZFrequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Junta: frequência da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af09b024354cd10d" class="astra-member">LinearZFriction</h3>

```csharp
public float LinearZFriction { get; set; }
```

Atrito máximo (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Atrito máximo:** Junta: fricção no grau de liberdade do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac55f7f6cb1fa885" class="astra-member">LinearZMaximum</h3>

```csharp
public float LinearZMaximum { get; set; }
```

Limite máximo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Limite máximo:** Junta: limite superior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb420d5ff98422fc" class="astra-member">LinearZMinimum</h3>

```csharp
public float LinearZMinimum { get; set; }
```

Limite mínimo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Limite mínimo:** Junta: limite inferior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c57617406a8056e" class="astra-member">LinearZMotion</h3>

```csharp
public Astra.Components.Joint.LinearZMotionOption LinearZMotion { get; set; }
```

Movimento

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Junta: política livre/limitado/travado do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2749582f77ef927a" class="astra-member">LinearZMotor</h3>

```csharp
public Astra.Components.Joint.LinearZMotorOption LinearZMotor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Motor:** Junta: modo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-22701b7718198af6" class="astra-member">LinearZPosition</h3>

```csharp
public float LinearZPosition { get; set; }
```

Posição alvo (u)

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Posição alvo:** Junta: posição/ângulo alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eef2c183cd61054d" class="astra-member">LinearZVelocity</h3>

```csharp
public float LinearZVelocity { get; set; }
```

Velocidade alvo (u/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Translação Z; ou fachada C# em um Behavior.

**Uso:** **Velocidade alvo:** Junta: velocidade alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98c95368f844f4d6" class="astra-member">Motor</h3>

```csharp
public Astra.Components.Joint.MotorOption Motor { get; set; }
```

Motor

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Motor:** Modo de motor da junta; exige tipo e limites compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9d6c2453223ad388" class="astra-member">MotorForce</h3>

```csharp
public float MotorForce { get; set; }
```

Força / torque máximo

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Força / torque máximo:** Força/torque máximo do motor, conforme o tipo de junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-97ab41fe62747929" class="astra-member">MotorPosition</h3>

```csharp
public float MotorPosition { get; set; }
```

Alvo do motor

Faixa válida: -100000 a 100000.

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Alvo do motor:** Posição alvo do motor da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-652c7510727f348c" class="astra-member">MotorVelocity</h3>

```csharp
public float MotorVelocity { get; set; }
```

Velocidade do motor

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Velocidade do motor:** Velocidade alvo do motor da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-26aa8600134b0c2a" class="astra-member">NormalA</h3>

```csharp
public System.Numerics.Vector3 NormalA { get; set; }
```

Plano A

**Caminho:** Inspector → Junta → Eixos; ou fachada C# em um Behavior.

**Uso:** **Plano A · X:** Normal de referência no frame do corpo A, componente X. Configure os dois frames compatíveis. **Plano A · Y:** Normal de referência no frame do corpo A, componente Y. Configure os dois frames compatíveis. **Plano A · Z:** Normal de referência no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d854902f15a38b56" class="astra-member">NormalB</h3>

```csharp
public System.Numerics.Vector3 NormalB { get; set; }
```

Plano B

**Caminho:** Inspector → Junta → Eixos; ou fachada C# em um Behavior.

**Uso:** **Plano B · X:** Normal de referência no frame do corpo B, componente X. Configure os dois frames compatíveis. **Plano B · Y:** Normal de referência no frame do corpo B, componente Y. Configure os dois frames compatíveis. **Plano B · Z:** Normal de referência no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bf5144ae86251347" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5bea658036c1ac9d" class="astra-member">SpringDamping</h3>

```csharp
public float SpringDamping { get; set; }
```

Amortecimento da mola

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Amortecimento da mola:** Amortecimento da mola da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-de3fdd100216ab96" class="astra-member">SpringFrequency</h3>

```csharp
public float SpringFrequency { get; set; }
```

Frequência · Hz (Hz)

Faixa válida: 0.001 a 1000.

**Caminho:** Inspector → Junta → Motor; ou fachada C# em um Behavior.

**Uso:** **Frequência · Hz:** Frequência da mola da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6222219e1bbac5ef" class="astra-member">SwingY</h3>

```csharp
public float SwingY { get; set; }
```

Cone · semiângulo Y (°)

Faixa válida: 0 a 180.

**Caminho:** Inspector → Junta → Rotação; ou fachada C# em um Behavior.

**Uso:** **Cone · semiângulo Y:** Limite de swing no eixo Y da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-afeafd60061a22e2" class="astra-member">SwingZ</h3>

```csharp
public float SwingZ { get; set; }
```

Cone · semiângulo Z (°)

Faixa válida: 0 a 180.

**Caminho:** Inspector → Junta → Rotação; ou fachada C# em um Behavior.

**Uso:** **Cone · semiângulo Z:** Limite de swing no eixo Z da junta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08dd518a895e3f83" class="astra-member">TwistMax</h3>

```csharp
public float TwistMax { get; set; }
```

Torção máxima (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação; ou fachada C# em um Behavior.

**Uso:** **Torção máxima:** Limite superior de twist.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c0de2dc103aaa366" class="astra-member">TwistMin</h3>

```csharp
public float TwistMin { get; set; }
```

Torção mínima (°)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta → Rotação; ou fachada C# em um Behavior.

**Uso:** **Torção mínima:** Limite inferior de twist.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9c2d044f8037b66" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularXMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularxmotionoption/
---

# Astra.Components.Joint.AngularXMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularXMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-69a4f2c7f52bc215) | Field |
| [Livre](#member-46a99a3720f8b095) | Field |
| [Travado](#member-a783885b72bcd7c7) | Field |

<h3 id="member-69a4f2c7f52bc215" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-46a99a3720f8b095" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a783885b72bcd7c7" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularXMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularxmotoroption/
---

# Astra.Components.Joint.AngularXMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularXMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-730abd44cab6b478) | Field |
| [Posicao](#member-da50b43467ccaa3f) | Field |
| [PosicaoEVelocidade](#member-1f829a586479b4ef) | Field |
| [Velocidade](#member-893b9cfa6078bacc) | Field |

<h3 id="member-730abd44cab6b478" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-da50b43467ccaa3f" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f829a586479b4ef" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-893b9cfa6078bacc" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularYMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularymotionoption/
---

# Astra.Components.Joint.AngularYMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularYMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-a2694ee9f78fb3fb) | Field |
| [Livre](#member-6b37236c85652cfd) | Field |
| [Travado](#member-746bd9f2f72f7b90) | Field |

<h3 id="member-a2694ee9f78fb3fb" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b37236c85652cfd" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-746bd9f2f72f7b90" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularYMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularymotoroption/
---

# Astra.Components.Joint.AngularYMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularYMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-e14841170dd89d1d) | Field |
| [Posicao](#member-db744773590e2852) | Field |
| [PosicaoEVelocidade](#member-c01ba24f3e2840ec) | Field |
| [Velocidade](#member-daec0fea19601706) | Field |

<h3 id="member-e14841170dd89d1d" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db744773590e2852" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c01ba24f3e2840ec" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-daec0fea19601706" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularZMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularzmotionoption/
---

# Astra.Components.Joint.AngularZMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularZMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-bc27a2df2ec48830) | Field |
| [Livre](#member-8b7b4381d2d05ddf) | Field |
| [Travado](#member-dfcfaf896cf83927) | Field |

<h3 id="member-bc27a2df2ec48830" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8b7b4381d2d05ddf" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dfcfaf896cf83927" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.AngularZMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularzmotoroption/
---

# Astra.Components.Joint.AngularZMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.AngularZMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-d1da9692aebe86dd) | Field |
| [Posicao](#member-a03122d9404eb935) | Field |
| [PosicaoEVelocidade](#member-578704fdce486272) | Field |
| [Velocidade](#member-85dd0c0216117abe) | Field |

<h3 id="member-d1da9692aebe86dd" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a03122d9404eb935" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-578704fdce486272" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85dd0c0216117abe" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.KindOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-kindoption/
---

# Astra.Components.Joint.KindOption

Enum da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.KindOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cone](#member-b734e3bee227729c) | Field |
| [Configuravel6DOF](#member-76acc5fa59643abb) | Field |
| [Deslizante](#member-3f8fcdd50f506c6f) | Field |
| [Distancia](#member-1a44938be0ca98d2) | Field |
| [Dobradica](#member-2b1e7ae13add9912) | Field |
| [Fixa](#member-e15fb4195b5bcc43) | Field |
| [Mola](#member-586f1b4ed5c0c447) | Field |
| [Ponto](#member-b0517d84d5f187ae) | Field |
| [SwingTwist](#member-69816e28f95bbb78) | Field |

<h3 id="member-b734e3bee227729c" class="astra-member">Cone</h3>

```csharp
Cone = 5
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-76acc5fa59643abb" class="astra-member">Configuravel6DOF</h3>

```csharp
Configuravel6DOF = 7
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f8fcdd50f506c6f" class="astra-member">Deslizante</h3>

```csharp
Deslizante = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1a44938be0ca98d2" class="astra-member">Distancia</h3>

```csharp
Distancia = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b1e7ae13add9912" class="astra-member">Dobradica</h3>

```csharp
Dobradica = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e15fb4195b5bcc43" class="astra-member">Fixa</h3>

```csharp
Fixa = 4
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-586f1b4ed5c0c447" class="astra-member">Mola</h3>

```csharp
Mola = 8
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0517d84d5f187ae" class="astra-member">Ponto</h3>

```csharp
Ponto = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-69816e28f95bbb78" class="astra-member">SwingTwist</h3>

```csharp
SwingTwist = 6
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearXMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearxmotionoption/
---

# Astra.Components.Joint.LinearXMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearXMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-fa56c45c58c07503) | Field |
| [Livre](#member-b3bf7ee196561bd7) | Field |
| [Travado](#member-c895474fc69a5e04) | Field |

<h3 id="member-fa56c45c58c07503" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b3bf7ee196561bd7" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c895474fc69a5e04" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearXMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearxmotoroption/
---

# Astra.Components.Joint.LinearXMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearXMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-2c861c8ef6826dd6) | Field |
| [Posicao](#member-c99adc16ffc454a8) | Field |
| [PosicaoEVelocidade](#member-38a024792b5e2438) | Field |
| [Velocidade](#member-70cfbb0d83548280) | Field |

<h3 id="member-2c861c8ef6826dd6" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c99adc16ffc454a8" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38a024792b5e2438" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-70cfbb0d83548280" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearYMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearymotionoption/
---

# Astra.Components.Joint.LinearYMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearYMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-2dc365538bffc609) | Field |
| [Livre](#member-98da39e53878598a) | Field |
| [Travado](#member-2dc8c90014f3e241) | Field |

<h3 id="member-2dc365538bffc609" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98da39e53878598a" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2dc8c90014f3e241" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearYMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearymotoroption/
---

# Astra.Components.Joint.LinearYMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearYMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-06630709664f6b03) | Field |
| [Posicao](#member-0f51e1b10322f5dc) | Field |
| [PosicaoEVelocidade](#member-08264e7fe711877f) | Field |
| [Velocidade](#member-66e0bdef88655570) | Field |

<h3 id="member-06630709664f6b03" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f51e1b10322f5dc" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08264e7fe711877f" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66e0bdef88655570" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearZMotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearzmotionoption/
---

# Astra.Components.Joint.LinearZMotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearZMotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Limitado](#member-dd407e2c18187434) | Field |
| [Livre](#member-dd8d3a6c2f9a95a6) | Field |
| [Travado](#member-e44db905ed09ea0e) | Field |

<h3 id="member-dd407e2c18187434" class="astra-member">Limitado</h3>

```csharp
Limitado = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd8d3a6c2f9a95a6" class="astra-member">Livre</h3>

```csharp
Livre = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e44db905ed09ea0e" class="astra-member">Travado</h3>

```csharp
Travado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.LinearZMotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearzmotoroption/
---

# Astra.Components.Joint.LinearZMotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.LinearZMotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-a6a2c894f8723f24) | Field |
| [Posicao](#member-c4990b599d77ae96) | Field |
| [PosicaoEVelocidade](#member-15a3378bfa341055) | Field |
| [Velocidade](#member-811c883087eec66a) | Field |

<h3 id="member-a6a2c894f8723f24" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4990b599d77ae96" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15a3378bfa341055" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-811c883087eec66a" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint.MotorOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint-motoroption/
---

# Astra.Components.Joint.MotorOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint.MotorOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Desligado](#member-e8b0d910589529e3) | Field |
| [Posicao](#member-ef35652021262b73) | Field |
| [PosicaoEVelocidade](#member-74bc427373d275c2) | Field |
| [Velocidade](#member-8cd40b2084cedc31) | Field |

<h3 id="member-e8b0d910589529e3" class="astra-member">Desligado</h3>

```csharp
Desligado = 0
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef35652021262b73" class="astra-member">Posicao</h3>

```csharp
Posicao = 2
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74bc427373d275c2" class="astra-member">PosicaoEVelocidade</h3>

```csharp
PosicaoEVelocidade = 3
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8cd40b2084cedc31" class="astra-member">Velocidade</h3>

```csharp
Velocidade = 1
```

**Caminho:** Inspector → Junta; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint2d/
---

# Astra.Components.Joint2D

Junta 2D: Fixed/Weld, Revolute, Prismatic ou Distance reais. Família Física 2D · Juntas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Joint2D
```

Junta 2D: Fixed/Weld, Revolute, Prismatic ou Distance reais. Família Física 2D · Juntas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Joint2D.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Joint2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Juntas** → **Junta 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Junta 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-joint/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-88562ebef5c48898) | Method |
| [Remove](#member-de870e0d14e422ac) | Method |
| [Wrap](#member-3654194fb6532aa9) | Method |
| [AnchorAX](#member-cbdf51de0832ecd8) | Property |
| [AnchorAY](#member-070e90d98a6a0ff0) | Property |
| [AnchorBX](#member-fbd1d849830f49af) | Property |
| [AnchorBY](#member-adad69a11f284596) | Property |
| [AngularDampingRatio](#member-184d4bdcda8922eb) | Property |
| [AngularHertz](#member-9eb96af5dda46124) | Property |
| [AxisAngleDegrees](#member-c6945d146d51bd59) | Property |
| [CollideConnected](#member-3666bb3fc5e00f0c) | Property |
| [Component](#member-39141fb0ded10449) | Property |
| [Enabled](#member-f23eec8837107793) | Property |
| [InstanceId](#member-e2607c8519b2fc1f) | Property |
| [IsAlive](#member-fe701ef62a67638a) | Property |
| [Kind](#member-f0c6f8e4a7a3c9b2) | Property |
| [Length](#member-5b06bacfa711f9aa) | Property |
| [LimitEnabled](#member-c736443ee5fc1598) | Property |
| [LinearDampingRatio](#member-97d9dfa6ec23a933) | Property |
| [LinearHertz](#member-47df75b6fab82c3e) | Property |
| [LowerLimit](#member-b7a1c47f67f9fb7c) | Property |
| [MaxLength](#member-e66fe6fa4281b40c) | Property |
| [MaxMotorForce](#member-e84f207d246417fc) | Property |
| [MaxMotorTorque](#member-dc04a3ed0d35cf41) | Property |
| [MinLength](#member-5333b7a2e493e861) | Property |
| [MotorAngularSpeedDegrees](#member-90fcfb150d6550d6) | Property |
| [MotorEnabled](#member-7fe576b732631432) | Property |
| [MotorSpeed](#member-5047519b75d7acd0) | Property |
| [Object](#member-2a6673d7bb29596c) | Property |
| [ReferenceAngleDegrees](#member-b84b4a208b4ae55a) | Property |
| [SpringDamping](#member-f3b3f09a5955fd08) | Property |
| [SpringEnabled](#member-13896640a363bc96) | Property |
| [SpringHertz](#member-782011928b316b31) | Property |
| [SpringTargetAngleDegrees](#member-f5859980b33acde1) | Property |
| [SpringTargetTranslation](#member-d6042c76eee2614e) | Property |
| [Target](#member-a9b936dbd189bcc8) | Property |
| [TypeId](#member-4a2caf3fafa733db) | Property |
| [UpperLimit](#member-0ae5efc1f96c2fb9) | Property |
| [WorldAnchor](#member-9d16d0acfc933a1d) | Property |

<h3 id="member-88562ebef5c48898" class="astra-member">.ctor</h3>

```csharp
public Joint2D(Astra.Component component)
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-de870e0d14e422ac" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3654194fb6532aa9" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Joint2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-cbdf51de0832ecd8" class="astra-member">AnchorAX</h3>

```csharp
public float AnchorAX { get; set; }
```

Anchor A X (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior.

**Uso:** **Anchor A X:** Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-070e90d98a6a0ff0" class="astra-member">AnchorAY</h3>

```csharp
public float AnchorAY { get; set; }
```

Anchor A Y (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior.

**Uso:** **Anchor A Y:** Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fbd1d849830f49af" class="astra-member">AnchorBX</h3>

```csharp
public float AnchorBX { get; set; }
```

Anchor B X (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior.

**Uso:** **Anchor B X:** Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-adad69a11f284596" class="astra-member">AnchorBY</h3>

```csharp
public float AnchorBY { get; set; }
```

Anchor B Y (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Anchors; ou fachada C# em um Behavior.

**Uso:** **Anchor B Y:** Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-184d4bdcda8922eb" class="astra-member">AngularDampingRatio</h3>

```csharp
public float AngularDampingRatio { get; set; }
```

Amortecimento angular weld

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Amortecimento angular weld:** Razão de amortecimento angular 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9eb96af5dda46124" class="astra-member">AngularHertz</h3>

```csharp
public float AngularHertz { get; set; }
```

Mola angular weld (Hz)

Faixa válida: 0 a 120.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Mola angular weld:** Frequência da ligação angular 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6945d146d51bd59" class="astra-member">AxisAngleDegrees</h3>

```csharp
public float AxisAngleDegrees { get; set; }
```

Eixo local A (graus)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Eixo local A:** Direção do eixo da junta 2D em graus.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3666bb3fc5e00f0c" class="astra-member">CollideConnected</h3>

```csharp
public bool CollideConnected { get; set; }
```

Colidir conectados

**Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Colidir conectados:** Permite colisão entre os corpos conectados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-39141fb0ded10449" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f23eec8837107793" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2607c8519b2fc1f" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fe701ef62a67638a" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0c6f8e4a7a3c9b2" class="astra-member">Kind</h3>

```csharp
public Astra.Components.Joint2D.KindOption Kind { get; set; }
```

Modo

**Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Modo:** Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b06bacfa711f9aa" class="astra-member">Length</h3>

```csharp
public float Length { get; set; }
```

Comprimento repouso (m)

Faixa válida: 0.005 a 1000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Comprimento repouso:** Comprimento de referência da junta Distance.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c736443ee5fc1598" class="astra-member">LimitEnabled</h3>

```csharp
public bool LimitEnabled { get; set; }
```

Limites

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Limites:** Ativa os limites configurados da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-97d9dfa6ec23a933" class="astra-member">LinearDampingRatio</h3>

```csharp
public float LinearDampingRatio { get; set; }
```

Amortecimento linear weld

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Amortecimento linear weld:** Razão de amortecimento linear 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47df75b6fab82c3e" class="astra-member">LinearHertz</h3>

```csharp
public float LinearHertz { get; set; }
```

Mola linear weld (Hz)

Faixa válida: 0 a 120.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Mola linear weld:** Frequência da ligação linear 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b7a1c47f67f9fb7c" class="astra-member">LowerLimit</h3>

```csharp
public float LowerLimit { get; set; }
```

Limite inferior

Faixa válida: -178 a 178.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Limite inferior:** Limite inferior da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e66fe6fa4281b40c" class="astra-member">MaxLength</h3>

```csharp
public float MaxLength { get; set; }
```

Comprimento máximo (m)

Faixa válida: 0.005 a 1000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Comprimento máximo:** Comprimento máximo da junta Distance.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e84f207d246417fc" class="astra-member">MaxMotorForce</h3>

```csharp
public float MaxMotorForce { get; set; }
```

Força máxima motor (N)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Força máxima motor:** Limite de força do motor linear 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dc04a3ed0d35cf41" class="astra-member">MaxMotorTorque</h3>

```csharp
public float MaxMotorTorque { get; set; }
```

Torque máximo motor (N m)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Torque máximo motor:** Limite de torque do motor angular 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5333b7a2e493e861" class="astra-member">MinLength</h3>

```csharp
public float MinLength { get; set; }
```

Comprimento mínimo (m)

Faixa válida: 0.005 a 1000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Comprimento mínimo:** Comprimento mínimo da junta Distance.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-90fcfb150d6550d6" class="astra-member">MotorAngularSpeedDegrees</h3>

```csharp
public float MotorAngularSpeedDegrees { get; set; }
```

Motor angular (graus/s)

Faixa válida: -36000 a 36000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Motor angular:** Velocidade angular alvo do motor 2D em graus/s.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7fe576b732631432" class="astra-member">MotorEnabled</h3>

```csharp
public bool MotorEnabled { get; set; }
```

Motor

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Motor:** Ativa motor da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5047519b75d7acd0" class="astra-member">MotorSpeed</h3>

```csharp
public float MotorSpeed { get; set; }
```

Velocidade motor (m/s)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Velocidade motor:** Velocidade linear alvo do motor da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a6673d7bb29596c" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b84b4a208b4ae55a" class="astra-member">ReferenceAngleDegrees</h3>

```csharp
public float ReferenceAngleDegrees { get; set; }
```

Ângulo referência (graus)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Ângulo referência:** Ângulo de referência relativo da junta 2D em graus.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f3b3f09a5955fd08" class="astra-member">SpringDamping</h3>

```csharp
public float SpringDamping { get; set; }
```

Razão amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Razão amortecimento:** Amortecimento da mola da junta.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-13896640a363bc96" class="astra-member">SpringEnabled</h3>

```csharp
public bool SpringEnabled { get; set; }
```

Mola

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Mola:** Ativa mola da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-782011928b316b31" class="astra-member">SpringHertz</h3>

```csharp
public float SpringHertz { get; set; }
```

Frequência mola (Hz)

Faixa válida: 0 a 120.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Frequência mola:** Frequência da mola 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f5859980b33acde1" class="astra-member">SpringTargetAngleDegrees</h3>

```csharp
public float SpringTargetAngleDegrees { get; set; }
```

Ângulo alvo (graus)

Faixa válida: -180 a 180.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Ângulo alvo:** Ângulo alvo da mola 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d6042c76eee2614e" class="astra-member">SpringTargetTranslation</h3>

```csharp
public float SpringTargetTranslation { get; set; }
```

Translação alvo (m)

Faixa válida: -1000 a 1000.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Translação alvo:** Translação alvo da mola 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9b936dbd189bcc8" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Corpo conectado

**Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Corpo conectado:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a2caf3fafa733db" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ae5efc1f96c2fb9" class="astra-member">UpperLimit</h3>

```csharp
public float UpperLimit { get; set; }
```

Limite superior

Faixa válida: -178 a 178.

**Caminho:** Inspector → Junta 2D → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Limite superior:** Limite superior da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9d16d0acfc933a1d" class="astra-member">WorldAnchor</h3>

```csharp
public bool WorldAnchor { get; set; }
```

Conectar ao mundo

**Caminho:** Inspector → Junta 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Conectar ao mundo:** Interpreta a âncora conforme a opção de mundo da junta 2D.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Joint2D.KindOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-joint2d-kindoption/
---

# Astra.Components.Joint2D.KindOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Joint2D.KindOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Juntas** → **Junta 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Joint2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Joint2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Distance](#member-027ec2cddfdf0d5a) | Field |
| [FixedWeld](#member-e7d8dc480b9ae136) | Field |
| [Prismatic](#member-9b6b4e4b27ee4e2a) | Field |
| [Revolute](#member-26293f5410449f57) | Field |

<h3 id="member-027ec2cddfdf0d5a" class="astra-member">Distance</h3>

```csharp
Distance = 3
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e7d8dc480b9ae136" class="astra-member">FixedWeld</h3>

```csharp
FixedWeld = 0
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b6b4e4b27ee4e2a" class="astra-member">Prismatic</h3>

```csharp
Prismatic = 2
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-26293f5410449f57" class="astra-member">Revolute</h3>

```csharp
Revolute = 1
```

**Caminho:** Inspector → Junta 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Light"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-light/
---

# Astra.Components.Light

Luz: Direcional, pontual ou spot. Família Luz · Luzes.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.Light
```

Luz: Direcional, pontual ou spot. Família Luz · Luzes.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-Light.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.Light>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Light>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Light(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Luz](/pt-br/snapshot-2026-10-06/componentes/astra-render-light/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ba0e9dc516822bc9) | Method |
| [Remove](#member-40147e7e850e7bf0) | Method |
| [Wrap](#member-32dea2e396de7b5d) | Method |
| [Color](#member-2108c5812a6c0d04) | Property |
| [ColorTemperature](#member-d128145087fdbbf1) | Property |
| [Component](#member-aa20c3de4f4457db) | Property |
| [Enabled](#member-74f1357ae0ad4d66) | Property |
| [InnerAngle](#member-96c2ed4ce6dc08dc) | Property |
| [InstanceId](#member-6d25e8e1db0e0be7) | Property |
| [Intensity](#member-76ec3d58dddc0dec) | Property |
| [IsAlive](#member-79fc699745254b4f) | Property |
| [Kind](#member-53138e0254db4e2f) | Property |
| [Object](#member-84088979eb2d971a) | Property |
| [OuterAngle](#member-ca11958543c07b92) | Property |
| [Range](#member-d0e21139bef0283f) | Property |
| [ShadowBias](#member-84db382537c3d55a) | Property |
| [ShadowMode](#member-cbd4a031e4f05335) | Property |
| [ShadowNearPlane](#member-2a5cc339bd07d52e) | Property |
| [ShadowNormalBias](#member-04dc9331488bb242) | Property |
| [ShadowResolution](#member-0d1821836e316885) | Property |
| [ShadowStrength](#member-5a561532f463c414) | Property |
| [TypeId](#member-dbdd3bf830c5c0b8) | Property |
| [Unit](#member-693210a135fe3adf) | Property |
| [UseColorTemperature](#member-7d99bb9a485f80e8) | Property |

<h3 id="member-ba0e9dc516822bc9" class="astra-member">.ctor</h3>

```csharp
public Light(Astra.Component component)
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-40147e7e850e7bf0" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-32dea2e396de7b5d" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.Light Wrap(Astra.Component component)
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-2108c5812a6c0d04" class="astra-member">Color</h3>

```csharp
public System.Numerics.Vector3 Color { get; set; }
```

Cor linear. Cor linear RGB

**Caminho:** Inspector → Luz → Emissão; ou fachada C# em um Behavior.

**Uso:** **Cor R:** Canal R da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente. **Cor G:** Canal G da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente. **Cor B:** Canal B da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d128145087fdbbf1" class="astra-member">ColorTemperature</h3>

```csharp
public float ColorTemperature { get; set; }
```

Temperatura (K). Multiplicada pela cor linear; D65 é 6500 K

Faixa válida: 1667 a 25000.

**Caminho:** Inspector → Luz → Emissão; ou fachada C# em um Behavior.

**Uso:** **Temperatura:** Multiplicada pela cor linear; D65 é 6500 K

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa20c3de4f4457db" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74f1357ae0ad4d66" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Acesa. Ativa a contribuição desta luz

**Caminho:** Inspector → Luz → Geral; ou fachada C# em um Behavior.

**Uso:** **Acesa:** Ativa a contribuição desta luz

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-96c2ed4ce6dc08dc" class="astra-member">InnerAngle</h3>

```csharp
public float InnerAngle { get; set; }
```

Meio-cone interno (°)

Faixa válida: 0 a 89.

**Caminho:** Inspector → Luz → Volume; ou fachada C# em um Behavior.

**Uso:** **Meio-cone interno:** Ângulo interno do cone spot; região de contribuição central.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d25e8e1db0e0be7" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-76ec3d58dddc0dec" class="astra-member">Intensity</h3>

```csharp
public float Intensity { get; set; }
```

Intensidade

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Luz → Emissão; ou fachada C# em um Behavior.

**Uso:** **Intensidade:** Energia da luz na unidade selecionada; compare com distância/alcance constantes.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79fc699745254b4f" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53138e0254db4e2f" class="astra-member">Kind</h3>

```csharp
public Astra.Components.Light.KindOption Kind { get; set; }
```

Modalidade. Tipo de emissão da luz

**Caminho:** Inspector → Luz → Geral; ou fachada C# em um Behavior.

**Uso:** **Modalidade:** Tipo de emissão da luz

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84088979eb2d971a" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ca11958543c07b92" class="astra-member">OuterAngle</h3>

```csharp
public float OuterAngle { get; set; }
```

Meio-cone externo (°)

Faixa válida: 0 a 89.

**Caminho:** Inspector → Luz → Volume; ou fachada C# em um Behavior.

**Uso:** **Meio-cone externo:** Ângulo externo do cone spot; limite de contribuição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d0e21139bef0283f" class="astra-member">Range</h3>

```csharp
public float Range { get; set; }
```

Alcance (m)

Faixa válida: 0.01 a 1000.

**Caminho:** Inspector → Luz → Volume; ou fachada C# em um Behavior.

**Uso:** **Alcance:** Alcance de contribuição da luz pontual/spot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84db382537c3d55a" class="astra-member">ShadowBias</h3>

```csharp
public float ShadowBias { get; set; }
```

Desvio (texel). Afasta a comparação de profundidade e some com a acne

Faixa válida: 0 a 2.

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Desvio:** Afasta a comparação de profundidade e some com a acne

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cbd4a031e4f05335" class="astra-member">ShadowMode</h3>

```csharp
public Astra.Components.Light.ShadowModeOption ShadowMode { get; set; }
```

Sombra. Projeção de sombra desta luz no atlas local

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Sombra:** Projeção de sombra desta luz no atlas local

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a5cc339bd07d52e" class="astra-member">ShadowNearPlane</h3>

```csharp
public float ShadowNearPlane { get; set; }
```

Plano próximo da sombra (m). Perto demais perde precisão; longe demais corta o que está junto da lâmpada

Faixa válida: 0.01 a 10.

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Plano próximo da sombra:** Perto demais perde precisão; longe demais corta o que está junto da lâmpada

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-04dc9331488bb242" class="astra-member">ShadowNormalBias</h3>

```csharp
public float ShadowNormalBias { get; set; }
```

Desvio na normal (texel). Desloca a amostra ao longo da normal; some com o serrilhado da borda

Faixa válida: 0 a 2.

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Desvio na normal:** Desloca a amostra ao longo da normal; some com o serrilhado da borda

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0d1821836e316885" class="astra-member">ShadowResolution</h3>

```csharp
public Astra.Components.Light.ShadowResolutionOption ShadowResolution { get; set; }
```

Resolução da sombra. Automática escolhe pelo tamanho da luz na tela

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Resolução da sombra:** Automática escolhe pelo tamanho da luz na tela

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5a561532f463c414" class="astra-member">ShadowStrength</h3>

```csharp
public float ShadowStrength { get; set; }
```

Força da sombra. 1 é sombra opaca; abaixo disso a luz vaza pelo oclusor

Faixa válida: 0 a 1.

**Caminho:** Inspector → Luz → Sombra; ou fachada C# em um Behavior.

**Uso:** **Força da sombra:** 1 é sombra opaca; abaixo disso a luz vaza pelo oclusor

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dbdd3bf830c5c0b8" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-693210a135fe3adf" class="astra-member">Unit</h3>

```csharp
public Astra.Components.Light.UnitOption Unit { get; set; }
```

Unidade. Direcional usa lux; luz local usa candela ou lúmen

**Caminho:** Inspector → Luz → Emissão; ou fachada C# em um Behavior.

**Uso:** **Unidade:** Direcional usa lux; luz local usa candela ou lúmen

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d99bb9a485f80e8" class="astra-member">UseColorTemperature</h3>

```csharp
public bool UseColorTemperature { get; set; }
```

Filtro por temperatura. Multiplica a cor pela temperatura de corpo negro

**Caminho:** Inspector → Luz → Emissão; ou fachada C# em um Behavior.

**Uso:** **Filtro por temperatura:** Multiplica a cor pela temperatura de corpo negro

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Light.KindOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-light-kindoption/
---

# Astra.Components.Light.KindOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Light.KindOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Light>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Light(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Direcional](#member-830f845a16f0958d) | Field |
| [Pontual](#member-d2cb4dbbacbedc64) | Field |
| [Spot](#member-713f898e427df406) | Field |

<h3 id="member-830f845a16f0958d" class="astra-member">Direcional</h3>

```csharp
Direcional = 0
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d2cb4dbbacbedc64" class="astra-member">Pontual</h3>

```csharp
Pontual = 1
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-713f898e427df406" class="astra-member">Spot</h3>

```csharp
Spot = 2
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Light.ShadowModeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-light-shadowmodeoption/
---

# Astra.Components.Light.ShadowModeOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Light.ShadowModeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Light>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Light(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Dura](#member-5265799725467d8e) | Field |
| [Nenhuma](#member-17208753d3d117e0) | Field |
| [Suave](#member-11ec6cdeaff1781f) | Field |

<h3 id="member-5265799725467d8e" class="astra-member">Dura</h3>

```csharp
Dura = 1
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-17208753d3d117e0" class="astra-member">Nenhuma</h3>

```csharp
Nenhuma = 0
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-11ec6cdeaff1781f" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Light.ShadowResolutionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-light-shadowresolutionoption/
---

# Astra.Components.Light.ShadowResolutionOption

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Light.ShadowResolutionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Light>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Light(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Alta](#member-819d4fb51c5284fb) | Field |
| [Automatica](#member-68a8e1e1cf9249ea) | Field |
| [Baixa](#member-e94c47a027f9e940) | Field |
| [Media](#member-1631e3f97885c8da) | Field |
| [MuitoAlta](#member-82121c5bcf1c01da) | Field |

<h3 id="member-819d4fb51c5284fb" class="astra-member">Alta</h3>

```csharp
Alta = 3
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68a8e1e1cf9249ea" class="astra-member">Automatica</h3>

```csharp
Automatica = 0
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e94c47a027f9e940" class="astra-member">Baixa</h3>

```csharp
Baixa = 1
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1631e3f97885c8da" class="astra-member">Media</h3>

```csharp
Media = 2
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-82121c5bcf1c01da" class="astra-member">MuitoAlta</h3>

```csharp
MuitoAlta = 4
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.Light.UnitOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-light-unitoption/
---

# Astra.Components.Light.UnitOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.Light.UnitOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<Light>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new Light(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [InternaLegada](#member-3943642f26d544e5) | Field |
| [LuxCandela](#member-093630d597206cfe) | Field |
| [LuxLumen](#member-96f2421cd91f866d) | Field |

<h3 id="member-3943642f26d544e5" class="astra-member">InternaLegada</h3>

```csharp
InternaLegada = 0
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-093630d597206cfe" class="astra-member">LuxCandela</h3>

```csharp
LuxCandela = 1
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-96f2421cd91f866d" class="astra-member">LuxLumen</h3>

```csharp
LuxLumen = 2
```

**Caminho:** Inspector → Luz; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LodGroup"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup/
---

# Astra.Components.LodGroup

LOD Group: Nível de detalhe pela altura na tela. Família Renderização · Desempenho.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.LodGroup
```

LOD Group: Nível de detalhe pela altura na tela. Família Renderização · Desempenho.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-LODGroup.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.LodGroup>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LodGroup>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LodGroup(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [LOD Group](/pt-br/snapshot-2026-10-06/componentes/astra-render-lod-group/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a9affaed6276fece) | Method |
| [Remove](#member-eb2d8b077aea5385) | Method |
| [Wrap](#member-cf5ed027b07bb41e) | Method |
| [AnimateCrossFading](#member-7b0086deef8b8cc2) | Property |
| [Component](#member-fb421e7d44d34032) | Property |
| [Enabled](#member-399bce546d5c5ea1) | Property |
| [FadeMode](#member-6a21d93d9481f6c2) | Property |
| [FadeWidth0](#member-5aa58ee90391751f) | Property |
| [FadeWidth1](#member-443ebd95b6c48475) | Property |
| [FadeWidth2](#member-0da6f3b99e4560aa) | Property |
| [FadeWidth3](#member-e04d9d90c82d7d75) | Property |
| [ForceLevel](#member-794120f6a2c9b736) | Property |
| [InstanceId](#member-84cc0f7e4bc85d34) | Property |
| [IsAlive](#member-c085bd675de98d1e) | Property |
| [Level0](#member-4cad14402c80178d) | Property |
| [Level1](#member-81c884c540392628) | Property |
| [Level2](#member-0abf6d0f05a83d9f) | Property |
| [Level3](#member-2683b4cc87529ebd) | Property |
| [LevelCount](#member-ee52248d49d97ee2) | Property |
| [Object](#member-35cfff34b5c98ee7) | Property |
| [Size](#member-6acfa3899de6a3aa) | Property |
| [Transition0](#member-91eb2fe00fd63378) | Property |
| [Transition1](#member-34ed24977ebeb864) | Property |
| [Transition2](#member-99c93c126c984936) | Property |
| [Transition3](#member-9454a476016f9d86) | Property |
| [TypeId](#member-4fd4883a53fdb479) | Property |

<h3 id="member-a9affaed6276fece" class="astra-member">.ctor</h3>

```csharp
public LodGroup(Astra.Component component)
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-eb2d8b077aea5385" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf5ed027b07bb41e" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.LodGroup Wrap(Astra.Component component)
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-7b0086deef8b8cc2" class="astra-member">AnimateCrossFading</h3>

```csharp
public bool AnimateCrossFading { get; set; }
```

Animate Cross-fading. Troca por tempo em vez da faixa de largura

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Animate Cross-fading:** Troca por tempo em vez da faixa de largura

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb421e7d44d34032" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-399bce546d5c5ea1" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo. Desligar libera os renderizadores do controle deste grupo

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Desligar libera os renderizadores do controle deste grupo

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a21d93d9481f6c2" class="astra-member">FadeMode</h3>

```csharp
public Astra.Components.LodGroup.FadeModeOption FadeMode { get; set; }
```

Fade Mode

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Fade Mode:** Seleciona a política de transição de LOD, no domínio indicado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5aa58ee90391751f" class="astra-member">FadeWidth0</h3>

```csharp
public float FadeWidth0 { get; set; }
```

Largura do fade LOD 0. Proporção do nível em que ele cruza com o próximo

Faixa válida: 0 a 1.

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Largura do fade LOD 0:** Proporção do nível em que ele cruza com o próximo

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-443ebd95b6c48475" class="astra-member">FadeWidth1</h3>

```csharp
public float FadeWidth1 { get; set; }
```

Largura do fade LOD 1. Proporção do nível em que ele cruza com o próximo

Faixa válida: 0 a 1.

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Largura do fade LOD 1:** Proporção do nível em que ele cruza com o próximo

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0da6f3b99e4560aa" class="astra-member">FadeWidth2</h3>

```csharp
public float FadeWidth2 { get; set; }
```

Largura do fade LOD 2. Proporção do nível em que ele cruza com o próximo

Faixa válida: 0 a 1.

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Largura do fade LOD 2:** Proporção do nível em que ele cruza com o próximo

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e04d9d90c82d7d75" class="astra-member">FadeWidth3</h3>

```csharp
public float FadeWidth3 { get; set; }
```

Largura do fade LOD 3. Proporção do nível em que ele cruza com o próximo

Faixa válida: 0 a 1.

**Caminho:** Inspector → LOD Group → Fade; ou fachada C# em um Behavior.

**Uso:** **Largura do fade LOD 3:** Proporção do nível em que ele cruza com o próximo

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-794120f6a2c9b736" class="astra-member">ForceLevel</h3>

```csharp
public Astra.Components.LodGroup.ForceLevelOption ForceLevel { get; set; }
```

Forçar nível. Estado de execução: 0 automático, n força o LOD n-1

**Caminho:** Inspector → LOD Group → Execução; ou fachada C# em um Behavior.

**Uso:** **Forçar nível:** Estado de execução: 0 automático, n força o LOD n-1

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84cc0f7e4bc85d34" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c085bd675de98d1e" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4cad14402c80178d" class="astra-member">Level0</h3>

```csharp
public Astra.ObjectReference Level0 { get; set; }
```

Objetos LOD 0

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Objetos LOD 0:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-81c884c540392628" class="astra-member">Level1</h3>

```csharp
public Astra.ObjectReference Level1 { get; set; }
```

Objetos LOD 1

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Objetos LOD 1:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0abf6d0f05a83d9f" class="astra-member">Level2</h3>

```csharp
public Astra.ObjectReference Level2 { get; set; }
```

Objetos LOD 2

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Objetos LOD 2:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2683b4cc87529ebd" class="astra-member">Level3</h3>

```csharp
public Astra.ObjectReference Level3 { get; set; }
```

Objetos LOD 3

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Objetos LOD 3:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee52248d49d97ee2" class="astra-member">LevelCount</h3>

```csharp
public Astra.Components.LodGroup.LevelCountOption LevelCount { get; set; }
```

Níveis

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Níveis:** Quantidade de níveis ativos de LOD. Atribua malhas/objetos por nível.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-35cfff34b5c98ee7" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6acfa3899de6a3aa" class="astra-member">Size</h3>

```csharp
public float Size { get; set; }
```

Tamanho. Maior extensão do nível mais detalhado; Recalcular mede a malha

Faixa válida: 0.001 a 1000000.

**Caminho:** Inspector → LOD Group → Limites; ou fachada C# em um Behavior.

**Uso:** **Tamanho:** Maior extensão do nível mais detalhado; Recalcular mede a malha

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-91eb2fe00fd63378" class="astra-member">Transition0</h3>

```csharp
public float Transition0 { get; set; }
```

Transição LOD 0 (%). Altura na tela abaixo da qual este nível deixa de ser usado

Faixa válida: 0.1 a 100.

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Transição LOD 0:** Altura na tela abaixo da qual este nível deixa de ser usado

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-34ed24977ebeb864" class="astra-member">Transition1</h3>

```csharp
public float Transition1 { get; set; }
```

Transição LOD 1 (%). Altura na tela abaixo da qual este nível deixa de ser usado

Faixa válida: 0.1 a 100.

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Transição LOD 1:** Altura na tela abaixo da qual este nível deixa de ser usado

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-99c93c126c984936" class="astra-member">Transition2</h3>

```csharp
public float Transition2 { get; set; }
```

Transição LOD 2 (%). Altura na tela abaixo da qual este nível deixa de ser usado

Faixa válida: 0.1 a 100.

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Transição LOD 2:** Altura na tela abaixo da qual este nível deixa de ser usado

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9454a476016f9d86" class="astra-member">Transition3</h3>

```csharp
public float Transition3 { get; set; }
```

Transição LOD 3 (%). Altura na tela abaixo da qual este nível deixa de ser usado

Faixa válida: 0.1 a 100.

**Caminho:** Inspector → LOD Group → Níveis; ou fachada C# em um Behavior.

**Uso:** **Transição LOD 3:** Altura na tela abaixo da qual este nível deixa de ser usado

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4fd4883a53fdb479" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LodGroup.FadeModeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-fademodeoption/
---

# Astra.Components.LodGroup.FadeModeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.LodGroup.FadeModeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LodGroup>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LodGroup(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [CrossFade](#member-14a3cd4de1510e0e) | Field |
| [Nenhum](#member-03719e24426d4433) | Field |

<h3 id="member-14a3cd4de1510e0e" class="astra-member">CrossFade</h3>

```csharp
CrossFade = 1
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03719e24426d4433" class="astra-member">Nenhum</h3>

```csharp
Nenhum = 0
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LodGroup.ForceLevelOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-forceleveloption/
---

# Astra.Components.LodGroup.ForceLevelOption

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.LodGroup.ForceLevelOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LodGroup>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LodGroup(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Automatico](#member-f48517aea0a3a3dc) | Field |
| [LOD0](#member-092afe8d4402d951) | Field |
| [LOD1](#member-d5b41f6c1a15cb23) | Field |
| [LOD2](#member-c3f94cc5242a066a) | Field |
| [LOD3](#member-047b93fd191675d9) | Field |

<h3 id="member-f48517aea0a3a3dc" class="astra-member">Automatico</h3>

```csharp
Automatico = 0
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-092afe8d4402d951" class="astra-member">LOD0</h3>

```csharp
LOD0 = 1
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d5b41f6c1a15cb23" class="astra-member">LOD1</h3>

```csharp
LOD1 = 2
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c3f94cc5242a066a" class="astra-member">LOD2</h3>

```csharp
LOD2 = 3
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-047b93fd191675d9" class="astra-member">LOD3</h3>

```csharp
LOD3 = 4
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LodGroup.LevelCountOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-levelcountoption/
---

# Astra.Components.LodGroup.LevelCountOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.LodGroup.LevelCountOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LodGroup>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LodGroup(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [V1](#member-3a886508d85d6ba0) | Field |
| [V2](#member-1de5822acdfb8cba) | Field |
| [V3](#member-1888cc4f80d1c359) | Field |
| [V4](#member-8342db3f23cc2bd6) | Field |

<h3 id="member-3a886508d85d6ba0" class="astra-member">V1</h3>

```csharp
V1 = 1
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1de5822acdfb8cba" class="astra-member">V2</h3>

```csharp
V2 = 2
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1888cc4f80d1c359" class="astra-member">V3</h3>

```csharp
V3 = 3
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8342db3f23cc2bd6" class="astra-member">V4</h3>

```csharp
V4 = 4
```

**Caminho:** Inspector → LOD Group; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LookAtConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lookatconstraint/
---

# Astra.Components.LookAtConstraint

Look At Constraint: Orienta +Z para a fonte com vertical e roll. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.LookAtConstraint
```

Look At Constraint: Orienta +Z para a fonte com vertical e roll. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-LookAtConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.LookAtConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Look At Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LookAtConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LookAtConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Look At Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-look-at/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-98c0741f040407f4) | Method |
| [Remove](#member-dc46fa9f2686065e) | Method |
| [Wrap](#member-503cf98b0ff963f1) | Method |
| [AxisX](#member-fc5840b4eebed82b) | Property |
| [AxisY](#member-edac6e2f2e8e59dc) | Property |
| [AxisZ](#member-47380d71a65a9e2a) | Property |
| [Component](#member-61939ce728681e5e) | Property |
| [Enabled](#member-4d7ed00dd4b79cac) | Property |
| [InstanceId](#member-3038f2132f22ee19) | Property |
| [IsAlive](#member-91d954c865259f8f) | Property |
| [Object](#member-f4556112355c124b) | Property |
| [Roll](#member-e8372611f33a1f30) | Property |
| [Target](#member-61aee7d1fb998f15) | Property |
| [TypeId](#member-bc09a68afc679812) | Property |
| [UpAxis](#member-5181e478f5357cf6) | Property |
| [Weight](#member-1c51c2ba6c82914c) | Property |

<h3 id="member-98c0741f040407f4" class="astra-member">.ctor</h3>

```csharp
public LookAtConstraint(Astra.Component component)
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-dc46fa9f2686065e" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-503cf98b0ff963f1" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.LookAtConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-fc5840b4eebed82b" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Look At Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-edac6e2f2e8e59dc" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Look At Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47380d71a65a9e2a" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Look At Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61939ce728681e5e" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d7ed00dd4b79cac" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Look At Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3038f2132f22ee19" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-91d954c865259f8f" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f4556112355c124b" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e8372611f33a1f30" class="astra-member">Roll</h3>

```csharp
public float Roll { get; set; }
```

Roll (graus)

Faixa válida: -360 a 360.

**Caminho:** Inspector → Look At Constraint → Mira; ou fachada C# em um Behavior.

**Uso:** **Roll:** Rotação em torno do eixo de mira; não muda a posição do alvo.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61aee7d1fb998f15" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Look At Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc09a68afc679812" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5181e478f5357cf6" class="astra-member">UpAxis</h3>

```csharp
public Astra.Components.LookAtConstraint.UpAxisOption UpAxis { get; set; }
```

Vertical de mundo

**Caminho:** Inspector → Look At Constraint → Mira; ou fachada C# em um Behavior.

**Uso:** **Vertical de mundo:** Define a convenção de vertical da orientação; evite direção degenerada.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1c51c2ba6c82914c" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Look At Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.LookAtConstraint.UpAxisOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-lookatconstraint-upaxisoption/
---

# Astra.Components.LookAtConstraint.UpAxisOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.LookAtConstraint.UpAxisOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Look At Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LookAtConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LookAtConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [X](#member-4e2f125b743f25a4) | Field |
| [Y](#member-4d47ebd6d3af8259) | Field |
| [Z](#member-4141b94296e2dad9) | Field |

<h3 id="member-4e2f125b743f25a4" class="astra-member">X</h3>

```csharp
X = 2
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d47ebd6d3af8259" class="astra-member">Y</h3>

```csharp
Y = 0
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4141b94296e2dad9" class="astra-member">Z</h3>

```csharp
Z = 1
```

**Caminho:** Inspector → Look At Constraint; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.MeshRenderer"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-meshrenderer/
---

# Astra.Components.MeshRenderer

Malha: Geometria e material. Família Renderização · Geometria.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.MeshRenderer
```

Malha: Geometria e material. Família Renderização · Geometria.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-MeshRenderer.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.MeshRenderer>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Geometria** → **Malha**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<MeshRenderer>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new MeshRenderer(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Malha](/pt-br/snapshot-2026-10-06/componentes/astra-render-mesh/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-552ef751e79d0d28) | Method |
| [GetChannelsAlphaSource](#member-a2eea2c6e36eda8c) | Method |
| [GetChannelsMetallic](#member-20b34f799700bab6) | Method |
| [GetChannelsNormalFlipY](#member-7a73afc4b5e9a78e) | Method |
| [GetChannelsOcclusion](#member-d0a6ef1b306f819b) | Method |
| [GetChannelsOcclusionSource](#member-c512bf428557bfdb) | Method |
| [GetChannelsOcclusionStrength](#member-83586fc591edf4ec) | Method |
| [GetChannelsRoughness](#member-6b62ab22fd565424) | Method |
| [GetLightmapEnabled](#member-fc9b7117fa1a3fa5) | Method |
| [GetLightmapIntensity](#member-31cc800ff5b3b0f9) | Method |
| [GetLightmapOffsetU](#member-1561cf539328b95e) | Method |
| [GetLightmapOffsetV](#member-f070612fb8acf600) | Method |
| [GetLightmapScaleU](#member-cb5710f900972f9c) | Method |
| [GetLightmapScaleV](#member-41c2c09413d41df8) | Method |
| [GetMaterial](#member-cb7b056a28be8311) | Method |
| [GetMaterialBaseColorB](#member-876511b5b2bb2971) | Method |
| [GetMaterialBaseColorG](#member-3defd87107f78ffc) | Method |
| [GetMaterialBaseColorR](#member-24e420adc36df220) | Method |
| [GetMaterialEmissionB](#member-78e65ca0297c4f52) | Method |
| [GetMaterialEmissionG](#member-603473a4e29f9cb7) | Method |
| [GetMaterialEmissionR](#member-1319f85cee5f278b) | Method |
| [GetMaterialEmissionStrength](#member-c331a89beacf6ee1) | Method |
| [GetMaterialMetallic](#member-0a85292a065b0673) | Method |
| [GetMaterialNormalScale](#member-d060c547210ec404) | Method |
| [GetMaterialOverride](#member-7f4989c15680c2e5) | Method |
| [GetMaterialRoughness](#member-aaf70e8111fd761b) | Method |
| [GetMaterialSpecular](#member-d1db135d2efaa505) | Method |
| [GetMesh](#member-85ada8fe99ecbd17) | Method |
| [GetSamplingBaseColorFilter](#member-4d1acecdfd27ed40) | Method |
| [GetSamplingBaseColorOffsetU](#member-6fd7c4eabb0c699b) | Method |
| [GetSamplingBaseColorOffsetV](#member-980fed8fb9814c3e) | Method |
| [GetSamplingBaseColorRotation](#member-13b7d0f95e5b702f) | Method |
| [GetSamplingBaseColorScaleU](#member-f6ede253f4c825a5) | Method |
| [GetSamplingBaseColorScaleV](#member-6e07efca488bcc86) | Method |
| [GetSamplingBaseColorUvSet](#member-7406356fad0ce2b8) | Method |
| [GetSamplingBaseColorWrap](#member-bd385505e02e3dc8) | Method |
| [GetSamplingEmissiveFilter](#member-a389988dbcc37163) | Method |
| [GetSamplingEmissiveOffsetU](#member-4d83f8c6a78a01a7) | Method |
| [GetSamplingEmissiveOffsetV](#member-12c61833f4bb18d0) | Method |
| [GetSamplingEmissiveRotation](#member-cd3d2eb34469fa57) | Method |
| [GetSamplingEmissiveScaleU](#member-69cfcc6df6711b74) | Method |
| [GetSamplingEmissiveScaleV](#member-a16f77971b1d0759) | Method |
| [GetSamplingEmissiveUvSet](#member-00affe5866d3b69d) | Method |
| [GetSamplingEmissiveWrap](#member-138a52c4eb5d14be) | Method |
| [GetSamplingFilter](#member-b8b48a927e7a2590) | Method |
| [GetSamplingMetallicRoughnessFilter](#member-deb03ee8cf4a260a) | Method |
| [GetSamplingMetallicRoughnessOffsetU](#member-476e5ce65e1a2a26) | Method |
| [GetSamplingMetallicRoughnessOffsetV](#member-5529252513434f59) | Method |
| [GetSamplingMetallicRoughnessRotation](#member-a796001e47bedf52) | Method |
| [GetSamplingMetallicRoughnessScaleU](#member-c9010bdd4f94c8c9) | Method |
| [GetSamplingMetallicRoughnessScaleV](#member-4a71b45d83b4c9bb) | Method |
| [GetSamplingMetallicRoughnessUvSet](#member-b9a70194876846f1) | Method |
| [GetSamplingMetallicRoughnessWrap](#member-e2a8475e4dd291e8) | Method |
| [GetSamplingNormalFilter](#member-baf4a18a5cb583d3) | Method |
| [GetSamplingNormalOffsetU](#member-e3dab20bf655564c) | Method |
| [GetSamplingNormalOffsetV](#member-03fe31b55a8c7477) | Method |
| [GetSamplingNormalRotation](#member-bf197d0fff2590c4) | Method |
| [GetSamplingNormalScaleU](#member-c28ea712c0785051) | Method |
| [GetSamplingNormalScaleV](#member-bd40ffbfed06b76a) | Method |
| [GetSamplingNormalUvSet](#member-98a8dd65b56315b7) | Method |
| [GetSamplingNormalWrap](#member-37e1fa22dafe03ab) | Method |
| [GetSamplingOffsetU](#member-67ab1b10c327e0af) | Method |
| [GetSamplingOffsetV](#member-8939b61c7a2be0cf) | Method |
| [GetSamplingRotation](#member-657ea6621336b761) | Method |
| [GetSamplingScaleU](#member-90558ae5fb431729) | Method |
| [GetSamplingScaleV](#member-ae2a68ec33dfc89b) | Method |
| [GetSamplingUvSet](#member-d44c92cfa5bbd394) | Method |
| [GetSamplingWrap](#member-5f71c0b85f3605b0) | Method |
| [GetSurfaceAlphaCutoff](#member-987687a60b0be2c0) | Method |
| [GetSurfaceAlphaMode](#member-dd20188b710b8ebe) | Method |
| [GetSurfaceSides](#member-a2c63f7c2cda76f9) | Method |
| [GetTextureBaseColor](#member-d313a1a4d8460ef8) | Method |
| [GetTextureEmissive](#member-a8025d540c625f70) | Method |
| [GetTextureLightmap](#member-cc856cf84241a106) | Method |
| [GetTextureMetallicRoughness](#member-eebfd63276f60131) | Method |
| [GetTextureNormal](#member-282778aed11f844c) | Method |
| [GetTextureOcclusion](#member-eafc68d87455286f) | Method |
| [Remove](#member-0a98c892ec42f660) | Method |
| [SetChannelsAlphaSource](#member-bbcbcad88359c78a) | Method |
| [SetChannelsMetallic](#member-7af8c9f5f6a653cc) | Method |
| [SetChannelsNormalFlipY](#member-f0609696a66f45e6) | Method |
| [SetChannelsOcclusion](#member-90f6b47b70489f25) | Method |
| [SetChannelsOcclusionSource](#member-1013e4ba7d096a9b) | Method |
| [SetChannelsOcclusionStrength](#member-ca76935cda7a1731) | Method |
| [SetChannelsRoughness](#member-4d5c333c106e9cd8) | Method |
| [SetLightmapEnabled](#member-e04080ae2bfe2072) | Method |
| [SetLightmapIntensity](#member-bd19a758c70f8013) | Method |
| [SetLightmapOffsetU](#member-f08cec5d3d8a6bb6) | Method |
| [SetLightmapOffsetV](#member-9f2ecb34c63d8732) | Method |
| [SetLightmapScaleU](#member-bf9663b5769be09d) | Method |
| [SetLightmapScaleV](#member-7aa788d9e44bcde3) | Method |
| [SetMaterial](#member-a3dc4a9322731b40) | Method |
| [SetMaterialBaseColorB](#member-103cacb3424c6de3) | Method |
| [SetMaterialBaseColorG](#member-d17228b87324d943) | Method |
| [SetMaterialBaseColorR](#member-9f4b6e6703dda636) | Method |
| [SetMaterialEmissionB](#member-cc16dd86ab34a3b5) | Method |
| [SetMaterialEmissionG](#member-40613b56b76a414e) | Method |
| [SetMaterialEmissionR](#member-1c137706b918e376) | Method |
| [SetMaterialEmissionStrength](#member-e38b36e1a2246b9b) | Method |
| [SetMaterialMetallic](#member-642c25b6919bd924) | Method |
| [SetMaterialNormalScale](#member-670b1f8702af4b18) | Method |
| [SetMaterialOverride](#member-02deb8cf6ecbfb50) | Method |
| [SetMaterialRoughness](#member-8a360c7ccafefb5c) | Method |
| [SetMaterialSpecular](#member-bb8f4bbb21cb2fd5) | Method |
| [SetMesh](#member-a20bc66045d6c1c6) | Method |
| [SetSamplingBaseColorFilter](#member-f90ead60374c2661) | Method |
| [SetSamplingBaseColorOffsetU](#member-29abd23de20db984) | Method |
| [SetSamplingBaseColorOffsetV](#member-f0122e8dc1269156) | Method |
| [SetSamplingBaseColorRotation](#member-79e3135c602740f6) | Method |
| [SetSamplingBaseColorScaleU](#member-ee2252d2fa668d92) | Method |
| [SetSamplingBaseColorScaleV](#member-88129177aa8a4ab1) | Method |
| [SetSamplingBaseColorUvSet](#member-0f538aa39d894737) | Method |
| [SetSamplingBaseColorWrap](#member-95aae61c3e921ee0) | Method |
| [SetSamplingEmissiveFilter](#member-ff3c96a49f54fbad) | Method |
| [SetSamplingEmissiveOffsetU](#member-4e11f0cf6ae668a0) | Method |
| [SetSamplingEmissiveOffsetV](#member-6dc08005480e04bd) | Method |
| [SetSamplingEmissiveRotation](#member-650e76056cd8d57d) | Method |
| [SetSamplingEmissiveScaleU](#member-f453d873a2fa6231) | Method |
| [SetSamplingEmissiveScaleV](#member-f73c31352e43edc4) | Method |
| [SetSamplingEmissiveUvSet](#member-e8b80c080ef24c55) | Method |
| [SetSamplingEmissiveWrap](#member-7179543a8ba375dc) | Method |
| [SetSamplingFilter](#member-43e986e8a5f7cc0e) | Method |
| [SetSamplingMetallicRoughnessFilter](#member-ae32d4d65c8bcf9b) | Method |
| [SetSamplingMetallicRoughnessOffsetU](#member-e0739737edfa4ddd) | Method |
| [SetSamplingMetallicRoughnessOffsetV](#member-2fd4804d7c9d6ccb) | Method |
| [SetSamplingMetallicRoughnessRotation](#member-084c11338936baad) | Method |
| [SetSamplingMetallicRoughnessScaleU](#member-8d78a8fe9b62391f) | Method |
| [SetSamplingMetallicRoughnessScaleV](#member-dc5c1e5888fa0b18) | Method |
| [SetSamplingMetallicRoughnessUvSet](#member-3235d6d1c91c1e5a) | Method |
| [SetSamplingMetallicRoughnessWrap](#member-81a04b22978463e0) | Method |
| [SetSamplingNormalFilter](#member-f6a2755050f13703) | Method |
| [SetSamplingNormalOffsetU](#member-107ce6f9b2528cbb) | Method |
| [SetSamplingNormalOffsetV](#member-2e28fe24b09be295) | Method |
| [SetSamplingNormalRotation](#member-3b79f52a5e425a12) | Method |
| [SetSamplingNormalScaleU](#member-61b8f2716a5e94e3) | Method |
| [SetSamplingNormalScaleV](#member-da0b88e1c6e4e8c4) | Method |
| [SetSamplingNormalUvSet](#member-ce33b579148a3d0e) | Method |
| [SetSamplingNormalWrap](#member-39079b485e2b8616) | Method |
| [SetSamplingOffsetU](#member-7653c745b4ca8db5) | Method |
| [SetSamplingOffsetV](#member-6ce806d66f60a9f2) | Method |
| [SetSamplingRotation](#member-fe599d9cddc001a4) | Method |
| [SetSamplingScaleU](#member-b4312b926dbd82d3) | Method |
| [SetSamplingScaleV](#member-aa75c97c1eb89e40) | Method |
| [SetSamplingUvSet](#member-54cbde833e338c40) | Method |
| [SetSamplingWrap](#member-f228c71050ce142c) | Method |
| [SetSurfaceAlphaCutoff](#member-6c2192c57da532fa) | Method |
| [SetSurfaceAlphaMode](#member-a6104378c39853f2) | Method |
| [SetSurfaceSides](#member-1191a7900cb74f52) | Method |
| [SetTextureBaseColor](#member-f7e263b9f6f57d29) | Method |
| [SetTextureEmissive](#member-01042d6dc57cb4cf) | Method |
| [SetTextureLightmap](#member-51c5c663318e9581) | Method |
| [SetTextureMetallicRoughness](#member-a6e8269f45872103) | Method |
| [SetTextureNormal](#member-01d6565e237840eb) | Method |
| [SetTextureOcclusion](#member-3edd5a0f69fc93bb) | Method |
| [Wrap](#member-513ac033de7281a1) | Method |
| [BaseColorB](#member-6d1a51967825e8b5) | Property |
| [BaseColorG](#member-0cc36aa08e5e3d05) | Property |
| [BaseColorR](#member-79756fdc2cae36b8) | Property |
| [Component](#member-362d3795ece9727a) | Property |
| [EmissionB](#member-e6dee08c44d8d091) | Property |
| [EmissionG](#member-49980dbcff3c0e49) | Property |
| [EmissionR](#member-cc416ddfc6a85b8a) | Property |
| [EmissionStrength](#member-2c24d7321d15b597) | Property |
| [Enabled](#member-e4908369a1b85022) | Property |
| [InstanceId](#member-ea40cbfbe74864ff) | Property |
| [IsAlive](#member-21f889238c754ce4) | Property |
| [Metallic](#member-c9f3dcd5abbc56a6) | Property |
| [NormalScale](#member-ff0c921c987ed468) | Property |
| [Object](#member-093dfb9df257edf4) | Property |
| [Roughness](#member-a40c0aa974ab87fd) | Property |
| [Specular](#member-d41cab5a05b19823) | Property |
| [TypeId](#member-d6931f2f713b51fb) | Property |

<h3 id="member-552ef751e79d0d28" class="astra-member">.ctor</h3>

```csharp
public MeshRenderer(Astra.Component component)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a2eea2c6e36eda8c" class="astra-member">GetChannelsAlphaSource</h3>

```csharp
public uint GetChannelsAlphaSource(uint slot)
```

Origem do alfa. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Origem do alfa. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-20b34f799700bab6" class="astra-member">GetChannelsMetallic</h3>

```csharp
public uint GetChannelsMetallic(uint slot)
```

Canal do metálico. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Canal do metálico. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-7a73afc4b5e9a78e" class="astra-member">GetChannelsNormalFlipY</h3>

```csharp
public uint GetChannelsNormalFlipY(uint slot)
```

Inverter Y da normal. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Inverter Y da normal. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-d0a6ef1b306f819b" class="astra-member">GetChannelsOcclusion</h3>

```csharp
public uint GetChannelsOcclusion(uint slot)
```

Canal da oclusão. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Canal da oclusão. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-c512bf428557bfdb" class="astra-member">GetChannelsOcclusionSource</h3>

```csharp
public uint GetChannelsOcclusionSource(uint slot)
```

Origem da oclusão. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Origem da oclusão. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-83586fc591edf4ec" class="astra-member">GetChannelsOcclusionStrength</h3>

```csharp
public float GetChannelsOcclusionStrength(uint slot)
```

Força da oclusão. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Força da oclusão. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-6b62ab22fd565424" class="astra-member">GetChannelsRoughness</h3>

```csharp
public uint GetChannelsRoughness(uint slot)
```

Canal da rugosidade. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Canal da rugosidade. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-fc9b7117fa1a3fa5" class="astra-member">GetLightmapEnabled</h3>

```csharp
public uint GetLightmapEnabled(uint slot)
```

Receber lightmap indireto. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Receber lightmap indireto. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-31cc800ff5b3b0f9" class="astra-member">GetLightmapIntensity</h3>

```csharp
public float GetLightmapIntensity(uint slot)
```

Intensidade. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Intensidade. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-1561cf539328b95e" class="astra-member">GetLightmapOffsetU</h3>

```csharp
public float GetLightmapOffsetU(uint slot)
```

Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-f070612fb8acf600" class="astra-member">GetLightmapOffsetV</h3>

```csharp
public float GetLightmapOffsetV(uint slot)
```

Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-cb5710f900972f9c" class="astra-member">GetLightmapScaleU</h3>

```csharp
public float GetLightmapScaleU(uint slot)
```

Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-41c2c09413d41df8" class="astra-member">GetLightmapScaleV</h3>

```csharp
public float GetLightmapScaleV(uint slot)
```

Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-cb7b056a28be8311" class="astra-member">GetMaterial</h3>

```csharp
public Astra.AssetGuid GetMaterial(uint slot = 0)
```

Material. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Material. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-876511b5b2bb2971" class="astra-member">GetMaterialBaseColorB</h3>

```csharp
public float GetMaterialBaseColorB(uint slot)
```

Cor B. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor B. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-3defd87107f78ffc" class="astra-member">GetMaterialBaseColorG</h3>

```csharp
public float GetMaterialBaseColorG(uint slot)
```

Cor G. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor G. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-24e420adc36df220" class="astra-member">GetMaterialBaseColorR</h3>

```csharp
public float GetMaterialBaseColorR(uint slot)
```

Cor R. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor R. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-78e65ca0297c4f52" class="astra-member">GetMaterialEmissionB</h3>

```csharp
public float GetMaterialEmissionB(uint slot)
```

Emissão B. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão B. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-603473a4e29f9cb7" class="astra-member">GetMaterialEmissionG</h3>

```csharp
public float GetMaterialEmissionG(uint slot)
```

Emissão G. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão G. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-1319f85cee5f278b" class="astra-member">GetMaterialEmissionR</h3>

```csharp
public float GetMaterialEmissionR(uint slot)
```

Emissão R. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão R. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-c331a89beacf6ee1" class="astra-member">GetMaterialEmissionStrength</h3>

```csharp
public float GetMaterialEmissionStrength(uint slot)
```

Potência de emissão. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Potência de emissão. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-0a85292a065b0673" class="astra-member">GetMaterialMetallic</h3>

```csharp
public float GetMaterialMetallic(uint slot)
```

Metálico. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metálico. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-d060c547210ec404" class="astra-member">GetMaterialNormalScale</h3>

```csharp
public float GetMaterialNormalScale(uint slot)
```

Intensidade da normal. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Intensidade da normal. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-7f4989c15680c2e5" class="astra-member">GetMaterialOverride</h3>

```csharp
public uint GetMaterialOverride(uint slot)
```

Material. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Material. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-aaf70e8111fd761b" class="astra-member">GetMaterialRoughness</h3>

```csharp
public float GetMaterialRoughness(uint slot)
```

Rugosidade. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Rugosidade. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-d1db135d2efaa505" class="astra-member">GetMaterialSpecular</h3>

```csharp
public float GetMaterialSpecular(uint slot)
```

Especular. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Especular. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-85ada8fe99ecbd17" class="astra-member">GetMesh</h3>

```csharp
public Astra.AssetGuid GetMesh(uint slot = 0)
```

Malha. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Malha. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-4d1acecdfd27ed40" class="astra-member">GetSamplingBaseColorFilter</h3>

```csharp
public uint GetSamplingBaseColorFilter(uint slot)
```

Cor base / Filtro. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Filtro. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-6fd7c4eabb0c699b" class="astra-member">GetSamplingBaseColorOffsetU</h3>

```csharp
public float GetSamplingBaseColorOffsetU(uint slot)
```

Cor base / Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-980fed8fb9814c3e" class="astra-member">GetSamplingBaseColorOffsetV</h3>

```csharp
public float GetSamplingBaseColorOffsetV(uint slot)
```

Cor base / Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-13b7d0f95e5b702f" class="astra-member">GetSamplingBaseColorRotation</h3>

```csharp
public float GetSamplingBaseColorRotation(uint slot)
```

Cor base / Rotação. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Rotação. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-f6ede253f4c825a5" class="astra-member">GetSamplingBaseColorScaleU</h3>

```csharp
public float GetSamplingBaseColorScaleU(uint slot)
```

Cor base / Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-6e07efca488bcc86" class="astra-member">GetSamplingBaseColorScaleV</h3>

```csharp
public float GetSamplingBaseColorScaleV(uint slot)
```

Cor base / Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-7406356fad0ce2b8" class="astra-member">GetSamplingBaseColorUvSet</h3>

```csharp
public uint GetSamplingBaseColorUvSet(uint slot)
```

Cor base / UV. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / UV. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-bd385505e02e3dc8" class="astra-member">GetSamplingBaseColorWrap</h3>

```csharp
public uint GetSamplingBaseColorWrap(uint slot)
```

Cor base / Repetição. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base / Repetição. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-a389988dbcc37163" class="astra-member">GetSamplingEmissiveFilter</h3>

```csharp
public uint GetSamplingEmissiveFilter(uint slot)
```

Emissão / Filtro. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Filtro. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-4d83f8c6a78a01a7" class="astra-member">GetSamplingEmissiveOffsetU</h3>

```csharp
public float GetSamplingEmissiveOffsetU(uint slot)
```

Emissão / Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-12c61833f4bb18d0" class="astra-member">GetSamplingEmissiveOffsetV</h3>

```csharp
public float GetSamplingEmissiveOffsetV(uint slot)
```

Emissão / Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-cd3d2eb34469fa57" class="astra-member">GetSamplingEmissiveRotation</h3>

```csharp
public float GetSamplingEmissiveRotation(uint slot)
```

Emissão / Rotação. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Rotação. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-69cfcc6df6711b74" class="astra-member">GetSamplingEmissiveScaleU</h3>

```csharp
public float GetSamplingEmissiveScaleU(uint slot)
```

Emissão / Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-a16f77971b1d0759" class="astra-member">GetSamplingEmissiveScaleV</h3>

```csharp
public float GetSamplingEmissiveScaleV(uint slot)
```

Emissão / Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-00affe5866d3b69d" class="astra-member">GetSamplingEmissiveUvSet</h3>

```csharp
public uint GetSamplingEmissiveUvSet(uint slot)
```

Emissão / UV. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / UV. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-138a52c4eb5d14be" class="astra-member">GetSamplingEmissiveWrap</h3>

```csharp
public uint GetSamplingEmissiveWrap(uint slot)
```

Emissão / Repetição. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão / Repetição. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-b8b48a927e7a2590" class="astra-member">GetSamplingFilter</h3>

```csharp
public uint GetSamplingFilter(uint slot)
```

Filtro. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Filtro. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-deb03ee8cf4a260a" class="astra-member">GetSamplingMetallicRoughnessFilter</h3>

```csharp
public uint GetSamplingMetallicRoughnessFilter(uint slot)
```

Metal / rugosidade / Filtro. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Filtro. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-476e5ce65e1a2a26" class="astra-member">GetSamplingMetallicRoughnessOffsetU</h3>

```csharp
public float GetSamplingMetallicRoughnessOffsetU(uint slot)
```

Metal / rugosidade / Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-5529252513434f59" class="astra-member">GetSamplingMetallicRoughnessOffsetV</h3>

```csharp
public float GetSamplingMetallicRoughnessOffsetV(uint slot)
```

Metal / rugosidade / Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-a796001e47bedf52" class="astra-member">GetSamplingMetallicRoughnessRotation</h3>

```csharp
public float GetSamplingMetallicRoughnessRotation(uint slot)
```

Metal / rugosidade / Rotação. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Rotação. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-c9010bdd4f94c8c9" class="astra-member">GetSamplingMetallicRoughnessScaleU</h3>

```csharp
public float GetSamplingMetallicRoughnessScaleU(uint slot)
```

Metal / rugosidade / Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-4a71b45d83b4c9bb" class="astra-member">GetSamplingMetallicRoughnessScaleV</h3>

```csharp
public float GetSamplingMetallicRoughnessScaleV(uint slot)
```

Metal / rugosidade / Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-b9a70194876846f1" class="astra-member">GetSamplingMetallicRoughnessUvSet</h3>

```csharp
public uint GetSamplingMetallicRoughnessUvSet(uint slot)
```

Metal / rugosidade / UV. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / UV. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-e2a8475e4dd291e8" class="astra-member">GetSamplingMetallicRoughnessWrap</h3>

```csharp
public uint GetSamplingMetallicRoughnessWrap(uint slot)
```

Metal / rugosidade / Repetição. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade / Repetição. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-baf4a18a5cb583d3" class="astra-member">GetSamplingNormalFilter</h3>

```csharp
public uint GetSamplingNormalFilter(uint slot)
```

Normal / Filtro. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Filtro. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-e3dab20bf655564c" class="astra-member">GetSamplingNormalOffsetU</h3>

```csharp
public float GetSamplingNormalOffsetU(uint slot)
```

Normal / Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-03fe31b55a8c7477" class="astra-member">GetSamplingNormalOffsetV</h3>

```csharp
public float GetSamplingNormalOffsetV(uint slot)
```

Normal / Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-bf197d0fff2590c4" class="astra-member">GetSamplingNormalRotation</h3>

```csharp
public float GetSamplingNormalRotation(uint slot)
```

Normal / Rotação. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Rotação. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-c28ea712c0785051" class="astra-member">GetSamplingNormalScaleU</h3>

```csharp
public float GetSamplingNormalScaleU(uint slot)
```

Normal / Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-bd40ffbfed06b76a" class="astra-member">GetSamplingNormalScaleV</h3>

```csharp
public float GetSamplingNormalScaleV(uint slot)
```

Normal / Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-98a8dd65b56315b7" class="astra-member">GetSamplingNormalUvSet</h3>

```csharp
public uint GetSamplingNormalUvSet(uint slot)
```

Normal / UV. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / UV. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-37e1fa22dafe03ab" class="astra-member">GetSamplingNormalWrap</h3>

```csharp
public uint GetSamplingNormalWrap(uint slot)
```

Normal / Repetição. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal / Repetição. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-67ab1b10c327e0af" class="astra-member">GetSamplingOffsetU</h3>

```csharp
public float GetSamplingOffsetU(uint slot)
```

Deslocamento U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Deslocamento U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-8939b61c7a2be0cf" class="astra-member">GetSamplingOffsetV</h3>

```csharp
public float GetSamplingOffsetV(uint slot)
```

Deslocamento V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Deslocamento V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-657ea6621336b761" class="astra-member">GetSamplingRotation</h3>

```csharp
public float GetSamplingRotation(uint slot)
```

Rotação da UV. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Rotação da UV. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-90558ae5fb431729" class="astra-member">GetSamplingScaleU</h3>

```csharp
public float GetSamplingScaleU(uint slot)
```

Escala U. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Escala U. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-ae2a68ec33dfc89b" class="astra-member">GetSamplingScaleV</h3>

```csharp
public float GetSamplingScaleV(uint slot)
```

Escala V. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Escala V. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-d44c92cfa5bbd394" class="astra-member">GetSamplingUvSet</h3>

```csharp
public uint GetSamplingUvSet(uint slot)
```

Conjunto de UV. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Conjunto de UV. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-5f71c0b85f3605b0" class="astra-member">GetSamplingWrap</h3>

```csharp
public uint GetSamplingWrap(uint slot)
```

Repetição. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Repetição. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-987687a60b0be2c0" class="astra-member">GetSurfaceAlphaCutoff</h3>

```csharp
public float GetSurfaceAlphaCutoff(uint slot)
```

Corte do alfa. Valor por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Corte do alfa. Valor por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-dd20188b710b8ebe" class="astra-member">GetSurfaceAlphaMode</h3>

```csharp
public uint GetSurfaceAlphaMode(uint slot)
```

Tipo de superfície. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Tipo de superfície. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-a2c63f7c2cda76f9" class="astra-member">GetSurfaceSides</h3>

```csharp
public uint GetSurfaceSides(uint slot)
```

Faces. Opção por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Faces. Opção por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-d313a1a4d8460ef8" class="astra-member">GetTextureBaseColor</h3>

```csharp
public Astra.AssetGuid GetTextureBaseColor(uint slot = 0)
```

Cor base. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Cor base. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a8025d540c625f70" class="astra-member">GetTextureEmissive</h3>

```csharp
public Astra.AssetGuid GetTextureEmissive(uint slot = 0)
```

Emissão. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Emissão. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-cc856cf84241a106" class="astra-member">GetTextureLightmap</h3>

```csharp
public Astra.AssetGuid GetTextureLightmap(uint slot = 0)
```

Lightmap indireto (RGB linear / UV1). Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Lightmap indireto (RGB linear / UV1). Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-eebfd63276f60131" class="astra-member">GetTextureMetallicRoughness</h3>

```csharp
public Astra.AssetGuid GetTextureMetallicRoughness(uint slot = 0)
```

Metal / rugosidade. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Metal / rugosidade. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-282778aed11f844c" class="astra-member">GetTextureNormal</h3>

```csharp
public Astra.AssetGuid GetTextureNormal(uint slot = 0)
```

Normal. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Normal. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-eafc68d87455286f" class="astra-member">GetTextureOcclusion</h3>

```csharp
public Astra.AssetGuid GetTextureOcclusion(uint slot = 0)
```

Oclusão. Recurso do projeto por slot

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Oclusão. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-0a98c892ec42f660" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bbcbcad88359c78a" class="astra-member">SetChannelsAlphaSource</h3>

```csharp
public void SetChannelsAlphaSource(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-7af8c9f5f6a653cc" class="astra-member">SetChannelsMetallic</h3>

```csharp
public void SetChannelsMetallic(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-f0609696a66f45e6" class="astra-member">SetChannelsNormalFlipY</h3>

```csharp
public void SetChannelsNormalFlipY(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-90f6b47b70489f25" class="astra-member">SetChannelsOcclusion</h3>

```csharp
public void SetChannelsOcclusion(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-1013e4ba7d096a9b" class="astra-member">SetChannelsOcclusionSource</h3>

```csharp
public void SetChannelsOcclusionSource(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-ca76935cda7a1731" class="astra-member">SetChannelsOcclusionStrength</h3>

```csharp
public void SetChannelsOcclusionStrength(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-4d5c333c106e9cd8" class="astra-member">SetChannelsRoughness</h3>

```csharp
public void SetChannelsRoughness(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-e04080ae2bfe2072" class="astra-member">SetLightmapEnabled</h3>

```csharp
public void SetLightmapEnabled(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-bd19a758c70f8013" class="astra-member">SetLightmapIntensity</h3>

```csharp
public void SetLightmapIntensity(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-f08cec5d3d8a6bb6" class="astra-member">SetLightmapOffsetU</h3>

```csharp
public void SetLightmapOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-9f2ecb34c63d8732" class="astra-member">SetLightmapOffsetV</h3>

```csharp
public void SetLightmapOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-bf9663b5769be09d" class="astra-member">SetLightmapScaleU</h3>

```csharp
public void SetLightmapScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-7aa788d9e44bcde3" class="astra-member">SetLightmapScaleV</h3>

```csharp
public void SetLightmapScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-a3dc4a9322731b40" class="astra-member">SetMaterial</h3>

```csharp
public void SetMaterial(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-103cacb3424c6de3" class="astra-member">SetMaterialBaseColorB</h3>

```csharp
public void SetMaterialBaseColorB(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-d17228b87324d943" class="astra-member">SetMaterialBaseColorG</h3>

```csharp
public void SetMaterialBaseColorG(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-9f4b6e6703dda636" class="astra-member">SetMaterialBaseColorR</h3>

```csharp
public void SetMaterialBaseColorR(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-cc16dd86ab34a3b5" class="astra-member">SetMaterialEmissionB</h3>

```csharp
public void SetMaterialEmissionB(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-40613b56b76a414e" class="astra-member">SetMaterialEmissionG</h3>

```csharp
public void SetMaterialEmissionG(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-1c137706b918e376" class="astra-member">SetMaterialEmissionR</h3>

```csharp
public void SetMaterialEmissionR(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-e38b36e1a2246b9b" class="astra-member">SetMaterialEmissionStrength</h3>

```csharp
public void SetMaterialEmissionStrength(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-642c25b6919bd924" class="astra-member">SetMaterialMetallic</h3>

```csharp
public void SetMaterialMetallic(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-670b1f8702af4b18" class="astra-member">SetMaterialNormalScale</h3>

```csharp
public void SetMaterialNormalScale(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-02deb8cf6ecbfb50" class="astra-member">SetMaterialOverride</h3>

```csharp
public void SetMaterialOverride(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-8a360c7ccafefb5c" class="astra-member">SetMaterialRoughness</h3>

```csharp
public void SetMaterialRoughness(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-bb8f4bbb21cb2fd5" class="astra-member">SetMaterialSpecular</h3>

```csharp
public void SetMaterialSpecular(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-a20bc66045d6c1c6" class="astra-member">SetMesh</h3>

```csharp
public void SetMesh(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-f90ead60374c2661" class="astra-member">SetSamplingBaseColorFilter</h3>

```csharp
public void SetSamplingBaseColorFilter(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-29abd23de20db984" class="astra-member">SetSamplingBaseColorOffsetU</h3>

```csharp
public void SetSamplingBaseColorOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-f0122e8dc1269156" class="astra-member">SetSamplingBaseColorOffsetV</h3>

```csharp
public void SetSamplingBaseColorOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-79e3135c602740f6" class="astra-member">SetSamplingBaseColorRotation</h3>

```csharp
public void SetSamplingBaseColorRotation(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-ee2252d2fa668d92" class="astra-member">SetSamplingBaseColorScaleU</h3>

```csharp
public void SetSamplingBaseColorScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-88129177aa8a4ab1" class="astra-member">SetSamplingBaseColorScaleV</h3>

```csharp
public void SetSamplingBaseColorScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-0f538aa39d894737" class="astra-member">SetSamplingBaseColorUvSet</h3>

```csharp
public void SetSamplingBaseColorUvSet(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-95aae61c3e921ee0" class="astra-member">SetSamplingBaseColorWrap</h3>

```csharp
public void SetSamplingBaseColorWrap(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-ff3c96a49f54fbad" class="astra-member">SetSamplingEmissiveFilter</h3>

```csharp
public void SetSamplingEmissiveFilter(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-4e11f0cf6ae668a0" class="astra-member">SetSamplingEmissiveOffsetU</h3>

```csharp
public void SetSamplingEmissiveOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-6dc08005480e04bd" class="astra-member">SetSamplingEmissiveOffsetV</h3>

```csharp
public void SetSamplingEmissiveOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-650e76056cd8d57d" class="astra-member">SetSamplingEmissiveRotation</h3>

```csharp
public void SetSamplingEmissiveRotation(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-f453d873a2fa6231" class="astra-member">SetSamplingEmissiveScaleU</h3>

```csharp
public void SetSamplingEmissiveScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-f73c31352e43edc4" class="astra-member">SetSamplingEmissiveScaleV</h3>

```csharp
public void SetSamplingEmissiveScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-e8b80c080ef24c55" class="astra-member">SetSamplingEmissiveUvSet</h3>

```csharp
public void SetSamplingEmissiveUvSet(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-7179543a8ba375dc" class="astra-member">SetSamplingEmissiveWrap</h3>

```csharp
public void SetSamplingEmissiveWrap(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-43e986e8a5f7cc0e" class="astra-member">SetSamplingFilter</h3>

```csharp
public void SetSamplingFilter(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-ae32d4d65c8bcf9b" class="astra-member">SetSamplingMetallicRoughnessFilter</h3>

```csharp
public void SetSamplingMetallicRoughnessFilter(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-e0739737edfa4ddd" class="astra-member">SetSamplingMetallicRoughnessOffsetU</h3>

```csharp
public void SetSamplingMetallicRoughnessOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-2fd4804d7c9d6ccb" class="astra-member">SetSamplingMetallicRoughnessOffsetV</h3>

```csharp
public void SetSamplingMetallicRoughnessOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-084c11338936baad" class="astra-member">SetSamplingMetallicRoughnessRotation</h3>

```csharp
public void SetSamplingMetallicRoughnessRotation(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-8d78a8fe9b62391f" class="astra-member">SetSamplingMetallicRoughnessScaleU</h3>

```csharp
public void SetSamplingMetallicRoughnessScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-dc5c1e5888fa0b18" class="astra-member">SetSamplingMetallicRoughnessScaleV</h3>

```csharp
public void SetSamplingMetallicRoughnessScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-3235d6d1c91c1e5a" class="astra-member">SetSamplingMetallicRoughnessUvSet</h3>

```csharp
public void SetSamplingMetallicRoughnessUvSet(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-81a04b22978463e0" class="astra-member">SetSamplingMetallicRoughnessWrap</h3>

```csharp
public void SetSamplingMetallicRoughnessWrap(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-f6a2755050f13703" class="astra-member">SetSamplingNormalFilter</h3>

```csharp
public void SetSamplingNormalFilter(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-107ce6f9b2528cbb" class="astra-member">SetSamplingNormalOffsetU</h3>

```csharp
public void SetSamplingNormalOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-2e28fe24b09be295" class="astra-member">SetSamplingNormalOffsetV</h3>

```csharp
public void SetSamplingNormalOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-3b79f52a5e425a12" class="astra-member">SetSamplingNormalRotation</h3>

```csharp
public void SetSamplingNormalRotation(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-61b8f2716a5e94e3" class="astra-member">SetSamplingNormalScaleU</h3>

```csharp
public void SetSamplingNormalScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-da0b88e1c6e4e8c4" class="astra-member">SetSamplingNormalScaleV</h3>

```csharp
public void SetSamplingNormalScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-ce33b579148a3d0e" class="astra-member">SetSamplingNormalUvSet</h3>

```csharp
public void SetSamplingNormalUvSet(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-39079b485e2b8616" class="astra-member">SetSamplingNormalWrap</h3>

```csharp
public void SetSamplingNormalWrap(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-7653c745b4ca8db5" class="astra-member">SetSamplingOffsetU</h3>

```csharp
public void SetSamplingOffsetU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-6ce806d66f60a9f2" class="astra-member">SetSamplingOffsetV</h3>

```csharp
public void SetSamplingOffsetV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-fe599d9cddc001a4" class="astra-member">SetSamplingRotation</h3>

```csharp
public void SetSamplingRotation(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-b4312b926dbd82d3" class="astra-member">SetSamplingScaleU</h3>

```csharp
public void SetSamplingScaleU(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-aa75c97c1eb89e40" class="astra-member">SetSamplingScaleV</h3>

```csharp
public void SetSamplingScaleV(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-54cbde833e338c40" class="astra-member">SetSamplingUvSet</h3>

```csharp
public void SetSamplingUvSet(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-f228c71050ce142c" class="astra-member">SetSamplingWrap</h3>

```csharp
public void SetSamplingWrap(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-6c2192c57da532fa" class="astra-member">SetSurfaceAlphaCutoff</h3>

```csharp
public void SetSurfaceAlphaCutoff(uint slot, float value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-a6104378c39853f2" class="astra-member">SetSurfaceAlphaMode</h3>

```csharp
public void SetSurfaceAlphaMode(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-1191a7900cb74f52" class="astra-member">SetSurfaceSides</h3>

```csharp
public void SetSurfaceSides(uint slot, uint value)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `uint` |  |

<h3 id="member-f7e263b9f6f57d29" class="astra-member">SetTextureBaseColor</h3>

```csharp
public void SetTextureBaseColor(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-01042d6dc57cb4cf" class="astra-member">SetTextureEmissive</h3>

```csharp
public void SetTextureEmissive(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-51c5c663318e9581" class="astra-member">SetTextureLightmap</h3>

```csharp
public void SetTextureLightmap(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-a6e8269f45872103" class="astra-member">SetTextureMetallicRoughness</h3>

```csharp
public void SetTextureMetallicRoughness(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-01d6565e237840eb" class="astra-member">SetTextureNormal</h3>

```csharp
public void SetTextureNormal(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-3edd5a0f69fc93bb" class="astra-member">SetTextureOcclusion</h3>

```csharp
public void SetTextureOcclusion(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-513ac033de7281a1" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.MeshRenderer Wrap(Astra.Component component)
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-6d1a51967825e8b5" class="astra-member">BaseColorB</h3>

```csharp
public float BaseColorB { get; set; }
```

Cor B

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Cor B:** Canal B da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0cc36aa08e5e3d05" class="astra-member">BaseColorG</h3>

```csharp
public float BaseColorG { get; set; }
```

Cor G

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Cor G:** Canal G da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79756fdc2cae36b8" class="astra-member">BaseColorR</h3>

```csharp
public float BaseColorR { get; set; }
```

Cor R

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Cor R:** Canal R da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-362d3795ece9727a" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6dee08c44d8d091" class="astra-member">EmissionB</h3>

```csharp
public float EmissionB { get; set; }
```

Emissão B

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Emissão B:** Canal B da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-49980dbcff3c0e49" class="astra-member">EmissionG</h3>

```csharp
public float EmissionG { get; set; }
```

Emissão G

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Emissão G:** Canal G da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc416ddfc6a85b8a" class="astra-member">EmissionR</h3>

```csharp
public float EmissionR { get; set; }
```

Emissão R

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Emissão R:** Canal R da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2c24d7321d15b597" class="astra-member">EmissionStrength</h3>

```csharp
public float EmissionStrength { get; set; }
```

Potência de emissão

Faixa válida: 0 a 10000.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Potência de emissão:** Multiplica a emissão do material; não adiciona uma luz iluminando objetos vizinhos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e4908369a1b85022" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Renderizar

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Renderizar:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ea40cbfbe74864ff" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-21f889238c754ce4" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9f3dcd5abbc56a6" class="astra-member">Metallic</h3>

```csharp
public float Metallic { get; set; }
```

Metálico

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Metálico:** Participação metálica no material PBR; altera resposta difusa/especular.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff0c921c987ed468" class="astra-member">NormalScale</h3>

```csharp
public float NormalScale { get; set; }
```

Intensidade da normal

Faixa válida: 0 a 16.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Intensidade da normal:** Intensidade do normal map; exige textura e canal compatíveis.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-093dfb9df257edf4" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a40c0aa974ab87fd" class="astra-member">Roughness</h3>

```csharp
public float Roughness { get; set; }
```

Rugosidade

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Rugosidade:** Rugosidade PBR: menor valor produz reflexão mais concentrada; maior torna a superfície mais áspera.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d41cab5a05b19823" class="astra-member">Specular</h3>

```csharp
public float Specular { get; set; }
```

Especular

Faixa válida: 0 a 1.

**Caminho:** Inspector → Malha → Geral; ou fachada C# em um Behavior.

**Uso:** **Especular:** Ajuste especular do material dentro do contrato do renderer.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d6931f2f713b51fb" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Malha; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.ParentConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-parentconstraint/
---

# Astra.Components.ParentConstraint

Parent Constraint: Segue posição e rotação da fonte sem herdar escala. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.ParentConstraint
```

Parent Constraint: Segue posição e rotação da fonte sem herdar escala. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ParentConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.ParentConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Parent Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<ParentConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new ParentConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-03882083609fe054) | Method |
| [Remove](#member-487d5ea97ac88408) | Method |
| [Wrap](#member-9dfa9a68dad48086) | Method |
| [AxisX](#member-e2db75a0c2f5ceae) | Property |
| [AxisY](#member-146fd2a0c95b5c62) | Property |
| [AxisZ](#member-bcf297425ab640b2) | Property |
| [Component](#member-7ad08519a01cb600) | Property |
| [Enabled](#member-46f13a6d70855ad8) | Property |
| [InstanceId](#member-8d15b6ffc976a6a2) | Property |
| [IsAlive](#member-bfb767449da4a019) | Property |
| [Object](#member-4987641d2a14417c) | Property |
| [Offset](#member-4724bee579babac3) | Property |
| [RotationOffset](#member-e277bdb9ebd71e27) | Property |
| [RotationX](#member-d2903d8d7f201d1a) | Property |
| [RotationY](#member-0f71d292d6d43fe0) | Property |
| [RotationZ](#member-e1b948a5a423fb21) | Property |
| [Target](#member-738cd77c43cedb8e) | Property |
| [TypeId](#member-7594b72c1bc72dcd) | Property |
| [Weight](#member-bc5a6b74f13439dd) | Property |

<h3 id="member-03882083609fe054" class="astra-member">.ctor</h3>

```csharp
public ParentConstraint(Astra.Component component)
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-487d5ea97ac88408" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9dfa9a68dad48086" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.ParentConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-e2db75a0c2f5ceae" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Parent Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-146fd2a0c95b5c62" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Parent Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bcf297425ab640b2" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Parent Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7ad08519a01cb600" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-46f13a6d70855ad8" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Parent Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d15b6ffc976a6a2" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bfb767449da4a019" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4987641d2a14417c" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4724bee579babac3" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Posição offset

**Caminho:** Inspector → Parent Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Deslocamento X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Deslocamento Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Deslocamento Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e277bdb9ebd71e27" class="astra-member">RotationOffset</h3>

```csharp
public System.Numerics.Vector3 RotationOffset { get; set; }
```

Rotação offset

**Caminho:** Inspector → Parent Constraint → Rotação; ou fachada C# em um Behavior.

**Uso:** **Rotação offset X:** Offset angular da orientação resultante, eixo X. **Rotação offset Y:** Offset angular da orientação resultante, eixo Y. **Rotação offset Z:** Offset angular da orientação resultante, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d2903d8d7f201d1a" class="astra-member">RotationX</h3>

```csharp
public bool RotationX { get; set; }
```

Rotação X

**Caminho:** Inspector → Parent Constraint → Rotação; ou fachada C# em um Behavior.

**Uso:** **Rotação X:** Rotação autorada do sistema na unidade indicada, eixo X.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f71d292d6d43fe0" class="astra-member">RotationY</h3>

```csharp
public bool RotationY { get; set; }
```

Rotação Y

**Caminho:** Inspector → Parent Constraint → Rotação; ou fachada C# em um Behavior.

**Uso:** **Rotação Y:** Rotação autorada do sistema na unidade indicada, eixo Y.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1b948a5a423fb21" class="astra-member">RotationZ</h3>

```csharp
public bool RotationZ { get; set; }
```

Rotação Z

**Caminho:** Inspector → Parent Constraint → Rotação; ou fachada C# em um Behavior.

**Uso:** **Rotação Z:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-738cd77c43cedb8e" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Parent Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7594b72c1bc72dcd" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Parent Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc5a6b74f13439dd" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Parent Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PathComponent"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-pathcomponent/
---

# Astra.Components.PathComponent

Path: Curva Bézier local com pontos persistentes. Família Lógica · Caminhos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PathComponent
```

Path: Curva Bézier local com pontos persistentes. Família Lógica · Caminhos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_path3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PathComponent>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PathComponent>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PathComponent(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Path](/pt-br/snapshot-2026-10-06/componentes/astra-path/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-6d34a114e22e5fe3) | Method |
| [GetPointInX](#member-211c40ed3e41749e) | Method |
| [GetPointInY](#member-15f736e42e173e31) | Method |
| [GetPointInZ](#member-87aa94f561521d3c) | Method |
| [GetPointOutX](#member-69ebf5c0b46c74d5) | Method |
| [GetPointOutY](#member-ac04eb84358d1f0b) | Method |
| [GetPointOutZ](#member-5c5afeaf623f4ab0) | Method |
| [GetPointPositionX](#member-fb97eabe66fe9a88) | Method |
| [GetPointPositionY](#member-c8e62341bf240c6b) | Method |
| [GetPointPositionZ](#member-03976960ed23d21f) | Method |
| [GetPointRoll](#member-002a475bb6484346) | Method |
| [Remove](#member-432f071aab61e420) | Method |
| [SetPointInX](#member-a8661b72d1d6524c) | Method |
| [SetPointInY](#member-5c030ef67b3c819a) | Method |
| [SetPointInZ](#member-7b9d6fea0333fadf) | Method |
| [SetPointOutX](#member-185d442f8585402b) | Method |
| [SetPointOutY](#member-0de1b72218c0e7b7) | Method |
| [SetPointOutZ](#member-3990d368b4472de2) | Method |
| [SetPointPositionX](#member-870332514ff8e526) | Method |
| [SetPointPositionY](#member-5d0fce14e77116fc) | Method |
| [SetPointPositionZ](#member-ee03e4a68a5bbda8) | Method |
| [SetPointRoll](#member-74f37872ca866e85) | Method |
| [Wrap](#member-94da01a70c0a3d9a) | Method |
| [Closed](#member-c07b3c9a010e7765) | Property |
| [Component](#member-5c0aad7accb87075) | Property |
| [InstanceId](#member-c2d891bb3c39cfd2) | Property |
| [IsAlive](#member-7de6b0840c37df73) | Property |
| [Object](#member-041013319e0b09e4) | Property |
| [TypeId](#member-c734b4408300b39e) | Property |
| [Up](#member-c9b2a307041055d9) | Property |

<h3 id="member-6d34a114e22e5fe3" class="astra-member">.ctor</h3>

```csharp
public PathComponent(Astra.Component component)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-211c40ed3e41749e" class="astra-member">GetPointInX</h3>

```csharp
public float GetPointInX(uint slot)
```

Entrada X (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Entrada X (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-15f736e42e173e31" class="astra-member">GetPointInY</h3>

```csharp
public float GetPointInY(uint slot)
```

Entrada Y (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Entrada Y (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-87aa94f561521d3c" class="astra-member">GetPointInZ</h3>

```csharp
public float GetPointInZ(uint slot)
```

Entrada Z (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Entrada Z (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-69ebf5c0b46c74d5" class="astra-member">GetPointOutX</h3>

```csharp
public float GetPointOutX(uint slot)
```

Saída X (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Saída X (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-ac04eb84358d1f0b" class="astra-member">GetPointOutY</h3>

```csharp
public float GetPointOutY(uint slot)
```

Saída Y (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Saída Y (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-5c5afeaf623f4ab0" class="astra-member">GetPointOutZ</h3>

```csharp
public float GetPointOutZ(uint slot)
```

Saída Z (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Saída Z (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-fb97eabe66fe9a88" class="astra-member">GetPointPositionX</h3>

```csharp
public float GetPointPositionX(uint slot)
```

Posição X (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Posição X (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-c8e62341bf240c6b" class="astra-member">GetPointPositionY</h3>

```csharp
public float GetPointPositionY(uint slot)
```

Posição Y (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Posição Y (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-03976960ed23d21f" class="astra-member">GetPointPositionZ</h3>

```csharp
public float GetPointPositionZ(uint slot)
```

Posição Z (u). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Posição Z (u). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-002a475bb6484346" class="astra-member">GetPointRoll</h3>

```csharp
public float GetPointRoll(uint slot)
```

Roll (°). Valor por slot

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Roll (°). Valor por slot

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-432f071aab61e420" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a8661b72d1d6524c" class="astra-member">SetPointInX</h3>

```csharp
public void SetPointInX(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-5c030ef67b3c819a" class="astra-member">SetPointInY</h3>

```csharp
public void SetPointInY(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-7b9d6fea0333fadf" class="astra-member">SetPointInZ</h3>

```csharp
public void SetPointInZ(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-185d442f8585402b" class="astra-member">SetPointOutX</h3>

```csharp
public void SetPointOutX(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-0de1b72218c0e7b7" class="astra-member">SetPointOutY</h3>

```csharp
public void SetPointOutY(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-3990d368b4472de2" class="astra-member">SetPointOutZ</h3>

```csharp
public void SetPointOutZ(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-870332514ff8e526" class="astra-member">SetPointPositionX</h3>

```csharp
public void SetPointPositionX(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-5d0fce14e77116fc" class="astra-member">SetPointPositionY</h3>

```csharp
public void SetPointPositionY(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-ee03e4a68a5bbda8" class="astra-member">SetPointPositionZ</h3>

```csharp
public void SetPointPositionZ(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-74f37872ca866e85" class="astra-member">SetPointRoll</h3>

```csharp
public void SetPointRoll(uint slot, float value)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-94da01a70c0a3d9a" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PathComponent Wrap(Astra.Component component)
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-c07b3c9a010e7765" class="astra-member">Closed</h3>

```csharp
public bool Closed { get; set; }
```

Fechado

**Caminho:** Inspector → Path → Caminho; ou fachada C# em um Behavior.

**Uso:** **Fechado:** Fecha a curva ligando o último ponto ao primeiro.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c0aad7accb87075" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2d891bb3c39cfd2" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7de6b0840c37df73" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-041013319e0b09e4" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c734b4408300b39e" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Path; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9b2a307041055d9" class="astra-member">Up</h3>

```csharp
public System.Numerics.Vector3 Up { get; set; }
```

Up inicial local

**Caminho:** Inspector → Path → Orientação; ou fachada C# em um Behavior.

**Uso:** **Up X:** Up inicial local; vetor zero é inválido. **Up Y:** Vetor vertical inicial do frame do caminho; vetor total zero é inválido, eixo Y. **Up Z:** Vetor vertical inicial do frame do caminho; vetor total zero é inválido, eixo Z.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PathFollow"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow/
---

# Astra.Components.PathFollow

Path Follow: Percorre curva em distância mundial e orienta +Z. Família Lógica · Caminhos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PathFollow
```

Path Follow: Percorre curva em distância mundial e orienta +Z. Família Lógica · Caminhos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_pathfollow3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PathFollow>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path Follow**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PathFollow>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PathFollow(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Path Follow](/pt-br/snapshot-2026-10-06/componentes/astra-path-follow/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ae9458b9ae180acd) | Method |
| [Playing](#member-fe3c8533c74943fe) | Method |
| [Progress](#member-3af8de9116392837) | Method |
| [Remove](#member-cb53ba4c826d7d79) | Method |
| [Restart](#member-2f9b4339e5b60d52) | Method |
| [Stop](#member-b0c40885286e185f) | Method |
| [Wrap](#member-b5cf2f79409af26a) | Method |
| [Autoplay](#member-1d5e7bcf8e7f0e0c) | Property |
| [Backwards](#member-00b0567aeb8ec040) | Property |
| [Component](#member-ec9f43d48fc10de7) | Property |
| [Duration](#member-cf393963de83455e) | Property |
| [Enabled](#member-7381c1f5a15f2afa) | Property |
| [InstanceId](#member-0db619919d72009a) | Property |
| [IsAlive](#member-25649cfffcec48a8) | Property |
| [Loop](#member-267b9c29b4e4a24c) | Property |
| [Mode](#member-3c70a5ff8d752ba7) | Property |
| [Object](#member-cb6c1bc3c45cea63) | Property |
| [OffsetX](#member-600cdb32863c8e6d) | Property |
| [OffsetY](#member-a0685c056b249ebd) | Property |
| [OffsetZ](#member-4d476a0455d4ff6a) | Property |
| [Orient](#member-152a49196aebc18a) | Property |
| [ProgressDistance](#member-5dc757f0ea9006a0) | Property |
| [Speed](#member-2ff1e7928fef3aef) | Property |
| [Target](#member-a5f373225eee0cbb) | Property |
| [TypeId](#member-f8a70f74f7c1c078) | Property |

<h3 id="member-ae9458b9ae180acd" class="astra-member">.ctor</h3>

```csharp
public PathFollow(Astra.Component component)
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-fe3c8533c74943fe" class="astra-member">Playing</h3>

```csharp
public bool Playing()
```

Em movimento. Verdadeiro enquanto avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Em movimento. Verdadeiro enquanto avança

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3af8de9116392837" class="astra-member">Progress</h3>

```csharp
public double Progress()
```

Progresso. Distância percorrida no mundo

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Progresso. Distância percorrida no mundo

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb53ba4c826d7d79" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f9b4339e5b60d52" class="astra-member">Restart</h3>

```csharp
public void Restart()
```

Reiniciar. Volta à distância inicial e avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Reiniciar. Volta à distância inicial e avança

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0c40885286e185f" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Congela pose e progresso

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Parar. Congela pose e progresso

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5cf2f79409af26a" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PathFollow Wrap(Astra.Component component)
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1d5e7bcf8e7f0e0c" class="astra-member">Autoplay</h3>

```csharp
public bool Autoplay { get; set; }
```

Iniciar no Play

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Iniciar no Play:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00b0567aeb8ec040" class="astra-member">Backwards</h3>

```csharp
public bool Backwards { get; set; }
```

Sentido inverso

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Sentido inverso:** Percorre a curva na direção reversa.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ec9f43d48fc10de7" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf393963de83455e" class="astra-member">Duration</h3>

```csharp
public float Duration { get; set; }
```

Duração (s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Duração:** Tempo para completar o percurso no modo por duração; modo velocidade usa Speed.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7381c1f5a15f2afa" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0db619919d72009a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-25649cfffcec48a8" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-267b9c29b4e4a24c" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; set; }
```

Repetir percurso

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Repetir percurso:** Repete a reprodução/percurso no fim.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3c70a5ff8d752ba7" class="astra-member">Mode</h3>

```csharp
public Astra.Components.PathFollow.ModeOption Mode { get; set; }
```

Avanço

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Avanço:** Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb6c1bc3c45cea63" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-600cdb32863c8e6d" class="astra-member">OffsetX</h3>

```csharp
public float OffsetX { get; set; }
```

Deslocamento lateral (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento lateral:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0685c056b249ebd" class="astra-member">OffsetY</h3>

```csharp
public float OffsetY { get; set; }
```

Deslocamento vertical (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento vertical:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d476a0455d4ff6a" class="astra-member">OffsetZ</h3>

```csharp
public float OffsetZ { get; set; }
```

Deslocamento tangente (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento tangente:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-152a49196aebc18a" class="astra-member">Orient</h3>

```csharp
public bool Orient { get; set; }
```

Orientar +Z

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Orientar +Z:** Alinha orientação ao frame do caminho.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5dc757f0ea9006a0" class="astra-member">ProgressDistance</h3>

```csharp
public float ProgressDistance { get; set; }
```

Distância inicial (u)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Distância inicial:** Distância inicial mundial ao longo da curva.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ff1e7928fef3aef" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (u/s)

Faixa válida: 0 a 100000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a5f373225eee0cbb" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Caminho

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Caminho:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8a70f74f7c1c078" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PathFollow.ModeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow-modeoption/
---

# Astra.Components.PathFollow.ModeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PathFollow.ModeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path Follow**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PathFollow>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PathFollow(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DuracaoDoPercurso](#member-d7803d10efed199d) | Field |
| [VelocidadeMundial](#member-64d8cf2c28e47139) | Field |

<h3 id="member-d7803d10efed199d" class="astra-member">DuracaoDoPercurso</h3>

```csharp
DuracaoDoPercurso = 1
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-64d8cf2c28e47139" class="astra-member">VelocidadeMundial</h3>

```csharp
VelocidadeMundial = 0
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsBody"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicsbody/
---

# Astra.Components.PhysicsBody

Corpo físico: Massa e resposta física. Família Física 3D · Corpos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PhysicsBody
```

Corpo físico: Massa e resposta física. Família Física 3D · Corpos.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-Rigidbody.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PhysicsBody>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Corpo físico**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsBody>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsBody(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-61bf54466a3194cc) | Method |
| [Remove](#member-742ba0d9954b980f) | Method |
| [Wrap](#member-9692518abaa2cae7) | Method |
| [AllowSleep](#member-43c33dbbd04d4c23) | Property |
| [AngularDamping](#member-2b5c14abb3199dc4) | Property |
| [AngularVelocity](#member-8db6b50a9e2e7ef0) | Property |
| [Component](#member-ebb9c5fcabd9898d) | Property |
| [ContinuousCollision](#member-a6eaa86d5f0a254a) | Property |
| [FreezePositionX](#member-f3d265ea2d9ec103) | Property |
| [FreezePositionY](#member-50570724d85b7fbc) | Property |
| [FreezePositionZ](#member-8e078ea73ef2f642) | Property |
| [FreezeRotationX](#member-5b4d37285be87666) | Property |
| [FreezeRotationY](#member-24f936b343836b43) | Property |
| [FreezeRotationZ](#member-e261d0281cad429b) | Property |
| [Friction](#member-c1fed90a74a2a3e1) | Property |
| [GravityFactor](#member-af0fafe655fd7222) | Property |
| [InstanceId](#member-adcb9b5fbb4df747) | Property |
| [IsAlive](#member-bd788774308a8386) | Property |
| [LinearDamping](#member-420f46f2aedd605e) | Property |
| [Mass](#member-0cd4f8b5a230fa43) | Property |
| [MaxAngularVelocity](#member-65a01ed658e05f86) | Property |
| [MaxLinearVelocity](#member-b50b93a062687d6e) | Property |
| [Motion](#member-acba4c2440e1c140) | Property |
| [Object](#member-175bb73f52752e86) | Property |
| [Restitution](#member-e107851c40928fb1) | Property |
| [Sensor](#member-c6d8b4823d0d829e) | Property |
| [SolverVelocitySteps](#member-4b2402b214661899) | Property |
| [TypeId](#member-f7d87b29df1c9853) | Property |
| [Velocity](#member-404366a6f8f62d5c) | Property |

<h3 id="member-61bf54466a3194cc" class="astra-member">.ctor</h3>

```csharp
public PhysicsBody(Astra.Component component)
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-742ba0d9954b980f" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9692518abaa2cae7" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PhysicsBody Wrap(Astra.Component component)
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-43c33dbbd04d4c23" class="astra-member">AllowSleep</h3>

```csharp
public bool AllowSleep { get; set; }
```

Permitir repouso

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Permitir repouso:** Permite dormir quando o corpo pode ficar em repouso.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b5c14abb3199dc4" class="astra-member">AngularDamping</h3>

```csharp
public float AngularDamping { get; set; }
```

Amortecimento angular

Faixa válida: 0 a 10.

**Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior.

**Uso:** **Amortecimento angular:** Amortecimento de velocidade angular.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8db6b50a9e2e7ef0" class="astra-member">AngularVelocity</h3>

```csharp
public System.Numerics.Vector3 AngularVelocity { get; set; }
```

Giro inicial

**Caminho:** Inspector → Corpo físico → Início; ou fachada C# em um Behavior.

**Uso:** **Giro inicial X · rad/s:** Velocidade angular do corpo, eixo X. **Giro inicial Y · rad/s:** Velocidade angular do corpo, eixo Y. **Giro inicial Z · rad/s:** Velocidade angular do corpo, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ebb9c5fcabd9898d" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a6eaa86d5f0a254a" class="astra-member">ContinuousCollision</h3>

```csharp
public bool ContinuousCollision { get; set; }
```

Colisão contínua. Varredura linear Jolt; não detecta varredura apenas angular

**Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior.

**Uso:** **Colisão contínua:** Varredura linear Jolt; não detecta varredura apenas angular

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f3d265ea2d9ec103" class="astra-member">FreezePositionX</h3>

```csharp
public bool FreezePositionX { get; set; }
```

Travar posição X. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar posição X:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50570724d85b7fbc" class="astra-member">FreezePositionY</h3>

```csharp
public bool FreezePositionY { get; set; }
```

Travar posição Y. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar posição Y:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8e078ea73ef2f642" class="astra-member">FreezePositionZ</h3>

```csharp
public bool FreezePositionZ { get; set; }
```

Travar posição Z. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar posição Z:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b4d37285be87666" class="astra-member">FreezeRotationX</h3>

```csharp
public bool FreezeRotationX { get; set; }
```

Travar rotação X. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar rotação X:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-24f936b343836b43" class="astra-member">FreezeRotationY</h3>

```csharp
public bool FreezeRotationY { get; set; }
```

Travar rotação Y. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar rotação Y:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e261d0281cad429b" class="astra-member">FreezeRotationZ</h3>

```csharp
public bool FreezeRotationZ { get; set; }
```

Travar rotação Z. Eixos do mundo; bloquear todos exige corpo estático

**Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior.

**Uso:** **Travar rotação Z:** Eixos do mundo; bloquear todos exige corpo estático

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c1fed90a74a2a3e1" class="astra-member">Friction</h3>

```csharp
public float Friction { get; set; }
```

Atrito

Faixa válida: 0 a 1.

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Atrito:** Atrito nos contatos; compare deslizamento com o mesmo par de superfícies.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af0fafe655fd7222" class="astra-member">GravityFactor</h3>

```csharp
public float GravityFactor { get; set; }
```

Multiplicador da gravidade

Faixa válida: -100 a 100.

**Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior.

**Uso:** **Multiplicador da gravidade:** Multiplica gravidade mundial deste corpo 3D.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-adcb9b5fbb4df747" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bd788774308a8386" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-420f46f2aedd605e" class="astra-member">LinearDamping</h3>

```csharp
public float LinearDamping { get; set; }
```

Amortecimento linear

Faixa válida: 0 a 10.

**Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior.

**Uso:** **Amortecimento linear:** Amortecimento de velocidade linear.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0cd4f8b5a230fa43" class="astra-member">Mass</h3>

```csharp
public float Mass { get; set; }
```

Massa kg (kg)

Faixa válida: 0.01 a 1000000.

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Massa kg:** Massa do corpo dinâmico em kg; influencia resposta a força/impulso.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-65a01ed658e05f86" class="astra-member">MaxAngularVelocity</h3>

```csharp
public float MaxAngularVelocity { get; set; }
```

Limite angular (rad/s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior.

**Uso:** **Limite angular:** Limite de velocidade angular do corpo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b50b93a062687d6e" class="astra-member">MaxLinearVelocity</h3>

```csharp
public float MaxLinearVelocity { get; set; }
```

Limite linear (m/s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior.

**Uso:** **Limite linear:** Limite de velocidade linear do corpo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acba4c2440e1c140" class="astra-member">Motion</h3>

```csharp
public Astra.Components.PhysicsBody.MotionOption Motion { get; set; }
```

Movimento

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Movimento:** Escolhe autoridade estática/cinemática/dinâmica no domínio do corpo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-175bb73f52752e86" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e107851c40928fb1" class="astra-member">Restitution</h3>

```csharp
public float Restitution { get; set; }
```

Restituição

Faixa válida: 0 a 1.

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Restituição:** Restituição nos contatos; controla ressalto conforme a combinação física.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6d8b4823d0d829e" class="astra-member">Sensor</h3>

```csharp
public bool Sensor { get; set; }
```

Sensor sem resposta

**Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior.

**Uso:** **Sensor sem resposta:** Participa como sensor/sobreposição; não é uma superfície sólida de contato.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4b2402b214661899" class="astra-member">SolverVelocitySteps</h3>

```csharp
public float SolverVelocitySteps { get; set; }
```

Iterações de velocidade. 0 usa as iterações do mundo; aumenta custo por ilha de contato

Faixa válida: 0 a 255.

**Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior.

**Uso:** **Iterações de velocidade:** 0 usa as iterações do mundo; aumenta custo por ilha de contato

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f7d87b29df1c9853" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-404366a6f8f62d5c" class="astra-member">Velocity</h3>

```csharp
public System.Numerics.Vector3 Velocity { get; set; }
```

Velocidade inicial

**Caminho:** Inspector → Corpo físico → Início; ou fachada C# em um Behavior.

**Uso:** **Velocidade inicial X:** Velocidade linear inicial/autorada do corpo, eixo X. **Velocidade inicial Y:** Velocidade linear inicial/autorada do corpo, eixo Y. **Velocidade inicial Z:** Velocidade linear inicial/autorada do corpo, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsBody.MotionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicsbody-motionoption/
---

# Astra.Components.PhysicsBody.MotionOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PhysicsBody.MotionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Corpo físico**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsBody>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsBody(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cinematico](#member-adb26f6c9ac06089) | Field |
| [Dinamico](#member-323cd7ed400204ee) | Field |
| [Estatico](#member-7099db5b0b84a6c2) | Field |

<h3 id="member-adb26f6c9ac06089" class="astra-member">Cinematico</h3>

```csharp
Cinematico = 1
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-323cd7ed400204ee" class="astra-member">Dinamico</h3>

```csharp
Dinamico = 2
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7099db5b0b84a6c2" class="astra-member">Estatico</h3>

```csharp
Estatico = 0
```

**Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d/
---

# Astra.Components.PhysicsEventConnection2D

Conexão física 2D: Evento real de sensor/contato 2D altera ativação do receptor. Família Física 2D · Eventos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PhysicsEventConnection2D
```

Conexão física 2D: Evento real de sensor/contato 2D altera ativação do receptor. Família Física 2D · Eventos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PhysicsEventConnection2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Eventos** → **Conexão física 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Conexão física 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-event-connection/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-f2d6d26367c60577) | Method |
| [Remove](#member-2accdb6ae7e7601d) | Method |
| [Wrap](#member-d1e6877c1f45705c) | Method |
| [Action](#member-a233907df0e3ec86) | Property |
| [Component](#member-545ab22bc39fe0dc) | Property |
| [Enabled](#member-387b832aa365b6d8) | Property |
| [Event](#member-771d47cbd200dace) | Property |
| [InstanceId](#member-45f17238653612fc) | Property |
| [IsAlive](#member-78b111ada0b16ca2) | Property |
| [Object](#member-358c08ded0fbead3) | Property |
| [OtherFilter](#member-50f22aa58c71e1c8) | Property |
| [Receiver](#member-2a487b2fa591b0a8) | Property |
| [TypeId](#member-471ff378f288d7b8) | Property |

<h3 id="member-f2d6d26367c60577" class="astra-member">.ctor</h3>

```csharp
public PhysicsEventConnection2D(Astra.Component component)
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-2accdb6ae7e7601d" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1e6877c1f45705c" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PhysicsEventConnection2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a233907df0e3ec86" class="astra-member">Action</h3>

```csharp
public Astra.Components.PhysicsEventConnection2D.ActionOption Action { get; set; }
```

Ação. Executada antes do callback C#; permanência pode disparar a cada passo físico

**Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ação:** Executada antes do callback C#; permanência pode disparar a cada passo físico

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-545ab22bc39fe0dc" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-387b832aa365b6d8" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativa

**Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ativa:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-771d47cbd200dace" class="astra-member">Event</h3>

```csharp
public Astra.Components.PhysicsEventConnection2D.EventOption Event { get; set; }
```

Evento. Sensor exige um Colisor 2D sensor; contato exige uma forma sólida no emissor

**Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Evento:** Sensor exige um Colisor 2D sensor; contato exige uma forma sólida no emissor

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-45f17238653612fc" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-78b111ada0b16ca2" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-358c08ded0fbead3" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50f22aa58c71e1c8" class="astra-member">OtherFilter</h3>

```csharp
public Astra.ObjectReference OtherFilter { get; set; }
```

Outro objeto. Opcional: somente eventos com este outro objeto; vazio aceita todos

**Caminho:** Inspector → Conexão física 2D → Filtro; ou fachada C# em um Behavior.

**Uso:** **Outro objeto:** Opcional: somente eventos com este outro objeto; vazio aceita todos

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a487b2fa591b0a8" class="astra-member">Receiver</h3>

```csharp
public Astra.ObjectReference Receiver { get; set; }
```

Receptor. Objeto cuja ativação será alterada

**Caminho:** Inspector → Conexão física 2D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Receptor:** Objeto cuja ativação será alterada

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-471ff378f288d7b8" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection2D.ActionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d-actionoption/
---

# Astra.Components.PhysicsEventConnection2D.ActionOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PhysicsEventConnection2D.ActionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Eventos** → **Conexão física 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlternarObjeto](#member-f90d91911b4b6227) | Field |
| [AtivarObjeto](#member-bb135a0e9c38345b) | Field |
| [DesativarObjeto](#member-4aca7b88f5d8c21f) | Field |
| [Desconectado](#member-edbc14ab356191f9) | Field |

<h3 id="member-f90d91911b4b6227" class="astra-member">AlternarObjeto</h3>

```csharp
AlternarObjeto = 3
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bb135a0e9c38345b" class="astra-member">AtivarObjeto</h3>

```csharp
AtivarObjeto = 1
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4aca7b88f5d8c21f" class="astra-member">DesativarObjeto</h3>

```csharp
DesativarObjeto = 2
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-edbc14ab356191f9" class="astra-member">Desconectado</h3>

```csharp
Desconectado = 0
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection2D.EventOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d-eventoption/
---

# Astra.Components.PhysicsEventConnection2D.EventOption

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PhysicsEventConnection2D.EventOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Eventos** → **Conexão física 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [EntradaContato](#member-f6ab1b1d202edf8b) | Field |
| [EntradaSensor](#member-a93c420cea4ada5e) | Field |
| [PermContato](#member-71398222d49cad17) | Field |
| [PermSensor](#member-d34763261950cfd5) | Field |
| [SaidaContato](#member-9e71fa57544a8c3c) | Field |
| [SaidaSensor](#member-a27dd0eea8940b5d) | Field |

<h3 id="member-f6ab1b1d202edf8b" class="astra-member">EntradaContato</h3>

```csharp
EntradaContato = 3
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a93c420cea4ada5e" class="astra-member">EntradaSensor</h3>

```csharp
EntradaSensor = 0
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71398222d49cad17" class="astra-member">PermContato</h3>

```csharp
PermContato = 4
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d34763261950cfd5" class="astra-member">PermSensor</h3>

```csharp
PermSensor = 1
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9e71fa57544a8c3c" class="astra-member">SaidaContato</h3>

```csharp
SaidaContato = 5
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a27dd0eea8940b5d" class="astra-member">SaidaSensor</h3>

```csharp
SaidaSensor = 2
```

**Caminho:** Inspector → Conexão física 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection3D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d/
---

# Astra.Components.PhysicsEventConnection3D

Conexão física 3D: Evento de sensor/contato altera a ativação de um receptor. Família Física 3D · Eventos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PhysicsEventConnection3D
```

Conexão física 3D: Evento de sensor/contato altera a ativação de um receptor. Família Física 3D · Eventos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PhysicsEventConnection3D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Eventos** → **Conexão física 3D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection3D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection3D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Conexão física 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-event-connection/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ca37a65f9e3f8eef) | Method |
| [Remove](#member-d25be4739b1e7c1a) | Method |
| [Wrap](#member-08c79630f5a2af94) | Method |
| [Action](#member-9ba30386586bbb88) | Property |
| [Component](#member-dd823713e3755050) | Property |
| [Enabled](#member-c9866e33b7e8f937) | Property |
| [Event](#member-95d7e849e6cf7c71) | Property |
| [InstanceId](#member-0e73efd4f13589da) | Property |
| [IsAlive](#member-3415c247652c30c5) | Property |
| [Object](#member-306f92f75a0980c1) | Property |
| [OtherFilter](#member-d8be0b95f01a87aa) | Property |
| [Receiver](#member-3f87eb947d4b10c9) | Property |
| [TypeId](#member-2774c26de2ce2dba) | Property |

<h3 id="member-ca37a65f9e3f8eef" class="astra-member">.ctor</h3>

```csharp
public PhysicsEventConnection3D(Astra.Component component)
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-d25be4739b1e7c1a" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-08c79630f5a2af94" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PhysicsEventConnection3D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-9ba30386586bbb88" class="astra-member">Action</h3>

```csharp
public Astra.Components.PhysicsEventConnection3D.ActionOption Action { get; set; }
```

Ação. Executada antes do callback C#; permanência pode disparar a cada passo físico

**Caminho:** Inspector → Conexão física 3D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ação:** Executada antes do callback C#; permanência pode disparar a cada passo físico

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd823713e3755050" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9866e33b7e8f937" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativa

**Caminho:** Inspector → Conexão física 3D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ativa:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-95d7e849e6cf7c71" class="astra-member">Event</h3>

```csharp
public Astra.Components.PhysicsEventConnection3D.EventOption Event { get; set; }
```

Evento. Sensor exige Sensor ligado no Corpo físico; contato sólido exige desligado

**Caminho:** Inspector → Conexão física 3D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Evento:** Sensor exige Sensor ligado no Corpo físico; contato sólido exige desligado

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e73efd4f13589da" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3415c247652c30c5" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-306f92f75a0980c1" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8be0b95f01a87aa" class="astra-member">OtherFilter</h3>

```csharp
public Astra.ObjectReference OtherFilter { get; set; }
```

Outro objeto. Opcional: somente eventos com este outro objeto; vazio aceita todos

**Caminho:** Inspector → Conexão física 3D → Filtro; ou fachada C# em um Behavior.

**Uso:** **Outro objeto:** Opcional: somente eventos com este outro objeto; vazio aceita todos

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f87eb947d4b10c9" class="astra-member">Receiver</h3>

```csharp
public Astra.ObjectReference Receiver { get; set; }
```

Receptor. Objeto cuja ativação será alterada

**Caminho:** Inspector → Conexão física 3D → Conexão; ou fachada C# em um Behavior.

**Uso:** **Receptor:** Objeto cuja ativação será alterada

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2774c26de2ce2dba" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection3D.ActionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d-actionoption/
---

# Astra.Components.PhysicsEventConnection3D.ActionOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PhysicsEventConnection3D.ActionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Eventos** → **Conexão física 3D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection3D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection3D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlternarObjeto](#member-fab99f473b7200b2) | Field |
| [AtivarObjeto](#member-2826dfa709780d70) | Field |
| [DesativarObjeto](#member-d8c721c46f95049e) | Field |
| [Desconectado](#member-efe38a964bb5e405) | Field |

<h3 id="member-fab99f473b7200b2" class="astra-member">AlternarObjeto</h3>

```csharp
AlternarObjeto = 3
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2826dfa709780d70" class="astra-member">AtivarObjeto</h3>

```csharp
AtivarObjeto = 1
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8c721c46f95049e" class="astra-member">DesativarObjeto</h3>

```csharp
DesativarObjeto = 2
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-efe38a964bb5e405" class="astra-member">Desconectado</h3>

```csharp
Desconectado = 0
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PhysicsEventConnection3D.EventOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d-eventoption/
---

# Astra.Components.PhysicsEventConnection3D.EventOption

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.PhysicsEventConnection3D.EventOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Eventos** → **Conexão física 3D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PhysicsEventConnection3D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsEventConnection3D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [EntradaContato](#member-092ff898ed87b353) | Field |
| [EntradaSensor](#member-6690af61f3c827e0) | Field |
| [PermContato](#member-5c0e40243e8193e3) | Field |
| [PermSensor](#member-4020814544b606e6) | Field |
| [SaidaContato](#member-f0e792f40e9ef128) | Field |
| [SaidaSensor](#member-79cf95cd4aaab566) | Field |

<h3 id="member-092ff898ed87b353" class="astra-member">EntradaContato</h3>

```csharp
EntradaContato = 3
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6690af61f3c827e0" class="astra-member">EntradaSensor</h3>

```csharp
EntradaSensor = 0
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c0e40243e8193e3" class="astra-member">PermContato</h3>

```csharp
PermContato = 4
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4020814544b606e6" class="astra-member">PermSensor</h3>

```csharp
PermSensor = 1
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0e792f40e9ef128" class="astra-member">SaidaContato</h3>

```csharp
SaidaContato = 5
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79cf95cd4aaab566" class="astra-member">SaidaSensor</h3>

```csharp
SaidaSensor = 2
```

**Caminho:** Inspector → Conexão física 3D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.PositionConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-positionconstraint/
---

# Astra.Components.PositionConstraint

Position Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PositionConstraint
```

Position Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-PositionConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PositionConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Position Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PositionConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PositionConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Position Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-f1df786bc8cae208) | Method |
| [Remove](#member-a864ab589f449374) | Method |
| [Wrap](#member-5cf85b739a9f0642) | Method |
| [AxisX](#member-04848c751e098e66) | Property |
| [AxisY](#member-0e835f9dd796d344) | Property |
| [AxisZ](#member-d9a5bf99147d0511) | Property |
| [Component](#member-47bcac64eca2dc10) | Property |
| [Enabled](#member-7a6a02e0fec93c44) | Property |
| [InstanceId](#member-0845cff8b8ae900d) | Property |
| [IsAlive](#member-7722f3184f98f55d) | Property |
| [Object](#member-92da8295ec7f0a7f) | Property |
| [Offset](#member-0f1cfec6a2f86737) | Property |
| [Target](#member-c2bb0831eeed085f) | Property |
| [TypeId](#member-e2b9118649d95f0a) | Property |
| [Weight](#member-55006cc776ecb822) | Property |

<h3 id="member-f1df786bc8cae208" class="astra-member">.ctor</h3>

```csharp
public PositionConstraint(Astra.Component component)
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a864ab589f449374" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5cf85b739a9f0642" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PositionConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-04848c751e098e66" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Position Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e835f9dd796d344" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Position Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9a5bf99147d0511" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Position Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47bcac64eca2dc10" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a6a02e0fec93c44" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Position Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0845cff8b8ae900d" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7722f3184f98f55d" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-92da8295ec7f0a7f" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0f1cfec6a2f86737" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento

**Caminho:** Inspector → Position Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Deslocamento X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Deslocamento Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Deslocamento Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2bb0831eeed085f" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Position Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2b9118649d95f0a" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Position Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55006cc776ecb822" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Position Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield/
---

# Astra.Components.RadialField

Campo radial: Atração, repulsão e vórtice ao redor do centro. Família Física 3D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.RadialField
```

Campo radial: Atração, repulsão e vórtice ao redor do centro. Família Física 3D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.RadialField>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo radial**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo radial](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-radial/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-3f9c45c4f3aa3f25) | Method |
| [Remove](#member-926f7ef298809594) | Method |
| [Wrap](#member-b2c2a0af077b12d6) | Method |
| [Acceleration](#member-3bd36bfc6fae2863) | Property |
| [AffectedLayer](#member-ec453ba200e76c37) | Property |
| [Component](#member-2dd67fc6352a1b1d) | Property |
| [Enabled](#member-10d81ab756f31eb7) | Property |
| [Falloff](#member-ca3459f61b38e074) | Property |
| [HalfExtents](#member-a980e64f08590b60) | Property |
| [InstanceId](#member-9c6aa558835fa081) | Property |
| [IsAlive](#member-1fa0564882e38901) | Property |
| [Object](#member-af8db90f5b0dca84) | Property |
| [Offset](#member-f7a370a56463c3da) | Property |
| [Radius](#member-a95b87d458d29b82) | Property |
| [Shape](#member-7e0bc7ce4aad4502) | Property |
| [TangentialAcceleration](#member-9d9b3a297d966747) | Property |
| [TypeId](#member-674bdba7d3d2130a) | Property |
| [WakeBodies](#member-770dc5d272bac009) | Property |

<h3 id="member-3f9c45c4f3aa3f25" class="astra-member">.ctor</h3>

```csharp
public RadialField(Astra.Component component)
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-926f7ef298809594" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b2c2a0af077b12d6" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.RadialField Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3bd36bfc6fae2863" class="astra-member">Acceleration</h3>

```csharp
public float Acceleration { get; set; }
```

Aceleração radial (m/s²)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Campo radial → Efeito; ou fachada C# em um Behavior.

**Uso:** **Aceleração radial:** Aceleração radial em relação à origem do campo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ec453ba200e76c37" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.RadialField.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo radial → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2dd67fc6352a1b1d" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10d81ab756f31eb7" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo radial → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ca3459f61b38e074" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.RadialField.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo radial → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a980e64f08590b60" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meias XYZ

**Caminho:** Inspector → Campo radial → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Z:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c6aa558835fa081" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1fa0564882e38901" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af8db90f5b0dca84" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f7a370a56463c3da" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo radial → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Centro Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a95b87d458d29b82" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo radial → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e0bc7ce4aad4502" class="astra-member">Shape</h3>

```csharp
public Astra.Components.RadialField.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo radial → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9d9b3a297d966747" class="astra-member">TangentialAcceleration</h3>

```csharp
public float TangentialAcceleration { get; set; }
```

Aceleração tangencial (m/s²)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Campo radial → Efeito; ou fachada C# em um Behavior.

**Uso:** **Aceleração tangencial:** Aceleração tangencial em torno da origem.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-674bdba7d3d2130a" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-770dc5d272bac009" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo radial → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-affectedlayeroption/
---

# Astra.Components.RadialField.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo radial**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-fb6ea8a5becf15b1) | Field |
| [Camada1](#member-9aa40f6422869534) | Field |
| [Camada10](#member-96ee59ecb97312cd) | Field |
| [Camada11](#member-3b77a3cf3f319917) | Field |
| [Camada12](#member-8f1faf583e7f0fa3) | Field |
| [Camada13](#member-23a4232d51e67545) | Field |
| [Camada14](#member-6539f3cdb2d7078f) | Field |
| [Camada15](#member-c2c1f2fa59e0d09a) | Field |
| [Camada16](#member-3c5e8a1df37563df) | Field |
| [Camada17](#member-6a9fad51f5ece3bc) | Field |
| [Camada18](#member-2d744c19e322988f) | Field |
| [Camada19](#member-15520519038fc81a) | Field |
| [Camada2](#member-170efce058750a55) | Field |
| [Camada20](#member-03a4ac30ece4a739) | Field |
| [Camada21](#member-e3769757ef76a7b6) | Field |
| [Camada22](#member-6d0ef20f42f33683) | Field |
| [Camada23](#member-9cc89423cf0ba5f8) | Field |
| [Camada24](#member-7d5651ec26ed8ea6) | Field |
| [Camada25](#member-3e9fc8d3846dc046) | Field |
| [Camada26](#member-1a8d1b928a251a94) | Field |
| [Camada27](#member-ec5f29cc3db9090d) | Field |
| [Camada28](#member-1e9534191ca1ba33) | Field |
| [Camada29](#member-b786a75e89d1f80d) | Field |
| [Camada3](#member-8fd76a20c9b233cc) | Field |
| [Camada30](#member-0adfe61ad4aa1ad8) | Field |
| [Camada31](#member-a1c35929f31a2d7d) | Field |
| [Camada4](#member-4e965f61e5016c1c) | Field |
| [Camada5](#member-555a6519f7f53a83) | Field |
| [Camada6](#member-3e59bf2c3970dcd0) | Field |
| [Camada7](#member-f8d0e959717c16dc) | Field |
| [Camada8](#member-3eafd43c7c604459) | Field |
| [Camada9](#member-15d053b73b8fbfda) | Field |
| [Todas](#member-e95101169efec772) | Field |

<h3 id="member-fb6ea8a5becf15b1" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9aa40f6422869534" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-96ee59ecb97312cd" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3b77a3cf3f319917" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8f1faf583e7f0fa3" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-23a4232d51e67545" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6539f3cdb2d7078f" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2c1f2fa59e0d09a" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3c5e8a1df37563df" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a9fad51f5ece3bc" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d744c19e322988f" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15520519038fc81a" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-170efce058750a55" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03a4ac30ece4a739" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e3769757ef76a7b6" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d0ef20f42f33683" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9cc89423cf0ba5f8" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d5651ec26ed8ea6" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e9fc8d3846dc046" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1a8d1b928a251a94" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ec5f29cc3db9090d" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1e9534191ca1ba33" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b786a75e89d1f80d" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8fd76a20c9b233cc" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0adfe61ad4aa1ad8" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a1c35929f31a2d7d" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4e965f61e5016c1c" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-555a6519f7f53a83" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e59bf2c3970dcd0" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8d0e959717c16dc" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3eafd43c7c604459" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15d053b73b8fbfda" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e95101169efec772" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-falloffoption/
---

# Astra.Components.RadialField.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo radial**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-97283ee9338f54ae) | Field |
| [Suave](#member-a0ed2df4079da576) | Field |
| [Uniforme](#member-82c8c8e5dffa03e1) | Field |

<h3 id="member-97283ee9338f54ae" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0ed2df4079da576" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-82c8c8e5dffa03e1" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-shapeoption/
---

# Astra.Components.RadialField.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo radial**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-4a07b7ae7b642ad6) | Field |
| [Esfera](#member-2e9ad47dec50d070) | Field |

<h3 id="member-4a07b7ae7b642ad6" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2e9ad47dec50d070" class="astra-member">Esfera</h3>

```csharp
Esfera = 1
```

**Caminho:** Inspector → Campo radial; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d/
---

# Astra.Components.RadialField2D

Campo radial 2D: Atração, repulsão e vórtice no plano XY. Família Física 2D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.RadialField2D
```

Campo radial 2D: Atração, repulsão e vórtice no plano XY. Família Física 2D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.RadialField2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo radial 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-radial/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-30e3e891d18c2134) | Method |
| [Remove](#member-e4751a191fed5159) | Method |
| [Wrap](#member-5b3e1d1d62285ef9) | Method |
| [Acceleration](#member-cb4b802f09c21126) | Property |
| [AffectedLayer](#member-cb5a919996aa6faf) | Property |
| [Component](#member-0bd964436df09576) | Property |
| [Enabled](#member-da65042fd69fc13e) | Property |
| [Falloff](#member-cdbc3cd8f0d9df86) | Property |
| [HalfExtents](#member-ea7d540374c8a399) | Property |
| [InstanceId](#member-8c7634d3b3802a3b) | Property |
| [IsAlive](#member-0e0979caeaadd370) | Property |
| [Object](#member-48fcf3ef1cf89cdd) | Property |
| [Offset](#member-8c0b27c587c7a2e2) | Property |
| [Radius](#member-5bbdce42a3a987cc) | Property |
| [Shape](#member-776e0853fc377939) | Property |
| [TangentialAcceleration](#member-50e67b177ed8c2da) | Property |
| [TypeId](#member-3ce530872e4a4d58) | Property |
| [WakeBodies](#member-87aaef0e775b1119) | Property |

<h3 id="member-30e3e891d18c2134" class="astra-member">.ctor</h3>

```csharp
public RadialField2D(Astra.Component component)
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-e4751a191fed5159" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b3e1d1d62285ef9" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.RadialField2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-cb4b802f09c21126" class="astra-member">Acceleration</h3>

```csharp
public float Acceleration { get; set; }
```

Aceleração radial (m/s²)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Aceleração radial:** Aceleração radial em relação à origem do campo.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb5a919996aa6faf" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.RadialField2D.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0bd964436df09576" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-da65042fd69fc13e" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cdbc3cd8f0d9df86" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.RadialField2D.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ea7d540374c8a399" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector2 HalfExtents { get; set; }
```

Meias XY

**Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c7634d3b3802a3b" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e0979caeaadd370" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-48fcf3ef1cf89cdd" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c0b27c587c7a2e2" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5bbdce42a3a987cc" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-776e0853fc377939" class="astra-member">Shape</h3>

```csharp
public Astra.Components.RadialField2D.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50e67b177ed8c2da" class="astra-member">TangentialAcceleration</h3>

```csharp
public float TangentialAcceleration { get; set; }
```

Aceleração tangencial (m/s²)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Aceleração tangencial:** Aceleração tangencial em torno da origem.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3ce530872e4a4d58" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-87aaef0e775b1119" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField2D.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-affectedlayeroption/
---

# Astra.Components.RadialField2D.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField2D.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-4d5a0e0e16ee7286) | Field |
| [Camada1](#member-a7c2bfc75399da8e) | Field |
| [Camada10](#member-e5fa398da2a4fc0a) | Field |
| [Camada11](#member-6b8974a80c15e13e) | Field |
| [Camada12](#member-d32f8be08e8803df) | Field |
| [Camada13](#member-13fb00dfb55da121) | Field |
| [Camada14](#member-bfa7f11013b5445f) | Field |
| [Camada15](#member-04cf01f71af73c90) | Field |
| [Camada16](#member-617a860932633cbd) | Field |
| [Camada17](#member-250c5941ca37dc03) | Field |
| [Camada18](#member-94dfa48c57548475) | Field |
| [Camada19](#member-298122ba88452611) | Field |
| [Camada2](#member-bc7efdbc53999514) | Field |
| [Camada20](#member-3058fc78f5b18225) | Field |
| [Camada21](#member-c2b6b45bd2ee40bd) | Field |
| [Camada22](#member-7bf83e2ea7441dd9) | Field |
| [Camada23](#member-daa6a6cc99cbf6b4) | Field |
| [Camada24](#member-0fc198aea2f356ed) | Field |
| [Camada25](#member-71b3941cbea3fa8f) | Field |
| [Camada26](#member-665090996d14775b) | Field |
| [Camada27](#member-65cc51ae9fb1403f) | Field |
| [Camada28](#member-d08806bf8167a235) | Field |
| [Camada29](#member-7d8e3a3e0d444e0c) | Field |
| [Camada3](#member-94bf8113a86021be) | Field |
| [Camada30](#member-7c5b72cce34b1667) | Field |
| [Camada31](#member-fed3c8608a0d5f14) | Field |
| [Camada4](#member-88a3c887cda20639) | Field |
| [Camada5](#member-ffd91a4f9f109e5e) | Field |
| [Camada6](#member-1f51c0d6cc61730b) | Field |
| [Camada7](#member-acdf88f5f005b44c) | Field |
| [Camada8](#member-6950e83c61d3aaa5) | Field |
| [Camada9](#member-4da3fbb17656f0d9) | Field |
| [Todas](#member-9aead6f07cd510a4) | Field |

<h3 id="member-4d5a0e0e16ee7286" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a7c2bfc75399da8e" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e5fa398da2a4fc0a" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6b8974a80c15e13e" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d32f8be08e8803df" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-13fb00dfb55da121" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bfa7f11013b5445f" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-04cf01f71af73c90" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-617a860932633cbd" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-250c5941ca37dc03" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-94dfa48c57548475" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-298122ba88452611" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc7efdbc53999514" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3058fc78f5b18225" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2b6b45bd2ee40bd" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7bf83e2ea7441dd9" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-daa6a6cc99cbf6b4" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0fc198aea2f356ed" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71b3941cbea3fa8f" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-665090996d14775b" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-65cc51ae9fb1403f" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d08806bf8167a235" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7d8e3a3e0d444e0c" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-94bf8113a86021be" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c5b72cce34b1667" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fed3c8608a0d5f14" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-88a3c887cda20639" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ffd91a4f9f109e5e" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1f51c0d6cc61730b" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acdf88f5f005b44c" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6950e83c61d3aaa5" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4da3fbb17656f0d9" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9aead6f07cd510a4" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField2D.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-falloffoption/
---

# Astra.Components.RadialField2D.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField2D.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-bdcf75452889c1ca) | Field |
| [Suave](#member-ae31b19846d80638) | Field |
| [Uniforme](#member-d3c9c16937aec88f) | Field |

<h3 id="member-bdcf75452889c1ca" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae31b19846d80638" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d3c9c16937aec88f" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RadialField2D.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-shapeoption/
---

# Astra.Components.RadialField2D.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.RadialField2D.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RadialField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Circulo](#member-c41325ac883b6028) | Field |
| [Retangulo](#member-92ebc316fc384f4f) | Field |

<h3 id="member-c41325ac883b6028" class="astra-member">Circulo</h3>

```csharp
Circulo = 1
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-92ebc316fc384f4f" class="astra-member">Retangulo</h3>

```csharp
Retangulo = 0
```

**Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.RotationConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-rotationconstraint/
---

# Astra.Components.RotationConstraint

Rotation Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.RotationConstraint
```

Rotation Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-RotationConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.RotationConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Rotation Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<RotationConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RotationConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Rotation Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-rotation/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-28c53d7d8f49b7f7) | Method |
| [Remove](#member-f1ccca3dd8f3893b) | Method |
| [Wrap](#member-0ce3974d7b90c357) | Method |
| [AxisX](#member-404948c2f7dc7828) | Property |
| [AxisY](#member-9013977bcb3b4dab) | Property |
| [AxisZ](#member-aa907df3acb06d98) | Property |
| [Component](#member-18c3b693fd69c706) | Property |
| [Enabled](#member-714497303d2a3570) | Property |
| [InstanceId](#member-d3cde174a7df2797) | Property |
| [IsAlive](#member-a092096ae3278456) | Property |
| [Object](#member-d54617f953d632b7) | Property |
| [Offset](#member-4975b7a396e19192) | Property |
| [Target](#member-cf7d97a518a887c3) | Property |
| [TypeId](#member-37468b7194858659) | Property |
| [Weight](#member-478a02f9480b8100) | Property |

<h3 id="member-28c53d7d8f49b7f7" class="astra-member">.ctor</h3>

```csharp
public RotationConstraint(Astra.Component component)
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f1ccca3dd8f3893b" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ce3974d7b90c357" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.RotationConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-404948c2f7dc7828" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Rotation Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9013977bcb3b4dab" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Rotation Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa907df3acb06d98" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Rotation Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-18c3b693fd69c706" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-714497303d2a3570" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Rotation Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d3cde174a7df2797" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a092096ae3278456" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d54617f953d632b7" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4975b7a396e19192" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento

**Caminho:** Inspector → Rotation Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Deslocamento X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Deslocamento Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Deslocamento Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf7d97a518a887c3" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Rotation Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-37468b7194858659" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Rotation Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-478a02f9480b8100" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Rotation Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.ScaleConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-scaleconstraint/
---

# Astra.Components.ScaleConstraint

Scale Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.ScaleConstraint
```

Scale Constraint: Restrição de mundo com uma fonte. Família Lógica · Restrições.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ScaleConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.ScaleConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Scale Constraint**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<ScaleConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new ScaleConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Scale Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-scale/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a99d9917459c04d2) | Method |
| [Remove](#member-6838e9153a9b0dbb) | Method |
| [Wrap](#member-e6982a84015f7f34) | Method |
| [AxisX](#member-b90c2e467b0659e8) | Property |
| [AxisY](#member-58e1f533ef97ce67) | Property |
| [AxisZ](#member-dbb3235cb3cf6afa) | Property |
| [Component](#member-aa85768cce289f4c) | Property |
| [Enabled](#member-acb33870c657c6f6) | Property |
| [InstanceId](#member-8ed9bd855d9a2f3b) | Property |
| [IsAlive](#member-71711fb67d9f5b51) | Property |
| [Object](#member-bb15efa630090b7f) | Property |
| [Offset](#member-f95d1400025a87c6) | Property |
| [Target](#member-478bf8b883281bf5) | Property |
| [TypeId](#member-c4106ecee750bf5c) | Property |
| [Weight](#member-7faa34d78ca46def) | Property |

<h3 id="member-a99d9917459c04d2" class="astra-member">.ctor</h3>

```csharp
public ScaleConstraint(Astra.Component component)
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-6838e9153a9b0dbb" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6982a84015f7f34" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.ScaleConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b90c2e467b0659e8" class="astra-member">AxisX</h3>

```csharp
public bool AxisX { get; set; }
```

Aplicar X

**Caminho:** Inspector → Scale Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar X:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58e1f533ef97ce67" class="astra-member">AxisY</h3>

```csharp
public bool AxisY { get; set; }
```

Aplicar Y

**Caminho:** Inspector → Scale Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Y:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dbb3235cb3cf6afa" class="astra-member">AxisZ</h3>

```csharp
public bool AxisZ { get; set; }
```

Aplicar Z

**Caminho:** Inspector → Scale Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Aplicar Z:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa85768cce289f4c" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acb33870c657c6f6" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Scale Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8ed9bd855d9a2f3b" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71711fb67d9f5b51" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bb15efa630090b7f" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f95d1400025a87c6" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento

**Caminho:** Inspector → Scale Constraint → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Fator X:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros. **Fator Y:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros. **Fator Z:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-478bf8b883281bf5" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Scale Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4106ecee750bf5c" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Scale Constraint; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7faa34d78ca46def" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Peso

Faixa válida: 0 a 1.

**Caminho:** Inspector → Scale Constraint → Influência; ou fachada C# em um Behavior.

**Uso:** **Peso:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.SkinnedMesh"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-skinnedmesh/
---

# Astra.Components.SkinnedMesh

Malha deformável: Esqueleto e blend shapes da Malha. Família Renderização · Geometria.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.SkinnedMesh
```

Malha deformável: Esqueleto e blend shapes da Malha. Família Renderização · Geometria.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-SkinnedMeshRenderer.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.SkinnedMesh>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Geometria** → **Malha deformável**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<SkinnedMesh>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new SkinnedMesh(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Malha deformável](/pt-br/snapshot-2026-10-06/componentes/astra-render-skinned-mesh/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-4fa9350b2ea5eba5) | Method |
| [GetBlendShapeWeight](#member-14d309454f6458bf) | Method |
| [Remove](#member-870a0e8d502c0535) | Method |
| [SetBlendShapeWeight](#member-1dee5f019c5ec9ec) | Method |
| [Wrap](#member-60ea23870ec606c4) | Method |
| [Component](#member-c01ba7a9c8a846ef) | Property |
| [InstanceId](#member-5f20056b57158579) | Property |
| [IsAlive](#member-2a7e39c811cd7c2e) | Property |
| [Object](#member-717a9f559e4b1f4c) | Property |
| [Quality](#member-949b2866807d940a) | Property |
| [SkinnedMotionVectors](#member-357b6fd3dcb00910) | Property |
| [TypeId](#member-be6b6a5872eb60e6) | Property |

<h3 id="member-4fa9350b2ea5eba5" class="astra-member">.ctor</h3>

```csharp
public SkinnedMesh(Astra.Component component)
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-14d309454f6458bf" class="astra-member">GetBlendShapeWeight</h3>

```csharp
public float GetBlendShapeWeight(uint slot)
```

Peso do blend shape (%). Valor por slot

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Peso do blend shape (%). Valor por slot

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |

<h3 id="member-870a0e8d502c0535" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1dee5f019c5ec9ec" class="astra-member">SetBlendShapeWeight</h3>

```csharp
public void SetBlendShapeWeight(uint slot, float value)
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  |
| `value` | `float` |  |

<h3 id="member-60ea23870ec606c4" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.SkinnedMesh Wrap(Astra.Component component)
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-c01ba7a9c8a846ef" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5f20056b57158579" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a7e39c811cd7c2e" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-717a9f559e4b1f4c" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-949b2866807d940a" class="astra-member">Quality</h3>

```csharp
public Astra.Components.SkinnedMesh.QualityOption Quality { get; set; }
```

Qualidade. Influências por vértice usadas na deformação (Skin Weights)

**Caminho:** Inspector → Malha deformável → Skin; ou fachada C# em um Behavior.

**Uso:** **Qualidade:** Influências por vértice usadas na deformação (Skin Weights)

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-357b6fd3dcb00910" class="astra-member">SkinnedMotionVectors</h3>

```csharp
public bool SkinnedMotionVectors { get; set; }
```

Vetor de movimento da deformação. A reprojeção temporal usa a pose anterior dos ossos e dos blend shapes, não só a do objeto

**Caminho:** Inspector → Malha deformável → Skin; ou fachada C# em um Behavior.

**Uso:** **Vetor de movimento da deformação:** A reprojeção temporal usa a pose anterior dos ossos e dos blend shapes, não só a do objeto

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-be6b6a5872eb60e6" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.SkinnedMesh.QualityOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-skinnedmesh-qualityoption/
---

# Astra.Components.SkinnedMesh.QualityOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.SkinnedMesh.QualityOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Geometria** → **Malha deformável**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<SkinnedMesh>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new SkinnedMesh(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Automatica](#member-edbd0346b274ffaf) | Field |
| [V1Osso](#member-ae5352c94ef9fa36) | Field |
| [V2Ossos](#member-631aa0bbdc79404e) | Field |
| [V4Ossos](#member-e374ccfdef9b4ef9) | Field |

<h3 id="member-edbd0346b274ffaf" class="astra-member">Automatica</h3>

```csharp
Automatica = 0
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae5352c94ef9fa36" class="astra-member">V1Osso</h3>

```csharp
V1Osso = 1
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-631aa0bbdc79404e" class="astra-member">V2Ossos</h3>

```csharp
V2Ossos = 2
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e374ccfdef9b4ef9" class="astra-member">V4Ossos</h3>

```csharp
V4Ossos = 4
```

**Caminho:** Inspector → Malha deformável; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.SpringPositionConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-springpositionconstraint/
---

# Astra.Components.SpringPositionConstraint

Mola de posição: Segue fonte com velocidade e amortecimento persistentes no runtime. Família Lógica · Molas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.SpringPositionConstraint
```

Mola de posição: Segue fonte com velocidade e amortecimento persistentes no runtime. Família Lógica · Molas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-PositionConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.SpringPositionConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de posição**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<SpringPositionConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new SpringPositionConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Mola de posição](/pt-br/snapshot-2026-10-06/componentes/astra-spring-position/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-466bc50ee0f771d8) | Method |
| [Remove](#member-b142998f35162f36) | Method |
| [Wrap](#member-1eec84fedd730db1) | Method |
| [Component](#member-631cb61ad022e123) | Property |
| [DampingRatio](#member-e9234131a038f380) | Property |
| [Enabled](#member-1479f28bbeb7616b) | Property |
| [Frequency](#member-7e73568cf33f0f2c) | Property |
| [InstanceId](#member-9cb13dead37a0334) | Property |
| [IsAlive](#member-785d435874a5a599) | Property |
| [MaxSpeed](#member-403aebf0acff2aa8) | Property |
| [Object](#member-ac46fc9084da8cdc) | Property |
| [Offset](#member-291f9193d3171a3a) | Property |
| [Target](#member-e7e1a64344aa3368) | Property |
| [TypeId](#member-1568700a584db97d) | Property |
| [Weight](#member-14151385f0320ff3) | Property |

<h3 id="member-466bc50ee0f771d8" class="astra-member">.ctor</h3>

```csharp
public SpringPositionConstraint(Astra.Component component)
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b142998f35162f36" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1eec84fedd730db1" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.SpringPositionConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-631cb61ad022e123" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e9234131a038f380" class="astra-member">DampingRatio</h3>

```csharp
public float DampingRatio { get; set; }
```

Razão de amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Mola de posição → Resposta; ou fachada C# em um Behavior.

**Uso:** **Razão de amortecimento:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1479f28bbeb7616b" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Mola de posição → Fonte; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e73568cf33f0f2c" class="astra-member">Frequency</h3>

```csharp
public float Frequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.01 a 60.

**Caminho:** Inspector → Mola de posição → Resposta; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9cb13dead37a0334" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-785d435874a5a599" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-403aebf0acff2aa8" class="astra-member">MaxSpeed</h3>

```csharp
public float MaxSpeed { get; set; }
```

Velocidade máxima (m/s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Mola de posição → Resposta; ou fachada C# em um Behavior.

**Uso:** **Velocidade máxima:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac46fc9084da8cdc" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-291f9193d3171a3a" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Offset

**Caminho:** Inspector → Mola de posição → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Offset X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Offset Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Offset Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e7e1a64344aa3368" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Mola de posição → Fonte; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1568700a584db97d" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Mola de posição; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14151385f0320ff3" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Influência

Faixa válida: 0 a 1.

**Caminho:** Inspector → Mola de posição → Fonte; ou fachada C# em um Behavior.

**Uso:** **Influência:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.SpringRotationConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-springrotationconstraint/
---

# Astra.Components.SpringRotationConstraint

Mola de rotação: Segue orientação por quaternion com amortecimento e caminho curto. Família Lógica · Molas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.SpringRotationConstraint
```

Mola de rotação: Segue orientação por quaternion com amortecimento e caminho curto. Família Lógica · Molas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-RotationConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.SpringRotationConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de rotação**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<SpringRotationConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new SpringRotationConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Mola de rotação](/pt-br/snapshot-2026-10-06/componentes/astra-spring-rotation/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-3ae4e3eeb9b2a906) | Method |
| [Remove](#member-bbd7b4a4e25d94c9) | Method |
| [Wrap](#member-cbb9171d1fb72d76) | Method |
| [Component](#member-afca7478c444beec) | Property |
| [DampingRatio](#member-7c092ee69ae1950f) | Property |
| [Enabled](#member-1408aaf8346d6380) | Property |
| [Frequency](#member-486da6bbb5fbde81) | Property |
| [InstanceId](#member-e19b37450e742c29) | Property |
| [IsAlive](#member-03638d9ac3d207f0) | Property |
| [MaxSpeed](#member-25f1c9c92f7c0c9c) | Property |
| [Object](#member-6fcec19ca5388e19) | Property |
| [Offset](#member-3544b1a3d3be9640) | Property |
| [Target](#member-c3c9c045e8232faa) | Property |
| [TypeId](#member-e6dd33af6f34105e) | Property |
| [Weight](#member-ff04709806c47482) | Property |

<h3 id="member-3ae4e3eeb9b2a906" class="astra-member">.ctor</h3>

```csharp
public SpringRotationConstraint(Astra.Component component)
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-bbd7b4a4e25d94c9" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cbb9171d1fb72d76" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.SpringRotationConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-afca7478c444beec" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c092ee69ae1950f" class="astra-member">DampingRatio</h3>

```csharp
public float DampingRatio { get; set; }
```

Razão de amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Mola de rotação → Resposta; ou fachada C# em um Behavior.

**Uso:** **Razão de amortecimento:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1408aaf8346d6380" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Mola de rotação → Fonte; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-486da6bbb5fbde81" class="astra-member">Frequency</h3>

```csharp
public float Frequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.01 a 60.

**Caminho:** Inspector → Mola de rotação → Resposta; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e19b37450e742c29" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03638d9ac3d207f0" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-25f1c9c92f7c0c9c" class="astra-member">MaxSpeed</h3>

```csharp
public float MaxSpeed { get; set; }
```

Velocidade máxima (graus/s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Mola de rotação → Resposta; ou fachada C# em um Behavior.

**Uso:** **Velocidade máxima:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6fcec19ca5388e19" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3544b1a3d3be9640" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Offset

**Caminho:** Inspector → Mola de rotação → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Offset X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Offset Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Offset Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c3c9c045e8232faa" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Mola de rotação → Fonte; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6dd33af6f34105e" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Mola de rotação; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ff04709806c47482" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Influência

Faixa válida: 0 a 1.

**Caminho:** Inspector → Mola de rotação → Fonte; ou fachada C# em um Behavior.

**Uso:** **Influência:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.SpringScaleConstraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-springscaleconstraint/
---

# Astra.Components.SpringScaleConstraint

Mola de escala: Segue escala positiva sem publicar escala singular. Família Lógica · Molas.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.SpringScaleConstraint
```

Mola de escala: Segue escala positiva sem publicar escala singular. Família Lógica · Molas.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ScaleConstraint.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.SpringScaleConstraint>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de escala**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<SpringScaleConstraint>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new SpringScaleConstraint(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Mola de escala](/pt-br/snapshot-2026-10-06/componentes/astra-spring-scale/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-2e389964fc0d02c8) | Method |
| [Remove](#member-228b23c06a34577c) | Method |
| [Wrap](#member-d092196e80bcbea0) | Method |
| [Component](#member-73b6b0c0fa222e70) | Property |
| [DampingRatio](#member-6a08267f2d640c81) | Property |
| [Enabled](#member-c579b3eb197ec393) | Property |
| [Frequency](#member-accc0dca1cc82df3) | Property |
| [InstanceId](#member-3d2a59b2aff39943) | Property |
| [IsAlive](#member-2453cbd857e3523c) | Property |
| [MaxSpeed](#member-53a605e81b886911) | Property |
| [Object](#member-658dfb118e793573) | Property |
| [Offset](#member-6ed158647acddee8) | Property |
| [Target](#member-653e4abf7a6ba090) | Property |
| [TypeId](#member-9dc91876a5759427) | Property |
| [Weight](#member-650a4e65012b2493) | Property |

<h3 id="member-2e389964fc0d02c8" class="astra-member">.ctor</h3>

```csharp
public SpringScaleConstraint(Astra.Component component)
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-228b23c06a34577c" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d092196e80bcbea0" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.SpringScaleConstraint Wrap(Astra.Component component)
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-73b6b0c0fa222e70" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6a08267f2d640c81" class="astra-member">DampingRatio</h3>

```csharp
public float DampingRatio { get; set; }
```

Razão de amortecimento

Faixa válida: 0 a 10.

**Caminho:** Inspector → Mola de escala → Resposta; ou fachada C# em um Behavior.

**Uso:** **Razão de amortecimento:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c579b3eb197ec393" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Mola de escala → Fonte; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-accc0dca1cc82df3" class="astra-member">Frequency</h3>

```csharp
public float Frequency { get; set; }
```

Frequência (Hz)

Faixa válida: 0.01 a 60.

**Caminho:** Inspector → Mola de escala → Resposta; ou fachada C# em um Behavior.

**Uso:** **Frequência:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d2a59b2aff39943" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2453cbd857e3523c" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53a605e81b886911" class="astra-member">MaxSpeed</h3>

```csharp
public float MaxSpeed { get; set; }
```

Velocidade máxima (x/s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Mola de escala → Resposta; ou fachada C# em um Behavior.

**Uso:** **Velocidade máxima:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-658dfb118e793573" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6ed158647acddee8" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Offset

**Caminho:** Inspector → Mola de escala → Ajustes; ou fachada C# em um Behavior.

**Uso:** **Offset X:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros. **Offset Y:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros. **Offset Z:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-653e4abf7a6ba090" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Fonte

**Caminho:** Inspector → Mola de escala → Fonte; ou fachada C# em um Behavior.

**Uso:** **Fonte:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9dc91876a5759427" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Mola de escala; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-650a4e65012b2493" class="astra-member">Weight</h3>

```csharp
public float Weight { get; set; }
```

Influência

Faixa válida: 0 a 1.

**Caminho:** Inspector → Mola de escala → Fonte; ou fachada C# em um Behavior.

**Uso:** **Influência:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Roadmap deste membro:** [Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.TransformTween"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-transformtween/
---

# Astra.Components.TransformTween

Transform Tween: Interpola canais locais com espera, curva e repetição. Família Lógica · Tempo.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.TransformTween
```

Transform Tween: Interpola canais locais com espera, curva e repetição. Família Lógica · Tempo.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_tween.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.TransformTween>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<TransformTween>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new TransformTween(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Transform Tween](/pt-br/snapshot-2026-10-06/componentes/astra-tween-transform/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-4de0c94360df438a) | Method |
| [Cancel](#member-9469facc56ff4600) | Method |
| [Elapsed](#member-d64d49a8d9f4dc62) | Method |
| [OnCompleted](#member-07682d2c51f12448) | Method |
| [Pause](#member-737cbb521b8b3cf7) | Method |
| [Remove](#member-ce5eacf75d8ee13b) | Method |
| [Restart](#member-ce2afcfe4eb65666) | Method |
| [Resume](#member-0bdc116519ff435c) | Method |
| [Wrap](#member-6557b883dfcd039c) | Method |
| [Autoplay](#member-b70275907206d3f7) | Property |
| [Component](#member-71975c21116cf789) | Property |
| [Delay](#member-5375b49c0a8f8ec7) | Property |
| [Duration](#member-98a9a7f0e21c570a) | Property |
| [Easing](#member-f189f82851f7b323) | Property |
| [Enabled](#member-949a39e14d2c9a0b) | Property |
| [FinishedAction](#member-a0ebe0c9d3958c12) | Property |
| [FinishedTarget](#member-780db202be12ca79) | Property |
| [IgnoreTimeScale](#member-0060d115f499617b) | Property |
| [InstanceId](#member-73e1bacf54d090e2) | Property |
| [IsAlive](#member-e0bc06d890cf81f2) | Property |
| [Loops](#member-cf73bb8010662938) | Property |
| [Object](#member-e757fab010f5780b) | Property |
| [Pingpong](#member-682e097d9046f74a) | Property |
| [Position](#member-139a81a65775f055) | Property |
| [PositionDestination](#member-4a87e3147e51ec87) | Property |
| [Relative](#member-652f9f002105da98) | Property |
| [Rotation](#member-3797dae4f7355783) | Property |
| [RotationDestination](#member-4316df0f77e766c6) | Property |
| [Scale](#member-9c6a276b4dde6104) | Property |
| [ScaleDestination](#member-2a37b5ab2e0b0bcf) | Property |
| [TypeId](#member-55674668afc465f3) | Property |

<h3 id="member-4de0c94360df438a" class="astra-member">.ctor</h3>

```csharp
public TransformTween(Astra.Component component)
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-9469facc56ff4600" class="astra-member">Cancel</h3>

```csharp
public void Cancel()
```

Cancelar. Interrompe sem voltar à pose inicial

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Cancelar. Interrompe sem voltar à pose inicial

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d64d49a8d9f4dc62" class="astra-member">Elapsed</h3>

```csharp
public double Elapsed()
```

Decorrido. Segundos desde o início, incluindo o atraso

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Decorrido. Segundos desde o início, incluindo o atraso

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07682d2c51f12448" class="astra-member">OnCompleted</h3>

```csharp
public Astra.ComponentSubscription OnCompleted(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)
```

Concluiu. Emitido uma vez quando as repetições finitas terminam, depois da pose final

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Concluiu. Emitido uma vez quando as repetições finitas terminam, depois da pose final

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.Behavior` |  |
| `handler` | `System.Action&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-737cbb521b8b3cf7" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

Pausar. Congela o progresso

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Pausar. Congela o progresso

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ce5eacf75d8ee13b" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ce2afcfe4eb65666" class="astra-member">Restart</h3>

```csharp
public void Restart()
```

Reiniciar. Recomeça da pose atual, conservando a pausa

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Reiniciar. Recomeça da pose atual, conservando a pausa

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0bdc116519ff435c" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

Retomar. Continua o progresso pausado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Retomar. Continua o progresso pausado

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6557b883dfcd039c" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.TransformTween Wrap(Astra.Component component)
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b70275907206d3f7" class="astra-member">Autoplay</h3>

```csharp
public bool Autoplay { get; set; }
```

Iniciar no Play

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Iniciar no Play:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71975c21116cf789" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5375b49c0a8f8ec7" class="astra-member">Delay</h3>

```csharp
public float Delay { get; set; }
```

Espera (s)

Faixa válida: 0 a 36000.

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Espera:** Espera inicial antes de reproduzir a transição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98a9a7f0e21c570a" class="astra-member">Duration</h3>

```csharp
public float Duration { get; set; }
```

Duração (s)

Faixa válida: 0.001 a 36000.

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Duração:** Tempo da reprodução/interpolação; configure na unidade indicada. Valor curto acelera a transição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f189f82851f7b323" class="astra-member">Easing</h3>

```csharp
public Astra.Components.TransformTween.EasingOption Easing { get; set; }
```

Curva

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Curva:** Escolhe a curva de interpolação; altera a velocidade ao longo da transição, não o valor final.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-949a39e14d2c9a0b" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0ebe0c9d3958c12" class="astra-member">FinishedAction</h3>

```csharp
public Astra.Components.TransformTween.FinishedActionOption FinishedAction { get; set; }
```

Ao concluir. Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara

**Caminho:** Inspector → Transform Tween → Conexão; ou fachada C# em um Behavior.

**Uso:** **Ao concluir:** Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-780db202be12ca79" class="astra-member">FinishedTarget</h3>

```csharp
public Astra.ObjectReference FinishedTarget { get; set; }
```

Receptor. Referência persistente remapeada ao clonar; controla activeSelf do receptor

**Caminho:** Inspector → Transform Tween → Conexão; ou fachada C# em um Behavior.

**Uso:** **Receptor:** Referência persistente remapeada ao clonar; controla activeSelf do receptor

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0060d115f499617b" class="astra-member">IgnoreTimeScale</h3>

```csharp
public bool IgnoreTimeScale { get; set; }
```

Ignorar escala de tempo. Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos

**Caminho:** Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.

**Uso:** **Ignorar escala de tempo:** Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-73e1bacf54d090e2" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e0bc06d890cf81f2" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf73bb8010662938" class="astra-member">Loops</h3>

```csharp
public Astra.Components.TransformTween.LoopsOption Loops { get; set; }
```

Ciclos

**Caminho:** Inspector → Transform Tween → Repetição; ou fachada C# em um Behavior.

**Uso:** **Ciclos:** Número/política de repetições no domínio indicado; confira a opção de repetição contínua na enumeração/contrato.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e757fab010f5780b" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-682e097d9046f74a" class="astra-member">Pingpong</h3>

```csharp
public bool Pingpong { get; set; }
```

Ida e volta

**Caminho:** Inspector → Transform Tween → Repetição; ou fachada C# em um Behavior.

**Uso:** **Ida e volta:** Alterna ida e volta na reprodução.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-139a81a65775f055" class="astra-member">Position</h3>

```csharp
public bool Position { get; set; }
```

Mover

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Mover:** Seleciona a participação do canal de posição no tween.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a87e3147e51ec87" class="astra-member">PositionDestination</h3>

```csharp
public System.Numerics.Vector3 PositionDestination { get; set; }
```

Posição destino

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Destino X:** Destino do canal de posição do tween, eixo X. **Destino Y:** Destino do canal de posição do tween, eixo Y. **Destino Z:** Destino do canal de posição do tween, eixo Z.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-652f9f002105da98" class="astra-member">Relative</h3>

```csharp
public bool Relative { get; set; }
```

Destino relativo

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Destino relativo:** Interpreta os valores da transição como deslocamento relativo, conforme o canal.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3797dae4f7355783" class="astra-member">Rotation</h3>

```csharp
public bool Rotation { get; set; }
```

Girar

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Girar:** Seleciona a participação do canal de rotação no tween.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4316df0f77e766c6" class="astra-member">RotationDestination</h3>

```csharp
public System.Numerics.Vector3 RotationDestination { get; set; }
```

Rotação destino

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Rotação X:** Rotação autorada do sistema na unidade indicada, eixo X. **Rotação Y:** Rotação autorada do sistema na unidade indicada, eixo Y. **Rotação Z:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c6a276b4dde6104" class="astra-member">Scale</h3>

```csharp
public bool Scale { get; set; }
```

Escalar

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Escalar:** Seleciona a participação do canal de escala no tween.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a37b5ab2e0b0bcf" class="astra-member">ScaleDestination</h3>

```csharp
public System.Numerics.Vector3 ScaleDestination { get; set; }
```

Escala destino

**Caminho:** Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.

**Uso:** **Escala X:** Destino do canal de escala do tween, eixo X. **Escala Y:** Destino do canal de escala do tween, eixo Y. **Escala Z:** Destino do canal de escala do tween, eixo Z.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55674668afc465f3" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.TransformTween.EasingOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-easingoption/
---

# Astra.Components.TransformTween.EasingOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.TransformTween.EasingOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<TransformTween>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new TransformTween(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-f360d186c6702430) | Field |
| [QuadraticoEntrada](#member-76dad7c06358e87a) | Field |
| [QuadraticoSaida](#member-ab1105ba60811500) | Field |
| [Smoothstep](#member-956629395cfdc16e) | Field |

<h3 id="member-f360d186c6702430" class="astra-member">Linear</h3>

```csharp
Linear = 0
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-76dad7c06358e87a" class="astra-member">QuadraticoEntrada</h3>

```csharp
QuadraticoEntrada = 2
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab1105ba60811500" class="astra-member">QuadraticoSaida</h3>

```csharp
QuadraticoSaida = 3
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-956629395cfdc16e" class="astra-member">Smoothstep</h3>

```csharp
Smoothstep = 1
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.TransformTween.FinishedActionOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-finishedactionoption/
---

# Astra.Components.TransformTween.FinishedActionOption

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.TransformTween.FinishedActionOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<TransformTween>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new TransformTween(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlternarObjeto](#member-11bbca95d5e8a178) | Field |
| [AtivarObjeto](#member-9ade2d4a7a2c3e03) | Field |
| [DesativarObjeto](#member-008cf2abbf54880d) | Field |
| [Desconectado](#member-2d990a2bff759bb3) | Field |

<h3 id="member-11bbca95d5e8a178" class="astra-member">AlternarObjeto</h3>

```csharp
AlternarObjeto = 3
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9ade2d4a7a2c3e03" class="astra-member">AtivarObjeto</h3>

```csharp
AtivarObjeto = 1
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-008cf2abbf54880d" class="astra-member">DesativarObjeto</h3>

```csharp
DesativarObjeto = 2
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d990a2bff759bb3" class="astra-member">Desconectado</h3>

```csharp
Desconectado = 0
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.TransformTween.LoopsOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-loopsoption/
---

# Astra.Components.TransformTween.LoopsOption

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.TransformTween.LoopsOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<TransformTween>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new TransformTween(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DezVezes](#member-f3fb92cc5515df71) | Field |
| [DuasVezes](#member-a440ee66e0dcd8a2) | Field |
| [Infinito](#member-755af0ba6cd9c29c) | Field |
| [TresVezes](#member-f59cd1ac610c41cf) | Field |
| [UmaVez](#member-c142d51709e4577b) | Field |

<h3 id="member-f3fb92cc5515df71" class="astra-member">DezVezes</h3>

```csharp
DezVezes = 10
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a440ee66e0dcd8a2" class="astra-member">DuasVezes</h3>

```csharp
DuasVezes = 2
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-755af0ba6cd9c29c" class="astra-member">Infinito</h3>

```csharp
Infinito = 0
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f59cd1ac610c41cf" class="astra-member">TresVezes</h3>

```csharp
TresVezes = 3
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c142d51709e4577b" class="astra-member">UmaVez</h3>

```csharp
UmaVez = 1
```

**Caminho:** Inspector → Transform Tween; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.UiCanvas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas/
---

# Astra.Components.UiCanvas

Canvas UI: Instância independente de documento de UI, na tela ou no objeto. Família Renderização · Interface.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.UiCanvas
```

Canvas UI: Instância independente de documento de UI, na tela ou no objeto. Família Renderização · Interface.

Referência estudada: https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/class-Canvas.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.UiCanvas>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Interface** → **Canvas UI**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<UiCanvas>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new UiCanvas(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Canvas UI](/pt-br/snapshot-2026-10-06/componentes/astra-ui-canvas/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-706723e9affc38a5) | Method |
| [GetDocument](#member-eda975fe53a89291) | Method |
| [Remove](#member-2d9e8c3e181e785d) | Method |
| [SetDocument](#member-8585973dc4552982) | Method |
| [Wrap](#member-89705b7aa22a41ff) | Method |
| [Component](#member-08d571dd533bd2e6) | Property |
| [Enabled](#member-7cde971b39f68a2c) | Property |
| [InputCamera](#member-9429580b4c4d12cd) | Property |
| [InputReceiver](#member-58aeccd269f66471) | Property |
| [InstanceId](#member-5831e84f8405f826) | Property |
| [IsAlive](#member-2f03bbc5cecf6fbe) | Property |
| [Mode](#member-de309c4e6ca8f61f) | Property |
| [MovementSpace](#member-c52a0f29f65827e3) | Property |
| [Object](#member-d345cfde43355ce8) | Property |
| [Occlusion](#member-e1353dbc4b49273c) | Property |
| [Offset](#member-1a1be55ebc5c7fa4) | Property |
| [Order](#member-9bcd2e6bd8b3882d) | Property |
| [Resolution](#member-e61149985a6e062b) | Property |
| [Rotation](#member-07e04ab0e51212ad) | Property |
| [TypeId](#member-ea5ab67d9f162689) | Property |
| [UnitsPerPixel](#member-bd8a73af7da52e42) | Property |

<h3 id="member-706723e9affc38a5" class="astra-member">.ctor</h3>

```csharp
public UiCanvas(Astra.Component component)
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-eda975fe53a89291" class="astra-member">GetDocument</h3>

```csharp
public Astra.AssetGuid GetDocument(uint slot = 0)
```

Documento UI. Recurso do projeto por slot

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Documento UI. Recurso do projeto por slot

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-2d9e8c3e181e785d" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8585973dc4552982" class="astra-member">SetDocument</h3>

```csharp
public void SetDocument(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-89705b7aa22a41ff" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.UiCanvas Wrap(Astra.Component component)
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-08d571dd533bd2e6" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7cde971b39f68a2c" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Habilitado

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Habilitado:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9429580b4c4d12cd" class="astra-member">InputCamera</h3>

```csharp
public Astra.ObjectReference InputCamera { get; set; }
```

Camera de entrada

**Caminho:** Inspector → Canvas UI → Entrada; ou fachada C# em um Behavior.

**Uso:** **Camera de entrada:** Câmera usada para o espaço de movimento/olhar dos controles do Canvas.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58aeccd269f66471" class="astra-member">InputReceiver</h3>

```csharp
public Astra.ObjectReference InputReceiver { get; set; }
```

Jogador / receptor. Character ou motor de corpo dinâmico ativo.

**Caminho:** Inspector → Canvas UI → Entrada; ou fachada C# em um Behavior.

**Uso:** **Jogador / receptor:** Character ou motor de corpo dinâmico ativo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5831e84f8405f826" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f03bbc5cecf6fbe" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-de309c4e6ca8f61f" class="astra-member">Mode</h3>

```csharp
public Astra.Components.UiCanvas.ModeOption Mode { get; set; }
```

Apresentação

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Apresentação:** Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c52a0f29f65827e3" class="astra-member">MovementSpace</h3>

```csharp
public Astra.Components.UiCanvas.MovementSpaceOption MovementSpace { get; set; }
```

Espaço do movimento

**Caminho:** Inspector → Canvas UI → Entrada; ou fachada C# em um Behavior.

**Uso:** **Espaço do movimento:** Escolhe espaço do vetor de movimento: mundo, jogador ou câmera de entrada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d345cfde43355ce8" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1353dbc4b49273c" class="astra-member">Occlusion</h3>

```csharp
public bool Occlusion { get; set; }
```

Oclusão no mundo. Depth e hit de Canvas no mundo.

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Oclusão no mundo:** Depth e hit de Canvas no mundo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1a1be55ebc5c7fa4" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Deslocamento local

**Caminho:** Inspector → Canvas UI → Apresentação; ou fachada C# em um Behavior.

**Uso:** **Posição X:** Aplica-se ao Canvas no mundo; Tela usa o viewport. **Posição Y:** Aplica-se ao Canvas no mundo; Tela usa o viewport. **Posição Z:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9bcd2e6bd8b3882d" class="astra-member">Order</h3>

```csharp
public float Order { get; set; }
```

Ordem

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Ordem:** Ordena apresentação dos Canvas; compare sobreposição e entrada com o modo efetivo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e61149985a6e062b" class="astra-member">Resolution</h3>

```csharp
public System.Numerics.Vector2 Resolution { get; set; }
```

Resolução

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Largura:** Resolução local do plano no modo Mundo. No modo Tela, o retângulo é o viewport; não é resolução de referência para escala. **Altura:** Resolução local do plano no modo Mundo. No modo Tela, o retângulo é o viewport; não é resolução de referência para escala.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07e04ab0e51212ad" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Vector3 Rotation { get; set; }
```

Rotação local

**Caminho:** Inspector → Canvas UI → Apresentação; ou fachada C# em um Behavior.

**Uso:** **Rotação X:** Aplica-se ao Canvas no mundo; Tela usa o viewport. **Rotação Y:** Aplica-se ao Canvas no mundo; Tela usa o viewport. **Rotação Z:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ea5ab67d9f162689" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bd8a73af7da52e42" class="astra-member">UnitsPerPixel</h3>

```csharp
public float UnitsPerPixel { get; set; }
```

Unidades por pixel (m/px). Aplica-se ao Canvas no mundo; Tela usa o viewport.

Faixa válida: 0.00001 a 10.

**Caminho:** Inspector → Canvas UI → Canvas; ou fachada C# em um Behavior.

**Uso:** **Unidades por pixel:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.UiCanvas.ModeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas-modeoption/
---

# Astra.Components.UiCanvas.ModeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.UiCanvas.ModeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Interface** → **Canvas UI**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<UiCanvas>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new UiCanvas(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [MundoObjeto](#member-49b0ae92a3c315a2) | Field |
| [Tela](#member-1bbf51d5f96ac641) | Field |

<h3 id="member-49b0ae92a3c315a2" class="astra-member">MundoObjeto</h3>

```csharp
MundoObjeto = 1
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bbf51d5f96ac641" class="astra-member">Tela</h3>

```csharp
Tela = 0
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.UiCanvas.MovementSpaceOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas-movementspaceoption/
---

# Astra.Components.UiCanvas.MovementSpaceOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.UiCanvas.MovementSpaceOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Interface** → **Canvas UI**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<UiCanvas>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new UiCanvas(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [CameraDeEntrada](#member-46172d7d05a66bad) | Field |
| [LocalDoJogador](#member-9ea9ed40667d030e) | Field |
| [Mundo](#member-84e016b9eca6f484) | Field |

<h3 id="member-46172d7d05a66bad" class="astra-member">CameraDeEntrada</h3>

```csharp
CameraDeEntrada = 2
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9ea9ed40667d030e" class="astra-member">LocalDoJogador</h3>

```csharp
LocalDoJogador = 1
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-84e016b9eca6f484" class="astra-member">Mundo</h3>

```csharp
Mundo = 0
```

**Caminho:** Inspector → Canvas UI; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield/
---

# Astra.Components.WindField

Campo de vento: Arrasto para velocidade local do ar, dependente da massa. Família Física 3D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.WindField
```

Campo de vento: Arrasto para velocidade local do ar, dependente da massa. Família Física 3D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.WindField>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de vento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de vento](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-wind/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-15085f4d682bbe46) | Method |
| [Remove](#member-b76735f8951ee0e9) | Method |
| [Wrap](#member-5722a4421598b1e5) | Method |
| [AffectedLayer](#member-8dea7fbd3ddca5a9) | Property |
| [Coefficient](#member-3817c605c80f0576) | Property |
| [Component](#member-cc91beab26069ef6) | Property |
| [Enabled](#member-41799785dec52359) | Property |
| [Falloff](#member-fcd98c95433a86bc) | Property |
| [HalfExtents](#member-127891c8822c044d) | Property |
| [InstanceId](#member-2cb5ba3633029d6f) | Property |
| [IsAlive](#member-55e252b2f5382b90) | Property |
| [Object](#member-6ea9d2261171d714) | Property |
| [Offset](#member-5f96ebb3c86dcdac) | Property |
| [Radius](#member-393672b9900bb23b) | Property |
| [Shape](#member-22e4abb8f316234d) | Property |
| [TypeId](#member-948db24e9b6a075a) | Property |
| [Vector](#member-6d17ac8b32cc2dac) | Property |
| [WakeBodies](#member-61a4263d82dc8e2b) | Property |

<h3 id="member-15085f4d682bbe46" class="astra-member">.ctor</h3>

```csharp
public WindField(Astra.Component component)
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b76735f8951ee0e9" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5722a4421598b1e5" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.WindField Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-8dea7fbd3ddca5a9" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.WindField.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de vento → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3817c605c80f0576" class="astra-member">Coefficient</h3>

```csharp
public float Coefficient { get; set; }
```

Acoplamento (kg/s)

Faixa válida: 0 a 10000.

**Caminho:** Inspector → Campo de vento → Efeito; ou fachada C# em um Behavior.

**Uso:** **Acoplamento:** Coeficiente da contribuição de vento, combinado com o vetor/campo.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc91beab26069ef6" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-41799785dec52359" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de vento → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fcd98c95433a86bc" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.WindField.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de vento → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-127891c8822c044d" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector3 HalfExtents { get; set; }
```

Meias XYZ

**Caminho:** Inspector → Campo de vento → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Z:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2cb5ba3633029d6f" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55e252b2f5382b90" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6ea9d2261171d714" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5f96ebb3c86dcdac" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector3 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de vento → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Centro Z:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-393672b9900bb23b" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de vento → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-22e4abb8f316234d" class="astra-member">Shape</h3>

```csharp
public Astra.Components.WindField.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de vento → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-948db24e9b6a075a" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d17ac8b32cc2dac" class="astra-member">Vector</h3>

```csharp
public System.Numerics.Vector3 Vector { get; set; }
```

Vento local

**Caminho:** Inspector → Campo de vento → Efeito; ou fachada C# em um Behavior.

**Uso:** **Vetor X:** Componente do vetor de contribuição do campo, eixo X. **Vetor Y:** Componente do vetor de contribuição do campo, eixo Y. **Vetor Z:** Componente do vetor de contribuição do campo, eixo Z.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61a4263d82dc8e2b" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de vento → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield-affectedlayeroption/
---

# Astra.Components.WindField.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de vento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-b2a5f522af44e956) | Field |
| [Camada1](#member-8d49c649003423ea) | Field |
| [Camada10](#member-93604de42cbcc1e5) | Field |
| [Camada11](#member-a231d40bcc32bfd0) | Field |
| [Camada12](#member-d2f5c60d24c945e1) | Field |
| [Camada13](#member-be8c22de0591bd6d) | Field |
| [Camada14](#member-c4cc6c199a67d5fc) | Field |
| [Camada15](#member-f1e4a2209a7483a1) | Field |
| [Camada16](#member-5c44030278a20326) | Field |
| [Camada17](#member-1109698a60ac7f6f) | Field |
| [Camada18](#member-07a323c147571c81) | Field |
| [Camada19](#member-5c0ca8f94cdbc4bb) | Field |
| [Camada2](#member-01451a6ca60c5cc3) | Field |
| [Camada20](#member-e1255c6df0364a63) | Field |
| [Camada21](#member-a66e498861ec8c90) | Field |
| [Camada22](#member-a3a0a98eeebd5ca9) | Field |
| [Camada23](#member-7706c591b0ebad69) | Field |
| [Camada24](#member-db280d774b41a223) | Field |
| [Camada25](#member-3bdc8741efb09d0b) | Field |
| [Camada26](#member-9ac7efe2f5219379) | Field |
| [Camada27](#member-e624a588523cba5b) | Field |
| [Camada28](#member-c0be18d28353d3fc) | Field |
| [Camada29](#member-7a997268a8e444a5) | Field |
| [Camada3](#member-acee44f9b95b421c) | Field |
| [Camada30](#member-febb779aa85c6689) | Field |
| [Camada31](#member-d45029af96fad212) | Field |
| [Camada4](#member-1d8d9f85a9937d3d) | Field |
| [Camada5](#member-2549f50c62ecdc56) | Field |
| [Camada6](#member-0cd3255c69351524) | Field |
| [Camada7](#member-5935c9fbb31e6598) | Field |
| [Camada8](#member-4d24f6fb17335358) | Field |
| [Camada9](#member-98a72c3192c6c5c9) | Field |
| [Todas](#member-ab36b6e14cc4c80d) | Field |

<h3 id="member-b2a5f522af44e956" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d49c649003423ea" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-93604de42cbcc1e5" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a231d40bcc32bfd0" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d2f5c60d24c945e1" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-be8c22de0591bd6d" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4cc6c199a67d5fc" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f1e4a2209a7483a1" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c44030278a20326" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1109698a60ac7f6f" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07a323c147571c81" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c0ca8f94cdbc4bb" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01451a6ca60c5cc3" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1255c6df0364a63" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a66e498861ec8c90" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a3a0a98eeebd5ca9" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7706c591b0ebad69" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db280d774b41a223" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3bdc8741efb09d0b" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9ac7efe2f5219379" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e624a588523cba5b" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c0be18d28353d3fc" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a997268a8e444a5" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acee44f9b95b421c" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-febb779aa85c6689" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d45029af96fad212" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1d8d9f85a9937d3d" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2549f50c62ecdc56" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0cd3255c69351524" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5935c9fbb31e6598" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d24f6fb17335358" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98a72c3192c6c5c9" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab36b6e14cc4c80d" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield-falloffoption/
---

# Astra.Components.WindField.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de vento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-1f2bd45ffa7290c4) | Field |
| [Suave](#member-7abfe594fccab8ff) | Field |
| [Uniforme](#member-05c340f0e455661a) | Field |

<h3 id="member-1f2bd45ffa7290c4" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7abfe594fccab8ff" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-05c340f0e455661a" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield-shapeoption/
---

# Astra.Components.WindField.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de vento**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Caixa](#member-d56b084a89a6b07e) | Field |
| [Esfera](#member-d397631ace80e2f5) | Field |

<h3 id="member-d56b084a89a6b07e" class="astra-member">Caixa</h3>

```csharp
Caixa = 0
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d397631ace80e2f5" class="astra-member">Esfera</h3>

```csharp
Esfera = 1
```

**Caminho:** Inspector → Campo de vento; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d/
---

# Astra.Components.WindField2D

Campo de vento 2D: Acoplamento XY à velocidade do ar com massa real. Família Física 2D · Campos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.WindField2D
```

Campo de vento 2D: Acoplamento XY à velocidade do ar com massa real. Família Física 2D · Campos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.WindField2D>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de vento 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Campo de vento 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-wind/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-96400867a79b9902) | Method |
| [Remove](#member-1dc4beb8d74a6385) | Method |
| [Wrap](#member-90d63d4f244a60c4) | Method |
| [AffectedLayer](#member-30b2dd119f8043b1) | Property |
| [Coefficient](#member-b493b2dde5e5411f) | Property |
| [Component](#member-a099182fc4eec298) | Property |
| [Enabled](#member-d72e2deafeee31d0) | Property |
| [Falloff](#member-477c35463d21c27c) | Property |
| [HalfExtents](#member-ed5e9c9d0c2dcaf0) | Property |
| [InstanceId](#member-aac0e56d68518b0d) | Property |
| [IsAlive](#member-17df2ac5451080a6) | Property |
| [Object](#member-6608cf16b3fa2998) | Property |
| [Offset](#member-5e91a1a2bb7399d4) | Property |
| [Radius](#member-58b80278da898762) | Property |
| [Shape](#member-aa5cec80dbf9d1b8) | Property |
| [TypeId](#member-56d45a1f4c89d096) | Property |
| [Vector](#member-afafdbf28b871dc0) | Property |
| [WakeBodies](#member-e8e6b220ea8d37c6) | Property |

<h3 id="member-96400867a79b9902" class="astra-member">.ctor</h3>

```csharp
public WindField2D(Astra.Component component)
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1dc4beb8d74a6385" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-90d63d4f244a60c4" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.WindField2D Wrap(Astra.Component component)
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-30b2dd119f8043b1" class="astra-member">AffectedLayer</h3>

```csharp
public Astra.Components.WindField2D.AffectedLayerOption AffectedLayer { get; set; }
```

Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão

**Caminho:** Inspector → Campo de vento 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b493b2dde5e5411f" class="astra-member">Coefficient</h3>

```csharp
public float Coefficient { get; set; }
```

Acoplamento (kg/s)

Faixa válida: 0 a 10000.

**Caminho:** Inspector → Campo de vento 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Acoplamento:** Coeficiente da contribuição de vento, combinado com o vetor/campo.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a099182fc4eec298" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d72e2deafeee31d0" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Campo de vento 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-477c35463d21c27c" class="astra-member">Falloff</h3>

```csharp
public Astra.Components.WindField2D.FalloffOption Falloff { get; set; }
```

Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda

**Caminho:** Inspector → Campo de vento 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed5e9c9d0c2dcaf0" class="astra-member">HalfExtents</h3>

```csharp
public System.Numerics.Vector2 HalfExtents { get; set; }
```

Meias XY

**Caminho:** Inspector → Campo de vento 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Meia extensão X:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada. **Meia extensão Y:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aac0e56d68518b0d" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-17df2ac5451080a6" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6608cf16b3fa2998" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e91a1a2bb7399d4" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

Centro local

**Caminho:** Inspector → Campo de vento 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58b80278da898762" class="astra-member">Radius</h3>

```csharp
public float Radius { get; set; }
```

Raio (m)

Faixa válida: 0.001 a 10000.

**Caminho:** Inspector → Campo de vento 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa5cec80dbf9d1b8" class="astra-member">Shape</h3>

```csharp
public Astra.Components.WindField2D.ShapeOption Shape { get; set; }
```

Forma. Escala e orientação são as do objeto e de seus pais

**Caminho:** Inspector → Campo de vento 2D → Volume; ou fachada C# em um Behavior.

**Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-56d45a1f4c89d096" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-afafdbf28b871dc0" class="astra-member">Vector</h3>

```csharp
public System.Numerics.Vector2 Vector { get; set; }
```

Vento local

**Caminho:** Inspector → Campo de vento 2D → Efeito; ou fachada C# em um Behavior.

**Uso:** **Vetor X:** Componente do vetor de contribuição do campo, eixo X. **Vetor Y:** Componente do vetor de contribuição do campo, eixo Y.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e8e6b220ea8d37c6" class="astra-member">WakeBodies</h3>

```csharp
public bool WakeBodies { get; set; }
```

Acordar corpos. Desligado: corpos em repouso permanecem dormindo

**Caminho:** Inspector → Campo de vento 2D → Alcance; ou fachada C# em um Behavior.

**Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField2D.AffectedLayerOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-affectedlayeroption/
---

# Astra.Components.WindField2D.AffectedLayerOption

Enum da API C# da Astra. 33 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField2D.AffectedLayerOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de vento 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Camada0](#member-e33a46be971fbfc7) | Field |
| [Camada1](#member-a43e94233934f144) | Field |
| [Camada10](#member-1c2b73b3562e35ce) | Field |
| [Camada11](#member-baf12538a5ec2ab3) | Field |
| [Camada12](#member-9b57b4d6849bcb55) | Field |
| [Camada13](#member-59d7de4b56e08836) | Field |
| [Camada14](#member-f3b288f7f096f6ad) | Field |
| [Camada15](#member-aea6b289f677827f) | Field |
| [Camada16](#member-fb8dab6f5f93d9e8) | Field |
| [Camada17](#member-a0bd5e70dd5f214a) | Field |
| [Camada18](#member-fff27badfd6dc25b) | Field |
| [Camada19](#member-8359578aff7434e9) | Field |
| [Camada2](#member-513e282403612f4a) | Field |
| [Camada20](#member-66bf1feab7763bc5) | Field |
| [Camada21](#member-f7dfcf4d140c8ac5) | Field |
| [Camada22](#member-e1b3412d1ad7d331) | Field |
| [Camada23](#member-832d4cb3a871ab93) | Field |
| [Camada24](#member-f0ca4cc015a4ab27) | Field |
| [Camada25](#member-213a020bc7577022) | Field |
| [Camada26](#member-a69adccfd81a44a0) | Field |
| [Camada27](#member-42df1d00eebbe805) | Field |
| [Camada28](#member-8760d85b00a74c5b) | Field |
| [Camada29](#member-0d2fadba05cde1c7) | Field |
| [Camada3](#member-a37c7c2f6b9292f7) | Field |
| [Camada30](#member-07f6c7af5236b3cb) | Field |
| [Camada31](#member-0827244001ddb4f2) | Field |
| [Camada4](#member-0c3a645d59b5a0f5) | Field |
| [Camada5](#member-adf047ebee70d91d) | Field |
| [Camada6](#member-8bb7513972382420) | Field |
| [Camada7](#member-575681914c67c2ed) | Field |
| [Camada8](#member-680fff064bdbcd37) | Field |
| [Camada9](#member-cc586b1594ef5712) | Field |
| [Todas](#member-ee0c6794446d2699) | Field |

<h3 id="member-e33a46be971fbfc7" class="astra-member">Camada0</h3>

```csharp
Camada0 = 1
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a43e94233934f144" class="astra-member">Camada1</h3>

```csharp
Camada1 = 2
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1c2b73b3562e35ce" class="astra-member">Camada10</h3>

```csharp
Camada10 = 11
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-baf12538a5ec2ab3" class="astra-member">Camada11</h3>

```csharp
Camada11 = 12
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b57b4d6849bcb55" class="astra-member">Camada12</h3>

```csharp
Camada12 = 13
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-59d7de4b56e08836" class="astra-member">Camada13</h3>

```csharp
Camada13 = 14
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f3b288f7f096f6ad" class="astra-member">Camada14</h3>

```csharp
Camada14 = 15
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aea6b289f677827f" class="astra-member">Camada15</h3>

```csharp
Camada15 = 16
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb8dab6f5f93d9e8" class="astra-member">Camada16</h3>

```csharp
Camada16 = 17
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0bd5e70dd5f214a" class="astra-member">Camada17</h3>

```csharp
Camada17 = 18
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fff27badfd6dc25b" class="astra-member">Camada18</h3>

```csharp
Camada18 = 19
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8359578aff7434e9" class="astra-member">Camada19</h3>

```csharp
Camada19 = 20
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-513e282403612f4a" class="astra-member">Camada2</h3>

```csharp
Camada2 = 3
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66bf1feab7763bc5" class="astra-member">Camada20</h3>

```csharp
Camada20 = 21
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f7dfcf4d140c8ac5" class="astra-member">Camada21</h3>

```csharp
Camada21 = 22
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1b3412d1ad7d331" class="astra-member">Camada22</h3>

```csharp
Camada22 = 23
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-832d4cb3a871ab93" class="astra-member">Camada23</h3>

```csharp
Camada23 = 24
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0ca4cc015a4ab27" class="astra-member">Camada24</h3>

```csharp
Camada24 = 25
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-213a020bc7577022" class="astra-member">Camada25</h3>

```csharp
Camada25 = 26
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a69adccfd81a44a0" class="astra-member">Camada26</h3>

```csharp
Camada26 = 27
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42df1d00eebbe805" class="astra-member">Camada27</h3>

```csharp
Camada27 = 28
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8760d85b00a74c5b" class="astra-member">Camada28</h3>

```csharp
Camada28 = 29
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0d2fadba05cde1c7" class="astra-member">Camada29</h3>

```csharp
Camada29 = 30
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a37c7c2f6b9292f7" class="astra-member">Camada3</h3>

```csharp
Camada3 = 4
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07f6c7af5236b3cb" class="astra-member">Camada30</h3>

```csharp
Camada30 = 31
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0827244001ddb4f2" class="astra-member">Camada31</h3>

```csharp
Camada31 = 32
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0c3a645d59b5a0f5" class="astra-member">Camada4</h3>

```csharp
Camada4 = 5
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-adf047ebee70d91d" class="astra-member">Camada5</h3>

```csharp
Camada5 = 6
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8bb7513972382420" class="astra-member">Camada6</h3>

```csharp
Camada6 = 7
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-575681914c67c2ed" class="astra-member">Camada7</h3>

```csharp
Camada7 = 8
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-680fff064bdbcd37" class="astra-member">Camada8</h3>

```csharp
Camada8 = 9
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc586b1594ef5712" class="astra-member">Camada9</h3>

```csharp
Camada9 = 10
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee0c6794446d2699" class="astra-member">Todas</h3>

```csharp
Todas = 0
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField2D.FalloffOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-falloffoption/
---

# Astra.Components.WindField2D.FalloffOption

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField2D.FalloffOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de vento 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-27f397d2e42741f1) | Field |
| [Suave](#member-2abc5b073ba291bc) | Field |
| [Uniforme](#member-15ab25966095b8e1) | Field |

<h3 id="member-27f397d2e42741f1" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2abc5b073ba291bc" class="astra-member">Suave</h3>

```csharp
Suave = 2
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15ab25966095b8e1" class="astra-member">Uniforme</h3>

```csharp
Uniforme = 0
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Components.WindField2D.ShapeOption"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-shapeoption/
---

# Astra.Components.WindField2D.ShapeOption

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.Components.WindField2D.ShapeOption
```

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de vento 2D**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<WindField2D>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new WindField2D(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Circulo](#member-d1faa0a82ec9c22f) | Field |
| [Retangulo](#member-e44166c35e1075f6) | Field |

<h3 id="member-d1faa0a82ec9c22f" class="astra-member">Circulo</h3>

```csharp
Circulo = 1
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e44166c35e1075f6" class="astra-member">Retangulo</h3>

```csharp
Retangulo = 0
```

**Caminho:** Inspector → Campo de vento 2D; ou fachada C# em um Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Coroutine"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-coroutine/
---

# Astra.Coroutine

Session-owned operation handle. Completed handles retain neither the Behavior nor its enumerators.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Coroutine
```

Session-owned operation handle. Completed handles retain neither the Behavior nor its enumerators.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Failure](#member-f7420452239d64c0) | Property |
| [IsRunning](#member-bdddb453aafee569) | Property |
| [Status](#member-0097ebd74b0255b7) | Property |

<h3 id="member-f7420452239d64c0" class="astra-member">Failure</h3>

```csharp
public string? Failure { get; internal set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bdddb453aafee569" class="astra-member">IsRunning</h3>

```csharp
public bool IsRunning { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0097ebd74b0255b7" class="astra-member">Status</h3>

```csharp
public Astra.CoroutineStatus Status { get; internal set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CoroutineStatus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-coroutinestatus/
---

# Astra.CoroutineStatus

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.CoroutineStatus
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cancelled](#member-9017d53fb45ae142) | Field |
| [Completed](#member-718624d45dc99ecb) | Field |
| [Failed](#member-b6542dc5571563ec) | Field |
| [Running](#member-efc7968f3c77a923) | Field |

<h3 id="member-9017d53fb45ae142" class="astra-member">Cancelled</h3>

```csharp
Cancelled = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-718624d45dc99ecb" class="astra-member">Completed</h3>

```csharp
Completed = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b6542dc5571563ec" class="astra-member">Failed</h3>

```csharp
Failed = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-efc7968f3c77a923" class="astra-member">Running</h3>

```csharp
Running = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CurvePath"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-curvepath/
---

# Astra.CurvePath

A scene-owned Curve3D. Point identity survives reorder and value edits.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.CurvePath
```

A scene-owned Curve3D. Point identity survives reorder and value edits.

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-3acda61e78bca856) | Method |
| [At](#member-9316dbe348b508fd) | Method |
| [ById](#member-1a2cca6e58c07361) | Method |
| [Insert](#member-a65aaadd822090d9) | Method |
| [Move](#member-72aa88180e25b698) | Method |
| [Remove](#member-79c4c959359398a8) | Method |
| [Sample](#member-b70d7e2b704f79ef) | Method |
| [SampleFrame](#member-510dfd5a8f17b956) | Method |
| [Set](#member-8976f0a678d40a03) | Method |
| [Set](#member-bb99c20257ef076c) | Method |
| [Closed](#member-3e3e21a2a3305905) | Property |
| [Count](#member-acc065869deca0f0) | Property |
| [Up](#member-4dee55663812d8b2) | Property |

<h3 id="member-3acda61e78bca856" class="astra-member">.ctor</h3>

```csharp
public CurvePath(Astra.Component component)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-9316dbe348b508fd" class="astra-member">At</h3>

```csharp
public Astra.CurvePoint3D At(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-1a2cca6e58c07361" class="astra-member">ById</h3>

```csharp
public Astra.CurvePoint3D ById(ulong id)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |

<h3 id="member-a65aaadd822090d9" class="astra-member">Insert</h3>

```csharp
public ulong Insert(int index, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming = default(System.Numerics.Vector3), System.Numerics.Vector3 outgoing = default(System.Numerics.Vector3), float rollDegrees = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  · Opcional: `` |
| `outgoing` | `System.Numerics.Vector3` |  · Opcional: `` |
| `rollDegrees` | `float` |  · Opcional: `0` |

<h3 id="member-72aa88180e25b698" class="astra-member">Move</h3>

```csharp
public void Move(ulong id, int destinationIndex)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `destinationIndex` | `int` |  |

<h3 id="member-79c4c959359398a8" class="astra-member">Remove</h3>

```csharp
public void Remove(ulong id)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |

<h3 id="member-b70d7e2b704f79ef" class="astra-member">Sample</h3>

```csharp
public Astra.PathSample Sample(double worldDistance, bool wrap = false)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldDistance` | `double` |  |
| `wrap` | `bool` |  · Opcional: `False` |

<h3 id="member-510dfd5a8f17b956" class="astra-member">SampleFrame</h3>

```csharp
public Astra.PathFrame SampleFrame(double worldDistance, bool wrap = false)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldDistance` | `double` |  |
| `wrap` | `bool` |  · Opcional: `False` |

<h3 id="member-8976f0a678d40a03" class="astra-member">Set</h3>

```csharp
public void Set(ulong id, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming, System.Numerics.Vector3 outgoing)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  |
| `outgoing` | `System.Numerics.Vector3` |  |

<h3 id="member-bb99c20257ef076c" class="astra-member">Set</h3>

```csharp
public void Set(ulong id, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming, System.Numerics.Vector3 outgoing, float rollDegrees)
```

Atomically edits geometry and roll; the overload without roll preserves it.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Atomically edits geometry and roll; the overload without roll preserves it.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  |
| `outgoing` | `System.Numerics.Vector3` |  |
| `rollDegrees` | `float` |  |

<h3 id="member-3e3e21a2a3305905" class="astra-member">Closed</h3>

```csharp
public bool Closed { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acc065869deca0f0" class="astra-member">Count</h3>

```csharp
public int Count { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4dee55663812d8b2" class="astra-member">Up</h3>

```csharp
public System.Numerics.Vector3 Up { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CurvePoint3D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-curvepoint3d/
---

# Astra.CurvePoint3D

Handles are offsets from Position in the path object's local space.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.CurvePoint3D
```

Handles are offsets from Position in the path object's local space.

**Interfaces:** `System.IEquatable<Astra.CurvePoint3D>`.

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-70b2cdeff86f2e34) | Method |
| [Id](#member-16f1034bc40f1e74) | Property |
| [In](#member-2d028a3cdb612356) | Property |
| [Out](#member-4d958a80ab6ee3f4) | Property |
| [Position](#member-b6a82d8294026593) | Property |
| [RollDegrees](#member-989ca58b5fe3ad3d) | Property |

<h3 id="member-70b2cdeff86f2e34" class="astra-member">.ctor</h3>

```csharp
public CurvePoint3D(ulong Id, System.Numerics.Vector3 Position, System.Numerics.Vector3 In, System.Numerics.Vector3 Out)
```

Handles are offsets from Position in the path object's local space.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Id` | `ulong` |  |
| `Position` | `System.Numerics.Vector3` |  |
| `In` | `System.Numerics.Vector3` |  |
| `Out` | `System.Numerics.Vector3` |  |

<h3 id="member-16f1034bc40f1e74" class="astra-member">Id</h3>

```csharp
public ulong Id { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d028a3cdb612356" class="astra-member">In</h3>

```csharp
public System.Numerics.Vector3 In { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d958a80ab6ee3f4" class="astra-member">Out</h3>

```csharp
public System.Numerics.Vector3 Out { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b6a82d8294026593" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-989ca58b5fe3ad3d" class="astra-member">RollDegrees</h3>

```csharp
public float RollDegrees { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.CurveWrapMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-curvewrapmode/
---

# Astra.CurveWrapMode

Repetição antes da primeira e depois da última chave (Unity: WrapMode).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.CurveWrapMode
```

Repetição antes da primeira e depois da última chave (Unity: WrapMode).

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Clamp](#member-1d881f8ddf728b52) | Field |
| [Loop](#member-00c7e1eb16168e57) | Field |
| [PingPong](#member-6441e02c97e2bcfb) | Field |

<h3 id="member-1d881f8ddf728b52" class="astra-member">Clamp</h3>

```csharp
Clamp = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00c7e1eb16168e57" class="astra-member">Loop</h3>

```csharp
Loop = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6441e02c97e2bcfb" class="astra-member">PingPong</h3>

```csharp
PingPong = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.DebugDraw"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-debugdraw/
---

# Astra.DebugDraw

Linhas de depuração do Play (Unity 6000.0 Debug.DrawLine/DrawRay); nunca persistidas.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.DebugDraw
```

Linhas de depuração do Play (Unity 6000.0 Debug.DrawLine/DrawRay); nunca persistidas.

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DrawLine](#member-915db739bebeb1cb) | Method |
| [DrawRay](#member-d5cd74cb1c5a8b97) | Method |
| [ToArgb](#member-d8ab78ba91175fbc) | Method |

<h3 id="member-915db739bebeb1cb" class="astra-member">DrawLine</h3>

```csharp
public void DrawLine(System.Numerics.Vector3 from, System.Numerics.Vector3 to, Astra.Color? color = null, float duration = 0)
```

Duração zero mostra a linha no quadro corrente.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Duração zero mostra a linha no quadro corrente.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `System.Numerics.Vector3` |  |
| `to` | `System.Numerics.Vector3` |  |
| `color` | `Astra.Color?` |  · Opcional: `` |
| `duration` | `float` |  · Opcional: `0` |

<h3 id="member-d5cd74cb1c5a8b97" class="astra-member">DrawRay</h3>

```csharp
public void DrawRay(System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, Astra.Color? color = null, float duration = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `origin` | `System.Numerics.Vector3` |  |
| `direction` | `System.Numerics.Vector3` |  |
| `color` | `Astra.Color?` |  · Opcional: `` |
| `duration` | `float` |  · Opcional: `0` |

<h3 id="member-d8ab78ba91175fbc" class="astra-member">ToArgb</h3>

```csharp
public static uint ToArgb(Astra.Color color)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `color` | `Astra.Color` |  |


---

---
title: "Astra.DeformableMesh"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-deformablemesh/
---

# Astra.DeformableMesh

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.DeformableMesh
```

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-0ae49b86ec2a9ba4) | Method |
| [GetBlendShapeWeight](#member-a8bd0a67151800d8) | Method |
| [SetBlendShapeWeight](#member-a0c56cb7257ae16a) | Method |
| [Component](#member-b3340196f2889030) | Property |

<h3 id="member-0ae49b86ec2a9ba4" class="astra-member">.ctor</h3>

```csharp
public DeformableMesh(Astra.Component component)
```

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a8bd0a67151800d8" class="astra-member">GetBlendShapeWeight</h3>

```csharp
public float GetBlendShapeWeight(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-a0c56cb7257ae16a" class="astra-member">SetBlendShapeWeight</h3>

```csharp
public void SetBlendShapeWeight(int index, float weight)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `weight` | `float` |  |

<h3 id="member-b3340196f2889030" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.DynamicMotorRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-dynamicmotorruntime/
---

# Astra.DynamicMotorRuntime

Instance-bound commands on the real Body motor. Move applies for the current script frame; call in Update or FixedUpdate. FixedUpdate can override Update; ReleaseMove returns control to Canvas input. Commands never write pose.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.DynamicMotorRuntime
```

Instance-bound commands on the real Body motor. Move applies for the current script frame; call in Update or FixedUpdate. FixedUpdate can override Update; ReleaseMove returns control to Canvas input. Commands never write pose.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Move](#member-a6fc9b9147a839c7) | Method |
| [ReadBodyState](#member-1ef5300cf16d6f99) | Method |
| [ReleaseMove](#member-d4307004be8f1a64) | Method |
| [TryJump](#member-8a2e1fa395be8774) | Method |

<h3 id="member-a6fc9b9147a839c7" class="astra-member">Move</h3>

```csharp
public void Move(System.Numerics.Vector2 input, float yawRadians = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `input` | `System.Numerics.Vector2` |  |
| `yawRadians` | `float` |  · Opcional: `0` |

<h3 id="member-1ef5300cf16d6f99" class="astra-member">ReadBodyState</h3>

```csharp
public Astra.PhysicsBodyState ReadBodyState()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d4307004be8f1a64" class="astra-member">ReleaseMove</h3>

```csharp
public void ReleaseMove()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8a2e1fa395be8774" class="astra-member">TryJump</h3>

```csharp
public bool TryJump()
```

Queues one attempt for the next fixed step. Support decides acceptance; true means queued, not that an airborne jump was allowed.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Queues one attempt for the next fixed step. Support decides acceptance; true means queued, not that an airborne jump was allowed.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.FrameStatistics"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-framestatistics/
---

# Astra.FrameStatistics

Último quadro da cena, como a janela Statistics da Unity: intervalo entre quadros apresentados, GPU do quadro (0 quando não medida), desenhos e triângulos enviados depois de culling e LOD, e o efeito do LOD na malha.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.FrameStatistics
```

Último quadro da cena, como a janela Statistics da Unity: intervalo entre quadros apresentados, GPU do quadro (0 quando não medida), desenhos e triângulos enviados depois de culling e LOD, e o efeito do LOD na malha.

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DrawCalls](#member-5ea4c158ea1136db) | Field |
| [FrameIntervalMs](#member-e8931622f252b426) | Field |
| [GpuFrameMs](#member-f330beb486f0c910) | Field |
| [LodBaseTriangles](#member-e3905836eb6e0435) | Field |
| [LodDraws](#member-37d6caad51b7f01a) | Field |
| [LodReducedDraws](#member-324864aaf4bb659f) | Field |
| [LodSelectedTriangles](#member-a93385c369ef16d7) | Field |
| [RenderHeight](#member-463d95d614f46473) | Field |
| [RenderWidth](#member-20b220c8a69df215) | Field |
| [Triangles](#member-7da597acb810fc06) | Field |

<h3 id="member-5ea4c158ea1136db" class="astra-member">DrawCalls</h3>

```csharp
public uint DrawCalls
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e8931622f252b426" class="astra-member">FrameIntervalMs</h3>

```csharp
public float FrameIntervalMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f330beb486f0c910" class="astra-member">GpuFrameMs</h3>

```csharp
public float GpuFrameMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e3905836eb6e0435" class="astra-member">LodBaseTriangles</h3>

```csharp
public ulong LodBaseTriangles
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-37d6caad51b7f01a" class="astra-member">LodDraws</h3>

```csharp
public uint LodDraws
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-324864aaf4bb659f" class="astra-member">LodReducedDraws</h3>

```csharp
public uint LodReducedDraws
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a93385c369ef16d7" class="astra-member">LodSelectedTriangles</h3>

```csharp
public ulong LodSelectedTriangles
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-463d95d614f46473" class="astra-member">RenderHeight</h3>

```csharp
public uint RenderHeight
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-20b220c8a69df215" class="astra-member">RenderWidth</h3>

```csharp
public uint RenderWidth
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7da597acb810fc06" class="astra-member">Triangles</h3>

```csharp
public ulong Triangles
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GameObject"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gameobject/
---

# Astra.GameObject

Class da API C# da Astra. 91 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.GameObject
```

**Interfaces:** `System.IEquatable<Astra.GameObject>`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AddBehavior](#member-fbb24afdf07d0717) | Method |
| [AddComponent](#member-b22667c4a03a6d4f) | Method |
| [AddToGroup](#member-1f2999924f5f32e9) | Method |
| [AsReference](#member-399e79b6936cd3dd) | Method |
| [BroadcastMessage](#member-311716c660346d92) | Method |
| [BroadcastMessage](#member-8f16d6be61b42805) | Method |
| [BroadcastMessage](#member-529f04e9c3b08708) | Method |
| [ChildAt](#member-6b21a57680723f3f) | Method |
| [Children](#member-3b87ca5b3230aa2d) | Method |
| [CompareTag](#member-1bbf46cd05bf731f) | Method |
| [ComponentAt](#member-01983b4d972bddd5) | Method |
| [Components](#member-43308d9db6f35e49) | Method |
| [CreateChild](#member-79a077703b058da4) | Method |
| [CreatePrimitive](#member-0ff4e46a95fc756f) | Method |
| [Destroy](#member-de9fe059a1141a89) | Method |
| [Destroy](#member-dc28fae13c672d24) | Method |
| [DestroyTracked](#member-aee87b67d7016742) | Method |
| [DynamicMotor](#member-3773671fec56645a) | Method |
| [Equals](#member-a1bc4d5960fbfe99) | Method |
| [Equals](#member-10db15e69fc3339b) | Method |
| [Find](#member-622376f964b94846) | Method |
| [FindGameObjectsInGroup](#member-39789b3567c85441) | Method |
| [FindGameObjectsWithTag](#member-6e13e09a2e56cb19) | Method |
| [FindInWorld](#member-5f75a28ac38c5b42) | Method |
| [FindWithTag](#member-f8fa2479d7f991e4) | Method |
| [GetBehavior](#member-6b6d662bf7f506d4) | Method |
| [GetBehaviors](#member-8a41c3f262a09974) | Method |
| [GetComponent](#member-24b50121a4ce1851) | Method |
| [GetHashCode](#member-f8bacfd2c87119bb) | Method |
| [HasComponent](#member-553ecc1d05bb6cdd) | Method |
| [Instantiate](#member-e24bf2b2273ec05b) | Method |
| [InstantiatePrefab](#member-9b7262a81e14f3c7) | Method |
| [InverseTransformDirection](#member-bdf8f6312d8f569e) | Method |
| [InverseTransformPoint](#member-583f0ee680a7e55a) | Method |
| [InverseTransformVector](#member-0b55a3155bc830ad) | Method |
| [IsInGroup](#member-eb3fa0eb15d69d40) | Method |
| [LookAt](#member-0943c42375a33683) | Method |
| [LookAt](#member-d3776b29d0202bfd) | Method |
| [LookCamera](#member-0858ce524989fd9e) | Method |
| [MoveCharacter](#member-4b1887ef3a6454d0) | Method |
| [PhysicsBody](#member-bab0b5af61909fb1) | Method |
| [PhysicsField](#member-183a61ed9b19e7fc) | Method |
| [PhysicsField2D](#member-4822c83a0a519840) | Method |
| [ReadCharacterState](#member-733ced5537fdfd6a) | Method |
| [RemoveFromGroup](#member-ef1dc437b69d71bf) | Method |
| [Resolve](#member-44d036a21aece8e3) | Method |
| [Rotate](#member-b8788a22b57b4271) | Method |
| [RotateAround](#member-0b02d116e75b5090) | Method |
| [SendMessage](#member-d6d85ab5f51fe5fa) | Method |
| [SendMessage](#member-5d1927cbd500353f) | Method |
| [SendMessageUpwards](#member-02e8c2474c3ded2d) | Method |
| [SendMessageUpwards](#member-d4a10fa4b256a885) | Method |
| [SendMessageUpwards](#member-12a2ecc2165c8099) | Method |
| [SendMessage](#member-204da76c3e169de8) | Method |
| [SetActive](#member-b89cef199fea74dc) | Method |
| [SetParent](#member-0f949b277a0c8ba2) | Method |
| [SetParentTracked](#member-eb5c209d9f81791e) | Method |
| [ToString](#member-ee2e267a303cb81a) | Method |
| [TransformDirection](#member-cf8e0c0f0454cc46) | Method |
| [TransformPoint](#member-013018b13b1239e2) | Method |
| [TransformVector](#member-74f59539c85d41d8) | Method |
| [Translate](#member-84e357520e5e22f5) | Method |
| [TryJumpCharacter](#member-ad372d72c8b5f30a) | Method |
| [op_Equality](#member-668e096280210447) | Method |
| [op_Inequality](#member-7f33c72c7301c63f) | Method |
| [ActiveInHierarchy](#member-22702a101086793f) | Property |
| [ActiveSelf](#member-5dbbab9d2cb325b3) | Property |
| [ChildCount](#member-a2790e483d5e2115) | Property |
| [ComponentCount](#member-00e569fd9927940b) | Property |
| [Forward](#member-cdc7bbee211c6a26) | Property |
| [Generation](#member-5f1fbb87bc5a4b20) | Property |
| [Groups](#member-60fa65fed26ef71e) | Property |
| [IsAlive](#member-4f9f716813a5689b) | Property |
| [IsValid](#member-1e28cdf14a18e9fd) | Property |
| [Layer](#member-d17e023eb2b8d177) | Property |
| [LocalRotation](#member-e94f8982aef2b422) | Property |
| [LocalScale](#member-467f782f775f07a5) | Property |
| [LocalToWorldMatrix](#member-5b0c187e9f05355e) | Property |
| [LocalTransform](#member-83f7c85afd59823a) | Property |
| [Name](#member-d30fea1e2773dc4d) | Property |
| [ObjectId](#member-de33a9afc2acd313) | Property |
| [Parent](#member-ce7b109e238cd609) | Property |
| [Position](#member-e9d91db922238a77) | Property |
| [Right](#member-7bd70fb024afecd8) | Property |
| [Tag](#member-9b6710d4d2be2f31) | Property |
| [Up](#member-8522ce3e8aa7ad39) | Property |
| [World](#member-6e2c18c5ad194245) | Property |
| [WorldPosition](#member-9b87a1886f35813f) | Property |
| [WorldRotation](#member-2825af74b34b6758) | Property |
| [WorldToLocalMatrix](#member-520e8b20e5c93aa0) | Property |
| [WorldTransform](#member-80cbab6e47202f74) | Property |

<h3 id="member-fbb24afdf07d0717" class="astra-member">AddBehavior</h3>

```csharp
public T AddBehavior<T>() where T : Astra.Behavior
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b22667c4a03a6d4f" class="astra-member">AddComponent</h3>

```csharp
public Astra.Component AddComponent(string typeId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `typeId` | `string` |  |

<h3 id="member-1f2999924f5f32e9" class="astra-member">AddToGroup</h3>

```csharp
public void AddToGroup(string name)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-399e79b6936cd3dd" class="astra-member">AsReference</h3>

```csharp
public Astra.ObjectReference AsReference()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-311716c660346d92" class="astra-member">BroadcastMessage</h3>

```csharp
public int BroadcastMessage(string method, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-8f16d6be61b42805" class="astra-member">BroadcastMessage</h3>

```csharp
public int BroadcastMessage(string method, object? payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `object?` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-529f04e9c3b08708" class="astra-member">BroadcastMessage</h3>

```csharp
public int BroadcastMessage<T>(string method, T payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `T` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-6b21a57680723f3f" class="astra-member">ChildAt</h3>

```csharp
public Astra.GameObject ChildAt(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-3b87ca5b3230aa2d" class="astra-member">Children</h3>

```csharp
public System.Collections.Generic.IEnumerable<Astra.GameObject> Children()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bbf46cd05bf731f" class="astra-member">CompareTag</h3>

```csharp
public bool CompareTag(string tag)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tag` | `string` |  |

<h3 id="member-01983b4d972bddd5" class="astra-member">ComponentAt</h3>

```csharp
public Astra.Component ComponentAt(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-43308d9db6f35e49" class="astra-member">Components</h3>

```csharp
public System.Collections.Generic.IEnumerable<Astra.Component> Components()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79a077703b058da4" class="astra-member">CreateChild</h3>

```csharp
public Astra.GameObject CreateChild(string name)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-0ff4e46a95fc756f" class="astra-member">CreatePrimitive</h3>

```csharp
public Astra.GameObject CreatePrimitive(Astra.PrimitiveType type)
```

Creates a primitive as a child, with renderer and static collision body.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Creates a primitive as a child, with renderer and static collision body.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `type` | `Astra.PrimitiveType` |  |

<h3 id="member-de9fe059a1141a89" class="astra-member">Destroy</h3>

```csharp
public void Destroy()
```

Marca o objeto e a subárvore como vencidos imediatamente; o armazenamento sai no próximo ponto seguro do mundo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Marca o objeto e a subárvore como vencidos imediatamente; o armazenamento sai no próximo ponto seguro do mundo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dc28fae13c672d24" class="astra-member">Destroy</h3>

```csharp
public void Destroy(double delaySeconds)
```

Segundos simulados do Play; pedidos repetidos conservam o menor prazo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Segundos simulados do Play; pedidos repetidos conservam o menor prazo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `delaySeconds` | `double` |  |

<h3 id="member-aee87b67d7016742" class="astra-member">DestroyTracked</h3>

```csharp
public Astra.WorldOperation DestroyTracked()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3773671fec56645a" class="astra-member">DynamicMotor</h3>

```csharp
public Astra.DynamicMotorRuntime DynamicMotor()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a1bc4d5960fbfe99" class="astra-member">Equals</h3>

```csharp
public bool Equals(Astra.GameObject? other)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `other` | `Astra.GameObject?` |  |

<h3 id="member-10db15e69fc3339b" class="astra-member">Equals</h3>

```csharp
public override bool Equals(object? obj)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `obj` | `object?` |  |

<h3 id="member-622376f964b94846" class="astra-member">Find</h3>

```csharp
public Astra.GameObject? Find(string name, bool recursive = true)
```

Procura por nome na subárvore. Resolver uma vez e guardar o resultado é o uso pretendido — chamar isto todo quadro percorre a cena inteira.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Procura por nome na subárvore. Resolver uma vez e guardar o resultado é o uso pretendido — chamar isto todo quadro percorre a cena inteira.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |
| `recursive` | `bool` |  · Opcional: `True` |

<h3 id="member-39789b3567c85441" class="astra-member">FindGameObjectsInGroup</h3>

```csharp
public Astra.GameObject[] FindGameObjectsInGroup(string name, bool includeInactive = true)
```

Snapshot neste mundo; inclui inativos por padrão, exclui destruições pendentes. Custo linear na cena; ordem da árvore. Alterações no snapshot não alteram grupos.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Snapshot neste mundo; inclui inativos por padrão, exclui destruições pendentes. Custo linear na cena; ordem da árvore. Alterações no snapshot não alteram grupos.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |
| `includeInactive` | `bool` |  · Opcional: `True` |

<h3 id="member-6e13e09a2e56cb19" class="astra-member">FindGameObjectsWithTag</h3>

```csharp
public Astra.GameObject[] FindGameObjectsWithTag(string tag)
```

Snapshot dos objetos ativos deste mundo com a tag; custo linear na cena.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Snapshot dos objetos ativos deste mundo com a tag; custo linear na cena.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tag` | `string` |  |

<h3 id="member-5f75a28ac38c5b42" class="astra-member">FindInWorld</h3>

```csharp
public Astra.GameObject? FindInWorld(string name)
```

Busca por nome exato no mundo: pré-ordem, ativos, sem a raiz sintética. O(N).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Busca por nome exato no mundo: pré-ordem, ativos, sem a raiz sintética. O(N).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-f8fa2479d7f991e4" class="astra-member">FindWithTag</h3>

```csharp
public Astra.GameObject? FindWithTag(string tag)
```

Busca global neste mundo, somente objetos ativos. Não inclui a raiz sintética.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Busca global neste mundo, somente objetos ativos. Não inclui a raiz sintética.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tag` | `string` |  |

<h3 id="member-6b6d662bf7f506d4" class="astra-member">GetBehavior</h3>

```csharp
public T? GetBehavior<T>() where T : class
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8a41c3f262a09974" class="astra-member">GetBehaviors</h3>

```csharp
public T[] GetBehaviors<T>() where T : class
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-24b50121a4ce1851" class="astra-member">GetComponent</h3>

```csharp
public Astra.Component? GetComponent(string typeId, int ordinal = 0)
```

A instância de ordem ordinal desse tipo, ou null.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** A instância de ordem ordinal desse tipo, ou null.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `typeId` | `string` |  |
| `ordinal` | `int` |  · Opcional: `0` |

<h3 id="member-f8bacfd2c87119bb" class="astra-member">GetHashCode</h3>

```csharp
public override int GetHashCode()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-553ecc1d05bb6cdd" class="astra-member">HasComponent</h3>

```csharp
public bool HasComponent(string typeId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `typeId` | `string` |  |

<h3 id="member-e24bf2b2273ec05b" class="astra-member">Instantiate</h3>

```csharp
public Astra.GameObject Instantiate(Astra.GameObject parent)
```

Copia a hierarquia sob parent, preservando pose local. Campos serializados são copiados do estado atual.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Copia a hierarquia sob parent, preservando pose local. Campos serializados são copiados do estado atual.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `parent` | `Astra.GameObject` |  |

<h3 id="member-9b7262a81e14f3c7" class="astra-member">InstantiatePrefab</h3>

```csharp
public Astra.GameObject InstantiatePrefab(Astra.AssetGuid asset)
```

Instantiates a project prefab under this object, binding scripts before lifecycle callbacks.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Instantiates a project prefab under this object, binding scripts before lifecycle callbacks.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `asset` | `Astra.AssetGuid` |  |

<h3 id="member-bdf8f6312d8f569e" class="astra-member">InverseTransformDirection</h3>

```csharp
public System.Numerics.Vector3 InverseTransformDirection(System.Numerics.Vector3 direction)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `direction` | `System.Numerics.Vector3` |  |

<h3 id="member-583f0ee680a7e55a" class="astra-member">InverseTransformPoint</h3>

```csharp
public System.Numerics.Vector3 InverseTransformPoint(System.Numerics.Vector3 point)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector3` |  |

<h3 id="member-0b55a3155bc830ad" class="astra-member">InverseTransformVector</h3>

```csharp
public System.Numerics.Vector3 InverseTransformVector(System.Numerics.Vector3 vector)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `vector` | `System.Numerics.Vector3` |  |

<h3 id="member-eb3fa0eb15d69d40" class="astra-member">IsInGroup</h3>

```csharp
public bool IsInGroup(string name)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-0943c42375a33683" class="astra-member">LookAt</h3>

```csharp
public void LookAt(System.Numerics.Vector3 target)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `target` | `System.Numerics.Vector3` |  |

<h3 id="member-d3776b29d0202bfd" class="astra-member">LookAt</h3>

```csharp
public void LookAt(System.Numerics.Vector3 target, System.Numerics.Vector3 up)
```

Aims the object's local +Z at a world point. Up is a world-space hint. Coincident target and collinear up are rejected rather than silently selecting an orientation. A camera's viewing axis may differ; this method is an object orientation operation.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Aims the object's local +Z at a world point. Up is a world-space hint. Coincident target and collinear up are rejected rather than silently selecting an orientation. A camera's viewing axis may differ; this method is an object orientation operation.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `target` | `System.Numerics.Vector3` |  |
| `up` | `System.Numerics.Vector3` |  |

<h3 id="member-0858ce524989fd9e" class="astra-member">LookCamera</h3>

```csharp
public void LookCamera(System.Numerics.Vector2 normalizedDelta)
```

Aplica um delta de olhar normalizado pela viewport à CameraLook local.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Aplica um delta de olhar normalizado pela viewport à CameraLook local.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `normalizedDelta` | `System.Numerics.Vector2` |  |

<h3 id="member-4b1887ef3a6454d0" class="astra-member">MoveCharacter</h3>

```csharp
public void MoveCharacter(System.Numerics.Vector2 input, float yawRadians)
```

Envia direção normalizada ao Character para os passos físicos deste quadro. O yaw usa radianos; no quadro seguinte prevalece o toque até novo comando.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Envia direção normalizada ao Character para os passos físicos deste quadro. O yaw usa radianos; no quadro seguinte prevalece o toque até novo comando.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `input` | `System.Numerics.Vector2` |  |
| `yawRadians` | `float` |  |

<h3 id="member-bab0b5af61909fb1" class="astra-member">PhysicsBody</h3>

```csharp
public Astra.PhysicsBodyRuntime PhysicsBody()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-183a61ed9b19e7fc" class="astra-member">PhysicsField</h3>

```csharp
public Astra.PhysicsFieldRuntime PhysicsField(string typeId)
```

Access one specific field component on this object. Select its type explicitly when several kinds share the same object.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Access one specific field component on this object. Select its type explicitly when several kinds share the same object.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `typeId` | `string` |  |

<h3 id="member-4822c83a0a519840" class="astra-member">PhysicsField2D</h3>

```csharp
public Astra.PhysicsField2DRuntime PhysicsField2D(string typeId)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `typeId` | `string` |  |

<h3 id="member-733ced5537fdfd6a" class="astra-member">ReadCharacterState</h3>

```csharp
public Astra.CharacterRuntimeState ReadCharacterState()
```

Consulta apoio e movimento resolvido do motor vivo, sem alterar a física.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Consulta apoio e movimento resolvido do motor vivo, sem alterar a física.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef1dc437b69d71bf" class="astra-member">RemoveFromGroup</h3>

```csharp
public void RemoveFromGroup(string name)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-44d036a21aece8e3" class="astra-member">Resolve</h3>

```csharp
public static Astra.GameObject Resolve(Astra.ISceneAccess scene, ulong objectId)
```

Resolve um id cru no mundo atual, capturando mundo e geração. É o que o hospedeiro usa para entregar um objeto a um comportamento, e o que um script usa ao converter uma Astra.ObjectReference autorada.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Resolve um id cru no mundo atual, capturando mundo e geração. É o que o hospedeiro usa para entregar um objeto a um comportamento, e o que um script usa ao converter uma Astra.ObjectReference autorada.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |
| `objectId` | `ulong` |  |

<h3 id="member-b8788a22b57b4271" class="astra-member">Rotate</h3>

```csharp
public void Rotate(System.Numerics.Vector3 axis, float angleRadians, Astra.TransformSpace space = Astra.TransformSpace.Local)
```

Atomic orientation change; angle is in radians, matching System.Numerics.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Atomic orientation change; angle is in radians, matching System.Numerics.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `axis` | `System.Numerics.Vector3` |  |
| `angleRadians` | `float` |  |
| `space` | `Astra.TransformSpace` |  · Opcional: `0` |

<h3 id="member-0b02d116e75b5090" class="astra-member">RotateAround</h3>

```csharp
public void RotateAround(System.Numerics.Vector3 pivot, System.Numerics.Vector3 axis, float angleRadians)
```

Rotates around a world-space pivot and axis with one native pose write.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Rotates around a world-space pivot and axis with one native pose write.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `pivot` | `System.Numerics.Vector3` |  |
| `axis` | `System.Numerics.Vector3` |  |
| `angleRadians` | `float` |  |

<h3 id="member-d6d85ab5f51fe5fa" class="astra-member">SendMessage</h3>

```csharp
public int SendMessage(string method, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-5d1927cbd500353f" class="astra-member">SendMessage</h3>

```csharp
public int SendMessage(string method, object? payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `object?` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-02e8c2474c3ded2d" class="astra-member">SendMessageUpwards</h3>

```csharp
public int SendMessageUpwards(string method, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-d4a10fa4b256a885" class="astra-member">SendMessageUpwards</h3>

```csharp
public int SendMessageUpwards(string method, object? payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `object?` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-12a2ecc2165c8099" class="astra-member">SendMessageUpwards</h3>

```csharp
public int SendMessageUpwards<T>(string method, T payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `T` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-204da76c3e169de8" class="astra-member">SendMessage</h3>

```csharp
public int SendMessage<T>(string method, T payload, Astra.MessageOptions options = Astra.MessageOptions.RequireReceiver)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `method` | `string` |  |
| `payload` | `T` |  |
| `options` | `Astra.MessageOptions` |  · Opcional: `0` |

<h3 id="member-b89cef199fea74dc" class="astra-member">SetActive</h3>

```csharp
public void SetActive(bool active)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `active` | `bool` |  |

<h3 id="member-0f949b277a0c8ba2" class="astra-member">SetParent</h3>

```csharp
public void SetParent(Astra.GameObject parent, int index = 0, Astra.ReparentPosePolicy posePolicy = Astra.ReparentPosePolicy.KeepLocal)
```

Enfileira a troca de pai para o próximo ponto seguro.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Enfileira a troca de pai para o próximo ponto seguro.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `parent` | `Astra.GameObject` |  |
| `index` | `int` |  · Opcional: `0` |
| `posePolicy` | `Astra.ReparentPosePolicy` |  · Opcional: `0` |

<h3 id="member-eb5c209d9f81791e" class="astra-member">SetParentTracked</h3>

```csharp
public Astra.WorldOperation SetParentTracked(Astra.GameObject parent, int index = 0, Astra.ReparentPosePolicy posePolicy = Astra.ReparentPosePolicy.KeepLocal)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `parent` | `Astra.GameObject` |  |
| `index` | `int` |  · Opcional: `0` |
| `posePolicy` | `Astra.ReparentPosePolicy` |  · Opcional: `0` |

<h3 id="member-ee2e267a303cb81a" class="astra-member">ToString</h3>

```csharp
public override string ToString()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf8e0c0f0454cc46" class="astra-member">TransformDirection</h3>

```csharp
public System.Numerics.Vector3 TransformDirection(System.Numerics.Vector3 direction)
```

Direction conversion ignores scale and translation, preserving length.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Direction conversion ignores scale and translation, preserving length.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `direction` | `System.Numerics.Vector3` |  |

<h3 id="member-013018b13b1239e2" class="astra-member">TransformPoint</h3>

```csharp
public System.Numerics.Vector3 TransformPoint(System.Numerics.Vector3 point)
```

Position conversion includes scale and translation (Unity 6000.0 TransformPoint).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Position conversion includes scale and translation (Unity 6000.0 TransformPoint).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector3` |  |

<h3 id="member-74f59539c85d41d8" class="astra-member">TransformVector</h3>

```csharp
public System.Numerics.Vector3 TransformVector(System.Numerics.Vector3 vector)
```

Vector conversion includes scale, but excludes translation.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Vector conversion includes scale, but excludes translation.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `vector` | `System.Numerics.Vector3` |  |

<h3 id="member-84e357520e5e22f5" class="astra-member">Translate</h3>

```csharp
public void Translate(System.Numerics.Vector3 displacement, Astra.TransformSpace space = Astra.TransformSpace.Local)
```

Moves through the existing world-pose write. Physical ownership and native validation still apply.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Moves through the existing world-pose write. Physical ownership and native validation still apply.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `displacement` | `System.Numerics.Vector3` |  |
| `space` | `Astra.TransformSpace` |  · Opcional: `0` |

<h3 id="member-ad372d72c8b5f30a" class="astra-member">TryJumpCharacter</h3>

```csharp
public bool TryJumpCharacter()
```

Tenta saltar. Retorna falso quando o motor recusa o salto no ar.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Tenta saltar. Retorna falso quando o motor recusa o salto no ar.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-668e096280210447" class="astra-member">op_Equality</h3>

```csharp
public static bool operator ==(Astra.GameObject? a, Astra.GameObject? b)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `a` | `Astra.GameObject?` |  |
| `b` | `Astra.GameObject?` |  |

<h3 id="member-7f33c72c7301c63f" class="astra-member">op_Inequality</h3>

```csharp
public static bool operator !=(Astra.GameObject? a, Astra.GameObject? b)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `a` | `Astra.GameObject?` |  |
| `b` | `Astra.GameObject?` |  |

<h3 id="member-22702a101086793f" class="astra-member">ActiveInHierarchy</h3>

```csharp
public bool ActiveInHierarchy { get; }
```

Ativo considerando também os ancestrais.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Ativo considerando também os ancestrais.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5dbbab9d2cb325b3" class="astra-member">ActiveSelf</h3>

```csharp
public bool ActiveSelf { get; }
```

Estado local persistido; pode ser verdadeiro com um ancestral inativo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Estado local persistido; pode ser verdadeiro com um ancestral inativo.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a2790e483d5e2115" class="astra-member">ChildCount</h3>

```csharp
public int ChildCount { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00e569fd9927940b" class="astra-member">ComponentCount</h3>

```csharp
public int ComponentCount { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cdc7bbee211c6a26" class="astra-member">Forward</h3>

```csharp
public System.Numerics.Vector3 Forward { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5f1fbb87bc5a4b20" class="astra-member">Generation</h3>

```csharp
public uint Generation { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-60fa65fed26ef71e" class="astra-member">Groups</h3>

```csharp
public string[] Groups { get; }
```

Snapshot dos nomes de grupos deste objeto, em ordem ordinal.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Snapshot dos nomes de grupos deste objeto, em ordem ordinal.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f9f716813a5689b" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

Falso quando o objeto foi destruído ou pertence a outra execução.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Falso quando o objeto foi destruído ou pertence a outra execução.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1e28cdf14a18e9fd" class="astra-member">IsValid</h3>

```csharp
public bool IsValid { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d17e023eb2b8d177" class="astra-member">Layer</h3>

```csharp
public uint Layer { get; set; }
```

Gameplay layer 0..31. Uses the project layer catalog and actual rendering/physics filters; groups and tags remain independent.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Gameplay layer 0..31. Uses the project layer catalog and actual rendering/physics filters; groups and tags remain independent.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e94f8982aef2b422" class="astra-member">LocalRotation</h3>

```csharp
public System.Numerics.Quaternion LocalRotation { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-467f782f775f07a5" class="astra-member">LocalScale</h3>

```csharp
public System.Numerics.Vector3 LocalScale { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b0c187e9f05355e" class="astra-member">LocalToWorldMatrix</h3>

```csharp
public System.Numerics.Matrix4x4 LocalToWorldMatrix { get; }
```

Full affine matrix, including shear caused by rotated nonuniform parents. System.Numerics uses row vectors: local * parent * ancestor. O(depth) native reads and a cycle-detection set; capture once for batches of points.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Full affine matrix, including shear caused by rotated nonuniform parents. System.Numerics uses row vectors: local * parent * ancestor. O(depth) native reads and a cycle-detection set; capture once for batches of points.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-83f7c85afd59823a" class="astra-member">LocalTransform</h3>

```csharp
public Astra.TransformValue LocalTransform { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d30fea1e2773dc4d" class="astra-member">Name</h3>

```csharp
public string Name { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-de33a9afc2acd313" class="astra-member">ObjectId</h3>

```csharp
public ulong ObjectId { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ce7b109e238cd609" class="astra-member">Parent</h3>

```csharp
public Astra.GameObject? Parent { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e9d91db922238a77" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7bd70fb024afecd8" class="astra-member">Right</h3>

```csharp
public System.Numerics.Vector3 Right { get; }
```

World axes of the object's local +X, +Y and +Z. Cameras may use a different viewing axis.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** World axes of the object's local +X, +Y and +Z. Cameras may use a different viewing axis.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b6710d4d2be2f31" class="astra-member">Tag</h3>

```csharp
public string Tag { get; set; }
```

Tag do catálogo do projeto; nomes desconhecidos são recusados.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Tag do catálogo do projeto; nomes desconhecidos são recusados.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8522ce3e8aa7ad39" class="astra-member">Up</h3>

```csharp
public System.Numerics.Vector3 Up { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6e2c18c5ad194245" class="astra-member">World</h3>

```csharp
public uint World { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b87a1886f35813f" class="astra-member">WorldPosition</h3>

```csharp
public System.Numerics.Vector3 WorldPosition { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2825af74b34b6758" class="astra-member">WorldRotation</h3>

```csharp
public System.Numerics.Quaternion WorldRotation { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-520e8b20e5c93aa0" class="astra-member">WorldToLocalMatrix</h3>

```csharp
public System.Numerics.Matrix4x4 WorldToLocalMatrix { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-80cbab6e47202f74" class="astra-member">WorldTransform</h3>

```csharp
public Astra.TransformValue WorldTransform { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GameTimerRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gametimerruntime/
---

# Astra.GameTimerRuntime

Controls the session scheduler; countdown state is never authored or serialized.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.GameTimerRuntime
```

Controls the session scheduler; countdown state is never authored or serialized.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Pause](#member-625ec3d82a44896e) | Method |
| [Resume](#member-c8fa687b80f1fa35) | Method |
| [Start](#member-80cbd63501044ff7) | Method |
| [State](#member-42f9acaeffa4586d) | Method |
| [Stop](#member-9fb18bc8ff156c71) | Method |

<h3 id="member-625ec3d82a44896e" class="astra-member">Pause</h3>

```csharp
public static void Pause(Astra.Components.GameTimer timer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timer` | `Astra.Components.GameTimer` |  |

<h3 id="member-c8fa687b80f1fa35" class="astra-member">Resume</h3>

```csharp
public static void Resume(Astra.Components.GameTimer timer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timer` | `Astra.Components.GameTimer` |  |

<h3 id="member-80cbd63501044ff7" class="astra-member">Start</h3>

```csharp
public static void Start(Astra.Components.GameTimer timer, float seconds = 0)
```

Starts/restarts; positive seconds also updates the runtime interval. Zero uses the configured interval. Keeps per-timer pause.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Starts/restarts; positive seconds also updates the runtime interval. Zero uses the configured interval. Keeps per-timer pause.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timer` | `Astra.Components.GameTimer` |  |
| `seconds` | `float` |  · Opcional: `0` |

<h3 id="member-42f9acaeffa4586d" class="astra-member">State</h3>

```csharp
public static Astra.TimerRuntimeState State(Astra.Components.GameTimer timer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timer` | `Astra.Components.GameTimer` |  |

<h3 id="member-9fb18bc8ff156c71" class="astra-member">Stop</h3>

```csharp
public static void Stop(Astra.Components.GameTimer timer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `timer` | `Astra.Components.GameTimer` |  |


---

---
title: "Astra.GameViewAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gameviewaccess/
---

# Astra.GameViewAccess

A vista de jogo como no Unity 6000.0 Screen e Camera: pixels com origem no canto inferior esquerdo, câmera = a que produziu o quadro (a autorada de maior prioridade; sem ela, a do editor).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.GameViewAccess
```

A vista de jogo como no Unity 6000.0 Screen e Camera: pixels com origem no canto inferior esquerdo, câmera = a que produziu o quadro (a autorada de maior prioridade; sem ela, a do editor).

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ScreenPointToRay](#member-84cd2f12e87c77fb) | Method |
| [TryGetSafeArea](#member-de4ce83f4fa269ce) | Method |
| [ViewportPointToRay](#member-32f0f9a8c33f1a49) | Method |
| [WorldToScreenPoint](#member-3821a1aea3ddb0c4) | Method |
| [WorldToViewportPoint](#member-a06d3786e7b55b98) | Method |
| [Dpi](#member-31138b9f1b614214) | Property |
| [Height](#member-64f8fbf0f220d607) | Property |
| [State](#member-77f114041a98c04b) | Property |
| [Width](#member-75f22c08bf4539d7) | Property |

<h3 id="member-84cd2f12e87c77fb" class="astra-member">ScreenPointToRay</h3>

```csharp
public Astra.Ray ScreenPointToRay(System.Numerics.Vector2 pixel)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `pixel` | `System.Numerics.Vector2` |  |

<h3 id="member-de4ce83f4fa269ce" class="astra-member">TryGetSafeArea</h3>

```csharp
public bool TryGetSafeArea(out Astra.ScreenRect area)
```

Falso quando a plataforma não informou recortes; então não há área segura a afirmar.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Falso quando a plataforma não informou recortes; então não há área segura a afirmar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `area` | `Astra.ScreenRect` |  · Out |

<h3 id="member-32f0f9a8c33f1a49" class="astra-member">ViewportPointToRay</h3>

```csharp
public Astra.Ray ViewportPointToRay(System.Numerics.Vector2 viewport)
```

Viewport 0..1, origem no canto inferior esquerdo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Viewport 0..1, origem no canto inferior esquerdo.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `viewport` | `System.Numerics.Vector2` |  |

<h3 id="member-3821a1aea3ddb0c4" class="astra-member">WorldToScreenPoint</h3>

```csharp
public System.Numerics.Vector3 WorldToScreenPoint(System.Numerics.Vector3 world)
```

x,y em pixels; z = profundidade de vista em metros (negativa atrás da câmera).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** x,y em pixels; z = profundidade de vista em metros (negativa atrás da câmera).

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `world` | `System.Numerics.Vector3` |  |

<h3 id="member-a06d3786e7b55b98" class="astra-member">WorldToViewportPoint</h3>

```csharp
public System.Numerics.Vector3 WorldToViewportPoint(System.Numerics.Vector3 world)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `world` | `System.Numerics.Vector3` |  |

<h3 id="member-31138b9f1b614214" class="astra-member">Dpi</h3>

```csharp
public float Dpi { get; }
```

DPI informado pelo sistema; zero quando desconhecido.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** DPI informado pelo sistema; zero quando desconhecido.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-64f8fbf0f220d607" class="astra-member">Height</h3>

```csharp
public float Height { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-77f114041a98c04b" class="astra-member">State</h3>

```csharp
public Astra.GameViewState State { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75f22c08bf4539d7" class="astra-member">Width</h3>

```csharp
public float Width { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GameViewPlatform"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gameviewplatform/
---

# Astra.GameViewPlatform

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GameViewPlatform
```

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Android](#member-438e2f66fd17978a) | Field |
| [Host](#member-d30ca1bb51975a52) | Field |

<h3 id="member-438e2f66fd17978a" class="astra-member">Android</h3>

```csharp
Android = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d30ca1bb51975a52" class="astra-member">Host</h3>

```csharp
Host = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GameViewState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gameviewstate/
---

# Astra.GameViewState

Estado da vista de jogo no quadro corrente.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GameViewState
```

Estado da vista de jogo no quadro corrente.

**Interfaces:** `System.IEquatable<Astra.GameViewState>`.

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-7ea73dd57b0fa106) | Method |
| [CameraObjectId](#member-b471f0592831f0ad) | Property |
| [Dpi](#member-b0aa7ef731862c9a) | Property |
| [Height](#member-f92ce382a5a7d8bc) | Property |
| [Platform](#member-c07eb8b4ea97a334) | Property |
| [SafeArea](#member-75c10eadc2e14cbe) | Property |
| [SafeAreaReported](#member-71b2153bd600e922) | Property |
| [Width](#member-2fda0a7a2a805581) | Property |

<h3 id="member-7ea73dd57b0fa106" class="astra-member">.ctor</h3>

```csharp
public GameViewState(float Width, float Height, float Dpi, bool SafeAreaReported, Astra.ScreenRect SafeArea, Astra.GameViewPlatform Platform, ulong CameraObjectId)
```

Estado da vista de jogo no quadro corrente.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Width` | `float` |  |
| `Height` | `float` |  |
| `Dpi` | `float` |  |
| `SafeAreaReported` | `bool` |  |
| `SafeArea` | `Astra.ScreenRect` |  |
| `Platform` | `Astra.GameViewPlatform` |  |
| `CameraObjectId` | `ulong` |  |

<h3 id="member-b471f0592831f0ad" class="astra-member">CameraObjectId</h3>

```csharp
public ulong CameraObjectId { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0aa7ef731862c9a" class="astra-member">Dpi</h3>

```csharp
public float Dpi { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f92ce382a5a7d8bc" class="astra-member">Height</h3>

```csharp
public float Height { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c07eb8b4ea97a334" class="astra-member">Platform</h3>

```csharp
public Astra.GameViewPlatform Platform { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75c10eadc2e14cbe" class="astra-member">SafeArea</h3>

```csharp
public Astra.ScreenRect SafeArea { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71b2153bd600e922" class="astra-member">SafeAreaReported</h3>

```csharp
public bool SafeAreaReported { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2fda0a7a2a805581" class="astra-member">Width</h3>

```csharp
public float Width { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Gradient"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gradient/
---

# Astra.Gradient

Gradiente de cor e alfa (Unity: Gradient), editado no Inspector pelo editor de gradiente. Astra.Gradient.Evaluate(System.Single) segue a mesma regra do editor.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Gradient
```

Gradiente de cor e alfa (Unity: Gradient), editado no Inspector pelo editor de gradiente. Astra.Gradient.Evaluate(System.Single) segue a mesma regra do editor.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Evaluate](#member-2ea64c4d39716b95) | Method |
| [AlphaKeys](#member-ac7961f2060da677) | Property |
| [ColorKeys](#member-97cf34c4ccaf92ce) | Property |
| [Mode](#member-07d9a69451d177ff) | Property |

<h3 id="member-2ea64c4d39716b95" class="astra-member">Evaluate</h3>

```csharp
public Astra.Color Evaluate(float time)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `time` | `float` |  |

<h3 id="member-ac7961f2060da677" class="astra-member">AlphaKeys</h3>

```csharp
public Astra.GradientAlphaKey[] AlphaKeys { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-97cf34c4ccaf92ce" class="astra-member">ColorKeys</h3>

```csharp
public Astra.GradientColorKey[] ColorKeys { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07d9a69451d177ff" class="astra-member">Mode</h3>

```csharp
public Astra.GradientMode Mode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GradientAlphaKey"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gradientalphakey/
---

# Astra.GradientAlphaKey

Parada de alfa de um Astra.Gradient.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.GradientAlphaKey
```

Parada de alfa de um Astra.Gradient.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Alpha](#member-86d012d5de9dd3a6) | Field |
| [Time](#member-df75708d58dea409) | Field |
| [.ctor](#member-c077d13ccbd49a1a) | Method |

<h3 id="member-86d012d5de9dd3a6" class="astra-member">Alpha</h3>

```csharp
public float Alpha
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-df75708d58dea409" class="astra-member">Time</h3>

```csharp
public float Time
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c077d13ccbd49a1a" class="astra-member">.ctor</h3>

```csharp
public GradientAlphaKey(float alpha, float time)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `alpha` | `float` |  |
| `time` | `float` |  |


---

---
title: "Astra.GradientColorKey"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gradientcolorkey/
---

# Astra.GradientColorKey

Parada de cor de um Astra.Gradient (tempo em [0,1]).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.GradientColorKey
```

Parada de cor de um Astra.Gradient (tempo em [0,1]).

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Color](#member-c745e841d8ef914f) | Field |
| [Time](#member-c469a3ebdb77a52c) | Field |
| [.ctor](#member-db5ab654bf02194a) | Method |

<h3 id="member-c745e841d8ef914f" class="astra-member">Color</h3>

```csharp
public Astra.Color Color
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c469a3ebdb77a52c" class="astra-member">Time</h3>

```csharp
public float Time
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db5ab654bf02194a" class="astra-member">.ctor</h3>

```csharp
public GradientColorKey(Astra.Color color, float time)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `color` | `Astra.Color` |  |
| `time` | `float` |  |


---

---
title: "Astra.GradientMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gradientmode/
---

# Astra.GradientMode

Interpolação entre paradas (Unity: GradientMode).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GradientMode
```

Interpolação entre paradas (Unity: GradientMode).

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Blend](#member-a8ebd767a93e5f6b) | Field |
| [Fixed](#member-53014e8073de9e6f) | Field |
| [PerceptualBlend](#member-fb310ef9d9340657) | Field |

<h3 id="member-a8ebd767a93e5f6b" class="astra-member">Blend</h3>

```csharp
Blend = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53014e8073de9e6f" class="astra-member">Fixed</h3>

```csharp
Fixed = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb310ef9d9340657" class="astra-member">PerceptualBlend</h3>

```csharp
PerceptualBlend = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GradientUsageAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gradientusageattribute/
---

# Astra.GradientUsageAttribute

Gradiente com cores HDR no Inspector (Unity: [GradientUsage(hdr)]).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.GradientUsageAttribute
```

Gradiente com cores HDR no Inspector (Unity: [GradientUsage(hdr)]).

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-5dd92f263d7d6798) | Method |
| [Hdr](#member-8d4ad17328704d89) | Property |

<h3 id="member-5dd92f263d7d6798" class="astra-member">.ctor</h3>

```csharp
public GradientUsageAttribute(bool hdr)
```

Gradiente com cores HDR no Inspector (Unity: [GradientUsage(hdr)]).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `hdr` | `bool` |  |

<h3 id="member-8d4ad17328704d89" class="astra-member">Hdr</h3>

```csharp
public bool Hdr { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Graphics"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphics/
---

# Astra.Graphics

Política gráfica da sessão Play. Alterações não persistem no projeto.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Graphics
```

Política gráfica da sessão Play. Alterações não persistem no projeto.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ApplyRuntime](#member-603c4cb8874203bf) | Method |
| [State](#member-7a93c9e0908fdd4d) | Property |

<h3 id="member-603c4cb8874203bf" class="astra-member">ApplyRuntime</h3>

```csharp
public static ulong ApplyRuntime(Astra.GraphicsSettings settings)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `settings` | `Astra.GraphicsSettings` |  |

<h3 id="member-7a93c9e0908fdd4d" class="astra-member">State</h3>

```csharp
public static Astra.GraphicsSnapshot State { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsAmbient"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsambient/
---

# Astra.GraphicsAmbient

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsAmbient
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Constant](#member-21afd31551c0bcf5) | Field |
| [Hemispheric](#member-8eff57bb70f2024b) | Field |
| [HemisphericSpecular](#member-e19c24f06e377226) | Field |
| [Inherit](#member-75f150c8a3ed7f37) | Field |

<h3 id="member-21afd31551c0bcf5" class="astra-member">Constant</h3>

```csharp
Constant = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8eff57bb70f2024b" class="astra-member">Hemispheric</h3>

```csharp
Hemispheric = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e19c24f06e377226" class="astra-member">HemisphericSpecular</h3>

```csharp
HemisphericSpecular = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75f150c8a3ed7f37" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsAntiAliasing"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsantialiasing/
---

# Astra.GraphicsAntiAliasing

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsAntiAliasing
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Fxaa](#member-d7578727afe4c398) | Field |
| [Inherit](#member-90c29ef790074aa9) | Field |
| [Off](#member-1b428506d0ac3a3c) | Field |
| [Temporal](#member-a96b01725dc7e7f1) | Field |

<h3 id="member-d7578727afe4c398" class="astra-member">Fxaa</h3>

```csharp
Fxaa = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-90c29ef790074aa9" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1b428506d0ac3a3c" class="astra-member">Off</h3>

```csharp
Off = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a96b01725dc7e7f1" class="astra-member">Temporal</h3>

```csharp
Temporal = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsCapabilities"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicscapabilities/
---

# Astra.GraphicsCapabilities

Struct da API C# da Astra. 10 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.GraphicsCapabilities
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ArmAsr](#member-84c0005e2b6a8fbb) | Field |
| [CapabilityProfile](#member-7f67c700eabe4964) | Field |
| [DisplayHz](#member-6cacea5faf067f93) | Field |
| [Fsr2](#member-20625fbe08171309) | Field |
| [MaximumImage2DSize](#member-e364bc24a19e69f1) | Field |
| [MaximumImageArrayLayers](#member-61dd4c6512c4deec) | Field |
| [MaximumSamplerAnisotropy](#member-e7458e7ee09142dd) | Field |
| [RecommendationSource](#member-c87ebd7a79fa67c8) | Field |
| [RecommendedProfile](#member-793d9c18f5574b7e) | Field |
| [SupportsDepthSampling](#member-3250d2b91b5ec716) | Field |

<h3 id="member-84c0005e2b6a8fbb" class="astra-member">ArmAsr</h3>

```csharp
public Astra.GraphicsTemporalAvailability ArmAsr
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7f67c700eabe4964" class="astra-member">CapabilityProfile</h3>

```csharp
public uint CapabilityProfile
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6cacea5faf067f93" class="astra-member">DisplayHz</h3>

```csharp
public float DisplayHz
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-20625fbe08171309" class="astra-member">Fsr2</h3>

```csharp
public Astra.GraphicsTemporalAvailability Fsr2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e364bc24a19e69f1" class="astra-member">MaximumImage2DSize</h3>

```csharp
public uint MaximumImage2DSize
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-61dd4c6512c4deec" class="astra-member">MaximumImageArrayLayers</h3>

```csharp
public uint MaximumImageArrayLayers
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e7458e7ee09142dd" class="astra-member">MaximumSamplerAnisotropy</h3>

```csharp
public float MaximumSamplerAnisotropy
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c87ebd7a79fa67c8" class="astra-member">RecommendationSource</h3>

```csharp
public uint RecommendationSource
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-793d9c18f5574b7e" class="astra-member">RecommendedProfile</h3>

```csharp
public uint RecommendedProfile
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3250d2b91b5ec716" class="astra-member">SupportsDepthSampling</h3>

```csharp
public uint SupportsDepthSampling
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsFeature"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsfeature/
---

# Astra.GraphicsFeature

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsFeature
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Disabled](#member-ff4285d5361e747d) | Field |
| [Enabled](#member-87cf8e7e9ac31a06) | Field |
| [Inherit](#member-dceb8f6517b33db8) | Field |

<h3 id="member-ff4285d5361e747d" class="astra-member">Disabled</h3>

```csharp
Disabled = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-87cf8e7e9ac31a06" class="astra-member">Enabled</h3>

```csharp
Enabled = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dceb8f6517b33db8" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsPost"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicspost/
---

# Astra.GraphicsPost

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsPost
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Bloom](#member-cc1acc36a88226d2) | Field |
| [Inherit](#member-cde220e836929f63) | Field |
| [None](#member-d54e618b51a32502) | Field |
| [Tonemap](#member-320f69dcb34d93ce) | Field |

<h3 id="member-cc1acc36a88226d2" class="astra-member">Bloom</h3>

```csharp
Bloom = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cde220e836929f63" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d54e618b51a32502" class="astra-member">None</h3>

```csharp
None = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-320f69dcb34d93ce" class="astra-member">Tonemap</h3>

```csharp
Tonemap = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsQuality"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsquality/
---

# Astra.GraphicsQuality

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsQuality
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Auto](#member-92585428f242dd99) | Field |
| [Custom](#member-5e8583b4a0e76afa) | Field |
| [High](#member-68df74b86adc53e2) | Field |
| [Low](#member-e71dce53f0c8936d) | Field |
| [Medium](#member-4ea5b43886e272e6) | Field |
| [Ultra](#member-ba0207f1894c3e4b) | Field |

<h3 id="member-92585428f242dd99" class="astra-member">Auto</h3>

```csharp
Auto = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e8583b4a0e76afa" class="astra-member">Custom</h3>

```csharp
Custom = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68df74b86adc53e2" class="astra-member">High</h3>

```csharp
High = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e71dce53f0c8936d" class="astra-member">Low</h3>

```csharp
Low = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4ea5b43886e272e6" class="astra-member">Medium</h3>

```csharp
Medium = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba0207f1894c3e4b" class="astra-member">Ultra</h3>

```csharp
Ultra = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsSettings"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicssettings/
---

# Astra.GraphicsSettings

Struct da API C# da Astra. 55 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.GraphicsSettings
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Ambient](#member-5bac9178271cdcc6) | Field |
| [AntiAliasing](#member-d50d42c5c590ba21) | Field |
| [BloomIntensity](#member-0ed595f1007f8451) | Field |
| [BloomThreshold](#member-bc41871b92c4b5be) | Field |
| [CoverageLodPixelErrorBudget](#member-85883fb64b80053d) | Field |
| [DynamicResolution](#member-f77b4c4f9a9241d4) | Field |
| [DynamicResolutionDecreaseStep](#member-fe058649f189aa66) | Field |
| [DynamicResolutionIncreaseStep](#member-c103f56382e3e822) | Field |
| [DynamicResolutionMinimumScale](#member-9349045bb3172b88) | Field |
| [DynamicResolutionOverloadFrames](#member-8c9594d071a969d5) | Field |
| [DynamicResolutionRecoveryFrames](#member-0e5528ec76a5f8c8) | Field |
| [DynamicResolutionRecoveryHeadroomRatio](#member-c154e7749f422f0c) | Field |
| [EmissiveMaximumDistance](#member-092a16ae1579bacc) | Field |
| [EnvironmentSplitSumBrdf](#member-11d64b1e611b6452) | Field |
| [LegacyPostFxaa](#member-4f31a29457790468) | Field |
| [LodHysteresisBandRatio](#member-ac3f400b1378c5e3) | Field |
| [LodPixelErrorBudget](#member-9f7ccc4b7ada65e9) | Field |
| [LodSelection](#member-f06875b5acb9cc62) | Field |
| [MaterialDetailFadeBandRatio](#member-8113d475f114e28f) | Field |
| [MaterialShaderVariants](#member-28af3fbe8e5f1cbb) | Field |
| [MaximumRenderHz](#member-f7abcd171601669f) | Field |
| [MetallicRoughnessMaximumDistance](#member-0618c72c71529ca6) | Field |
| [NormalMapMaximumDistance](#member-7946537fe38f1694) | Field |
| [Post](#member-f354b8a422355649) | Field |
| [PostContrast](#member-afd9ec2ee3ef1743) | Field |
| [PostSaturation](#member-43ae53bb2b408180) | Field |
| [PostSharpen](#member-7055ad9a87780fe1) | Field |
| [PostVignette](#member-82e078803897743e) | Field |
| [Preset](#member-5be7cd16b0da29ab) | Field |
| [ResolutionScale](#member-af93f5408c6c7940) | Field |
| [SchemaVersion](#member-03c739d50ee360d9) | Field |
| [ShadowCacheGuardBandRatio](#member-f3fe164e34fbd179) | Field |
| [ShadowCascadeBlendRatio](#member-2d4e75cec4492c56) | Field |
| [ShadowCascadeCount](#member-35bc3f3810be8b1d) | Field |
| [ShadowCascadeResolution](#member-299fb1dd075e6464) | Field |
| [ShadowDepthBiasConstant](#member-400cc9c113fa6e47) | Field |
| [ShadowDepthBiasSlope](#member-918c860bac5d3d4a) | Field |
| [ShadowDistanceFadeRatio](#member-e1acb4ceb62b7269) | Field |
| [ShadowFarFilterTaps](#member-3e5d52f0e25ef3c3) | Field |
| [ShadowFilterTaps](#member-e36198164e672e65) | Field |
| [ShadowMaximumDistance](#member-624ebf4eef4f3ed5) | Field |
| [ShadowNormalOffsetTexels](#member-5c02e92ce7625c9a) | Field |
| [Shadows](#member-7457c02876e0c03a) | Field |
| [SpecularProbeMaximumDistance](#member-f040b0130adfd623) | Field |
| [StaticShadowCache](#member-dd440abb69bdec0a) | Field |
| [TemporalHistoryWeight](#member-9e3fbde8d17c8104) | Field |
| [TemporalUpscalerQuality](#member-ef5cfb364797a237) | Field |
| [TextureStreaming](#member-a72e594796d4ab8d) | Field |
| [TextureStreamingBudgetMegabytes](#member-16f0b071b46a6f5c) | Field |
| [TextureStreamingMaxLevelReduction](#member-ab0be9307a1718f0) | Field |
| [TextureStreamingUploadKilobytesPerFrame](#member-83608fb905fe34e6) | Field |
| [Textures](#member-2a756dcb10a1adaa) | Field |
| [ThermalDistanceScaling](#member-1682455d2a66fc00) | Field |
| [UpscalingFilter](#member-3f4cead4c624e4cd) | Field |
| [WaterMesh](#member-c226efe02e542709) | Field |

<h3 id="member-5bac9178271cdcc6" class="astra-member">Ambient</h3>

```csharp
public Astra.GraphicsAmbient Ambient
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d50d42c5c590ba21" class="astra-member">AntiAliasing</h3>

```csharp
public Astra.GraphicsAntiAliasing AntiAliasing
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ed595f1007f8451" class="astra-member">BloomIntensity</h3>

```csharp
public float BloomIntensity
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc41871b92c4b5be" class="astra-member">BloomThreshold</h3>

```csharp
public float BloomThreshold
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85883fb64b80053d" class="astra-member">CoverageLodPixelErrorBudget</h3>

```csharp
public float CoverageLodPixelErrorBudget
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f77b4c4f9a9241d4" class="astra-member">DynamicResolution</h3>

```csharp
public Astra.GraphicsFeature DynamicResolution
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fe058649f189aa66" class="astra-member">DynamicResolutionDecreaseStep</h3>

```csharp
public float DynamicResolutionDecreaseStep
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c103f56382e3e822" class="astra-member">DynamicResolutionIncreaseStep</h3>

```csharp
public float DynamicResolutionIncreaseStep
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9349045bb3172b88" class="astra-member">DynamicResolutionMinimumScale</h3>

```csharp
public float DynamicResolutionMinimumScale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c9594d071a969d5" class="astra-member">DynamicResolutionOverloadFrames</h3>

```csharp
public uint DynamicResolutionOverloadFrames
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e5528ec76a5f8c8" class="astra-member">DynamicResolutionRecoveryFrames</h3>

```csharp
public uint DynamicResolutionRecoveryFrames
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c154e7749f422f0c" class="astra-member">DynamicResolutionRecoveryHeadroomRatio</h3>

```csharp
public float DynamicResolutionRecoveryHeadroomRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-092a16ae1579bacc" class="astra-member">EmissiveMaximumDistance</h3>

```csharp
public float EmissiveMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-11d64b1e611b6452" class="astra-member">EnvironmentSplitSumBrdf</h3>

```csharp
public Astra.GraphicsFeature EnvironmentSplitSumBrdf
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f31a29457790468" class="astra-member">LegacyPostFxaa</h3>

```csharp
public Astra.GraphicsFeature LegacyPostFxaa
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac3f400b1378c5e3" class="astra-member">LodHysteresisBandRatio</h3>

```csharp
public float LodHysteresisBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f7ccc4b7ada65e9" class="astra-member">LodPixelErrorBudget</h3>

```csharp
public float LodPixelErrorBudget
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f06875b5acb9cc62" class="astra-member">LodSelection</h3>

```csharp
public Astra.GraphicsFeature LodSelection
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8113d475f114e28f" class="astra-member">MaterialDetailFadeBandRatio</h3>

```csharp
public float MaterialDetailFadeBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-28af3fbe8e5f1cbb" class="astra-member">MaterialShaderVariants</h3>

```csharp
public Astra.GraphicsFeature MaterialShaderVariants
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f7abcd171601669f" class="astra-member">MaximumRenderHz</h3>

```csharp
public uint MaximumRenderHz
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0618c72c71529ca6" class="astra-member">MetallicRoughnessMaximumDistance</h3>

```csharp
public float MetallicRoughnessMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7946537fe38f1694" class="astra-member">NormalMapMaximumDistance</h3>

```csharp
public float NormalMapMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f354b8a422355649" class="astra-member">Post</h3>

```csharp
public Astra.GraphicsPost Post
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-afd9ec2ee3ef1743" class="astra-member">PostContrast</h3>

```csharp
public float PostContrast
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-43ae53bb2b408180" class="astra-member">PostSaturation</h3>

```csharp
public float PostSaturation
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7055ad9a87780fe1" class="astra-member">PostSharpen</h3>

```csharp
public float PostSharpen
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-82e078803897743e" class="astra-member">PostVignette</h3>

```csharp
public Astra.GraphicsFeature PostVignette
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5be7cd16b0da29ab" class="astra-member">Preset</h3>

```csharp
public Astra.GraphicsQuality Preset
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af93f5408c6c7940" class="astra-member">ResolutionScale</h3>

```csharp
public float ResolutionScale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03c739d50ee360d9" class="astra-member">SchemaVersion</h3>

```csharp
public uint SchemaVersion
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f3fe164e34fbd179" class="astra-member">ShadowCacheGuardBandRatio</h3>

```csharp
public float ShadowCacheGuardBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d4e75cec4492c56" class="astra-member">ShadowCascadeBlendRatio</h3>

```csharp
public float ShadowCascadeBlendRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-35bc3f3810be8b1d" class="astra-member">ShadowCascadeCount</h3>

```csharp
public uint ShadowCascadeCount
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-299fb1dd075e6464" class="astra-member">ShadowCascadeResolution</h3>

```csharp
public uint ShadowCascadeResolution
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-400cc9c113fa6e47" class="astra-member">ShadowDepthBiasConstant</h3>

```csharp
public float ShadowDepthBiasConstant
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-918c860bac5d3d4a" class="astra-member">ShadowDepthBiasSlope</h3>

```csharp
public float ShadowDepthBiasSlope
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1acb4ceb62b7269" class="astra-member">ShadowDistanceFadeRatio</h3>

```csharp
public float ShadowDistanceFadeRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e5d52f0e25ef3c3" class="astra-member">ShadowFarFilterTaps</h3>

```csharp
public uint ShadowFarFilterTaps
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e36198164e672e65" class="astra-member">ShadowFilterTaps</h3>

```csharp
public uint ShadowFilterTaps
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-624ebf4eef4f3ed5" class="astra-member">ShadowMaximumDistance</h3>

```csharp
public float ShadowMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c02e92ce7625c9a" class="astra-member">ShadowNormalOffsetTexels</h3>

```csharp
public float ShadowNormalOffsetTexels
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7457c02876e0c03a" class="astra-member">Shadows</h3>

```csharp
public Astra.GraphicsShadows Shadows
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f040b0130adfd623" class="astra-member">SpecularProbeMaximumDistance</h3>

```csharp
public float SpecularProbeMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd440abb69bdec0a" class="astra-member">StaticShadowCache</h3>

```csharp
public Astra.GraphicsFeature StaticShadowCache
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9e3fbde8d17c8104" class="astra-member">TemporalHistoryWeight</h3>

```csharp
public float TemporalHistoryWeight
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef5cfb364797a237" class="astra-member">TemporalUpscalerQuality</h3>

```csharp
public Astra.GraphicsTemporalQuality TemporalUpscalerQuality
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a72e594796d4ab8d" class="astra-member">TextureStreaming</h3>

```csharp
public Astra.GraphicsFeature TextureStreaming
```

Mipmap Streaming (QualitySettings.streamingMipmapsActive da Unity). Zero nos números herda o nível; Inherit fica desligado.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Mipmap Streaming (QualitySettings.streamingMipmapsActive da Unity). Zero nos números herda o nível; Inherit fica desligado.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16f0b071b46a6f5c" class="astra-member">TextureStreamingBudgetMegabytes</h3>

```csharp
public uint TextureStreamingBudgetMegabytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ab0be9307a1718f0" class="astra-member">TextureStreamingMaxLevelReduction</h3>

```csharp
public uint TextureStreamingMaxLevelReduction
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-83608fb905fe34e6" class="astra-member">TextureStreamingUploadKilobytesPerFrame</h3>

```csharp
public uint TextureStreamingUploadKilobytesPerFrame
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a756dcb10a1adaa" class="astra-member">Textures</h3>

```csharp
public Astra.GraphicsTextures Textures
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1682455d2a66fc00" class="astra-member">ThermalDistanceScaling</h3>

```csharp
public Astra.GraphicsFeature ThermalDistanceScaling
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f4cead4c624e4cd" class="astra-member">UpscalingFilter</h3>

```csharp
public Astra.GraphicsUpscaling UpscalingFilter
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c226efe02e542709" class="astra-member">WaterMesh</h3>

```csharp
public Astra.GraphicsWaterMesh WaterMesh
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsShadows"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsshadows/
---

# Astra.GraphicsShadows

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsShadows
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Hard](#member-ac9326fb29b64aa1) | Field |
| [Inherit](#member-4da9df94a5c10268) | Field |
| [Off](#member-ee4e3c9559f4c7f9) | Field |
| [Soft](#member-f48f0da4bfa85b58) | Field |
| [UltraSoft](#member-163ab98aed82f821) | Field |

<h3 id="member-ac9326fb29b64aa1" class="astra-member">Hard</h3>

```csharp
Hard = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4da9df94a5c10268" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee4e3c9559f4c7f9" class="astra-member">Off</h3>

```csharp
Off = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f48f0da4bfa85b58" class="astra-member">Soft</h3>

```csharp
Soft = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-163ab98aed82f821" class="astra-member">UltraSoft</h3>

```csharp
UltraSoft = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsSnapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicssnapshot/
---

# Astra.GraphicsSnapshot

Estado gráfico da sessão. ExecutedUpscaler é o algoritmo que o renderer realmente executou no último quadro; ExecutedStatus explica por que um ampliador temporal pedido não rodou.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GraphicsSnapshot
```

Estado gráfico da sessão. ExecutedUpscaler é o algoritmo que o renderer realmente executou no último quadro; ExecutedStatus explica por que um ampliador temporal pedido não rodou.

**Interfaces:** `System.IEquatable<Astra.GraphicsSnapshot>`.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-74585af38859e563) | Method |
| [Capabilities](#member-a989bdf89189b0eb) | Property |
| [Diagnostics](#member-f0bc9bc85190ea72) | Property |
| [Effective](#member-ee465f74a9eb39ea) | Property |
| [EffectiveAvailable](#member-9fd5840833c1f129) | Property |
| [ExecutedStatus](#member-ed79237b8787d401) | Property |
| [ExecutedUpscaler](#member-6198ec7accaa09c1) | Property |
| [Frame](#member-58cbe6e24074d1c0) | Property |
| [LastRequestSucceeded](#member-ba2c4485cfd424ab) | Property |
| [Pending](#member-fd9027b726fd7e15) | Property |
| [PendingRequestId](#member-370e9594f3361e0f) | Property |
| [Requested](#member-23222ebc9f6c7c8a) | Property |
| [TextureStreaming](#member-5bf305e3f4d901fd) | Property |

<h3 id="member-74585af38859e563" class="astra-member">.ctor</h3>

```csharp
public GraphicsSnapshot(Astra.GraphicsSettings Requested, Astra.ResolvedGraphicsSettings Effective, Astra.GraphicsCapabilities Capabilities, bool Pending, ulong PendingRequestId, bool LastRequestSucceeded, bool EffectiveAvailable, string Diagnostics, Astra.GraphicsUpscaling ExecutedUpscaler = Astra.GraphicsUpscaling.Bilinear, Astra.GraphicsTemporalAvailability ExecutedStatus = Astra.GraphicsTemporalAvailability.Available, Astra.TextureStreamingStats TextureStreaming = default(Astra.TextureStreamingStats), Astra.FrameStatistics Frame = default(Astra.FrameStatistics))
```

Estado gráfico da sessão. ExecutedUpscaler é o algoritmo que o renderer realmente executou no último quadro; ExecutedStatus explica por que um ampliador temporal pedido não rodou.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Requested` | `Astra.GraphicsSettings` |  |
| `Effective` | `Astra.ResolvedGraphicsSettings` |  |
| `Capabilities` | `Astra.GraphicsCapabilities` |  |
| `Pending` | `bool` |  |
| `PendingRequestId` | `ulong` |  |
| `LastRequestSucceeded` | `bool` |  |
| `EffectiveAvailable` | `bool` |  |
| `Diagnostics` | `string` |  |
| `ExecutedUpscaler` | `Astra.GraphicsUpscaling` |  · Opcional: `1` |
| `ExecutedStatus` | `Astra.GraphicsTemporalAvailability` |  · Opcional: `0` |
| `TextureStreaming` | `Astra.TextureStreamingStats` |  · Opcional: `` |
| `Frame` | `Astra.FrameStatistics` |  · Opcional: `` |

<h3 id="member-a989bdf89189b0eb" class="astra-member">Capabilities</h3>

```csharp
public Astra.GraphicsCapabilities Capabilities { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0bc9bc85190ea72" class="astra-member">Diagnostics</h3>

```csharp
public string Diagnostics { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee465f74a9eb39ea" class="astra-member">Effective</h3>

```csharp
public Astra.ResolvedGraphicsSettings Effective { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9fd5840833c1f129" class="astra-member">EffectiveAvailable</h3>

```csharp
public bool EffectiveAvailable { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed79237b8787d401" class="astra-member">ExecutedStatus</h3>

```csharp
public Astra.GraphicsTemporalAvailability ExecutedStatus { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6198ec7accaa09c1" class="astra-member">ExecutedUpscaler</h3>

```csharp
public Astra.GraphicsUpscaling ExecutedUpscaler { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58cbe6e24074d1c0" class="astra-member">Frame</h3>

```csharp
public Astra.FrameStatistics Frame { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba2c4485cfd424ab" class="astra-member">LastRequestSucceeded</h3>

```csharp
public bool LastRequestSucceeded { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd9027b726fd7e15" class="astra-member">Pending</h3>

```csharp
public bool Pending { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-370e9594f3361e0f" class="astra-member">PendingRequestId</h3>

```csharp
public ulong PendingRequestId { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-23222ebc9f6c7c8a" class="astra-member">Requested</h3>

```csharp
public Astra.GraphicsSettings Requested { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5bf305e3f4d901fd" class="astra-member">TextureStreaming</h3>

```csharp
public Astra.TextureStreamingStats TextureStreaming { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsTemporalAvailability"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicstemporalavailability/
---

# Astra.GraphicsTemporalAvailability

Motivo pelo qual um ampliador temporal não roda neste aparelho.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsTemporalAvailability
```

Motivo pelo qual um ampliador temporal não roda neste aparelho.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Available](#member-4bec14b3a3d5790d) | Field |
| [ContextCreationFailed](#member-8dbdafe677c14e28) | Field |
| [MissingFloat16](#member-d56fc7cf20aedb44) | Field |
| [MissingHdrSceneColor](#member-7494728257ce74f8) | Field |
| [MissingInt16](#member-6dcac2857c825d37) | Field |
| [MissingQuadSubgroup](#member-c8eb0aa5bccc3875) | Field |
| [MissingSampledDepth32](#member-31f49cb094bbd44a) | Field |
| [MissingStorageImageFormats](#member-285901a8c2b5f749) | Field |
| [MissingStorageWriteWithoutFormat](#member-8db6719729142a96) | Field |
| [NotBuilt](#member-ac6c46aa84d661a3) | Field |
| [NotProbed](#member-c318e822bcb982b7) | Field |

<h3 id="member-4bec14b3a3d5790d" class="astra-member">Available</h3>

```csharp
Available = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8dbdafe677c14e28" class="astra-member">ContextCreationFailed</h3>

```csharp
ContextCreationFailed = 9
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d56fc7cf20aedb44" class="astra-member">MissingFloat16</h3>

```csharp
MissingFloat16 = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7494728257ce74f8" class="astra-member">MissingHdrSceneColor</h3>

```csharp
MissingHdrSceneColor = 8
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6dcac2857c825d37" class="astra-member">MissingInt16</h3>

```csharp
MissingInt16 = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c8eb0aa5bccc3875" class="astra-member">MissingQuadSubgroup</h3>

```csharp
MissingQuadSubgroup = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-31f49cb094bbd44a" class="astra-member">MissingSampledDepth32</h3>

```csharp
MissingSampledDepth32 = 10
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-285901a8c2b5f749" class="astra-member">MissingStorageImageFormats</h3>

```csharp
MissingStorageImageFormats = 6
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8db6719729142a96" class="astra-member">MissingStorageWriteWithoutFormat</h3>

```csharp
MissingStorageWriteWithoutFormat = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ac6c46aa84d661a3" class="astra-member">NotBuilt</h3>

```csharp
NotBuilt = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c318e822bcb982b7" class="astra-member">NotProbed</h3>

```csharp
NotProbed = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsTemporalQuality"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicstemporalquality/
---

# Astra.GraphicsTemporalQuality

Preset de shader do ampliador temporal (Arm ASR), independente da escala.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsTemporalQuality
```

Preset de shader do ampliador temporal (Arm ASR), independente da escala.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Balanced](#member-94826ef4a6688daa) | Field |
| [Inherit](#member-873ab94825e7a79b) | Field |
| [Performance](#member-977846e8a9dff1da) | Field |
| [Quality](#member-544892e40942d26f) | Field |
| [UltraPerformance](#member-d7d9938c0b2b2354) | Field |

<h3 id="member-94826ef4a6688daa" class="astra-member">Balanced</h3>

```csharp
Balanced = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-873ab94825e7a79b" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-977846e8a9dff1da" class="astra-member">Performance</h3>

```csharp
Performance = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-544892e40942d26f" class="astra-member">Quality</h3>

```csharp
Quality = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d7d9938c0b2b2354" class="astra-member">UltraPerformance</h3>

```csharp
UltraPerformance = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsTextures"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicstextures/
---

# Astra.GraphicsTextures

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsTextures
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Full](#member-4ff625463465199d) | Field |
| [Half](#member-fa9e6462ddf24d77) | Field |
| [Inherit](#member-fde988fa5381490a) | Field |

<h3 id="member-4ff625463465199d" class="astra-member">Full</h3>

```csharp
Full = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fa9e6462ddf24d77" class="astra-member">Half</h3>

```csharp
Half = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fde988fa5381490a" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsUpscaling"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicsupscaling/
---

# Astra.GraphicsUpscaling

Filtro de reconstrução. ArmAsr e Fsr2 são ampliadores temporais: substituem FXAA/TAA enquanto ativos e exigem capacidade do aparelho.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsUpscaling
```

Filtro de reconstrução. ArmAsr e Fsr2 são ampliadores temporais: substituem FXAA/TAA enquanto ativos e exigem capacidade do aparelho.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ArmAsr](#member-026f01836cba09df) | Field |
| [Bilinear](#member-b87782d6330ad523) | Field |
| [CatmullRom](#member-5b99a1167a337c89) | Field |
| [Fsr1](#member-8a61eac84cf4614b) | Field |
| [Fsr2](#member-2ea8f9e1af0572ed) | Field |
| [Inherit](#member-8056fd260fa59cc8) | Field |

<h3 id="member-026f01836cba09df" class="astra-member">ArmAsr</h3>

```csharp
ArmAsr = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b87782d6330ad523" class="astra-member">Bilinear</h3>

```csharp
Bilinear = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b99a1167a337c89" class="astra-member">CatmullRom</h3>

```csharp
CatmullRom = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8a61eac84cf4614b" class="astra-member">Fsr1</h3>

```csharp
Fsr1 = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ea8f9e1af0572ed" class="astra-member">Fsr2</h3>

```csharp
Fsr2 = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8056fd260fa59cc8" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GraphicsWaterMesh"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-graphicswatermesh/
---

# Astra.GraphicsWaterMesh

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GraphicsWaterMesh
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [High](#member-68d4b9cd639e85d3) | Field |
| [Inherit](#member-d61de1c30d21165a) | Field |
| [Low](#member-3639730d7bd79cfc) | Field |
| [Medium](#member-b78e36539cc48d5b) | Field |
| [Ultra](#member-3dce39651be8e7c0) | Field |
| [VeryLow](#member-ccd3112ceb1ddaed) | Field |

<h3 id="member-68d4b9cd639e85d3" class="astra-member">High</h3>

```csharp
High = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d61de1c30d21165a" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3639730d7bd79cfc" class="astra-member">Low</h3>

```csharp
Low = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b78e36539cc48d5b" class="astra-member">Medium</h3>

```csharp
Medium = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3dce39651be8e7c0" class="astra-member">Ultra</h3>

```csharp
Ultra = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ccd3112ceb1ddaed" class="astra-member">VeryLow</h3>

```csharp
VeryLow = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiaccess/
---

# Astra.GuiAccess

UI in this Play session. Preview/Play owns a copy of the authored .aeui.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.GuiAccess
```

UI in this Play session. Preview/Play owns a copy of the authored .aeui.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. Gui é a propriedade protegida herdada de Behavior; use ForCanvas para escolher explicitamente o proprietário. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-8a32e6787d7f9f1d) | Method |
| [Create](#member-78d2fb7b33c01fab) | Method |
| [Find](#member-605984e11ec24da8) | Method |
| [ForCanvas](#member-9d610ce258bc3963) | Method |
| [Poll](#member-2f590c02865ae7ad) | Method |
| [TryFind](#member-0c31ca559ee40286) | Method |
| [Canvas](#member-ee60f115b1991dcd) | Property |
| [Diagnostic](#member-297acd0258c2478d) | Property |
| [Input](#member-a85de5e6fe1b7b80) | Property |
| [InstanceId](#member-856c198f848bef84) | Property |

<h3 id="member-8a32e6787d7f9f1d" class="astra-member">.ctor</h3>

```csharp
public GuiAccess(Astra.ISceneAccess scene)
```

UI in this Play session. Preview/Play owns a copy of the authored .aeui.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-78d2fb7b33c01fab" class="astra-member">Create</h3>

```csharp
public Astra.GuiElement Create(Astra.GuiKind kind, Astra.GuiElement parent = default(Astra.GuiElement), string name = "")
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cria elemento na cópia runtime da instância. GuiKind define o tipo; parent precisa pertencer ao mesmo contexto. Não grava a autoria .aeui.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `kind` | `Astra.GuiKind` |  |
| `parent` | `Astra.GuiElement` |  · Opcional: `` |
| `name` | `string` |  · Opcional: `` |

<h3 id="member-605984e11ec24da8" class="astra-member">Find</h3>

```csharp
public Astra.GuiElement Find(string name)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Busca nome exato e entrega handle desta instância; lança erro se ausente. Resolva em Start e conserve enquanto a instância estiver viva.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-9d610ce258bc3963" class="astra-member">ForCanvas</h3>

```csharp
public Astra.GuiAccess ForCanvas(Astra.GameObject owner, ulong componentInstance = 0)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Escolhe a UI do objeto proprietário e, quando informado, a instância exata do componente. Não passa um GuiElement como proprietário.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `componentInstance` | `ulong` |  · Opcional: `0` |

<h3 id="member-2f590c02865ae7ad" class="astra-member">Poll</h3>

```csharp
public bool Poll(out Astra.GuiEvent message)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Retira um evento da fila. Use while, filtre Kind e identifique Element. Mantenha um consumidor da fila por Canvas.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `message` | `Astra.GuiEvent` |  · Out |

<h3 id="member-0c31ca559ee40286" class="astra-member">TryFind</h3>

```csharp
public bool TryFind(string name, out Astra.GuiElement element)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Busca sem presumir sucesso; teste o bool antes de usar o out element. Útil quando o elemento é opcional.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |
| `element` | `Astra.GuiElement` |  · Out |

<h3 id="member-ee60f115b1991dcd" class="astra-member">Canvas</h3>

```csharp
public Astra.GuiCanvas Canvas { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Apresentação da instância GUI; em cena, o componente UiCanvas é a origem da configuração. Não grava a fonte.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-297acd0258c2478d" class="astra-member">Diagnostic</h3>

```csharp
public string Diagnostic { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Mensagem de diagnóstico da instância, útil para ação/alvo/pose inválidos. Não é um status global de todas as UI.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a85de5e6fe1b7b80" class="astra-member">Input</h3>

```csharp
public Astra.GuiInputAccess Input { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado bruto de gesto do controle (Value, Pressed, Pointer, Device). Não substitui ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-856c198f848bef84" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Identidade da instância runtime; não salve uma lease como referência autoral.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiActionBinding"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiactionbinding/
---

# Astra.GuiActionBinding

Additional listeners execute in order after the primary OnClick action.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiActionBinding
```

Additional listeners execute in order after the primary OnClick action.

**Interfaces:** `System.IEquatable<Astra.GuiActionBinding>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiActionBinding** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-aeb7d27b8945fd1e) | Method |
| [Action](#member-ded1e48b2114bafe) | Property |
| [Event](#member-8e9a4a6fb802a83e) | Property |
| [Target](#member-8ebc25ce7cb0809a) | Property |
| [Value](#member-3bd7aebe3db8fb7f) | Property |

<h3 id="member-aeb7d27b8945fd1e" class="astra-member">.ctor</h3>

```csharp
public GuiActionBinding(Astra.GuiEventKind Event, Astra.GuiClickAction Action, uint Target = 0, float Value = 0)
```

Additional listeners execute in order after the primary OnClick action.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Event` | `Astra.GuiEventKind` |  |
| `Action` | `Astra.GuiClickAction` |  |
| `Target` | `uint` |  · Opcional: `0` |
| `Value` | `float` |  · Opcional: `0` |

<h3 id="member-ded1e48b2114bafe" class="astra-member">Action</h3>

```csharp
public Astra.GuiClickAction Action { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Ação nativa executada na ordem da lista.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8e9a4a6fb802a83e" class="astra-member">Event</h3>

```csharp
public Astra.GuiEventKind Event { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Evento que dispara o listener: Click ou ValueChanged.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8ebc25ce7cb0809a" class="astra-member">Target</h3>

```csharp
public uint Target { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Alvo local no mesmo documento; não é objeto de cena.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3bd7aebe3db8fb7f" class="astra-member">Value</h3>

```csharp
public float Value { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Argumento da ação, como valor de Progress.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiAlignment"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guialignment/
---

# Astra.GuiAlignment

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiAlignment
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiAlignment** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Center](#member-4186bec24651da89) | Field |
| [End](#member-a0867ae95202b373) | Field |
| [Start](#member-668fce0d4ebfb176) | Field |
| [Stretch](#member-75e8d744993dae15) | Field |

<h3 id="member-4186bec24651da89" class="astra-member">Center</h3>

```csharp
Center = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0867ae95202b373" class="astra-member">End</h3>

```csharp
End = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-668fce0d4ebfb176" class="astra-member">Start</h3>

```csharp
Start = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75e8d744993dae15" class="astra-member">Stretch</h3>

```csharp
Stretch = 3
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiAnimation"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guianimation/
---

# Astra.GuiAnimation

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiAnimation
```

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**Interfaces:** `System.IEquatable<Astra.GuiAnimation>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiAnimation** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-9a4de8f8ee9be38c) | Method |
| [AutoPlay](#member-e6444befc2ff01a4) | Property |
| [Default](#member-268d53fda1546cfb) | Property |
| [Delay](#member-f6b3bdaad0307fb6) | Property |
| [Duration](#member-5ceef6eab2d9113b) | Property |
| [Easing](#member-26afdec54bdabf40) | Property |
| [Enabled](#member-94b18ec2f4b36cb9) | Property |
| [From](#member-5142ed46acd0c73a) | Property |
| [Loop](#member-5caac6176a025a2e) | Property |
| [PingPong](#member-2830f4a93d49632b) | Property |
| [To](#member-2b5da846036b2a56) | Property |

<h3 id="member-9a4de8f8ee9be38c" class="astra-member">.ctor</h3>

```csharp
public GuiAnimation(bool Enabled, bool AutoPlay, bool Loop, bool PingPong, Astra.GuiEasing Easing, float Duration, float Delay, Astra.GuiPose From, Astra.GuiPose To)
```

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Enabled` | `bool` |  |
| `AutoPlay` | `bool` |  |
| `Loop` | `bool` |  |
| `PingPong` | `bool` |  |
| `Easing` | `Astra.GuiEasing` |  |
| `Duration` | `float` |  |
| `Delay` | `float` |  |
| `From` | `Astra.GuiPose` |  |
| `To` | `Astra.GuiPose` |  |

<h3 id="member-e6444befc2ff01a4" class="astra-member">AutoPlay</h3>

```csharp
public bool AutoPlay { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Inicia a transição automaticamente.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-268d53fda1546cfb" class="astra-member">Default</h3>

```csharp
public static Astra.GuiAnimation Default { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Configuração desativada, 0,3 s, curva Smooth, poses identidade.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f6b3bdaad0307fb6" class="astra-member">Delay</h3>

```csharp
public float Delay { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Espera inicial, em segundos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5ceef6eab2d9113b" class="astra-member">Duration</h3>

```csharp
public float Duration { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tempo da transição, em segundos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-26afdec54bdabf40" class="astra-member">Easing</h3>

```csharp
public Astra.GuiEasing Easing { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Curva de interpolação.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-94b18ec2f4b36cb9" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Habilita a transição de duas poses.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5142ed46acd0c73a" class="astra-member">From</h3>

```csharp
public Astra.GuiPose From { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Pose inicial.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5caac6176a025a2e" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Repete a transição após completar; atraso é inicial.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2830f4a93d49632b" class="astra-member">PingPong</h3>

```csharp
public bool PingPong { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Executa ida e volta.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b5da846036b2a56" class="astra-member">To</h3>

```csharp
public Astra.GuiPose To { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Pose final.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiCanvas"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guicanvas/
---

# Astra.GuiCanvas

Struct da API C# da Astra. 7 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiCanvas
```

**Interfaces:** `System.IEquatable<Astra.GuiCanvas>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiCanvas** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-fb7c7219439f72c1) | Method |
| [Mode](#member-99408b2cb717c3b3) | Property |
| [Occlusion](#member-4f2329f8b319a8a5) | Property |
| [Position](#member-17ffe328aaf97ef8) | Property |
| [Resolution](#member-e98e6842cad73741) | Property |
| [Rotation](#member-c4e351c57411520b) | Property |
| [UnitsPerPixel](#member-66d1a47a7be8ef1c) | Property |

<h3 id="member-fb7c7219439f72c1" class="astra-member">.ctor</h3>

```csharp
public GuiCanvas(Astra.GuiCanvasMode Mode, System.Numerics.Vector2 Resolution, System.Numerics.Vector3 Position, System.Numerics.Vector3 Rotation, float UnitsPerPixel, bool Occlusion)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Mode` | `Astra.GuiCanvasMode` |  |
| `Resolution` | `System.Numerics.Vector2` |  |
| `Position` | `System.Numerics.Vector3` |  |
| `Rotation` | `System.Numerics.Vector3` |  |
| `UnitsPerPixel` | `float` |  |
| `Occlusion` | `bool` |  |

<h3 id="member-99408b2cb717c3b3" class="astra-member">Mode</h3>

```csharp
public Astra.GuiCanvasMode Mode { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Screen para Tela ou World para plano de mundo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f2329f8b319a8a5" class="astra-member">Occlusion</h3>

```csharp
public bool Occlusion { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Profundidade/hit no plano de mundo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-17ffe328aaf97ef8" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Posição local do plano.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e98e6842cad73741" class="astra-member">Resolution</h3>

```csharp
public System.Numerics.Vector2 Resolution { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Resolução do plano de mundo; Screen usa viewport.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4e351c57411520b" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Vector3 Rotation { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Euler do plano, em graus.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66d1a47a7be8ef1c" class="astra-member">UnitsPerPixel</h3>

```csharp
public float UnitsPerPixel { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Unidades do mundo por pixel.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiCanvasMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guicanvasmode/
---

# Astra.GuiCanvasMode

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiCanvasMode
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiCanvasMode** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Screen](#member-668f5178d2d76363) | Field |
| [World](#member-9bb33d7ebd6822dd) | Field |

<h3 id="member-668f5178d2d76363" class="astra-member">Screen</h3>

```csharp
Screen = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9bb33d7ebd6822dd" class="astra-member">World</h3>

```csharp
World = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiClickAction"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiclickaction/
---

# Astra.GuiClickAction

Enum da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiClickAction
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiClickAction** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Notify](#member-bfaed94ba9c90ce2) | Field |
| [PlayAnimation](#member-c1b93b06cfc1081e) | Field |
| [SetValue](#member-ba6a1c6c7c2e4f20) | Field |
| [StopAnimation](#member-a647dccd7830aaf0) | Field |
| [ToggleEnabled](#member-c9a5949a6ebd5666) | Field |
| [ToggleVisible](#member-759433470f9d6a94) | Field |

<h3 id="member-bfaed94ba9c90ce2" class="astra-member">Notify</h3>

```csharp
Notify = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c1b93b06cfc1081e" class="astra-member">PlayAnimation</h3>

```csharp
PlayAnimation = 4
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba6a1c6c7c2e4f20" class="astra-member">SetValue</h3>

```csharp
SetValue = 3
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a647dccd7830aaf0" class="astra-member">StopAnimation</h3>

```csharp
StopAnimation = 5
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9a5949a6ebd5666" class="astra-member">ToggleEnabled</h3>

```csharp
ToggleEnabled = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-759433470f9d6a94" class="astra-member">ToggleVisible</h3>

```csharp
ToggleVisible = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiControlSettings"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guicontrolsettings/
---

# Astra.GuiControlSettings

Struct da API C# da Astra. 15 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiControlSettings
```

**Interfaces:** `System.IEquatable<Astra.GuiControlSettings>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiControlSettings** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-470b7b58f15dad13) | Method |
| [Axis](#member-4371af1be648c89a) | Property |
| [BaseRadius](#member-8145ac698f001826) | Property |
| [Deadzone](#member-1655ddc5595b1a5d) | Property |
| [Default](#member-81370696472fb35c) | Property |
| [Exponent](#member-95ff5a6c9aa0ad5d) | Property |
| [Gate](#member-85b1175514df3e07) | Property |
| [InputRadius](#member-88718089a36cb0d1) | Property |
| [KnobRadius](#member-a9b2966172dd63e9) | Property |
| [Mode](#member-e2ca6580ce8ae073) | Property |
| [OuterDeadzone](#member-68961cd6a425b287) | Property |
| [ReturnSeconds](#member-f703e04900144ab1) | Property |
| [Sensitivity](#member-0802de94fc02898c) | Property |
| [ShowBase](#member-b1c0f616591b77db) | Property |
| [ShowKnob](#member-50de30e174f69bf2) | Property |

<h3 id="member-470b7b58f15dad13" class="astra-member">.ctor</h3>

```csharp
public GuiControlSettings(Astra.GuiStickMode Mode, Astra.GuiStickAxis Axis, Astra.GuiStickGate Gate, float InputRadius, float BaseRadius, float KnobRadius, float Deadzone, float OuterDeadzone, float Exponent, float Sensitivity, float ReturnSeconds, bool ShowBase, bool ShowKnob)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Mode` | `Astra.GuiStickMode` |  |
| `Axis` | `Astra.GuiStickAxis` |  |
| `Gate` | `Astra.GuiStickGate` |  |
| `InputRadius` | `float` |  |
| `BaseRadius` | `float` |  |
| `KnobRadius` | `float` |  |
| `Deadzone` | `float` |  |
| `OuterDeadzone` | `float` |  |
| `Exponent` | `float` |  |
| `Sensitivity` | `float` |  |
| `ReturnSeconds` | `float` |  |
| `ShowBase` | `bool` |  |
| `ShowKnob` | `bool` |  |

<h3 id="member-4371af1be648c89a" class="astra-member">Axis</h3>

```csharp
public Astra.GuiStickAxis Axis { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Restringe eixo Livre/Horizontal/Vertical.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8145ac698f001826" class="astra-member">BaseRadius</h3>

```csharp
public float BaseRadius { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Raio visual da base em pixels.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1655ddc5595b1a5d" class="astra-member">Deadzone</h3>

```csharp
public float Deadzone { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Zona morta interna normalizada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-81370696472fb35c" class="astra-member">Default</h3>

```csharp
public static Astra.GuiControlSettings Default { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** 80/80/28 px, deadzone 0,12, ganho/expoente 1, retorno 0,12 s.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-95ff5a6c9aa0ad5d" class="astra-member">Exponent</h3>

```csharp
public float Exponent { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Expoente da curva de resposta.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85b1175514df3e07" class="astra-member">Gate</h3>

```csharp
public Astra.GuiStickGate Gate { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Domínio circular ou quadrado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-88718089a36cb0d1" class="astra-member">InputRadius</h3>

```csharp
public float InputRadius { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Raio de referência da entrada em pixels.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9b2966172dd63e9" class="astra-member">KnobRadius</h3>

```csharp
public float KnobRadius { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Raio visual do puxador.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2ca6580ce8ae073" class="astra-member">Mode</h3>

```csharp
public Astra.GuiStickMode Mode { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Fixo/Flutuante/Dinâmico do controle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68961cd6a425b287" class="astra-member">OuterDeadzone</h3>

```csharp
public float OuterDeadzone { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Zona morta externa normalizada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f703e04900144ab1" class="astra-member">ReturnSeconds</h3>

```csharp
public float ReturnSeconds { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tempo do retorno visual.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0802de94fc02898c" class="astra-member">Sensitivity</h3>

```csharp
public float Sensitivity { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Ganho da resposta.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b1c0f616591b77db" class="astra-member">ShowBase</h3>

```csharp
public bool ShowBase { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Mostra desenho da base.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50de30e174f69bf2" class="astra-member">ShowKnob</h3>

```csharp
public bool ShowKnob { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Mostra desenho do puxador.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiControlSnapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guicontrolsnapshot/
---

# Astra.GuiControlSnapshot

Struct da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiControlSnapshot
```

**Interfaces:** `System.IEquatable<Astra.GuiControlSnapshot>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiControlSnapshot** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-44c535c0552f4319) | Method |
| [Device](#member-a312a8c9737d2cb5) | Property |
| [Pointer](#member-96773237ae9da0af) | Property |
| [Pressed](#member-faf61865310e698a) | Property |
| [Value](#member-a4992bb654eab742) | Property |

<h3 id="member-44c535c0552f4319" class="astra-member">.ctor</h3>

```csharp
public GuiControlSnapshot(System.Numerics.Vector2 Value, bool Pressed, uint Pointer, uint Device)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Value` | `System.Numerics.Vector2` |  |
| `Pressed` | `bool` |  |
| `Pointer` | `uint` |  |
| `Device` | `uint` |  |

<h3 id="member-a312a8c9737d2cb5" class="astra-member">Device</h3>

```csharp
public uint Device { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tipo/identidade de device; pointer igual não une mouse e touch.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-96773237ae9da0af" class="astra-member">Pointer</h3>

```csharp
public uint Pointer { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Identificador do ponteiro capturado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-faf61865310e698a" class="astra-member">Pressed</h3>

```csharp
public bool Pressed { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Captura/pressão atual.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a4992bb654eab742" class="astra-member">Value</h3>

```csharp
public System.Numerics.Vector2 Value { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Vetor bruto do gesto, não velocidade física.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiEasing"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guieasing/
---

# Astra.GuiEasing

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiEasing
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiEasing** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [EaseIn](#member-118fec9f241e9f52) | Field |
| [EaseOut](#member-4a716e85f9574f87) | Field |
| [Linear](#member-0e7d4aaf9e7e3037) | Field |
| [Smooth](#member-d6c44166219e4df9) | Field |

<h3 id="member-118fec9f241e9f52" class="astra-member">EaseIn</h3>

```csharp
EaseIn = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a716e85f9574f87" class="astra-member">EaseOut</h3>

```csharp
EaseOut = 3
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e7d4aaf9e7e3037" class="astra-member">Linear</h3>

```csharp
Linear = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d6c44166219e4df9" class="astra-member">Smooth</h3>

```csharp
Smooth = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiElement"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guielement/
---

# Astra.GuiElement

Stable ID and world identity; removed nodes and previous Play handles are rejected.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.GuiElement
```

Stable ID and world identity; removed nodes and previous Play handles are rejected.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. GuiElement vem de Find/TryFind/Create; um valor default não é um elemento válido. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AddAction](#member-71f18290ac1e0de1) | Method |
| [MoveAction](#member-b47844afaca0a82b) | Method |
| [MoveEarlier](#member-11eb70eef10f16e1) | Method |
| [MoveLater](#member-1030c8e134194cd6) | Method |
| [OnClick](#member-2f99a2b0365e58fb) | Method |
| [PlayAnimation](#member-bbe63e25613f0cf6) | Method |
| [Remove](#member-0968773c6d3d2bc0) | Method |
| [RemoveAction](#member-79c6a285cedcd35a) | Method |
| [ReplaceAction](#member-74ff402bd5c6f4d5) | Method |
| [SetText](#member-6c6c30bfe2d2ad5e) | Method |
| [StopAnimation](#member-82dcd2be5f111698) | Method |
| [Actions](#member-c5d4a49b75cd9bf3) | Property |
| [Animation](#member-74074d2e783a7720) | Property |
| [BaseImage](#member-23397b535bee7367) | Property |
| [ControlSettings](#member-00b560a3f92ea766) | Property |
| [Enabled](#member-c47f0377a5693811) | Property |
| [Id](#member-38ac2f7a96814b60) | Property |
| [Image](#member-ed6d8a5c0f1e5f24) | Property |
| [ImageStyle](#member-f2f4baf04712c18e) | Property |
| [Input](#member-e8d7476fafe037ab) | Property |
| [InputAction](#member-aa396e785db9b17d) | Property |
| [InstanceId](#member-8c665d50d28038d3) | Property |
| [Interaction](#member-98cf867a260f179b) | Property |
| [Kind](#member-212e81bd850173dc) | Property |
| [KnobImage](#member-48be10cb12bd36f4) | Property |
| [Layout](#member-79406adf2533f4a4) | Property |
| [Name](#member-ee0a8b2f95201080) | Property |
| [Sizing](#member-78bd0d9b53efeddf) | Property |
| [Snapshot](#member-8d1da7affbefdd4a) | Property |
| [Style](#member-12fdbbbd36a3871f) | Property |
| [Text](#member-9cc0547eae8d9b0c) | Property |
| [Transitions](#member-8fb27c340d69850e) | Property |
| [Value](#member-ce081bb8f0a59f2f) | Property |
| [Visible](#member-4618cde3c9ad7691) | Property |

<h3 id="member-71f18290ac1e0de1" class="astra-member">AddAction</h3>

```csharp
public void AddAction(Astra.GuiEventKind @event, Astra.GuiClickAction action, Astra.GuiElement target = default(Astra.GuiElement), float value = 0)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Acrescenta listener ordenado após ação principal, no mesmo documento. Até 16 ações por elemento no formato atual.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `event` | `Astra.GuiEventKind` |  |
| `action` | `Astra.GuiClickAction` |  |
| `target` | `Astra.GuiElement` |  · Opcional: `` |
| `value` | `float` |  · Opcional: `0` |

<h3 id="member-b47844afaca0a82b" class="astra-member">MoveAction</h3>

```csharp
public void MoveAction(int index, int destination)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Reordena listeners; ordem altera a sequência dos efeitos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `destination` | `int` |  |

<h3 id="member-11eb70eef10f16e1" class="astra-member">MoveEarlier</h3>

```csharp
public void MoveEarlier()
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Reordena o elemento na árvore runtime para posição anterior; observe desenho/hit/layout.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1030c8e134194cd6" class="astra-member">MoveLater</h3>

```csharp
public void MoveLater()
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Reordena o elemento na árvore runtime para posição posterior; observe desenho/hit/layout.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f99a2b0365e58fb" class="astra-member">OnClick</h3>

```csharp
public void OnClick(Astra.GuiClickAction action, Astra.GuiElement target = default(Astra.GuiElement), float value = 0)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Configura ação principal de clique e alvo da mesma instância; Notify permite consumir Poll. Para Image, o clique é opcional.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `Astra.GuiClickAction` |  |
| `target` | `Astra.GuiElement` |  · Opcional: `` |
| `value` | `float` |  · Opcional: `0` |

<h3 id="member-bbe63e25613f0cf6" class="astra-member">PlayAnimation</h3>

```csharp
public void PlayAnimation()
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Reinicia a transição configurada; precisa de animação habilitada válida.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0968773c6d3d2bc0" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Remove nó e subárvore da cópia runtime, invalida handles/ações afetados. Não remove o componente Canvas da cena.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79c6a285cedcd35a" class="astra-member">RemoveAction</h3>

```csharp
public void RemoveAction(int index)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Remove listener no índice indicado, preservando os demais.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-74ff402bd5c6f4d5" class="astra-member">ReplaceAction</h3>

```csharp
public void ReplaceAction(int index, Astra.GuiActionBinding binding)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Troca listener no índice indicado; preserve evento, alvo e argumento válidos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `binding` | `Astra.GuiActionBinding` |  |

<h3 id="member-6c6c30bfe2d2ad5e" class="astra-member">SetText</h3>

```csharp
public void SetText(string text)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Altera string do elemento runtime; Image não desenha texto.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `text` | `string` |  |

<h3 id="member-82dcd2be5f111698" class="astra-member">StopAnimation</h3>

```csharp
public void StopAnimation()
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Para e restaura pose autoral. Não é pause/resume da transição.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c5d4a49b75cd9bf3" class="astra-member">Actions</h3>

```csharp
public Astra.GuiActionBinding[] Actions { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Snapshot dos listeners adicionais; alterar o array retornado não substitui a lista no documento.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74074d2e783a7720" class="astra-member">Animation</h3>

```csharp
public Astra.GuiAnimation Animation { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Configuração de uma transição de duas poses; enabled/autoplay/loop e delay são campos distintos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-23397b535bee7367" class="astra-member">BaseImage</h3>

```csharp
public string BaseImage { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Imagem de base do Joystick no projeto.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00b560a3f92ea766" class="astra-member">ControlSettings</h3>

```csharp
public Astra.GuiControlSettings ControlSettings { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Modo/eixo/gate, raios, zonas mortas, resposta e visual do controle touch.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c47f0377a5693811" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Participação em input/estado desabilitado; pode continuar desenhado. Ancestrais também influenciam.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38ac2f7a96814b60" class="astra-member">Id</h3>

```csharp
public uint Id { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Identificador local do nó, não identidade global entre documentos/Canvas.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed6d8a5c0f1e5f24" class="astra-member">Image</h3>

```csharp
public string Image { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Caminho relativo de imagem dentro do projeto. Troca o recurso do elemento Image; não aceita URL/caminho externo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f2f4baf04712c18e" class="astra-member">ImageStyle</h3>

```csharp
public Astra.GuiImageStyle ImageStyle { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Fit e Tint da Image. Use with para conservar o outro campo. Conter preserva proporção e cabe inteira.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e8d7476fafe037ab" class="astra-member">Input</h3>

```csharp
public Astra.GuiControlSnapshot Input { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado bruto de gesto do controle (Value, Pressed, Pointer, Device). Não substitui ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa396e785db9b17d" class="astra-member">InputAction</h3>

```csharp
public string InputAction { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Nome da ação compatível do catálogo do projeto. Não é GuiClickAction.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c665d50d28038d3" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Identidade da instância runtime; não salve uma lease como referência autoral.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-98cf867a260f179b" class="astra-member">Interaction</h3>

```csharp
public Astra.GuiInteraction Interaction { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Clicável, ação, alvo e argumento do clique; alvo 0 significa o próprio elemento.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-212e81bd850173dc" class="astra-member">Kind</h3>

```csharp
public Astra.GuiKind Kind { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tipo do elemento encontrado. Confira GuiKind.Image antes de tratar o nó como coração.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-48be10cb12bd36f4" class="astra-member">KnobImage</h3>

```csharp
public string KnobImage { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Imagem de puxador do Joystick no projeto.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-79406adf2533f4a4" class="astra-member">Layout</h3>

```csharp
public Astra.GuiLayout Layout { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Âncoras normalizadas e bordas em pixels do pai. Offsets são esquerda/topo/direita/base, não largura/altura.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee0a8b2f95201080" class="astra-member">Name</h3>

```csharp
public string Name { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Nome exato usado por Find. ID e lease conservam identidade; renomear não converte outro handle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-78bd0d9b53efeddf" class="astra-member">Sizing</h3>

```csharp
public Astra.GuiSizing Sizing { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanhos mínimo/preferido, pesos e espaçamento do layout automático. Pai HBox/VBox/Grid pode controlar o retângulo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d1da7affbefdd4a" class="astra-member">Snapshot</h3>

```csharp
public Astra.GuiSnapshot Snapshot { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado atual de tipo, visible/enabled e intervalo/valor, no contexto desta instância.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-12fdbbbd36a3871f" class="astra-member">Style</h3>

```csharp
public Astra.GuiStyle Style { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Fundo, conteúdo, destaque, clipping, fonte e raio. Cores usam 0xAARRGGBB; preserve campos com with.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9cc0547eae8d9b0c" class="astra-member">Text</h3>

```csharp
public string Text { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Lê/escreve conteúdo textual. Atualize o Text de status quando a vida mudar.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8fb27c340d69850e" class="astra-member">Transitions</h3>

```csharp
public Astra.GuiTransitions Transitions { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Configura estados Normal, Pressionado e Desabilitado; combina pose/tinta com a animação.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ce081bb8f0a59f2f" class="astra-member">Value</h3>

```csharp
public float Value { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Escrita numérica para Toggle, Slider e Progress. Não altera vida nem preenchimento de Image.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4618cde3c9ad7691" class="astra-member">Visible</h3>

```csharp
public bool Visible { get; set; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Liga/desliga a apresentação da subárvore. No HUD, esconde camada cheia e mantém a imagem vazia atrás.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiEvent"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guievent/
---

# Astra.GuiEvent

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiEvent
```

**Interfaces:** `System.IEquatable<Astra.GuiEvent>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiEvent** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-6182bc76b1e8151f) | Method |
| [Element](#member-2965857f2dc4d8f9) | Property |
| [Kind](#member-fb88080234cbf077) | Property |
| [Value](#member-0dc949a2da0478e2) | Property |

<h3 id="member-6182bc76b1e8151f" class="astra-member">.ctor</h3>

```csharp
public GuiEvent(Astra.GuiElement Element, Astra.GuiEventKind Kind, float Value)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Element` | `Astra.GuiElement` |  |
| `Kind` | `Astra.GuiEventKind` |  |
| `Value` | `float` |  |

<h3 id="member-2965857f2dc4d8f9" class="astra-member">Element</h3>

```csharp
public Astra.GuiElement Element { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Handle da origem na instância que emitiu.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb88080234cbf077" class="astra-member">Kind</h3>

```csharp
public Astra.GuiEventKind Kind { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Click ou ValueChanged.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0dc949a2da0478e2" class="astra-member">Value</h3>

```csharp
public float Value { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Valor entregue com o evento.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiEventKind"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guieventkind/
---

# Astra.GuiEventKind

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiEventKind
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiEventKind** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Click](#member-51182cc4f48fe8ab) | Field |
| [ValueChanged](#member-ae99f3fb01263e11) | Field |

<h3 id="member-51182cc4f48fe8ab" class="astra-member">Click</h3>

```csharp
Click = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae99f3fb01263e11" class="astra-member">ValueChanged</h3>

```csharp
ValueChanged = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiImageFit"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiimagefit/
---

# Astra.GuiImageFit

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiImageFit
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiImageFit** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Contain](#member-65cf89abb9757344) | Field |
| [Cover](#member-cd75343a3ca68880) | Field |
| [Stretch](#member-5da8f5af6788408d) | Field |

<h3 id="member-65cf89abb9757344" class="astra-member">Contain</h3>

```csharp
Contain = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cd75343a3ca68880" class="astra-member">Cover</h3>

```csharp
Cover = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5da8f5af6788408d" class="astra-member">Stretch</h3>

```csharp
Stretch = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiImageStyle"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiimagestyle/
---

# Astra.GuiImageStyle

Struct da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiImageStyle
```

**Interfaces:** `System.IEquatable<Astra.GuiImageStyle>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiImageStyle** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-92b1f1a6b7b306e0) | Method |
| [Fit](#member-5bb7e0f3c27c3cac) | Property |
| [Tint](#member-eb531314f74dedc0) | Property |

<h3 id="member-92b1f1a6b7b306e0" class="astra-member">.ctor</h3>

```csharp
public GuiImageStyle(Astra.GuiImageFit Fit, uint Tint)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Fit` | `Astra.GuiImageFit` |  |
| `Tint` | `uint` |  |

<h3 id="member-5bb7e0f3c27c3cac" class="astra-member">Fit</h3>

```csharp
public Astra.GuiImageFit Fit { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Modo de ajuste Stretch/Contain/Cover.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb531314f74dedc0" class="astra-member">Tint</h3>

```csharp
public uint Tint { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cor multiplicativa; branco 0xFFFFFFFF conserva imagem e alpha.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiInputAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiinputaccess/
---

# Astra.GuiInputAccess

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.GuiInputAccess
```

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiInputAccess** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-bcfd3acbf68cfd67) | Method |
| [ActionState](#member-c8dcb38241991fa8) | Method |
| [Axis](#member-4649d52052b89e61) | Method |
| [Axis2](#member-459a6af30ec05299) | Method |
| [JustPressed](#member-1b1dcd43885bf4a1) | Method |
| [JustReleased](#member-4f23e5c95c76cdd6) | Method |
| [Pressed](#member-fbe513758f270c9e) | Method |

<h3 id="member-bcfd3acbf68cfd67" class="astra-member">.ctor</h3>

```csharp
public GuiInputAccess(Astra.ISceneAccess scene)
```

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-c8dcb38241991fa8" class="astra-member">ActionState</h3>

```csharp
public Astra.InputActionState ActionState(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado tipado da ação amostrada, incluindo fase/valor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-4649d52052b89e61" class="astra-member">Axis</h3>

```csharp
public float Axis(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Lê a componente X da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-459a6af30ec05299" class="astra-member">Axis2</h3>

```csharp
public System.Numerics.Vector2 Axis2(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Lê o vetor 2D da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-1b1dcd43885bf4a1" class="astra-member">JustPressed</h3>

```csharp
public bool JustPressed(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Borda de pressionar na amostra de entrada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-4f23e5c95c76cdd6" class="astra-member">JustReleased</h3>

```csharp
public bool JustReleased(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Borda de soltar na amostra de entrada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-fbe513758f270c9e" class="astra-member">Pressed</h3>

```csharp
public bool Pressed(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado mantido da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |


---

---
title: "Astra.GuiInteraction"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiinteraction/
---

# Astra.GuiInteraction

Target is a stable ID in the same UI document; zero means this element.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiInteraction
```

Target is a stable ID in the same UI document; zero means this element.

**Interfaces:** `System.IEquatable<Astra.GuiInteraction>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiInteraction** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-414d57f37da32193) | Method |
| [Action](#member-ed537fcbabd22a06) | Property |
| [Clickable](#member-69b1c70f832d8946) | Property |
| [Target](#member-3d722bfc46537400) | Property |
| [Value](#member-30ffc8dc08b55063) | Property |

<h3 id="member-414d57f37da32193" class="astra-member">.ctor</h3>

```csharp
public GuiInteraction(bool Clickable, Astra.GuiClickAction Action = Astra.GuiClickAction.Notify, uint Target = 0, float Value = 0)
```

Target is a stable ID in the same UI document; zero means this element.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Clickable` | `bool` |  |
| `Action` | `Astra.GuiClickAction` |  · Opcional: `0` |
| `Target` | `uint` |  · Opcional: `0` |
| `Value` | `float` |  · Opcional: `0` |

<h3 id="member-ed537fcbabd22a06" class="astra-member">Action</h3>

```csharp
public Astra.GuiClickAction Action { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Ação primária ao clicar.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-69b1c70f832d8946" class="astra-member">Clickable</h3>

```csharp
public bool Clickable { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Habilita clique opcional de Image/Text/Panel/container.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d722bfc46537400" class="astra-member">Target</h3>

```csharp
public uint Target { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** ID local no mesmo documento; zero = próprio elemento.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-30ffc8dc08b55063" class="astra-member">Value</h3>

```csharp
public float Value { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Argumento numérico da ação.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiKind"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guikind/
---

# Astra.GuiKind

Enum da API C# da Astra. 13 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiKind
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiKind** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ActionButton](#member-9238fcb642a37f2a) | Field |
| [Button](#member-cdcb8ee494bdbc76) | Field |
| [Grid](#member-673ce58c8d0290a8) | Field |
| [HBox](#member-bb1236f64d7d120b) | Field |
| [Image](#member-cb4c8532bbd52ff2) | Field |
| [Joystick](#member-8925f205d0620e9f) | Field |
| [LookArea](#member-fa15ee45208e0f5a) | Field |
| [Panel](#member-2ee384831cd4b7af) | Field |
| [Progress](#member-3d3cb3b7bdc9152a) | Field |
| [Slider](#member-f2ece5b248c13494) | Field |
| [Text](#member-c86e0207ff5257cd) | Field |
| [Toggle](#member-2fe1caf7dd724315) | Field |
| [VBox](#member-9c8daecff035da9f) | Field |

<h3 id="member-9238fcb642a37f2a" class="astra-member">ActionButton</h3>

```csharp
ActionButton = 11
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cdcb8ee494bdbc76" class="astra-member">Button</h3>

```csharp
Button = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-673ce58c8d0290a8" class="astra-member">Grid</h3>

```csharp
Grid = 9
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bb1236f64d7d120b" class="astra-member">HBox</h3>

```csharp
HBox = 7
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb4c8532bbd52ff2" class="astra-member">Image</h3>

```csharp
Image = 6
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8925f205d0620e9f" class="astra-member">Joystick</h3>

```csharp
Joystick = 10
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fa15ee45208e0f5a" class="astra-member">LookArea</h3>

```csharp
LookArea = 12
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ee384831cd4b7af" class="astra-member">Panel</h3>

```csharp
Panel = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d3cb3b7bdc9152a" class="astra-member">Progress</h3>

```csharp
Progress = 5
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f2ece5b248c13494" class="astra-member">Slider</h3>

```csharp
Slider = 4
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c86e0207ff5257cd" class="astra-member">Text</h3>

```csharp
Text = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2fe1caf7dd724315" class="astra-member">Toggle</h3>

```csharp
Toggle = 3
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c8daecff035da9f" class="astra-member">VBox</h3>

```csharp
VBox = 8
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiLayout"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guilayout/
---

# Astra.GuiLayout

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiLayout
```

**Interfaces:** `System.IEquatable<Astra.GuiLayout>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiLayout** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-a9ca4159b2d7621e) | Method |
| [AnchorMax](#member-9a1daf333b464a40) | Property |
| [AnchorMin](#member-4a6509485705237e) | Property |
| [Offsets](#member-abbe78cf91fd6e5d) | Property |

<h3 id="member-a9ca4159b2d7621e" class="astra-member">.ctor</h3>

```csharp
public GuiLayout(System.Numerics.Vector2 AnchorMin, System.Numerics.Vector2 AnchorMax, System.Numerics.Vector4 Offsets)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `AnchorMin` | `System.Numerics.Vector2` |  |
| `AnchorMax` | `System.Numerics.Vector2` |  |
| `Offsets` | `System.Numerics.Vector4` |  |

<h3 id="member-9a1daf333b464a40" class="astra-member">AnchorMax</h3>

```csharp
public System.Numerics.Vector2 AnchorMax { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Âncora final XY normalizada em relação ao pai.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4a6509485705237e" class="astra-member">AnchorMin</h3>

```csharp
public System.Numerics.Vector2 AnchorMin { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Âncora inicial XY normalizada em relação ao pai.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-abbe78cf91fd6e5d" class="astra-member">Offsets</h3>

```csharp
public System.Numerics.Vector4 Offsets { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Bordas esquerda/topo/direita/base em pixels relativos às âncoras.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiPose"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guipose/
---

# Astra.GuiPose

Struct da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiPose
```

**Interfaces:** `System.IEquatable<Astra.GuiPose>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiPose** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-75c0e559531dadf6) | Method |
| [Identity](#member-17e9d508d7e4782a) | Property |
| [Opacity](#member-a33a87f7dd803773) | Property |
| [Position](#member-14382c8bd6337f36) | Property |
| [Scale](#member-351a18b88d78116d) | Property |

<h3 id="member-75c0e559531dadf6" class="astra-member">.ctor</h3>

```csharp
public GuiPose(System.Numerics.Vector2 Position, float Scale, float Opacity)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Position` | `System.Numerics.Vector2` |  |
| `Scale` | `float` |  |
| `Opacity` | `float` |  |

<h3 id="member-17e9d508d7e4782a" class="astra-member">Identity</h3>

```csharp
public static Astra.GuiPose Identity { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Pose sem deslocamento, escala 1 e alpha 1.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a33a87f7dd803773" class="astra-member">Opacity</h3>

```csharp
public float Opacity { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Alpha da pose, propagado aos filhos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14382c8bd6337f36" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector2 Position { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Deslocamento XY em pixels aplicado sobre o layout.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-351a18b88d78116d" class="astra-member">Scale</h3>

```csharp
public float Scale { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Escala uniforme; não é escala independente por eixo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiSizing"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guisizing/
---

# Astra.GuiSizing

Struct da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiSizing
```

**Interfaces:** `System.IEquatable<Astra.GuiSizing>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiSizing** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-629470cb17c806bb) | Method |
| [Alignment](#member-625ba8b008032543) | Property |
| [Columns](#member-ccaf220f5f5dd289) | Property |
| [Flexible](#member-5f30812bbd0f9d8a) | Property |
| [Ignore](#member-2109ac25ef615c3a) | Property |
| [Minimum](#member-011482100f894b01) | Property |
| [Padding](#member-853356d0ab9c5148) | Property |
| [Preferred](#member-c9fd6e122352256c) | Property |
| [Spacing](#member-3f63d7bd166c4e3e) | Property |

<h3 id="member-629470cb17c806bb" class="astra-member">.ctor</h3>

```csharp
public GuiSizing(System.Numerics.Vector2 Minimum, System.Numerics.Vector2 Preferred, System.Numerics.Vector2 Flexible, System.Numerics.Vector4 Padding, System.Numerics.Vector2 Spacing, Astra.GuiAlignment Alignment, uint Columns, bool Ignore)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Minimum` | `System.Numerics.Vector2` |  |
| `Preferred` | `System.Numerics.Vector2` |  |
| `Flexible` | `System.Numerics.Vector2` |  |
| `Padding` | `System.Numerics.Vector4` |  |
| `Spacing` | `System.Numerics.Vector2` |  |
| `Alignment` | `Astra.GuiAlignment` |  |
| `Columns` | `uint` |  |
| `Ignore` | `bool` |  |

<h3 id="member-625ba8b008032543" class="astra-member">Alignment</h3>

```csharp
public Astra.GuiAlignment Alignment { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Início, Centro, Fim ou Esticar no container.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ccaf220f5f5dd289" class="astra-member">Columns</h3>

```csharp
public uint Columns { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Colunas do Grid.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5f30812bbd0f9d8a" class="astra-member">Flexible</h3>

```csharp
public System.Numerics.Vector2 Flexible { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Peso de expansão dos filhos HBox/VBox.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2109ac25ef615c3a" class="astra-member">Ignore</h3>

```csharp
public bool Ignore { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Fora do fluxo automático; libera layout manual.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-011482100f894b01" class="astra-member">Minimum</h3>

```csharp
public System.Numerics.Vector2 Minimum { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanho mínimo XY do filho.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-853356d0ab9c5148" class="astra-member">Padding</h3>

```csharp
public System.Numerics.Vector4 Padding { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Margens internas esquerda/topo/direita/base.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9fd6e122352256c" class="astra-member">Preferred</h3>

```csharp
public System.Numerics.Vector2 Preferred { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanho preferido XY; zero mede conteúdo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f63d7bd166c4e3e" class="astra-member">Spacing</h3>

```csharp
public System.Numerics.Vector2 Spacing { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Distância XY entre filhos; HBox usa X e VBox usa Y.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiSnapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guisnapshot/
---

# Astra.GuiSnapshot

Struct da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiSnapshot
```

**Interfaces:** `System.IEquatable<Astra.GuiSnapshot>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiSnapshot** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-34cdc0b4b4e2c0f0) | Method |
| [Enabled](#member-8be8228b328b0b1f) | Property |
| [Id](#member-3d7be55575765382) | Property |
| [Kind](#member-39424b3222fab13c) | Property |
| [Maximum](#member-f86ac2b969288554) | Property |
| [Minimum](#member-af895a7c2f336de0) | Property |
| [Value](#member-8fcb07b7f705a27f) | Property |
| [Visible](#member-e6b9527d6623e144) | Property |
| [World](#member-7db537d4365349f3) | Property |

<h3 id="member-34cdc0b4b4e2c0f0" class="astra-member">.ctor</h3>

```csharp
public GuiSnapshot(uint World, uint Id, Astra.GuiKind Kind, bool Visible, bool Enabled, float Value, float Minimum, float Maximum)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `World` | `uint` |  |
| `Id` | `uint` |  |
| `Kind` | `Astra.GuiKind` |  |
| `Visible` | `bool` |  |
| `Enabled` | `bool` |  |
| `Value` | `float` |  |
| `Minimum` | `float` |  |
| `Maximum` | `float` |  |

<h3 id="member-8be8228b328b0b1f" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Habilitação do estado local.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d7be55575765382" class="astra-member">Id</h3>

```csharp
public uint Id { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** ID local do nó.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-39424b3222fab13c" class="astra-member">Kind</h3>

```csharp
public Astra.GuiKind Kind { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tipo de nó.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f86ac2b969288554" class="astra-member">Maximum</h3>

```csharp
public float Maximum { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Extremo superior autorado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af895a7c2f336de0" class="astra-member">Minimum</h3>

```csharp
public float Minimum { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Extremo inferior autorado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8fcb07b7f705a27f" class="astra-member">Value</h3>

```csharp
public float Value { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Valor de Toggle/Slider/Progress.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6b9527d6623e144" class="astra-member">Visible</h3>

```csharp
public bool Visible { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Visibilidade do estado local.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7db537d4365349f3" class="astra-member">World</h3>

```csharp
public uint World { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Mundo da execução.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiStateStyle"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guistatestyle/
---

# Astra.GuiStateStyle

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiStateStyle
```

**Interfaces:** `System.IEquatable<Astra.GuiStateStyle>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiStateStyle** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-abfe6b311a6e56f0) | Method |
| [Identity](#member-b5aae8c7409a181c) | Property |
| [Pose](#member-4e97400da83b89fc) | Property |
| [Tint](#member-6feeb896c42e0221) | Property |

<h3 id="member-abfe6b311a6e56f0" class="astra-member">.ctor</h3>

```csharp
public GuiStateStyle(Astra.GuiPose Pose, uint Tint = 4294967295)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Pose` | `Astra.GuiPose` |  |
| `Tint` | `uint` |  · Opcional: `4294967295` |

<h3 id="member-b5aae8c7409a181c" class="astra-member">Identity</h3>

```csharp
public static Astra.GuiStateStyle Identity { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Pose identidade e tinta branca.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4e97400da83b89fc" class="astra-member">Pose</h3>

```csharp
public Astra.GuiPose Pose { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Deslocamento, escala e alpha do estado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6feeb896c42e0221" class="astra-member">Tint</h3>

```csharp
public uint Tint { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cor multiplicativa do estado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiStickAxis"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guistickaxis/
---

# Astra.GuiStickAxis

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiStickAxis
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiStickAxis** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Free](#member-90c331f13362cea3) | Field |
| [Horizontal](#member-803fa542fa9a1457) | Field |
| [Vertical](#member-24bffbb2570e70b1) | Field |

<h3 id="member-90c331f13362cea3" class="astra-member">Free</h3>

```csharp
Free = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-803fa542fa9a1457" class="astra-member">Horizontal</h3>

```csharp
Horizontal = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-24bffbb2570e70b1" class="astra-member">Vertical</h3>

```csharp
Vertical = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiStickGate"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guistickgate/
---

# Astra.GuiStickGate

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiStickGate
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiStickGate** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Circle](#member-c3a88951a9977573) | Field |
| [Square](#member-a5ecdd1e49637ba9) | Field |

<h3 id="member-c3a88951a9977573" class="astra-member">Circle</h3>

```csharp
Circle = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a5ecdd1e49637ba9" class="astra-member">Square</h3>

```csharp
Square = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiStickMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guistickmode/
---

# Astra.GuiStickMode

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.GuiStickMode
```

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiStickMode** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Dynamic](#member-0996ffcc69d213ad) | Field |
| [Fixed](#member-2b6a1970d7edab81) | Field |
| [Floating](#member-99f6b49096e7d130) | Field |

<h3 id="member-0996ffcc69d213ad" class="astra-member">Dynamic</h3>

```csharp
Dynamic = 2
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2b6a1970d7edab81" class="astra-member">Fixed</h3>

```csharp
Fixed = 0
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-99f6b49096e7d130" class="astra-member">Floating</h3>

```csharp
Floating = 1
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiStyle"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guistyle/
---

# Astra.GuiStyle

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiStyle
```

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

**Interfaces:** `System.IEquatable<Astra.GuiStyle>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiStyle** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-18527f472f44b344) | Method |
| [Accent](#member-e5550e8c843f5457) | Property |
| [Background](#member-2eaff5057989f5c7) | Property |
| [ClipChildren](#member-6171f7c2237a7aa3) | Property |
| [FontSize](#member-f747c87feb5676c5) | Property |
| [Foreground](#member-f8c677b04be2f445) | Property |
| [Radius](#member-ed20f911f2696191) | Property |

<h3 id="member-18527f472f44b344" class="astra-member">.ctor</h3>

```csharp
public GuiStyle(uint Background, uint Foreground, uint Accent, bool ClipChildren, float FontSize, float Radius)
```

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Background` | `uint` |  |
| `Foreground` | `uint` |  |
| `Accent` | `uint` |  |
| `ClipChildren` | `bool` |  |
| `FontSize` | `float` |  |
| `Radius` | `float` |  |

<h3 id="member-e5550e8c843f5457" class="astra-member">Accent</h3>

```csharp
public uint Accent { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cor de destaque/preenchimento do controle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2eaff5057989f5c7" class="astra-member">Background</h3>

```csharp
public uint Background { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cor de fundo 0xAARRGGBB; alpha zero não desenha fundo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6171f7c2237a7aa3" class="astra-member">ClipChildren</h3>

```csharp
public bool ClipChildren { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Recorta desenho/hit de descendentes ao retângulo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f747c87feb5676c5" class="astra-member">FontSize</h3>

```csharp
public float FontSize { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanho do texto em pixels.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8c677b04be2f445" class="astra-member">Foreground</h3>

```csharp
public uint Foreground { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Cor do texto/conteúdo do controle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed20f911f2696191" class="astra-member">Radius</h3>

```csharp
public float Radius { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Raio do fundo/imagem desenhados; não é uma hit mask por alpha.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.GuiTransitions"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guitransitions/
---

# Astra.GuiTransitions

Struct da API C# da Astra. 8 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiTransitions
```

**Interfaces:** `System.IEquatable<Astra.GuiTransitions>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiTransitions** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e2a298db8716fcf1) | Method |
| [Default](#member-1eede7455777cc9b) | Property |
| [Disabled](#member-ae218f6198ab32a9) | Property |
| [Duration](#member-5c6a60ab853d0ca8) | Property |
| [Easing](#member-c9f472b817e132ac) | Property |
| [Enabled](#member-8bcd59d7816e6f72) | Property |
| [Normal](#member-a585eb7307119cb6) | Property |
| [Pressed](#member-4098c7d8f1e1eaa3) | Property |

<h3 id="member-e2a298db8716fcf1" class="astra-member">.ctor</h3>

```csharp
public GuiTransitions(bool Enabled, float Duration, Astra.GuiEasing Easing, Astra.GuiStateStyle Normal, Astra.GuiStateStyle Pressed, Astra.GuiStateStyle Disabled)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Enabled` | `bool` |  |
| `Duration` | `float` |  |
| `Easing` | `Astra.GuiEasing` |  |
| `Normal` | `Astra.GuiStateStyle` |  |
| `Pressed` | `Astra.GuiStateStyle` |  |
| `Disabled` | `Astra.GuiStateStyle` |  |

<h3 id="member-1eede7455777cc9b" class="astra-member">Default</h3>

```csharp
public static Astra.GuiTransitions Default { get; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Desativado, 0,12 s; pressionado escala 0,94, desabilitado alpha 0,45.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae218f6198ab32a9" class="astra-member">Disabled</h3>

```csharp
public Astra.GuiStateStyle Disabled { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Visual com elemento/ancestral desabilitado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c6a60ab853d0ca8" class="astra-member">Duration</h3>

```csharp
public float Duration { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tempo de mistura entre estados, em segundos.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9f472b817e132ac" class="astra-member">Easing</h3>

```csharp
public Astra.GuiEasing Easing { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Curva da transição de estado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8bcd59d7816e6f72" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Habilita Normal/Pressionado/Desabilitado.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a585eb7307119cb6" class="astra-member">Normal</h3>

```csharp
public Astra.GuiStateStyle Normal { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Visual sem interação.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4098c7d8f1e1eaa3" class="astra-member">Pressed</h3>

```csharp
public Astra.GuiStateStyle Pressed { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Visual durante pressão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.HapticsAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-hapticsaccess/
---

# Astra.HapticsAccess

Vibração do aparelho (Unity 6000.0 Handheld.Vibrate, com duração e intensidade).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.HapticsAccess
```

Vibração do aparelho (Unity 6000.0 Handheld.Vibrate, com duração e intensidade).

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Vibrate](#member-698638964f8f1e2b) | Method |
| [Available](#member-e3c4abf2647c8261) | Property |

<h3 id="member-698638964f8f1e2b" class="astra-member">Vibrate</h3>

```csharp
public void Vibrate(uint milliseconds = 60, float amplitude = 0)
```

1..5000 ms; amplitude 0..1, zero usa a do aparelho. Sem vibrador lança NotSupportedException.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** 1..5000 ms; amplitude 0..1, zero usa a do aparelho. Sem vibrador lança NotSupportedException.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `milliseconds` | `uint` |  · Opcional: `60` |
| `amplitude` | `float` |  · Opcional: `0` |

<h3 id="member-e3c4abf2647c8261" class="astra-member">Available</h3>

```csharp
public bool Available { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.HideInInspectorAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-hideininspectorattribute/
---

# Astra.HideInInspectorAttribute

Campo guardado na cena que o Inspector não mostra (Unity: [HideInInspector]). O valor autoral continua preservado e entregue no Play.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.HideInInspectorAttribute
```

Campo guardado na cena que o Inspector não mostra (Unity: [HideInInspector]). O valor autoral continua preservado e entregue no Play.

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

Este tipo não declara membros públicos adicionais neste recorte.


---

---
title: "Astra.InputAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputaccess/
---

# Astra.InputAccess

As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.InputAccess
```

As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-d182649f804cfcd0) | Method |
| [ActionState](#member-71ba134a07bae39a) | Method |
| [ApplyBindingOverride](#member-c21b28f38231ba6f) | Method |
| [Axis](#member-a78c589b02726841) | Method |
| [Axis2](#member-0a3439dca9a729d2) | Method |
| [BeginBindingCapture](#member-2f9ec90d2cd4a84e) | Method |
| [CancelBindingCapture](#member-f6c45c59febfa91c) | Method |
| [ContextEnabled](#member-97912a16db0d12c8) | Method |
| [Exists](#member-2e9b788483a86d8b) | Method |
| [ExportProfile](#member-b4492439701520f0) | Method |
| [GetBinding](#member-2ace1ae05546bca6) | Method |
| [ImportProfile](#member-44a05b44253e77d3) | Method |
| [JustPressed](#member-dd9e8da95801be42) | Method |
| [JustReleased](#member-aefe85caa733c991) | Method |
| [LoadProfile](#member-ec069fef3eb3731f) | Method |
| [Pressed](#member-6ba5c5131a0ef4f2) | Method |
| [RemoveAllBindingOverrides](#member-d7091a7696619d1b) | Method |
| [RemoveBindingOverride](#member-6af46d6f38f3918b) | Method |
| [RestoreActionEnabled](#member-5487213b6eae1809) | Method |
| [RoleAction](#member-5e259fcc03e9429e) | Method |
| [SaveProfile](#member-0d4bd789f8e5ec00) | Method |
| [SetActionEnabled](#member-1083caec06e969ab) | Method |
| [SetContextEnabled](#member-b054ff1bc97eea09) | Method |
| [BindingCaptureStatus](#member-1814b21d852740a3) | Property |
| [DeviceGroups](#member-cc22a9a3571bc008) | Property |
| [JumpPressed](#member-354513fa23ad64e7) | Property |
| [Look](#member-16d698a1ab4eb40c) | Property |
| [Move](#member-1cdc227face2cf83) | Property |

<h3 id="member-d182649f804cfcd0" class="astra-member">.ctor</h3>

```csharp
public InputAccess(Astra.ISceneAccess scene)
```

As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-71ba134a07bae39a" class="astra-member">ActionState</h3>

```csharp
public Astra.InputActionState ActionState(string action)
```

State of the real interaction. Timing uses unscaled sampled input time.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** State of the real interaction. Timing uses unscaled sampled input time.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-c21b28f38231ba6f" class="astra-member">ApplyBindingOverride</h3>

```csharp
public bool ApplyBindingOverride(string action, uint index, Astra.InputBindingValue binding)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |
| `index` | `uint` |  |
| `binding` | `Astra.InputBindingValue` |  |

<h3 id="member-a78c589b02726841" class="astra-member">Axis</h3>

```csharp
public float Axis(string action)
```

Componente X do eixo, para ações Axis1D.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Componente X do eixo, para ações Axis1D.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-0a3439dca9a729d2" class="astra-member">Axis2</h3>

```csharp
public System.Numerics.Vector2 Axis2(string action)
```

Eixo 2D da ação. Ação desconhecida lê zero.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Eixo 2D da ação. Ação desconhecida lê zero.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-2f9ec90d2cd4a84e" class="astra-member">BeginBindingCapture</h3>

```csharp
public bool BeginBindingCapture(string action, uint index, Astra.InputSource source, bool negative = false, uint cancelKey = 111)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |
| `index` | `uint` |  |
| `source` | `Astra.InputSource` |  |
| `negative` | `bool` |  · Opcional: `False` |
| `cancelKey` | `uint` |  · Opcional: `111` |

<h3 id="member-f6c45c59febfa91c" class="astra-member">CancelBindingCapture</h3>

```csharp
public void CancelBindingCapture()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-97912a16db0d12c8" class="astra-member">ContextEnabled</h3>

```csharp
public bool ContextEnabled(string context)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `context` | `string` |  |

<h3 id="member-2e9b788483a86d8b" class="astra-member">Exists</h3>

```csharp
public bool Exists(string action)
```

Falso quando a ação nem existe no mapa do projeto.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Falso quando a ação nem existe no mapa do projeto.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-b4492439701520f0" class="astra-member">ExportProfile</h3>

```csharp
public string ExportProfile()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ace1ae05546bca6" class="astra-member">GetBinding</h3>

```csharp
public Astra.InputBindingValue GetBinding(string action, uint index = 0, bool authored = false)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |
| `index` | `uint` |  · Opcional: `0` |
| `authored` | `bool` |  · Opcional: `False` |

<h3 id="member-44a05b44253e77d3" class="astra-member">ImportProfile</h3>

```csharp
public bool ImportProfile(string profile)
```

Troca todos os overrides atomicamente; mapa incompatível é recusado sem alteração.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Troca todos os overrides atomicamente; mapa incompatível é recusado sem alteração.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `profile` | `string` |  |

<h3 id="member-dd9e8da95801be42" class="astra-member">JustPressed</h3>

```csharp
public bool JustPressed(string action)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-aefe85caa733c991" class="astra-member">JustReleased</h3>

```csharp
public bool JustReleased(string action)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-ec069fef3eb3731f" class="astra-member">LoadProfile</h3>

```csharp
public bool LoadProfile(string path)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `path` | `string` |  |

<h3 id="member-6ba5c5131a0ef4f2" class="astra-member">Pressed</h3>

```csharp
public bool Pressed(string action)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-d7091a7696619d1b" class="astra-member">RemoveAllBindingOverrides</h3>

```csharp
public void RemoveAllBindingOverrides()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6af46d6f38f3918b" class="astra-member">RemoveBindingOverride</h3>

```csharp
public bool RemoveBindingOverride(string action, uint index = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |
| `index` | `uint` |  · Opcional: `0` |

<h3 id="member-5487213b6eae1809" class="astra-member">RestoreActionEnabled</h3>

```csharp
public bool RestoreActionEnabled(string action)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-5e259fcc03e9429e" class="astra-member">RoleAction</h3>

```csharp
public string RoleAction(Astra.InputRole role)
```

Nome da ação que o projeto atribuiu a este papel, ou vazio.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Nome da ação que o projeto atribuiu a este papel, ou vazio.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `role` | `Astra.InputRole` |  |

<h3 id="member-0d4bd789f8e5ec00" class="astra-member">SaveProfile</h3>

```csharp
public void SaveProfile(string path)
```

Grava o perfil separado da cena. O jogo escolhe o caminho de armazenamento do jogador.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Grava o perfil separado da cena. O jogo escolhe o caminho de armazenamento do jogador.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `path` | `string` |  |

<h3 id="member-1083caec06e969ab" class="astra-member">SetActionEnabled</h3>

```csharp
public bool SetActionEnabled(string action, bool enabled)
```

Runtime policy only; the scene and rebind profile remain authored data.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Runtime policy only; the scene and rebind profile remain authored data.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |
| `enabled` | `bool` |  |

<h3 id="member-b054ff1bc97eea09" class="astra-member">SetContextEnabled</h3>

```csharp
public void SetContextEnabled(string context, bool enabled)
```

Liga ou desliga um contexto. Uma ação em contexto desligado lê zero sem perder o que o usuário configurou — é assim que um menu do jogo silencia o controle do personagem sem apagar o mapa.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Liga ou desliga um contexto. Uma ação em contexto desligado lê zero sem perder o que o usuário configurou — é assim que um menu do jogo silencia o controle do personagem sem apagar o mapa.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `context` | `string` |  |
| `enabled` | `bool` |  |

<h3 id="member-1814b21d852740a3" class="astra-member">BindingCaptureStatus</h3>

```csharp
public Astra.InputCaptureStatus BindingCaptureStatus { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cc22a9a3571bc008" class="astra-member">DeviceGroups</h3>

```csharp
public Astra.InputDeviceGroups DeviceGroups { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-354513fa23ad64e7" class="astra-member">JumpPressed</h3>

```csharp
public bool JumpPressed { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16d698a1ab4eb40c" class="astra-member">Look</h3>

```csharp
public System.Numerics.Vector2 Look { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1cdc227face2cf83" class="astra-member">Move</h3>

```csharp
public System.Numerics.Vector2 Move { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputActionState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputactionstate/
---

# Astra.InputActionState

Struct da API C# da Astra. 8 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.InputActionState
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DeviceGroups](#member-b589501044758c78) | Field |
| [Duration](#member-d9304e09433605cd) | Field |
| [Elapsed](#member-c23cb18ffd50c5d6) | Field |
| [Interaction](#member-4740b2ef8c9c5675) | Field |
| [Phase](#member-204eeecdfd0fbb33) | Field |
| [Progress](#member-5017ae9cebcd560e) | Field |
| [AuthoredEnabled](#member-16088d2e0d894816) | Property |
| [Enabled](#member-5c947023081e9c85) | Property |

<h3 id="member-b589501044758c78" class="astra-member">DeviceGroups</h3>

```csharp
public Astra.InputDeviceGroups DeviceGroups
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9304e09433605cd" class="astra-member">Duration</h3>

```csharp
public float Duration
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c23cb18ffd50c5d6" class="astra-member">Elapsed</h3>

```csharp
public float Elapsed
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4740b2ef8c9c5675" class="astra-member">Interaction</h3>

```csharp
public Astra.InputInteraction Interaction
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-204eeecdfd0fbb33" class="astra-member">Phase</h3>

```csharp
public Astra.InputPhase Phase
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5017ae9cebcd560e" class="astra-member">Progress</h3>

```csharp
public float Progress
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16088d2e0d894816" class="astra-member">AuthoredEnabled</h3>

```csharp
public bool AuthoredEnabled { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c947023081e9c85" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputBindingValue"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputbindingvalue/
---

# Astra.InputBindingValue

Valor tipado de um vínculo. Códigos de tecla/gamepad são códigos Android.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.InputBindingValue
```

Valor tipado de um vínculo. Códigos de tecla/gamepad são códigos Android.

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Axis](#member-56f5bcaf6cf65432) | Field |
| [Code](#member-2ef4d76ddb47eef6) | Field |
| [NegativeCode](#member-7961631797c7f0e6) | Field |
| [Scale](#member-bd10fc2beb610ac4) | Field |
| [Source](#member-a3ffba89cdc49a89) | Field |
| [.ctor](#member-e30f7e5c1806e0d4) | Method |
| [Invert](#member-1eb0fb28b42ec0e9) | Property |

<h3 id="member-56f5bcaf6cf65432" class="astra-member">Axis</h3>

```csharp
public uint Axis
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ef4d76ddb47eef6" class="astra-member">Code</h3>

```csharp
public uint Code
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7961631797c7f0e6" class="astra-member">NegativeCode</h3>

```csharp
public uint NegativeCode
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bd10fc2beb610ac4" class="astra-member">Scale</h3>

```csharp
public float Scale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a3ffba89cdc49a89" class="astra-member">Source</h3>

```csharp
public Astra.InputSource Source
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e30f7e5c1806e0d4" class="astra-member">.ctor</h3>

```csharp
public InputBindingValue(Astra.InputSource source, uint code = 0, uint negativeCode = 0, uint axis = 0, float scale = 1, bool invert = false)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `source` | `Astra.InputSource` |  |
| `code` | `uint` |  · Opcional: `0` |
| `negativeCode` | `uint` |  · Opcional: `0` |
| `axis` | `uint` |  · Opcional: `0` |
| `scale` | `float` |  · Opcional: `1` |
| `invert` | `bool` |  · Opcional: `False` |

<h3 id="member-1eb0fb28b42ec0e9" class="astra-member">Invert</h3>

```csharp
public bool Invert { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputCaptureStatus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputcapturestatus/
---

# Astra.InputCaptureStatus

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputCaptureStatus
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cancelled](#member-e18005a3ab83f9a1) | Field |
| [Completed](#member-0c313f13026638a5) | Field |
| [Idle](#member-987cebe65b427d49) | Field |
| [Waiting](#member-f52866ecf0652f8c) | Field |

<h3 id="member-e18005a3ab83f9a1" class="astra-member">Cancelled</h3>

```csharp
Cancelled = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0c313f13026638a5" class="astra-member">Completed</h3>

```csharp
Completed = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-987cebe65b427d49" class="astra-member">Idle</h3>

```csharp
Idle = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f52866ecf0652f8c" class="astra-member">Waiting</h3>

```csharp
Waiting = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputDeviceGroups"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputdevicegroups/
---

# Astra.InputDeviceGroups

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputDeviceGroups
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [All](#member-7dc9230eb9058206) | Field |
| [Gamepad](#member-eafe0c49bd384945) | Field |
| [KeyboardMouse](#member-8b29c1a0ff022cbf) | Field |
| [None](#member-542af07fb1f67498) | Field |
| [Touch](#member-7b3deebc6399c139) | Field |

<h3 id="member-7dc9230eb9058206" class="astra-member">All</h3>

```csharp
All = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eafe0c49bd384945" class="astra-member">Gamepad</h3>

```csharp
Gamepad = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8b29c1a0ff022cbf" class="astra-member">KeyboardMouse</h3>

```csharp
KeyboardMouse = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-542af07fb1f67498" class="astra-member">None</h3>

```csharp
None = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7b3deebc6399c139" class="astra-member">Touch</h3>

```csharp
Touch = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputInteraction"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputinteraction/
---

# Astra.InputInteraction

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputInteraction
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Hold](#member-95498f636a3fb15c) | Field |
| [Press](#member-91c4eb0e7a76cc19) | Field |
| [Tap](#member-c32e6dcfd6390f90) | Field |

<h3 id="member-95498f636a3fb15c" class="astra-member">Hold</h3>

```csharp
Hold = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-91c4eb0e7a76cc19" class="astra-member">Press</h3>

```csharp
Press = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c32e6dcfd6390f90" class="astra-member">Tap</h3>

```csharp
Tap = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputPhase"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputphase/
---

# Astra.InputPhase

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputPhase
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Canceled](#member-eee6df8ff3b6493c) | Field |
| [Disabled](#member-a85dba8c6fa74b90) | Field |
| [Performed](#member-345f0d758b84bc4b) | Field |
| [Started](#member-fa0e1fcf26758dc0) | Field |
| [Waiting](#member-643ae9e67fef4bb2) | Field |

<h3 id="member-eee6df8ff3b6493c" class="astra-member">Canceled</h3>

```csharp
Canceled = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a85dba8c6fa74b90" class="astra-member">Disabled</h3>

```csharp
Disabled = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-345f0d758b84bc4b" class="astra-member">Performed</h3>

```csharp
Performed = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fa0e1fcf26758dc0" class="astra-member">Started</h3>

```csharp
Started = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-643ae9e67fef4bb2" class="astra-member">Waiting</h3>

```csharp
Waiting = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputRole"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputrole/
---

# Astra.InputRole

Os papéis que o projeto atribui às próprias ações.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputRole
```

Os papéis que o projeto atribui às próprias ações.

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Jump](#member-23b0bb80d5b74eca) | Field |
| [Look](#member-a0c45fce1f6b9c11) | Field |
| [Move](#member-f61b8b8ce7f351c9) | Field |

<h3 id="member-23b0bb80d5b74eca" class="astra-member">Jump</h3>

```csharp
Jump = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0c45fce1f6b9c11" class="astra-member">Look</h3>

```csharp
Look = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f61b8b8ce7f351c9" class="astra-member">Move</h3>

```csharp
Move = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.InputSource"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-inputsource/
---

# Astra.InputSource

Enum da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.InputSource
```

## Onde acessar este tipo

Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [GamepadAxis](#member-fffde027dced6ae8) | Field |
| [GamepadButton](#member-66eabdf3b796c1f0) | Field |
| [Key](#member-7e9daf86886963c4) | Field |
| [MouseAxis](#member-288909bcf85ccc99) | Field |
| [MouseButton](#member-d6b1cc6b3c1fdf69) | Field |
| [None](#member-5402ba6c142bb768) | Field |
| [TouchButton](#member-99d38b9f668be8f7) | Field |
| [TouchLook](#member-bde0ffa3450dbffb) | Field |
| [TouchMove](#member-37876e8ba7e0acbe) | Field |

<h3 id="member-fffde027dced6ae8" class="astra-member">GamepadAxis</h3>

```csharp
GamepadAxis = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66eabdf3b796c1f0" class="astra-member">GamepadButton</h3>

```csharp
GamepadButton = 6
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e9daf86886963c4" class="astra-member">Key</h3>

```csharp
Key = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-288909bcf85ccc99" class="astra-member">MouseAxis</h3>

```csharp
MouseAxis = 8
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d6b1cc6b3c1fdf69" class="astra-member">MouseButton</h3>

```csharp
MouseButton = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5402ba6c142bb768" class="astra-member">None</h3>

```csharp
None = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-99d38b9f668be8f7" class="astra-member">TouchButton</h3>

```csharp
TouchButton = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bde0ffa3450dbffb" class="astra-member">TouchLook</h3>

```csharp
TouchLook = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-37876e8ba7e0acbe" class="astra-member">TouchMove</h3>

```csharp
TouchMove = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Keyframe"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-keyframe/
---

# Astra.Keyframe

Chave de uma Astra.AnimationCurve (Unity: Keyframe).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.Keyframe
```

Chave de uma Astra.AnimationCurve (Unity: Keyframe).

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Broken](#member-34afa1ba0c3fcd9c) | Field |
| [InTangent](#member-e3d1bb6e85d8c036) | Field |
| [LeftMode](#member-3c45167a1cc8ce87) | Field |
| [OutTangent](#member-4b9fab3a23d57183) | Field |
| [RightMode](#member-c1784af2bc514997) | Field |
| [Time](#member-71067cf9b75169c3) | Field |
| [Value](#member-7ae2d2ed25d51a4e) | Field |
| [.ctor](#member-aa3ceb5fd31848e3) | Method |

<h3 id="member-34afa1ba0c3fcd9c" class="astra-member">Broken</h3>

```csharp
public bool Broken
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e3d1bb6e85d8c036" class="astra-member">InTangent</h3>

```csharp
public float InTangent
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3c45167a1cc8ce87" class="astra-member">LeftMode</h3>

```csharp
public Astra.TangentMode LeftMode
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4b9fab3a23d57183" class="astra-member">OutTangent</h3>

```csharp
public float OutTangent
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c1784af2bc514997" class="astra-member">RightMode</h3>

```csharp
public Astra.TangentMode RightMode
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71067cf9b75169c3" class="astra-member">Time</h3>

```csharp
public float Time
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7ae2d2ed25d51a4e" class="astra-member">Value</h3>

```csharp
public float Value
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa3ceb5fd31848e3" class="astra-member">.ctor</h3>

```csharp
public Keyframe(float time, float value, float inTangent = 0, float outTangent = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `time` | `float` |  |
| `value` | `float` |  |
| `inTangent` | `float` |  · Opcional: `0` |
| `outTangent` | `float` |  · Opcional: `0` |


---

---
title: "Astra.MaterialAlphaMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialalphamode/
---

# Astra.MaterialAlphaMode

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialAlphaMode
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Blend](#member-acffe7356c318153) | Field |
| [Inherit](#member-eb02fda3e95767aa) | Field |
| [Mask](#member-57c81d3b93f5e640) | Field |
| [Opaque](#member-3b94bc49273db0d2) | Field |

<h3 id="member-acffe7356c318153" class="astra-member">Blend</h3>

```csharp
Blend = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-eb02fda3e95767aa" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57c81d3b93f5e640" class="astra-member">Mask</h3>

```csharp
Mask = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3b94bc49273db0d2" class="astra-member">Opaque</h3>

```csharp
Opaque = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialAlphaSource"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialalphasource/
---

# Astra.MaterialAlphaSource

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialAlphaSource
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [BaseAlpha](#member-00ff29bb5ea156a2) | Field |
| [BaseLuminance](#member-9a6d1c500e3e68f5) | Field |
| [Inherit](#member-e86c9a1436638f97) | Field |
| [Opaque](#member-29dc45cad6b865d5) | Field |

<h3 id="member-00ff29bb5ea156a2" class="astra-member">BaseAlpha</h3>

```csharp
BaseAlpha = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9a6d1c500e3e68f5" class="astra-member">BaseLuminance</h3>

```csharp
BaseLuminance = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e86c9a1436638f97" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-29dc45cad6b865d5" class="astra-member">Opaque</h3>

```csharp
Opaque = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialChannel"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialchannel/
---

# Astra.MaterialChannel

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialChannel
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [A](#member-db585258c7b2ce3d) | Field |
| [B](#member-83ca4313b7acfdfb) | Field |
| [G](#member-32cc89e278356fea) | Field |
| [Inherit](#member-ea51bd58ae544e87) | Field |
| [R](#member-2f006aabcc506ae7) | Field |

<h3 id="member-db585258c7b2ce3d" class="astra-member">A</h3>

```csharp
A = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-83ca4313b7acfdfb" class="astra-member">B</h3>

```csharp
B = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-32cc89e278356fea" class="astra-member">G</h3>

```csharp
G = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ea51bd58ae544e87" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f006aabcc506ae7" class="astra-member">R</h3>

```csharp
R = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialFilter"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialfilter/
---

# Astra.MaterialFilter

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialFilter
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Inherit](#member-b37155eb1dc8bb27) | Field |
| [Linear](#member-770b558e724e2d3e) | Field |
| [Nearest](#member-be86e5af09e86b00) | Field |

<h3 id="member-b37155eb1dc8bb27" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-770b558e724e2d3e" class="astra-member">Linear</h3>

```csharp
Linear = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-be86e5af09e86b00" class="astra-member">Nearest</h3>

```csharp
Nearest = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialOcclusionSource"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialocclusionsource/
---

# Astra.MaterialOcclusionSource

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialOcclusionSource
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Inherit](#member-dcfb70ce5a92351a) | Field |
| [None](#member-5338b5afbca23bcf) | Field |
| [Packed](#member-fd0f3f0447ca980a) | Field |
| [Texture](#member-fbabe4bb40018959) | Field |

<h3 id="member-dcfb70ce5a92351a" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5338b5afbca23bcf" class="astra-member">None</h3>

```csharp
None = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd0f3f0447ca980a" class="astra-member">Packed</h3>

```csharp
Packed = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fbabe4bb40018959" class="astra-member">Texture</h3>

```csharp
Texture = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialSides"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialsides/
---

# Astra.MaterialSides

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialSides
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Double](#member-af52dbc64f310487) | Field |
| [Inherit](#member-97a0575cab402d99) | Field |
| [Single](#member-6638d3bfed0f7d9b) | Field |

<h3 id="member-af52dbc64f310487" class="astra-member">Double</h3>

```csharp
Double = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-97a0575cab402d99" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6638d3bfed0f7d9b" class="astra-member">Single</h3>

```csharp
Single = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialSlot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialslot/
---

# Astra.MaterialSlot

Vista de um slot existente de MeshRenderer no mundo Play. Propriedades de amostragem sem binding escrevem todos e leem a cor base; use TextureSampling para um binding.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.MaterialSlot
```

Vista de um slot existente de MeshRenderer no mundo Play. Propriedades de amostragem sem binding escrevem todos e leem a cor base; use TextureSampling para um binding.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-36878003f7b56613) | Method |
| [GetTexture](#member-f6396108985fce26) | Method |
| [InheritTexture](#member-c0cfaf578d9bbeee) | Method |
| [RemoveTexture](#member-0522e8a2bd1703c0) | Method |
| [SetTexture](#member-6595ca53ec225cc6) | Method |
| [SetTexture](#member-6596ef2f77495f93) | Method |
| [TextureSampling](#member-13785399c0c996c2) | Method |
| [AlphaCutoff](#member-b184eaf694573492) | Property |
| [AlphaMode](#member-4378936b58adc654) | Property |
| [AlphaSource](#member-34afb400ddd4ad2f) | Property |
| [BaseColor](#member-b36d3bcf8f362958) | Property |
| [Emission](#member-e4afad3e4a84801a) | Property |
| [EmissionStrength](#member-44090a7736ed10cc) | Property |
| [Filter](#member-382beb30c1eab09c) | Property |
| [Metallic](#member-d924a2dc6d5def22) | Property |
| [MetallicChannel](#member-fd85fa980a7d19de) | Property |
| [NormalFlipY](#member-a3f36a4fde528404) | Property |
| [NormalScale](#member-9f3bd8d81f4eac04) | Property |
| [OcclusionChannel](#member-9796cecbba4eec7a) | Property |
| [OcclusionSource](#member-273a9f855dc701d5) | Property |
| [OcclusionStrength](#member-7c54bbf1d34107d7) | Property |
| [Offset](#member-aefa813542502f45) | Property |
| [Override](#member-0ade196205b6d2a7) | Property |
| [RotationDegrees](#member-56beece1d1d01785) | Property |
| [Roughness](#member-fcff7088a0993b24) | Property |
| [RoughnessChannel](#member-7c4ae71adcd67a37) | Property |
| [Scale](#member-150c2bc1230335f4) | Property |
| [SharedMaterial](#member-2a1f439c17c3fe2b) | Property |
| [Sides](#member-64adac2ceeeb1427) | Property |
| [Specular](#member-a6a90e0388676b2f) | Property |
| [UvSet](#member-f8b9210b9c135940) | Property |
| [Wrap](#member-7a2dc5545d967eb9) | Property |

<h3 id="member-36878003f7b56613" class="astra-member">.ctor</h3>

```csharp
public MaterialSlot(Astra.Component component, uint slot)
```

Vista de um slot existente de MeshRenderer no mundo Play. Propriedades de amostragem sem binding escrevem todos e leem a cor base; use TextureSampling para um binding.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |
| `slot` | `uint` |  |

<h3 id="member-f6396108985fce26" class="astra-member">GetTexture</h3>

```csharp
public Astra.AssetGuid GetTexture(Astra.MaterialTextureBinding binding)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |

<h3 id="member-c0cfaf578d9bbeee" class="astra-member">InheritTexture</h3>

```csharp
public void InheritTexture(Astra.MaterialTextureBinding binding)
```

Remove o override local; o material compartilhado ou a fonte volta a fornecer o binding.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Remove o override local; o material compartilhado ou a fonte volta a fornecer o binding.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |

<h3 id="member-0522e8a2bd1703c0" class="astra-member">RemoveTexture</h3>

```csharp
public void RemoveTexture(Astra.MaterialTextureBinding binding)
```

Declara o binding sem textura, mesmo quando a fonte ou o material compartilhado possui uma.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Declara o binding sem textura, mesmo quando a fonte ou o material compartilhado possui uma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |

<h3 id="member-6595ca53ec225cc6" class="astra-member">SetTexture</h3>

```csharp
public void SetTexture(Astra.MaterialTextureBinding binding, Astra.AssetGuid texture)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |
| `texture` | `Astra.AssetGuid` |  |

<h3 id="member-6596ef2f77495f93" class="astra-member">SetTexture</h3>

```csharp
public void SetTexture(Astra.MaterialTextureBinding binding, Astra.AssetReference texture)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |
| `texture` | `Astra.AssetReference` |  |

<h3 id="member-13785399c0c996c2" class="astra-member">TextureSampling</h3>

```csharp
public Astra.MaterialTextureSampling TextureSampling(Astra.MaterialTextureBinding binding)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `binding` | `Astra.MaterialTextureBinding` |  |

<h3 id="member-b184eaf694573492" class="astra-member">AlphaCutoff</h3>

```csharp
public float AlphaCutoff { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4378936b58adc654" class="astra-member">AlphaMode</h3>

```csharp
public Astra.MaterialAlphaMode AlphaMode { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-34afb400ddd4ad2f" class="astra-member">AlphaSource</h3>

```csharp
public Astra.MaterialAlphaSource AlphaSource { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b36d3bcf8f362958" class="astra-member">BaseColor</h3>

```csharp
public System.Numerics.Vector3 BaseColor { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e4afad3e4a84801a" class="astra-member">Emission</h3>

```csharp
public System.Numerics.Vector3 Emission { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-44090a7736ed10cc" class="astra-member">EmissionStrength</h3>

```csharp
public float EmissionStrength { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-382beb30c1eab09c" class="astra-member">Filter</h3>

```csharp
public Astra.MaterialFilter Filter { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d924a2dc6d5def22" class="astra-member">Metallic</h3>

```csharp
public float Metallic { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd85fa980a7d19de" class="astra-member">MetallicChannel</h3>

```csharp
public Astra.MaterialChannel MetallicChannel { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a3f36a4fde528404" class="astra-member">NormalFlipY</h3>

```csharp
public Astra.MaterialToggle NormalFlipY { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f3bd8d81f4eac04" class="astra-member">NormalScale</h3>

```csharp
public float NormalScale { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9796cecbba4eec7a" class="astra-member">OcclusionChannel</h3>

```csharp
public Astra.MaterialChannel OcclusionChannel { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-273a9f855dc701d5" class="astra-member">OcclusionSource</h3>

```csharp
public Astra.MaterialOcclusionSource OcclusionSource { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c54bbf1d34107d7" class="astra-member">OcclusionStrength</h3>

```csharp
public float OcclusionStrength { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aefa813542502f45" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ade196205b6d2a7" class="astra-member">Override</h3>

```csharp
public bool Override { get; set; }
```

Controla o override local. Escrever qualquer fator PBR também o ativa, como no Inspector.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Controla o override local. Escrever qualquer fator PBR também o ativa, como no Inspector.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-56beece1d1d01785" class="astra-member">RotationDegrees</h3>

```csharp
public float RotationDegrees { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fcff7088a0993b24" class="astra-member">Roughness</h3>

```csharp
public float Roughness { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c4ae71adcd67a37" class="astra-member">RoughnessChannel</h3>

```csharp
public Astra.MaterialChannel RoughnessChannel { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-150c2bc1230335f4" class="astra-member">Scale</h3>

```csharp
public System.Numerics.Vector2 Scale { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a1f439c17c3fe2b" class="astra-member">SharedMaterial</h3>

```csharp
public Astra.AssetGuid SharedMaterial { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-64adac2ceeeb1427" class="astra-member">Sides</h3>

```csharp
public Astra.MaterialSides Sides { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a6a90e0388676b2f" class="astra-member">Specular</h3>

```csharp
public float Specular { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8b9210b9c135940" class="astra-member">UvSet</h3>

```csharp
public Astra.MaterialUvSet UvSet { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a2dc5545d967eb9" class="astra-member">Wrap</h3>

```csharp
public Astra.MaterialWrap Wrap { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialTextureBinding"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialtexturebinding/
---

# Astra.MaterialTextureBinding

Enum da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialTextureBinding
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [BaseColor](#member-898870ba7c81381b) | Field |
| [Emissive](#member-fda579d4cd899825) | Field |
| [MetallicRoughness](#member-c52c4e3314212232) | Field |
| [Normal](#member-3a6a3bd4f9252670) | Field |
| [Occlusion](#member-961da346d9b7f037) | Field |

<h3 id="member-898870ba7c81381b" class="astra-member">BaseColor</h3>

```csharp
BaseColor = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fda579d4cd899825" class="astra-member">Emissive</h3>

```csharp
Emissive = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c52c4e3314212232" class="astra-member">MetallicRoughness</h3>

```csharp
MetallicRoughness = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3a6a3bd4f9252670" class="astra-member">Normal</h3>

```csharp
Normal = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-961da346d9b7f037" class="astra-member">Occlusion</h3>

```csharp
Occlusion = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialTextureSampling"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialtexturesampling/
---

# Astra.MaterialTextureSampling

Amostragem de um binding de textura dentro de um slot de material.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.MaterialTextureSampling
```

Amostragem de um binding de textura dentro de um slot de material.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-edd02d15ae5af161) | Method |
| [Filter](#member-2eae30574d77bdf1) | Property |
| [Offset](#member-07dbab5e8afdd2b2) | Property |
| [RotationDegrees](#member-3e1f5d5b1533f0bd) | Property |
| [Scale](#member-f479d430c199011a) | Property |
| [UvSet](#member-3104227b56539443) | Property |
| [Wrap](#member-47bd0088c4082824) | Property |

<h3 id="member-edd02d15ae5af161" class="astra-member">.ctor</h3>

```csharp
public MaterialTextureSampling(Astra.Component component, uint slot, string binding)
```

Amostragem de um binding de textura dentro de um slot de material.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |
| `slot` | `uint` |  |
| `binding` | `string` |  |

<h3 id="member-2eae30574d77bdf1" class="astra-member">Filter</h3>

```csharp
public Astra.MaterialFilter Filter { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-07dbab5e8afdd2b2" class="astra-member">Offset</h3>

```csharp
public System.Numerics.Vector2 Offset { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e1f5d5b1533f0bd" class="astra-member">RotationDegrees</h3>

```csharp
public float RotationDegrees { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f479d430c199011a" class="astra-member">Scale</h3>

```csharp
public System.Numerics.Vector2 Scale { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3104227b56539443" class="astra-member">UvSet</h3>

```csharp
public Astra.MaterialUvSet UvSet { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47bd0088c4082824" class="astra-member">Wrap</h3>

```csharp
public Astra.MaterialWrap Wrap { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialToggle"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialtoggle/
---

# Astra.MaterialToggle

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialToggle
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Inherit](#member-470118e02c34a3fa) | Field |
| [Off](#member-40f2cbf977600f28) | Field |
| [On](#member-9610b802c97571a1) | Field |

<h3 id="member-470118e02c34a3fa" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-40f2cbf977600f28" class="astra-member">Off</h3>

```csharp
Off = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9610b802c97571a1" class="astra-member">On</h3>

```csharp
On = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialUvSet"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialuvset/
---

# Astra.MaterialUvSet

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialUvSet
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Inherit](#member-928fb3286238271c) | Field |
| [Uv0](#member-ee8027b7e81a74f1) | Field |
| [Uv1](#member-8e66564d8a3ebc89) | Field |
| [World](#member-444a4a35d2fedfc7) | Field |

<h3 id="member-928fb3286238271c" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee8027b7e81a74f1" class="astra-member">Uv0</h3>

```csharp
Uv0 = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8e66564d8a3ebc89" class="astra-member">Uv1</h3>

```csharp
Uv1 = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-444a4a35d2fedfc7" class="astra-member">World</h3>

```csharp
World = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.MaterialWrap"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-materialwrap/
---

# Astra.MaterialWrap

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MaterialWrap
```

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Clamp](#member-c0711fcd4a67267f) | Field |
| [Inherit](#member-f99e07eee7c3c7d9) | Field |
| [Mirror](#member-0b0adce1847fa882) | Field |
| [Repeat](#member-6d38bc1b51f5990a) | Field |

<h3 id="member-c0711fcd4a67267f" class="astra-member">Clamp</h3>

```csharp
Clamp = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f99e07eee7c3c7d9" class="astra-member">Inherit</h3>

```csharp
Inherit = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0b0adce1847fa882" class="astra-member">Mirror</h3>

```csharp
Mirror = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6d38bc1b51f5990a" class="astra-member">Repeat</h3>

```csharp
Repeat = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Mathf"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-mathf/
---

# Astra.Mathf

Gameplay math in radians, with explicit time and velocity state. Unity 6000.0 Mathf is the capability reference; Astra angles are radians.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Mathf
```

Gameplay math in radians, with explicit time and velocity state. Unity 6000.0 Mathf is the capability reference; Astra angles are radians.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Deg2Rad](#member-dc586558488d357e) | Field |
| [Pi](#member-29d6dba0bcabf7f6) | Field |
| [Rad2Deg](#member-5246aac3b0f86c7f) | Field |
| [Tau](#member-0c26b99d68e70c59) | Field |
| [Clamp](#member-d40c0e74580c046d) | Method |
| [Clamp01](#member-07f3cb4192659104) | Method |
| [Damp](#member-b778879194df5273) | Method |
| [DeltaAngle](#member-511aa0af53146c65) | Method |
| [InverseLerp](#member-e50134b90314df04) | Method |
| [Lerp](#member-0e9c29e0fe711e2f) | Method |
| [LerpAngle](#member-8c415462f511163e) | Method |
| [LerpUnclamped](#member-973ff3b432d3ed84) | Method |
| [MoveTowards](#member-c2e9f846c09daf81) | Method |
| [MoveTowardsAngle](#member-9dc0caaf558903d2) | Method |
| [PingPong](#member-2228464945c3275b) | Method |
| [Repeat](#member-bcebe4e4004bac40) | Method |
| [SmoothDamp](#member-72332faf605234a6) | Method |
| [SmoothDampAngle](#member-21375a26d575bf42) | Method |
| [SmoothStep](#member-76f3bd615018e3c2) | Method |

<h3 id="member-dc586558488d357e" class="astra-member">Deg2Rad</h3>

```csharp
public const float Deg2Rad = 0.017453292
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-29d6dba0bcabf7f6" class="astra-member">Pi</h3>

```csharp
public const float Pi = 3.1415927
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5246aac3b0f86c7f" class="astra-member">Rad2Deg</h3>

```csharp
public const float Rad2Deg = 57.295776
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0c26b99d68e70c59" class="astra-member">Tau</h3>

```csharp
public const float Tau = 6.2831855
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d40c0e74580c046d" class="astra-member">Clamp</h3>

```csharp
public static float Clamp(float value, float minimum, float maximum)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `float` |  |
| `minimum` | `float` |  |
| `maximum` | `float` |  |

<h3 id="member-07f3cb4192659104" class="astra-member">Clamp01</h3>

```csharp
public static float Clamp01(float value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `float` |  |

<h3 id="member-b778879194df5273" class="astra-member">Damp</h3>

```csharp
public static float Damp(float current, float target, float halfLifeSeconds, float deltaSeconds)
```

Frame-rate independent half-life damping. Zero half-life snaps to target.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Frame-rate independent half-life damping. Zero half-life snaps to target.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |
| `halfLifeSeconds` | `float` |  |
| `deltaSeconds` | `float` |  |

<h3 id="member-511aa0af53146c65" class="astra-member">DeltaAngle</h3>

```csharp
public static float DeltaAngle(float current, float target)
```

Signed shortest displacement in [-pi,pi], angles in radians.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Signed shortest displacement in [-pi,pi], angles in radians.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |

<h3 id="member-e50134b90314df04" class="astra-member">InverseLerp</h3>

```csharp
public static float InverseLerp(float from, float to, float value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `float` |  |
| `to` | `float` |  |
| `value` | `float` |  |

<h3 id="member-0e9c29e0fe711e2f" class="astra-member">Lerp</h3>

```csharp
public static float Lerp(float from, float to, float t)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `float` |  |
| `to` | `float` |  |
| `t` | `float` |  |

<h3 id="member-8c415462f511163e" class="astra-member">LerpAngle</h3>

```csharp
public static float LerpAngle(float from, float to, float t)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `float` |  |
| `to` | `float` |  |
| `t` | `float` |  |

<h3 id="member-973ff3b432d3ed84" class="astra-member">LerpUnclamped</h3>

```csharp
public static float LerpUnclamped(float from, float to, float t)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `float` |  |
| `to` | `float` |  |
| `t` | `float` |  |

<h3 id="member-c2e9f846c09daf81" class="astra-member">MoveTowards</h3>

```csharp
public static float MoveTowards(float current, float target, float maximumDelta)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |
| `maximumDelta` | `float` |  |

<h3 id="member-9dc0caaf558903d2" class="astra-member">MoveTowardsAngle</h3>

```csharp
public static float MoveTowardsAngle(float current, float target, float maximumDelta)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |
| `maximumDelta` | `float` |  |

<h3 id="member-2228464945c3275b" class="astra-member">PingPong</h3>

```csharp
public static float PingPong(float value, float length)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `float` |  |
| `length` | `float` |  |

<h3 id="member-bcebe4e4004bac40" class="astra-member">Repeat</h3>

```csharp
public static float Repeat(float value, float length)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `float` |  |
| `length` | `float` |  |

<h3 id="member-72332faf605234a6" class="astra-member">SmoothDamp</h3>

```csharp
public static float SmoothDamp(float current, float target, ref float velocity, float smoothSeconds, float deltaSeconds, float maximumSpeed = Infinity)
```

Critically damped spring. Velocity must be retained by the caller; no hidden global time. Zero delta leaves current value and velocity intact.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Critically damped spring. Velocity must be retained by the caller; no hidden global time. Zero delta leaves current value and velocity intact.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |
| `velocity` | `float` |  · Ref |
| `smoothSeconds` | `float` |  |
| `deltaSeconds` | `float` |  |
| `maximumSpeed` | `float` |  · Opcional: `Infinity` |

<h3 id="member-21375a26d575bf42" class="astra-member">SmoothDampAngle</h3>

```csharp
public static float SmoothDampAngle(float current, float target, ref float velocity, float smoothSeconds, float deltaSeconds, float maximumSpeed = Infinity)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `current` | `float` |  |
| `target` | `float` |  |
| `velocity` | `float` |  · Ref |
| `smoothSeconds` | `float` |  |
| `deltaSeconds` | `float` |  |
| `maximumSpeed` | `float` |  · Opcional: `Infinity` |

<h3 id="member-76f3bd615018e3c2" class="astra-member">SmoothStep</h3>

```csharp
public static float SmoothStep(float from, float to, float t)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `from` | `float` |  |
| `to` | `float` |  |
| `t` | `float` |  |


---

---
title: "Astra.MessageOptions"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-messageoptions/
---

# Astra.MessageOptions

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.MessageOptions
```

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DontRequireReceiver](#member-ee233950b60799f4) | Field |
| [RequireReceiver](#member-95b08902c4654917) | Field |

<h3 id="member-ee233950b60799f4" class="astra-member">DontRequireReceiver</h3>

```csharp
DontRequireReceiver = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-95b08902c4654917" class="astra-member">RequireReceiver</h3>

```csharp
RequireReceiver = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.NumberTween"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-numbertween/
---

# Astra.NumberTween

World-bound native track. Dispose releases its retained snapshot; terminal tracks otherwise count toward the 256-track limit.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.NumberTween
```

World-bound native track. Dispose releases its retained snapshot; terminal tracks otherwise count toward the 256-track limit.

**Interfaces:** `System.IDisposable`.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cancel](#member-14653b5f4df1bdb0) | Method |
| [Dispose](#member-f615895507dd6839) | Method |
| [Pause](#member-81f28f517f33d225) | Method |
| [Resume](#member-13332327143a17df) | Method |
| [Id](#member-ad8e32aace2d1cf6) | Property |
| [State](#member-82f1e54d424c5bc3) | Property |

<h3 id="member-14653b5f4df1bdb0" class="astra-member">Cancel</h3>

```csharp
public void Cancel()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f615895507dd6839" class="astra-member">Dispose</h3>

```csharp
public void Dispose()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-81f28f517f33d225" class="astra-member">Pause</h3>

```csharp
public void Pause()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-13332327143a17df" class="astra-member">Resume</h3>

```csharp
public void Resume()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ad8e32aace2d1cf6" class="astra-member">Id</h3>

```csharp
public ulong Id { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-82f1e54d424c5bc3" class="astra-member">State</h3>

```csharp
public Astra.NumberTweenState State { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.NumberTweenCreation"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-numbertweencreation/
---

# Astra.NumberTweenCreation

Class da API C# da Astra. 1 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.NumberTweenCreation
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [TweenFloat](#member-26c96bb86e59704f) | Method |

<h3 id="member-26c96bb86e59704f" class="astra-member">TweenFloat</h3>

```csharp
public static Astra.NumberTween TweenFloat(Astra.Component component, string propertyId, float destination, float duration, Astra.NumberTweenEasing easing = Astra.NumberTweenEasing.Linear, bool ignoreTimeScale = false)
```

Interpolates an explicitly eligible numeric PropertyId using the native session scheduler. Competing writers fail instead of silently overwriting.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Interpolates an explicitly eligible numeric PropertyId using the native session scheduler. Competing writers fail instead of silently overwriting.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |
| `propertyId` | `string` |  |
| `destination` | `float` |  |
| `duration` | `float` |  |
| `easing` | `Astra.NumberTweenEasing` |  · Opcional: `0` |
| `ignoreTimeScale` | `bool` |  · Opcional: `False` |


---

---
title: "Astra.NumberTweenEasing"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-numbertweeneasing/
---

# Astra.NumberTweenEasing

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.NumberTweenEasing
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Linear](#member-051304316ef95f4f) | Field |
| [QuadraticIn](#member-f23ab2493aa9db0c) | Field |
| [QuadraticOut](#member-491b11701bb35022) | Field |
| [Smoothstep](#member-3be8f71eefe652dd) | Field |

<h3 id="member-051304316ef95f4f" class="astra-member">Linear</h3>

```csharp
Linear = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f23ab2493aa9db0c" class="astra-member">QuadraticIn</h3>

```csharp
QuadraticIn = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-491b11701bb35022" class="astra-member">QuadraticOut</h3>

```csharp
QuadraticOut = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3be8f71eefe652dd" class="astra-member">Smoothstep</h3>

```csharp
Smoothstep = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.NumberTweenState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-numbertweenstate/
---

# Astra.NumberTweenState

Struct da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.NumberTweenState
```

**Interfaces:** `System.IEquatable<Astra.NumberTweenState>`.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-d86a51f9dafea036) | Method |
| [ActiveInHierarchy](#member-b2e34f3b3a124485) | Property |
| [DurationSeconds](#member-09216f5178295168) | Property |
| [ElapsedSeconds](#member-0189f0270015875d) | Property |
| [Enabled](#member-5b617a53a6a43b5e) | Property |
| [Failure](#member-87fbb9ad58e3ef67) | Property |
| [LastWrittenValue](#member-c66e13d1a5744fd3) | Property |
| [Paused](#member-45a4618b28969033) | Property |
| [Status](#member-2a833d236ac67ef9) | Property |

<h3 id="member-d86a51f9dafea036" class="astra-member">.ctor</h3>

```csharp
public NumberTweenState(Astra.NumberTweenStatus Status, Astra.WorldStatus Failure, double ElapsedSeconds, float LastWrittenValue, float DurationSeconds, bool Paused, bool ActiveInHierarchy, bool Enabled)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Status` | `Astra.NumberTweenStatus` |  |
| `Failure` | `Astra.WorldStatus` |  |
| `ElapsedSeconds` | `double` |  |
| `LastWrittenValue` | `float` |  |
| `DurationSeconds` | `float` |  |
| `Paused` | `bool` |  |
| `ActiveInHierarchy` | `bool` |  |
| `Enabled` | `bool` |  |

<h3 id="member-b2e34f3b3a124485" class="astra-member">ActiveInHierarchy</h3>

```csharp
public bool ActiveInHierarchy { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-09216f5178295168" class="astra-member">DurationSeconds</h3>

```csharp
public float DurationSeconds { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0189f0270015875d" class="astra-member">ElapsedSeconds</h3>

```csharp
public double ElapsedSeconds { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b617a53a6a43b5e" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-87fbb9ad58e3ef67" class="astra-member">Failure</h3>

```csharp
public Astra.WorldStatus Failure { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c66e13d1a5744fd3" class="astra-member">LastWrittenValue</h3>

```csharp
public float LastWrittenValue { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-45a4618b28969033" class="astra-member">Paused</h3>

```csharp
public bool Paused { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2a833d236ac67ef9" class="astra-member">Status</h3>

```csharp
public Astra.NumberTweenStatus Status { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.NumberTweenStatus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-numbertweenstatus/
---

# Astra.NumberTweenStatus

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.NumberTweenStatus
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cancelled](#member-081779b7b6705a0e) | Field |
| [Completed](#member-567119a35925b5b2) | Field |
| [Failed](#member-5220488ccaa49a60) | Field |
| [Running](#member-63fc9209eefd037b) | Field |

<h3 id="member-081779b7b6705a0e" class="astra-member">Cancelled</h3>

```csharp
Cancelled = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-567119a35925b5b2" class="astra-member">Completed</h3>

```csharp
Completed = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5220488ccaa49a60" class="astra-member">Failed</h3>

```csharp
Failed = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-63fc9209eefd037b" class="astra-member">Running</h3>

```csharp
Running = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ObjectReference"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-objectreference/
---

# Astra.ObjectReference

O ID autoral é persistido na cena. Referências obtidas em Play também guardam a sessão e a geração, para não apontarem para outro objeto após Stop/Play.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.ObjectReference
```

O ID autoral é persistido na cena. Referências obtidas em Play também guardam a sessão e a geração, para não apontarem para outro objeto após Stop/Play.

**Interfaces:** `System.IEquatable<Astra.ObjectReference>`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-807720d7e851b04d) | Method |
| [ObjectId](#member-f49190b07daeeae0) | Property |

<h3 id="member-807720d7e851b04d" class="astra-member">.ctor</h3>

```csharp
public ObjectReference(ulong ObjectId)
```

O ID autoral é persistido na cena. Referências obtidas em Play também guardam a sessão e a geração, para não apontarem para outro objeto após Stop/Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `ObjectId` | `ulong` |  |

<h3 id="member-f49190b07daeeae0" class="astra-member">ObjectId</h3>

```csharp
public ulong ObjectId { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PathFollower"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-pathfollower/
---

# Astra.PathFollower

Struct da API C# da Astra. 5 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.PathFollower
```

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-36a1fee6f1c717d5) | Method |
| [Restart](#member-5cda5332d192877b) | Method |
| [Stop](#member-5e0d3022ad826f13) | Method |
| [IsPlaying](#member-e79440033d67c9d4) | Property |
| [Progress](#member-364dfeff1fe462f1) | Property |

<h3 id="member-36a1fee6f1c717d5" class="astra-member">.ctor</h3>

```csharp
public PathFollower(Astra.Component component)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-5cda5332d192877b" class="astra-member">Restart</h3>

```csharp
public void Restart()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e0d3022ad826f13" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e79440033d67c9d4" class="astra-member">IsPlaying</h3>

```csharp
public bool IsPlaying { get; }
```

Playback request; may be blocked by a runtime diagnostic or held at an endpoint.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Playback request; may be blocked by a runtime diagnostic or held at an endpoint.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-364dfeff1fe462f1" class="astra-member">Progress</h3>

```csharp
public double Progress { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PathFrame"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-pathframe/
---

# Astra.PathFrame

Struct da API C# da Astra. 7 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PathFrame
```

**Interfaces:** `System.IEquatable<Astra.PathFrame>`.

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-3486101657083f82) | Method |
| [Length](#member-e11b5c4cc4ccf74e) | Property |
| [Position](#member-faab54d1abd6921a) | Property |
| [Right](#member-c22435c7743ba652) | Property |
| [RollDegrees](#member-49840e9d8780d2e2) | Property |
| [Tangent](#member-2df92e3d400d64e1) | Property |
| [Up](#member-338236b4497d4b78) | Property |

<h3 id="member-3486101657083f82" class="astra-member">.ctor</h3>

```csharp
public PathFrame(System.Numerics.Vector3 Position, System.Numerics.Vector3 Tangent, System.Numerics.Vector3 Up, float RollDegrees, double Length)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Position` | `System.Numerics.Vector3` |  |
| `Tangent` | `System.Numerics.Vector3` |  |
| `Up` | `System.Numerics.Vector3` |  |
| `RollDegrees` | `float` |  |
| `Length` | `double` |  |

<h3 id="member-e11b5c4cc4ccf74e" class="astra-member">Length</h3>

```csharp
public double Length { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-faab54d1abd6921a" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c22435c7743ba652" class="astra-member">Right</h3>

```csharp
public System.Numerics.Vector3 Right { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-49840e9d8780d2e2" class="astra-member">RollDegrees</h3>

```csharp
public float RollDegrees { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2df92e3d400d64e1" class="astra-member">Tangent</h3>

```csharp
public System.Numerics.Vector3 Tangent { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-338236b4497d4b78" class="astra-member">Up</h3>

```csharp
public System.Numerics.Vector3 Up { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PathSample"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-pathsample/
---

# Astra.PathSample

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PathSample
```

**Interfaces:** `System.IEquatable<Astra.PathSample>`.

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-d8bdee2ba8356ce0) | Method |
| [Length](#member-59b151ccc563d092) | Property |
| [Position](#member-c76fb6dbb50d7120) | Property |
| [Tangent](#member-12726d28380d146f) | Property |

<h3 id="member-d8bdee2ba8356ce0" class="astra-member">.ctor</h3>

```csharp
public PathSample(System.Numerics.Vector3 Position, System.Numerics.Vector3 Tangent, double Length)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Position` | `System.Numerics.Vector3` |  |
| `Tangent` | `System.Numerics.Vector3` |  |
| `Length` | `double` |  |

<h3 id="member-59b151ccc563d092" class="astra-member">Length</h3>

```csharp
public double Length { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c76fb6dbb50d7120" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-12726d28380d146f" class="astra-member">Tangent</h3>

```csharp
public System.Numerics.Vector3 Tangent { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Physics2DAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physics2daccess/
---

# Astra.Physics2DAccess

Independent XY solver access. Forces use N, impulse N.s, rotation degrees.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Physics2DAccess
```

Independent XY solver access. Forces use N, impulse N.s, rotation degrees.

## Onde acessar este tipo

No Behavior, use **Physics2D** para consultas ou a fachada Body2D/Collider2D do objeto. O plano é XY e os contratos de graus/radianos são explícitos.

## Roadmap e uso

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-2cce8accab415d1f) | Method |
| [Body](#member-cdb5f83d86d4fe21) | Method |
| [OverlapCircle](#member-a1ef72857d201199) | Method |
| [RayCast](#member-8e18a58b9966c36a) | Method |

<h3 id="member-2cce8accab415d1f" class="astra-member">.ctor</h3>

```csharp
public Physics2DAccess(Astra.ISceneAccess scene)
```

Independent XY solver access. Forces use N, impulse N.s, rotation degrees.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-cdb5f83d86d4fe21" class="astra-member">Body</h3>

```csharp
public Astra.Body2DAccess Body(Astra.GameObject owner)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |

<h3 id="member-a1ef72857d201199" class="astra-member">OverlapCircle</h3>

```csharp
public int OverlapCircle(System.Numerics.Vector2 center, float radius, System.Span<Astra.PhysicsHit2D> results, Astra.QueryFilter? filter = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `center` | `System.Numerics.Vector2` |  |
| `radius` | `float` |  |
| `results` | `System.Span&lt;Astra.PhysicsHit2D&gt;` |  |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |

<h3 id="member-8e18a58b9966c36a" class="astra-member">RayCast</h3>

```csharp
public int RayCast(System.Numerics.Vector2 origin, System.Numerics.Vector2 translation, System.Span<Astra.PhysicsHit2D> results, Astra.QueryFilter? filter = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `origin` | `System.Numerics.Vector2` |  |
| `translation` | `System.Numerics.Vector2` |  |
| `results` | `System.Span&lt;Astra.PhysicsHit2D&gt;` |  |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |


---

---
title: "Astra.PhysicsAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/
---

# Astra.PhysicsAccess

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.PhysicsAccess
```

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-5ccc1a314575d17a) | Method |
| [LayerByName](#member-3169ee1f77b51f0c) | Method |
| [LayerMask](#member-d4fd36fde986bdb8) | Method |
| [LayerName](#member-5b4e71a256d3fc0e) | Method |
| [Overlap](#member-6bc99104ec726482) | Method |
| [RayCast](#member-541b9f05853f498d) | Method |
| [RayCastAll](#member-4b701be1b9b461c7) | Method |
| [ShapeCast](#member-5d5fa04d28b36906) | Method |

<h3 id="member-5ccc1a314575d17a" class="astra-member">.ctor</h3>

```csharp
public PhysicsAccess(Astra.ISceneAccess scene)
```

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-3169ee1f77b51f0c" class="astra-member">LayerByName</h3>

```csharp
public int LayerByName(string name)
```

Índice da camada de gameplay com esse nome, ou -1.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Índice da camada de gameplay com esse nome, ou -1.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-d4fd36fde986bdb8" class="astra-member">LayerMask</h3>

```csharp
public uint LayerMask(params string[] names)
```

Máscara com apenas as camadas nomeadas informadas.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Máscara com apenas as camadas nomeadas informadas.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `names` | `string[]` |  |

<h3 id="member-5b4e71a256d3fc0e" class="astra-member">LayerName</h3>

```csharp
public string LayerName(int layer)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `layer` | `int` |  |

<h3 id="member-6bc99104ec726482" class="astra-member">Overlap</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<Astra.RayHit> Overlap(Astra.ShapeQuery shape, System.Numerics.Vector3 origin, out bool truncated, Astra.QueryFilter? filter = null, int capacity = 32)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `shape` | `Astra.ShapeQuery` |  |
| `origin` | `System.Numerics.Vector3` |  |
| `truncated` | `bool` |  · Out |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |
| `capacity` | `int` |  · Opcional: `32` |

<h3 id="member-541b9f05853f498d" class="astra-member">RayCast</h3>

```csharp
public Astra.RayHit? RayCast(System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, Astra.QueryFilter? filter = null)
```

O acerto mais próximo ao longo de direction, cujo comprimento é o alcance. Nulo quando nada foi acertado.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** O acerto mais próximo ao longo de direction, cujo comprimento é o alcance. Nulo quando nada foi acertado.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `origin` | `System.Numerics.Vector3` |  |
| `direction` | `System.Numerics.Vector3` |  |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |

<h3 id="member-4b701be1b9b461c7" class="astra-member">RayCastAll</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<Astra.RayHit> RayCastAll(System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, out bool truncated, Astra.QueryFilter? filter = null, int capacity = 32)
```

Todos os acertos, do mais próximo ao mais distante. Devolve a lista efetivamente copiada; truncated diz se havia mais acertos do que o buffer comportava.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Todos os acertos, do mais próximo ao mais distante. Devolve a lista efetivamente copiada; truncated diz se havia mais acertos do que o buffer comportava.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `origin` | `System.Numerics.Vector3` |  |
| `direction` | `System.Numerics.Vector3` |  |
| `truncated` | `bool` |  · Out |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |
| `capacity` | `int` |  · Opcional: `32` |

<h3 id="member-5d5fa04d28b36906" class="astra-member">ShapeCast</h3>

```csharp
public Astra.RayHit? ShapeCast(Astra.ShapeQuery shape, System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, Astra.QueryFilter? filter = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `shape` | `Astra.ShapeQuery` |  |
| `origin` | `System.Numerics.Vector3` |  |
| `direction` | `System.Numerics.Vector3` |  |
| `filter` | `Astra.QueryFilter?` |  · Opcional: `` |


---

---
title: "Astra.PhysicsBodyRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsbodyruntime/
---

# Astra.PhysicsBodyRuntime

Instance-bound access to the real native body. Recreating or removing the component invalidates this access; rebuilding its solver body preserves it.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.PhysicsBodyRuntime
```

Instance-bound access to the real native body. Recreating or removing the component invalidates this access; rebuilding its solver body preserves it.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AddAngularVelocityChange](#member-bf04fb846c153f72) | Method |
| [AddForceAtPosition](#member-1110430eb41973da) | Method |
| [AddImpulseAtPosition](#member-c2cdca63fc82f17e) | Method |
| [AddVelocityChange](#member-b494dc76763dcaf3) | Method |
| [GetPointVelocity](#member-898542d98fec33a1) | Method |
| [GetRelativePointVelocity](#member-9f5f534e8c3e2da7) | Method |
| [ReadState](#member-853b9986eaceb42d) | Method |
| [SetLinearAndAngularVelocity](#member-f03a0d235e422ef3) | Method |
| [Sleep](#member-d7d01a97d79fa596) | Method |
| [TryReadState](#member-a84978a8dd7b287d) | Method |
| [WakeUp](#member-2a6cc57a9b94fcdb) | Method |
| [AngularVelocity](#member-f1c942c7ec38c3eb) | Property |
| [CenterOfMass](#member-c6641435f7806390) | Property |
| [IsActive](#member-c27521330bc1b5da) | Property |
| [IsSleeping](#member-1d61ba8759e5366c) | Property |

<h3 id="member-bf04fb846c153f72" class="astra-member">AddAngularVelocityChange</h3>

```csharp
public void AddAngularVelocityChange(System.Numerics.Vector3 delta)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `delta` | `System.Numerics.Vector3` |  |

<h3 id="member-1110430eb41973da" class="astra-member">AddForceAtPosition</h3>

```csharp
public void AddForceAtPosition(System.Numerics.Vector3 force, System.Numerics.Vector3 worldPoint)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `force` | `System.Numerics.Vector3` |  |
| `worldPoint` | `System.Numerics.Vector3` |  |

<h3 id="member-c2cdca63fc82f17e" class="astra-member">AddImpulseAtPosition</h3>

```csharp
public void AddImpulseAtPosition(System.Numerics.Vector3 impulse, System.Numerics.Vector3 worldPoint)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `impulse` | `System.Numerics.Vector3` |  |
| `worldPoint` | `System.Numerics.Vector3` |  |

<h3 id="member-b494dc76763dcaf3" class="astra-member">AddVelocityChange</h3>

```csharp
public void AddVelocityChange(System.Numerics.Vector3 delta)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `delta` | `System.Numerics.Vector3` |  |

<h3 id="member-898542d98fec33a1" class="astra-member">GetPointVelocity</h3>

```csharp
public System.Numerics.Vector3 GetPointVelocity(System.Numerics.Vector3 worldPoint)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldPoint` | `System.Numerics.Vector3` |  |

<h3 id="member-9f5f534e8c3e2da7" class="astra-member">GetRelativePointVelocity</h3>

```csharp
public System.Numerics.Vector3 GetRelativePointVelocity(System.Numerics.Vector3 localPoint)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `localPoint` | `System.Numerics.Vector3` |  |

<h3 id="member-853b9986eaceb42d" class="astra-member">ReadState</h3>

```csharp
public Astra.PhysicsBodyState ReadState()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f03a0d235e422ef3" class="astra-member">SetLinearAndAngularVelocity</h3>

```csharp
public void SetLinearAndAngularVelocity(System.Numerics.Vector3 linear, System.Numerics.Vector3 angular)
```

Both velocities are published under one body lock, capped by its solver limits.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Both velocities are published under one body lock, capped by its solver limits.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `linear` | `System.Numerics.Vector3` |  |
| `angular` | `System.Numerics.Vector3` |  |

<h3 id="member-d7d01a97d79fa596" class="astra-member">Sleep</h3>

```csharp
public void Sleep()
```

Refuses static/kinematic bodies and bodies with AllowSleep false. Jolt sleep clears velocity; waking does not restore it.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Refuses static/kinematic bodies and bodies with AllowSleep false. Jolt sleep clears velocity; waking does not restore it.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a84978a8dd7b287d" class="astra-member">TryReadState</h3>

```csharp
public bool TryReadState(out Astra.PhysicsBodyState state)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `state` | `Astra.PhysicsBodyState` |  · Out |

<h3 id="member-2a6cc57a9b94fcdb" class="astra-member">WakeUp</h3>

```csharp
public void WakeUp()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f1c942c7ec38c3eb" class="astra-member">AngularVelocity</h3>

```csharp
public System.Numerics.Vector3 AngularVelocity { get; set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c6641435f7806390" class="astra-member">CenterOfMass</h3>

```csharp
public System.Numerics.Vector3 CenterOfMass { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c27521330bc1b5da" class="astra-member">IsActive</h3>

```csharp
public bool IsActive { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1d61ba8759e5366c" class="astra-member">IsSleeping</h3>

```csharp
public bool IsSleeping { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsBodyState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsbodystate/
---

# Astra.PhysicsBodyState

Observed solver state in world space. Angular velocity is rad/s. Runtime only: capturing this does not change the authored initial velocity.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PhysicsBodyState
```

Observed solver state in world space. Angular velocity is rad/s. Runtime only: capturing this does not change the authored initial velocity.

**Interfaces:** `System.IEquatable<Astra.PhysicsBodyState>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-d83f563850e7ddc7) | Method |
| [AngularVelocity](#member-4859358ae0265cc2) | Property |
| [CenterOfMass](#member-1c64d22633717003) | Property |
| [IsActive](#member-74c3b48788d5d73f) | Property |
| [IsSleeping](#member-fd2b049318a8cd74) | Property |
| [LinearVelocity](#member-286b6c844fc5c641) | Property |

<h3 id="member-d83f563850e7ddc7" class="astra-member">.ctor</h3>

```csharp
public PhysicsBodyState(System.Numerics.Vector3 LinearVelocity, System.Numerics.Vector3 AngularVelocity, System.Numerics.Vector3 CenterOfMass, bool IsActive, bool IsSleeping)
```

Observed solver state in world space. Angular velocity is rad/s. Runtime only: capturing this does not change the authored initial velocity.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `LinearVelocity` | `System.Numerics.Vector3` |  |
| `AngularVelocity` | `System.Numerics.Vector3` |  |
| `CenterOfMass` | `System.Numerics.Vector3` |  |
| `IsActive` | `bool` |  |
| `IsSleeping` | `bool` |  |

<h3 id="member-4859358ae0265cc2" class="astra-member">AngularVelocity</h3>

```csharp
public System.Numerics.Vector3 AngularVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1c64d22633717003" class="astra-member">CenterOfMass</h3>

```csharp
public System.Numerics.Vector3 CenterOfMass { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-74c3b48788d5d73f" class="astra-member">IsActive</h3>

```csharp
public bool IsActive { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd2b049318a8cd74" class="astra-member">IsSleeping</h3>

```csharp
public bool IsSleeping { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-286b6c844fc5c641" class="astra-member">LinearVelocity</h3>

```csharp
public System.Numerics.Vector3 LinearVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsField2DRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsfield2druntime/
---

# Astra.PhysicsField2DRuntime

Independent Box2D queries; expired worlds and removed components fail explicitly. Counts are current eligible dynamic bodies.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.PhysicsField2DRuntime
```

Independent Box2D queries; expired worlds and removed components fail explicitly. Counts are current eligible dynamic bodies.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Contains](#member-f11b3ead4ce017d1) | Method |
| [Sample](#member-7f79328221fa405d) | Method |
| [TrySample](#member-2618ca4e5f502daa) | Method |
| [AffectedBodyCount](#member-4553e087e4a5b366) | Property |
| [AffectedMass](#member-aa12d3d9fd14811a) | Property |

<h3 id="member-f11b3ead4ce017d1" class="astra-member">Contains</h3>

```csharp
public bool Contains(System.Numerics.Vector2 point)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector2` |  |

<h3 id="member-7f79328221fa405d" class="astra-member">Sample</h3>

```csharp
public Astra.PhysicsFieldSample2D Sample(System.Numerics.Vector2 point, uint layer = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector2` |  |
| `layer` | `uint` |  · Opcional: `0` |

<h3 id="member-2618ca4e5f502daa" class="astra-member">TrySample</h3>

```csharp
public bool TrySample(System.Numerics.Vector2 point, uint layer, out Astra.PhysicsFieldSample2D sample)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `point` | `System.Numerics.Vector2` |  |
| `layer` | `uint` |  |
| `sample` | `Astra.PhysicsFieldSample2D` |  · Out |

<h3 id="member-4553e087e4a5b366" class="astra-member">AffectedBodyCount</h3>

```csharp
public uint AffectedBodyCount { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa12d3d9fd14811a" class="astra-member">AffectedMass</h3>

```csharp
public float AffectedMass { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsFieldRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsfieldruntime/
---

# Astra.PhysicsFieldRuntime

Queries share the exact evaluator used by the native solver. Removed components and expired worlds are rejected; disabled fields can be inspected but return zero influence. Counts include dynamic bodies eligible now, respecting layer and WakeBodies. Queries require a running physics session.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.PhysicsFieldRuntime
```

Queries share the exact evaluator used by the native solver. Removed components and expired worlds are rejected; disabled fields can be inspected but return zero influence. Counts include dynamic bodies eligible now, respecting layer and WakeBodies. Queries require a running physics session.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Contains](#member-3c33df8325f38063) | Method |
| [Sample](#member-6ba06d81b0687bcf) | Method |
| [TrySample](#member-7d8dd9e453793cec) | Method |
| [AffectedBodyCount](#member-265a76f28de043ec) | Property |
| [AffectedMass](#member-3d6f26751eff7114) | Property |

<h3 id="member-3c33df8325f38063" class="astra-member">Contains</h3>

```csharp
public bool Contains(System.Numerics.Vector3 worldPoint)
```

Geometric containment, independent of Enabled and layer filters.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Geometric containment, independent of Enabled and layer filters.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldPoint` | `System.Numerics.Vector3` |  |

<h3 id="member-6ba06d81b0687bcf" class="astra-member">Sample</h3>

```csharp
public Astra.PhysicsFieldSample Sample(System.Numerics.Vector3 worldPoint, uint layer = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldPoint` | `System.Numerics.Vector3` |  |
| `layer` | `uint` |  · Opcional: `0` |

<h3 id="member-7d8dd9e453793cec" class="astra-member">TrySample</h3>

```csharp
public bool TrySample(System.Numerics.Vector3 worldPoint, uint layer, out Astra.PhysicsFieldSample sample)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldPoint` | `System.Numerics.Vector3` |  |
| `layer` | `uint` |  |
| `sample` | `Astra.PhysicsFieldSample` |  · Out |

<h3 id="member-265a76f28de043ec" class="astra-member">AffectedBodyCount</h3>

```csharp
public uint AffectedBodyCount { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d6f26751eff7114" class="astra-member">AffectedMass</h3>

```csharp
public float AffectedMass { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsFieldSample"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsfieldsample/
---

# Astra.PhysicsFieldSample

Current field response at a world point. Wind drag is kg/s; linear/angular drag are exponential rates per second. Acceleration is m/s². Membership is evaluated at solver centers of mass, not collider surfaces.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PhysicsFieldSample
```

Current field response at a world point. Wind drag is kg/s; linear/angular drag are exponential rates per second. Acceleration is m/s². Membership is evaluated at solver centers of mass, not collider surfaces.

**Interfaces:** `System.IEquatable<Astra.PhysicsFieldSample>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-71cb5b659959fd5c) | Method |
| [Acceleration](#member-e0149b240784b302) | Property |
| [AffectedBodies](#member-bc788a5cafe9382f) | Property |
| [AffectedMass](#member-e0d467d2da037512) | Property |
| [AngularDrag](#member-20dbc5a6b9a66720) | Property |
| [ContainsPoint](#member-d1027f58b26589b2) | Property |
| [IsEnabled](#member-93fcd3fb68c2a781) | Property |
| [LinearDrag](#member-19e5dfb79b622eb8) | Property |
| [Weight](#member-22a95808753fa4c3) | Property |
| [WindDrag](#member-b500cab4b8f8f15d) | Property |
| [WindVelocity](#member-8d2f997ca4735053) | Property |
| [WorldGravityReplacement](#member-50eadeb841322581) | Property |

<h3 id="member-71cb5b659959fd5c" class="astra-member">.ctor</h3>

```csharp
public PhysicsFieldSample(bool ContainsPoint, bool IsEnabled, float Weight, System.Numerics.Vector3 Acceleration, System.Numerics.Vector3 WindVelocity, float WindDrag, float LinearDrag, float AngularDrag, float WorldGravityReplacement, uint AffectedBodies, float AffectedMass)
```

Current field response at a world point. Wind drag is kg/s; linear/angular drag are exponential rates per second. Acceleration is m/s². Membership is evaluated at solver centers of mass, not collider surfaces.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `ContainsPoint` | `bool` |  |
| `IsEnabled` | `bool` |  |
| `Weight` | `float` |  |
| `Acceleration` | `System.Numerics.Vector3` |  |
| `WindVelocity` | `System.Numerics.Vector3` |  |
| `WindDrag` | `float` |  |
| `LinearDrag` | `float` |  |
| `AngularDrag` | `float` |  |
| `WorldGravityReplacement` | `float` |  |
| `AffectedBodies` | `uint` |  |
| `AffectedMass` | `float` |  |

<h3 id="member-e0149b240784b302" class="astra-member">Acceleration</h3>

```csharp
public System.Numerics.Vector3 Acceleration { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bc788a5cafe9382f" class="astra-member">AffectedBodies</h3>

```csharp
public uint AffectedBodies { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e0d467d2da037512" class="astra-member">AffectedMass</h3>

```csharp
public float AffectedMass { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-20dbc5a6b9a66720" class="astra-member">AngularDrag</h3>

```csharp
public float AngularDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1027f58b26589b2" class="astra-member">ContainsPoint</h3>

```csharp
public bool ContainsPoint { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-93fcd3fb68c2a781" class="astra-member">IsEnabled</h3>

```csharp
public bool IsEnabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-19e5dfb79b622eb8" class="astra-member">LinearDrag</h3>

```csharp
public float LinearDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-22a95808753fa4c3" class="astra-member">Weight</h3>

```csharp
public float Weight { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b500cab4b8f8f15d" class="astra-member">WindDrag</h3>

```csharp
public float WindDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d2f997ca4735053" class="astra-member">WindVelocity</h3>

```csharp
public System.Numerics.Vector3 WindVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50eadeb841322581" class="astra-member">WorldGravityReplacement</h3>

```csharp
public float WorldGravityReplacement { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsFieldSample2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicsfieldsample2d/
---

# Astra.PhysicsFieldSample2D

XY sample from the same evaluator consumed by Box2D. Wind drag is kg/s; damping rates are per second. Centers of mass define membership.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PhysicsFieldSample2D
```

XY sample from the same evaluator consumed by Box2D. Wind drag is kg/s; damping rates are per second. Centers of mass define membership.

**Interfaces:** `System.IEquatable<Astra.PhysicsFieldSample2D>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-cc1ac36a9933dc69) | Method |
| [Acceleration](#member-1b9f7aa6c22c0d73) | Property |
| [AffectedBodies](#member-14194d096d5b875a) | Property |
| [AffectedMass](#member-e9bd08ff1a1377f0) | Property |
| [AngularDrag](#member-e81ec6528811130c) | Property |
| [ContainsPoint](#member-4d6d89048786d0cc) | Property |
| [IsEnabled](#member-9fafb4c460eaeebc) | Property |
| [LinearDrag](#member-3e28d07b8e1beb39) | Property |
| [Weight](#member-8d57b26632e4df8a) | Property |
| [WindDrag](#member-700fc38d77e82f92) | Property |
| [WindVelocity](#member-aaf59a92f1f8fd66) | Property |
| [WorldGravityReplacement](#member-232f4caf61280f63) | Property |

<h3 id="member-cc1ac36a9933dc69" class="astra-member">.ctor</h3>

```csharp
public PhysicsFieldSample2D(bool ContainsPoint, bool IsEnabled, float Weight, System.Numerics.Vector2 Acceleration, System.Numerics.Vector2 WindVelocity, float WindDrag, float LinearDrag, float AngularDrag, float WorldGravityReplacement, uint AffectedBodies, float AffectedMass)
```

XY sample from the same evaluator consumed by Box2D. Wind drag is kg/s; damping rates are per second. Centers of mass define membership.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `ContainsPoint` | `bool` |  |
| `IsEnabled` | `bool` |  |
| `Weight` | `float` |  |
| `Acceleration` | `System.Numerics.Vector2` |  |
| `WindVelocity` | `System.Numerics.Vector2` |  |
| `WindDrag` | `float` |  |
| `LinearDrag` | `float` |  |
| `AngularDrag` | `float` |  |
| `WorldGravityReplacement` | `float` |  |
| `AffectedBodies` | `uint` |  |
| `AffectedMass` | `float` |  |

<h3 id="member-1b9f7aa6c22c0d73" class="astra-member">Acceleration</h3>

```csharp
public System.Numerics.Vector2 Acceleration { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-14194d096d5b875a" class="astra-member">AffectedBodies</h3>

```csharp
public uint AffectedBodies { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e9bd08ff1a1377f0" class="astra-member">AffectedMass</h3>

```csharp
public float AffectedMass { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e81ec6528811130c" class="astra-member">AngularDrag</h3>

```csharp
public float AngularDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d6d89048786d0cc" class="astra-member">ContainsPoint</h3>

```csharp
public bool ContainsPoint { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9fafb4c460eaeebc" class="astra-member">IsEnabled</h3>

```csharp
public bool IsEnabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3e28d07b8e1beb39" class="astra-member">LinearDrag</h3>

```csharp
public float LinearDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d57b26632e4df8a" class="astra-member">Weight</h3>

```csharp
public float Weight { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-700fc38d77e82f92" class="astra-member">WindDrag</h3>

```csharp
public float WindDrag { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aaf59a92f1f8fd66" class="astra-member">WindVelocity</h3>

```csharp
public System.Numerics.Vector2 WindVelocity { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-232f4caf61280f63" class="astra-member">WorldGravityReplacement</h3>

```csharp
public float WorldGravityReplacement { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PhysicsHit2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-physicshit2d/
---

# Astra.PhysicsHit2D

Struct da API C# da Astra. 8 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.PhysicsHit2D
```

**Interfaces:** `System.IEquatable<Astra.PhysicsHit2D>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-412901ed5b1b837f) | Method |
| [ColliderInstance](#member-f86387ee8fca29b5) | Property |
| [Distance](#member-53605afad26ca3c5) | Property |
| [Fraction](#member-ee5fc8a58ac759a9) | Property |
| [IsSensor](#member-54a5cf4ad155264e) | Property |
| [Normal](#member-858219492a4b8aa0) | Property |
| [Object](#member-ee5dd043e78d5b63) | Property |
| [Point](#member-472b9c23c6c4f1d5) | Property |

<h3 id="member-412901ed5b1b837f" class="astra-member">.ctor</h3>

```csharp
public PhysicsHit2D(Astra.GameObject Object, ulong ColliderInstance, System.Numerics.Vector2 Point, System.Numerics.Vector2? Normal, float Distance, float Fraction, bool IsSensor)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Object` | `Astra.GameObject` |  |
| `ColliderInstance` | `ulong` |  |
| `Point` | `System.Numerics.Vector2` |  |
| `Normal` | `System.Numerics.Vector2?` |  |
| `Distance` | `float` |  |
| `Fraction` | `float` |  |
| `IsSensor` | `bool` |  |

<h3 id="member-f86387ee8fca29b5" class="astra-member">ColliderInstance</h3>

```csharp
public ulong ColliderInstance { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53605afad26ca3c5" class="astra-member">Distance</h3>

```csharp
public float Distance { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee5fc8a58ac759a9" class="astra-member">Fraction</h3>

```csharp
public float Fraction { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-54a5cf4ad155264e" class="astra-member">IsSensor</h3>

```csharp
public bool IsSensor { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-858219492a4b8aa0" class="astra-member">Normal</h3>

```csharp
public System.Numerics.Vector2? Normal { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee5dd043e78d5b63" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-472b9c23c6c4f1d5" class="astra-member">Point</h3>

```csharp
public System.Numerics.Vector2 Point { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PrimitiveType"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-primitivetype/
---

# Astra.PrimitiveType

Built-in geometry and its collision shape. Cylinder uses a convex 32-sided mesh.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.PrimitiveType
```

Built-in geometry and its collision shape. Cylinder uses a convex 32-sided mesh.

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Capsule](#member-cc4d20f676dadb10) | Field |
| [Cube](#member-72dc6d8ecc85b69f) | Field |
| [Cylinder](#member-d16f5fd73a0a9c17) | Field |
| [Plane](#member-38ebe3f8dbe34846) | Field |
| [Quad](#member-e1f85def18e6beb5) | Field |
| [Sphere](#member-7c0654f1c35757af) | Field |

<h3 id="member-cc4d20f676dadb10" class="astra-member">Capsule</h3>

```csharp
Capsule = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-72dc6d8ecc85b69f" class="astra-member">Cube</h3>

```csharp
Cube = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d16f5fd73a0a9c17" class="astra-member">Cylinder</h3>

```csharp
Cylinder = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-38ebe3f8dbe34846" class="astra-member">Plane</h3>

```csharp
Plane = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1f85def18e6beb5" class="astra-member">Quad</h3>

```csharp
Quad = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c0654f1c35757af" class="astra-member">Sphere</h3>

```csharp
Sphere = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.PropertyIdAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-propertyidattribute/
---

# Astra.PropertyIdAttribute

Class da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.PropertyIdAttribute
```

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ebc787e5875f5a0d) | Method |
| [Id](#member-8608a17f9fed0306) | Property |

<h3 id="member-ebc787e5875f5a0d" class="astra-member">.ctor</h3>

```csharp
public PropertyIdAttribute(string id)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `string` |  |

<h3 id="member-8608a17f9fed0306" class="astra-member">Id</h3>

```csharp
public string Id { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.QueryFilter"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-queryfilter/
---

# Astra.QueryFilter

Como a consulta escolhe o que pode acertar.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.QueryFilter
```

Como a consulta escolhe o que pode acertar.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Ignore](#member-671bb7caa3a110d0) | Field |
| [IncludeDynamic](#member-47b4477f6b916873) | Field |
| [IncludeSensors](#member-dd3cbab914c0ac44) | Field |
| [IncludeStatic](#member-9b5f8ff815572efa) | Field |
| [LayerMask](#member-136a865f9e697396) | Field |
| [Ignoring](#member-7cc51421846e2cb9) | Method |
| [OnlyLayers](#member-5e45068bb64ac5ff) | Method |
| [Default](#member-410c0cc9b5e4d233) | Property |

<h3 id="member-671bb7caa3a110d0" class="astra-member">Ignore</h3>

```csharp
public ulong Ignore
```

Objeto que não deve ser acertado — normalmente quem consulta.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Objeto que não deve ser acertado — normalmente quem consulta.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-47b4477f6b916873" class="astra-member">IncludeDynamic</h3>

```csharp
public bool IncludeDynamic
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-dd3cbab914c0ac44" class="astra-member">IncludeSensors</h3>

```csharp
public bool IncludeSensors
```

Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9b5f8ff815572efa" class="astra-member">IncludeStatic</h3>

```csharp
public bool IncludeStatic
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-136a865f9e697396" class="astra-member">LayerMask</h3>

```csharp
public uint LayerMask
```

Bit por camada de gameplay (0..31).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Bit por camada de gameplay (0..31).

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7cc51421846e2cb9" class="astra-member">Ignoring</h3>

```csharp
public Astra.QueryFilter Ignoring(Astra.GameObject self)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `self` | `Astra.GameObject` |  |

<h3 id="member-5e45068bb64ac5ff" class="astra-member">OnlyLayers</h3>

```csharp
public Astra.QueryFilter OnlyLayers(params int[] layers)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `layers` | `int[]` |  |

<h3 id="member-410c0cc9b5e4d233" class="astra-member">Default</h3>

```csharp
public static Astra.QueryFilter Default { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.QueryShapeKind"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-queryshapekind/
---

# Astra.QueryShapeKind

Enum da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.QueryShapeKind
```

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Box](#member-9ac1cae8f8029908) | Field |
| [Capsule](#member-b142b2241aa2fd74) | Field |
| [Cylinder](#member-852fd703839d5e0c) | Field |
| [Sphere](#member-5b83639f6d3d970b) | Field |

<h3 id="member-9ac1cae8f8029908" class="astra-member">Box</h3>

```csharp
Box = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b142b2241aa2fd74" class="astra-member">Capsule</h3>

```csharp
Capsule = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-852fd703839d5e0c" class="astra-member">Cylinder</h3>

```csharp
Cylinder = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b83639f6d3d970b" class="astra-member">Sphere</h3>

```csharp
Sphere = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.RandomStream"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-randomstream/
---

# Astra.RandomStream

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.RandomStream
```

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AlgorithmVersion](#member-de04a41c77e88a4f) | Field |
| [.ctor](#member-2ad2517ba4e94a54) | Method |
| [Capture](#member-511ad835fc7e3d3e) | Method |
| [Gaussian](#member-fd094caa4fc3b157) | Method |
| [InsideUnitCircle](#member-1ded7820dcc953f4) | Method |
| [InsideUnitSphere](#member-d5dd4d8bff658464) | Method |
| [NextUInt](#member-e90e46273ad4d428) | Method |
| [OnUnitSphere](#member-4f4b135cf72e14e5) | Method |
| [Range](#member-09d390b5118a33cd) | Method |
| [Range](#member-461f46493bff97fe) | Method |
| [Restore](#member-36a80a94d87bb21a) | Method |
| [Shuffle](#member-4254ee5a07041f3a) | Method |
| [Value](#member-947e53959b3d6d3d) | Property |

<h3 id="member-de04a41c77e88a4f" class="astra-member">AlgorithmVersion</h3>

```csharp
public const uint AlgorithmVersion = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ad2517ba4e94a54" class="astra-member">.ctor</h3>

```csharp
public RandomStream(ulong seed, ulong stream = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seed` | `ulong` |  |
| `stream` | `ulong` |  · Opcional: `0` |

<h3 id="member-511ad835fc7e3d3e" class="astra-member">Capture</h3>

```csharp
public Astra.RandomStream.Snapshot Capture()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd094caa4fc3b157" class="astra-member">Gaussian</h3>

```csharp
public float Gaussian(float mean = 0, float standardDeviation = 1)
```

Normal distribution using Box-Muller; zero deviation returns the mean.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Normal distribution using Box-Muller; zero deviation returns the mean.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `mean` | `float` |  · Opcional: `0` |
| `standardDeviation` | `float` |  · Opcional: `1` |

<h3 id="member-1ded7820dcc953f4" class="astra-member">InsideUnitCircle</h3>

```csharp
public System.Numerics.Vector2 InsideUnitCircle()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d5dd4d8bff658464" class="astra-member">InsideUnitSphere</h3>

```csharp
public System.Numerics.Vector3 InsideUnitSphere()
```

Uniform volume distribution, not a uniform radius.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Uniform volume distribution, not a uniform radius.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e90e46273ad4d428" class="astra-member">NextUInt</h3>

```csharp
public uint NextUInt()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f4b135cf72e14e5" class="astra-member">OnUnitSphere</h3>

```csharp
public System.Numerics.Vector3 OnUnitSphere()
```

Uniform direction on the unit sphere (no rejection loop).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Uniform direction on the unit sphere (no rejection loop).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-09d390b5118a33cd" class="astra-member">Range</h3>

```csharp
public int Range(int minimumInclusive, int maximumExclusive)
```

Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `minimumInclusive` | `int` |  |
| `maximumExclusive` | `int` |  |

<h3 id="member-461f46493bff97fe" class="astra-member">Range</h3>

```csharp
public float Range(float minimumInclusive, float maximumExclusive)
```

Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `minimumInclusive` | `float` |  |
| `maximumExclusive` | `float` |  |

<h3 id="member-36a80a94d87bb21a" class="astra-member">Restore</h3>

```csharp
public void Restore(Astra.RandomStream.Snapshot snapshot)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `snapshot` | `Astra.RandomStream.Snapshot` |  |

<h3 id="member-4254ee5a07041f3a" class="astra-member">Shuffle</h3>

```csharp
public void Shuffle<T>(System.Span<T> values)
```

Fisher-Yates shuffle, unbiased bounded indices.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Fisher-Yates shuffle, unbiased bounded indices.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `values` | `System.Span&lt;T&gt;` |  |

<h3 id="member-947e53959b3d6d3d" class="astra-member">Value</h3>

```csharp
public float Value { get; }
```

Uniform [0,1), using 24 random bits exactly representable by float.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Uniform [0,1), using 24 random bits exactly representable by float.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.RandomStream.Snapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-randomstream-snapshot/
---

# Astra.RandomStream.Snapshot

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.RandomStream.Snapshot
```

**Interfaces:** `System.IEquatable<Astra.RandomStream.Snapshot>`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-f7ff871706d64711) | Method |
| [Increment](#member-e53593e4ea625c17) | Property |
| [State](#member-5017e0d75527e44b) | Property |
| [Version](#member-b63d6cfd42aed2d0) | Property |

<h3 id="member-f7ff871706d64711" class="astra-member">.ctor</h3>

```csharp
public Snapshot(uint Version, ulong State, ulong Increment)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Version` | `uint` |  |
| `State` | `ulong` |  |
| `Increment` | `ulong` |  |

<h3 id="member-e53593e4ea625c17" class="astra-member">Increment</h3>

```csharp
public ulong Increment { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5017e0d75527e44b" class="astra-member">State</h3>

```csharp
public ulong State { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b63d6cfd42aed2d0" class="astra-member">Version</h3>

```csharp
public uint Version { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.Ray"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-ray/
---

# Astra.Ray

Raio no mundo: origem e direção normalizada.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.Ray
```

Raio no mundo: origem e direção normalizada.

**Interfaces:** `System.IEquatable<Astra.Ray>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-9e90822cd4634dae) | Method |
| [GetPoint](#member-526a938f482c90ad) | Method |
| [Direction](#member-46b54a8f206669cd) | Property |
| [Origin](#member-3f2d911d2d7b456e) | Property |

<h3 id="member-9e90822cd4634dae" class="astra-member">.ctor</h3>

```csharp
public Ray(System.Numerics.Vector3 Origin, System.Numerics.Vector3 Direction)
```

Raio no mundo: origem e direção normalizada.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Origin` | `System.Numerics.Vector3` |  |
| `Direction` | `System.Numerics.Vector3` |  |

<h3 id="member-526a938f482c90ad" class="astra-member">GetPoint</h3>

```csharp
public System.Numerics.Vector3 GetPoint(float distance)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `distance` | `float` |  |

<h3 id="member-46b54a8f206669cd" class="astra-member">Direction</h3>

```csharp
public System.Numerics.Vector3 Direction { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f2d911d2d7b456e" class="astra-member">Origin</h3>

```csharp
public System.Numerics.Vector3 Origin { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.RayHit"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-rayhit/
---

# Astra.RayHit

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.RayHit
```

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

**Interfaces:** `System.IEquatable<Astra.RayHit>`.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-577b60f91b37a943) | Method |
| [BodyObject](#member-47ccfa40977d7da1) | Property |
| [Collider](#member-4ec550f699e74410) | Property |
| [ColliderInstance](#member-151be7a78a3a83b4) | Property |
| [ColliderObject](#member-db8ac536cf45f84a) | Property |
| [Distance](#member-58031998abadddfb) | Property |
| [Fraction](#member-cb209ef1929e90fb) | Property |
| [IsSensor](#member-6f74ec761464da8a) | Property |
| [Normal](#member-81723e0c0b454b8b) | Property |
| [Object](#member-693a80b141d715da) | Property |
| [Point](#member-8b611c5365fc7712) | Property |

<h3 id="member-577b60f91b37a943" class="astra-member">.ctor</h3>

```csharp
public RayHit(Astra.GameObject Object, ulong ColliderInstance, System.Numerics.Vector3 Point, System.Numerics.Vector3? Normal, float Distance, float Fraction, bool IsSensor)
```

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Object` | `Astra.GameObject` |  |
| `ColliderInstance` | `ulong` |  |
| `Point` | `System.Numerics.Vector3` |  |
| `Normal` | `System.Numerics.Vector3?` |  |
| `Distance` | `float` |  |
| `Fraction` | `float` |  |
| `IsSensor` | `bool` |  |

<h3 id="member-47ccfa40977d7da1" class="astra-member">BodyObject</h3>

```csharp
public Astra.GameObject BodyObject { get; }
```

The Body owner, retained by Object for source compatibility.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** The Body owner, retained by Object for source compatibility.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4ec550f699e74410" class="astra-member">Collider</h3>

```csharp
public Astra.Components.Collider? Collider { get; }
```

Resolve this exact 3D Collider, never another local instance on the Body. Null after removal, object destruction or world expiration.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Resolve this exact 3D Collider, never another local instance on the Body. Null after removal, object destruction or world expiration.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-151be7a78a3a83b4" class="astra-member">ColliderInstance</h3>

```csharp
public ulong ColliderInstance { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-db8ac536cf45f84a" class="astra-member">ColliderObject</h3>

```csharp
public Astra.GameObject? ColliderObject { get; init; }
```

The authored Collider owner; null when the backend has no shape identity.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** The authored Collider owner; null when the backend has no shape identity.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-58031998abadddfb" class="astra-member">Distance</h3>

```csharp
public float Distance { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb209ef1929e90fb" class="astra-member">Fraction</h3>

```csharp
public float Fraction { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f74ec761464da8a" class="astra-member">IsSensor</h3>

```csharp
public bool IsSensor { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-81723e0c0b454b8b" class="astra-member">Normal</h3>

```csharp
public System.Numerics.Vector3? Normal { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-693a80b141d715da" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8b611c5365fc7712" class="astra-member">Point</h3>

```csharp
public System.Numerics.Vector3 Point { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ReparentPosePolicy"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-reparentposepolicy/
---

# Astra.ReparentPosePolicy

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.ReparentPosePolicy
```

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [KeepLocal](#member-430fc0d322b4d554) | Field |
| [KeepWorld](#member-96585ceffe61a328) | Field |

<h3 id="member-430fc0d322b4d554" class="astra-member">KeepLocal</h3>

```csharp
KeepLocal = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-96585ceffe61a328" class="astra-member">KeepWorld</h3>

```csharp
KeepWorld = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ResolvedGraphicsSettings"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-resolvedgraphicssettings/
---

# Astra.ResolvedGraphicsSettings

Struct da API C# da Astra. 67 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.ResolvedGraphicsSettings
```

## Onde acessar este tipo

Use este tipo no código C# do projeto, pela declaração abaixo. Ele não corresponde automaticamente a um botão ou componente no editor. Confira construtor, static e tipo de retorno antes de criar/obter uma instância.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [AmbientHemispheric](#member-939c00ed3f321b32) | Field |
| [AmbientSpecularProbe](#member-30470d1867f2fafb) | Field |
| [AmbientSplitSumBrdf](#member-ae8200c2da15242d) | Field |
| [AntiAliasing](#member-a01e90c195712ef4) | Field |
| [BloomIntensity](#member-86d1c0b800dc3c3d) | Field |
| [BloomThreshold](#member-a4e952f7a876c81f) | Field |
| [ClampCount](#member-8c03fa015a8ee7f6) | Field |
| [CompositorReserveMs](#member-10f291f36419a93f) | Field |
| [CoverageLodPixelErrorBudget](#member-92a5b29565b3be60) | Field |
| [CpuLaneBudgetMs](#member-402589139f47c46e) | Field |
| [DynamicResolutionDecreaseStep](#member-ed35f5fd7efde689) | Field |
| [DynamicResolutionEnabled](#member-52514ba1001fb778) | Field |
| [DynamicResolutionIncreaseStep](#member-f202e56a2a95a0d1) | Field |
| [DynamicResolutionMaximumScale](#member-1781ff9cb9ce0ac9) | Field |
| [DynamicResolutionMinimumScale](#member-a8b08833e366607c) | Field |
| [DynamicResolutionOverloadFrames](#member-b861abca6983a34c) | Field |
| [DynamicResolutionRecoveryFrames](#member-e1edf3a6ece8ad9c) | Field |
| [DynamicResolutionRecoveryHeadroomRatio](#member-0e8fb939b9c0064b) | Field |
| [EffectiveProfile](#member-a764f0914b378a94) | Field |
| [EmissiveMaximumDistance](#member-92c4e5d1c7b5fa43) | Field |
| [FrameIntervalMs](#member-03fa0df85cce1194) | Field |
| [GpuLaneBudgetMs](#member-29cb23a1b136ae99) | Field |
| [HzbHysteresisFrames](#member-49c88bb754fcdfc9) | Field |
| [HzbMinimumCandidateDraws](#member-24656cba043f7894) | Field |
| [HzbNormalizedDepthBias](#member-1db6350d4c125854) | Field |
| [LodHysteresisBandRatio](#member-aa59ef0f4550dbf2) | Field |
| [LodPixelErrorBudget](#member-b6beaf6d5a380b58) | Field |
| [LodSelection](#member-bfe3ddab4da69f88) | Field |
| [MaterialDetailFadeBandRatio](#member-978e5c730c70d7c4) | Field |
| [MaterialShaderVariants](#member-d50d083f6763c044) | Field |
| [MetallicRoughnessMaximumDistance](#member-7c66bff1ba9428b8) | Field |
| [NormalMapMaximumDistance](#member-ae61b5daf80064ce) | Field |
| [PostBloom](#member-5d2ab9ad194ca861) | Field |
| [PostContrast](#member-0499424b49fc5885) | Field |
| [PostDedicatedPass](#member-f107741c0de76bfe) | Field |
| [PostSaturation](#member-95d6953bf03a03f2) | Field |
| [PostSharpen](#member-5759a61de5f9a66f) | Field |
| [PostVignette](#member-bb9b7376c69c19f9) | Field |
| [RenderHz](#member-928d4837a86e30f3) | Field |
| [ResolutionScale](#member-0b2f6395ce05b925) | Field |
| [SamplerAnisotropy](#member-aa111a571949ab45) | Field |
| [ShadowCacheGuardBandRatio](#member-a824072c0ff1ced6) | Field |
| [ShadowCascadeBlendRatio](#member-71ebcd265d755425) | Field |
| [ShadowCascadeCount](#member-15420af385811ab0) | Field |
| [ShadowCascadeResolution](#member-a9171fa9c64c269f) | Field |
| [ShadowDepthBiasConstant](#member-a15aba535c98c9e5) | Field |
| [ShadowDepthBiasSlope](#member-50bd2f6e14ccce7b) | Field |
| [ShadowDistanceFadeRatio](#member-e6b4ee7a6c708255) | Field |
| [ShadowFarFilterTaps](#member-c92fed700e8f8145) | Field |
| [ShadowFilterTaps](#member-55776304671ab49c) | Field |
| [ShadowMaximumDistance](#member-0d7eddf3338cd64b) | Field |
| [ShadowNormalOffsetTexels](#member-b75b1b6592be4758) | Field |
| [ShadowStabilizeTexelSnap](#member-16507edf983830da) | Field |
| [ShadowsEnabled](#member-c22f4386d4c58aee) | Field |
| [SimulationHz](#member-5a51993998901050) | Field |
| [SpecularProbeMaximumDistance](#member-ef8d68f519d5adee) | Field |
| [StaticShadowCache](#member-2569f3ea4bd53c63) | Field |
| [TemporalHistoryWeight](#member-31af1f1cca86c0ac) | Field |
| [TemporalUpscalerQuality](#member-05112461e72e0c38) | Field |
| [TextureResidencyMipBias](#member-f623a4b6dea01df9) | Field |
| [TextureStreaming](#member-d4765ea85d824c4d) | Field |
| [TextureStreamingBudgetMegabytes](#member-2d38f7516c4ea469) | Field |
| [TextureStreamingMaxLevelReduction](#member-53d5036a3a076b78) | Field |
| [TextureStreamingUploadKilobytesPerFrame](#member-9f3523d6a4ee4f8a) | Field |
| [UpscalingFilter](#member-9bfe9e8993706e00) | Field |
| [VignetteIntensity](#member-7e382826b74f5c53) | Field |
| [WaterMesh](#member-19ba850f997c9abe) | Field |

<h3 id="member-939c00ed3f321b32" class="astra-member">AmbientHemispheric</h3>

```csharp
public uint AmbientHemispheric
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-30470d1867f2fafb" class="astra-member">AmbientSpecularProbe</h3>

```csharp
public uint AmbientSpecularProbe
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae8200c2da15242d" class="astra-member">AmbientSplitSumBrdf</h3>

```csharp
public uint AmbientSplitSumBrdf
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a01e90c195712ef4" class="astra-member">AntiAliasing</h3>

```csharp
public Astra.GraphicsAntiAliasing AntiAliasing
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-86d1c0b800dc3c3d" class="astra-member">BloomIntensity</h3>

```csharp
public float BloomIntensity
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a4e952f7a876c81f" class="astra-member">BloomThreshold</h3>

```csharp
public float BloomThreshold
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c03fa015a8ee7f6" class="astra-member">ClampCount</h3>

```csharp
public uint ClampCount
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10f291f36419a93f" class="astra-member">CompositorReserveMs</h3>

```csharp
public float CompositorReserveMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-92a5b29565b3be60" class="astra-member">CoverageLodPixelErrorBudget</h3>

```csharp
public float CoverageLodPixelErrorBudget
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-402589139f47c46e" class="astra-member">CpuLaneBudgetMs</h3>

```csharp
public float CpuLaneBudgetMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed35f5fd7efde689" class="astra-member">DynamicResolutionDecreaseStep</h3>

```csharp
public float DynamicResolutionDecreaseStep
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-52514ba1001fb778" class="astra-member">DynamicResolutionEnabled</h3>

```csharp
public uint DynamicResolutionEnabled
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f202e56a2a95a0d1" class="astra-member">DynamicResolutionIncreaseStep</h3>

```csharp
public float DynamicResolutionIncreaseStep
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1781ff9cb9ce0ac9" class="astra-member">DynamicResolutionMaximumScale</h3>

```csharp
public float DynamicResolutionMaximumScale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a8b08833e366607c" class="astra-member">DynamicResolutionMinimumScale</h3>

```csharp
public float DynamicResolutionMinimumScale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b861abca6983a34c" class="astra-member">DynamicResolutionOverloadFrames</h3>

```csharp
public uint DynamicResolutionOverloadFrames
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1edf3a6ece8ad9c" class="astra-member">DynamicResolutionRecoveryFrames</h3>

```csharp
public uint DynamicResolutionRecoveryFrames
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0e8fb939b9c0064b" class="astra-member">DynamicResolutionRecoveryHeadroomRatio</h3>

```csharp
public float DynamicResolutionRecoveryHeadroomRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a764f0914b378a94" class="astra-member">EffectiveProfile</h3>

```csharp
public uint EffectiveProfile
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-92c4e5d1c7b5fa43" class="astra-member">EmissiveMaximumDistance</h3>

```csharp
public float EmissiveMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-03fa0df85cce1194" class="astra-member">FrameIntervalMs</h3>

```csharp
public float FrameIntervalMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-29cb23a1b136ae99" class="astra-member">GpuLaneBudgetMs</h3>

```csharp
public float GpuLaneBudgetMs
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-49c88bb754fcdfc9" class="astra-member">HzbHysteresisFrames</h3>

```csharp
public uint HzbHysteresisFrames
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-24656cba043f7894" class="astra-member">HzbMinimumCandidateDraws</h3>

```csharp
public uint HzbMinimumCandidateDraws
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1db6350d4c125854" class="astra-member">HzbNormalizedDepthBias</h3>

```csharp
public float HzbNormalizedDepthBias
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa59ef0f4550dbf2" class="astra-member">LodHysteresisBandRatio</h3>

```csharp
public float LodHysteresisBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b6beaf6d5a380b58" class="astra-member">LodPixelErrorBudget</h3>

```csharp
public float LodPixelErrorBudget
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bfe3ddab4da69f88" class="astra-member">LodSelection</h3>

```csharp
public uint LodSelection
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-978e5c730c70d7c4" class="astra-member">MaterialDetailFadeBandRatio</h3>

```csharp
public float MaterialDetailFadeBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d50d083f6763c044" class="astra-member">MaterialShaderVariants</h3>

```csharp
public uint MaterialShaderVariants
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7c66bff1ba9428b8" class="astra-member">MetallicRoughnessMaximumDistance</h3>

```csharp
public float MetallicRoughnessMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae61b5daf80064ce" class="astra-member">NormalMapMaximumDistance</h3>

```csharp
public float NormalMapMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5d2ab9ad194ca861" class="astra-member">PostBloom</h3>

```csharp
public uint PostBloom
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0499424b49fc5885" class="astra-member">PostContrast</h3>

```csharp
public float PostContrast
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f107741c0de76bfe" class="astra-member">PostDedicatedPass</h3>

```csharp
public uint PostDedicatedPass
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-95d6953bf03a03f2" class="astra-member">PostSaturation</h3>

```csharp
public float PostSaturation
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5759a61de5f9a66f" class="astra-member">PostSharpen</h3>

```csharp
public float PostSharpen
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bb9b7376c69c19f9" class="astra-member">PostVignette</h3>

```csharp
public uint PostVignette
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-928d4837a86e30f3" class="astra-member">RenderHz</h3>

```csharp
public uint RenderHz
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0b2f6395ce05b925" class="astra-member">ResolutionScale</h3>

```csharp
public float ResolutionScale
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-aa111a571949ab45" class="astra-member">SamplerAnisotropy</h3>

```csharp
public float SamplerAnisotropy
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a824072c0ff1ced6" class="astra-member">ShadowCacheGuardBandRatio</h3>

```csharp
public float ShadowCacheGuardBandRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-71ebcd265d755425" class="astra-member">ShadowCascadeBlendRatio</h3>

```csharp
public float ShadowCascadeBlendRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-15420af385811ab0" class="astra-member">ShadowCascadeCount</h3>

```csharp
public uint ShadowCascadeCount
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9171fa9c64c269f" class="astra-member">ShadowCascadeResolution</h3>

```csharp
public uint ShadowCascadeResolution
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a15aba535c98c9e5" class="astra-member">ShadowDepthBiasConstant</h3>

```csharp
public float ShadowDepthBiasConstant
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50bd2f6e14ccce7b" class="astra-member">ShadowDepthBiasSlope</h3>

```csharp
public float ShadowDepthBiasSlope
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e6b4ee7a6c708255" class="astra-member">ShadowDistanceFadeRatio</h3>

```csharp
public float ShadowDistanceFadeRatio
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c92fed700e8f8145" class="astra-member">ShadowFarFilterTaps</h3>

```csharp
public uint ShadowFarFilterTaps
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-55776304671ab49c" class="astra-member">ShadowFilterTaps</h3>

```csharp
public uint ShadowFilterTaps
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0d7eddf3338cd64b" class="astra-member">ShadowMaximumDistance</h3>

```csharp
public float ShadowMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b75b1b6592be4758" class="astra-member">ShadowNormalOffsetTexels</h3>

```csharp
public float ShadowNormalOffsetTexels
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-16507edf983830da" class="astra-member">ShadowStabilizeTexelSnap</h3>

```csharp
public uint ShadowStabilizeTexelSnap
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c22f4386d4c58aee" class="astra-member">ShadowsEnabled</h3>

```csharp
public uint ShadowsEnabled
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5a51993998901050" class="astra-member">SimulationHz</h3>

```csharp
public uint SimulationHz
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ef8d68f519d5adee" class="astra-member">SpecularProbeMaximumDistance</h3>

```csharp
public float SpecularProbeMaximumDistance
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2569f3ea4bd53c63" class="astra-member">StaticShadowCache</h3>

```csharp
public uint StaticShadowCache
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-31af1f1cca86c0ac" class="astra-member">TemporalHistoryWeight</h3>

```csharp
public float TemporalHistoryWeight
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-05112461e72e0c38" class="astra-member">TemporalUpscalerQuality</h3>

```csharp
public Astra.GraphicsTemporalQuality TemporalUpscalerQuality
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f623a4b6dea01df9" class="astra-member">TextureResidencyMipBias</h3>

```csharp
public uint TextureResidencyMipBias
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d4765ea85d824c4d" class="astra-member">TextureStreaming</h3>

```csharp
public uint TextureStreaming
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d38f7516c4ea469" class="astra-member">TextureStreamingBudgetMegabytes</h3>

```csharp
public uint TextureStreamingBudgetMegabytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-53d5036a3a076b78" class="astra-member">TextureStreamingMaxLevelReduction</h3>

```csharp
public uint TextureStreamingMaxLevelReduction
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f3523d6a4ee4f8a" class="astra-member">TextureStreamingUploadKilobytesPerFrame</h3>

```csharp
public uint TextureStreamingUploadKilobytesPerFrame
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9bfe9e8993706e00" class="astra-member">UpscalingFilter</h3>

```csharp
public Astra.GraphicsUpscaling UpscalingFilter
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e382826b74f5c53" class="astra-member">VignetteIntensity</h3>

```csharp
public float VignetteIntensity
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-19ba850f997c9abe" class="astra-member">WaterMesh</h3>

```csharp
public Astra.GraphicsWaterMesh WaterMesh
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.SaveRecovery"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-saverecovery/
---

# Astra.SaveRecovery

Enum da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.SaveRecovery
```

## Onde acessar este tipo

No Behavior, **Save** dá acesso ao armazenamento do projeto. Use chave e versão explícitas; salvar estado de gameplay não é salvar cena autoral.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [None](#member-4b564a4dd406a0ce) | Field |
| [PreviousSnapshot](#member-528b06032e829117) | Field |

<h3 id="member-4b564a4dd406a0ce" class="astra-member">None</h3>

```csharp
None = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-528b06032e829117" class="astra-member">PreviousSnapshot</h3>

```csharp
PreviousSnapshot = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.SaveStore"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-savestore/
---

# Astra.SaveStore

One project-owned save namespace. Changes to keys commit with Flush; standalone files commit immediately. Errors never select a temporary directory.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.SaveStore
```

One project-owned save namespace. Changes to keys commit with Flush; standalone files commit immediately. Errors never select a temporary directory.

**Interfaces:** `System.IDisposable`.

## Onde acessar este tipo

No Behavior, **Save** dá acesso ao armazenamento do projeto. Use chave e versão explícitas; salvar estado de gameplay não é salvar cena autoral.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [MaxFileBytes](#member-e8a33f263513c6b7) | Field |
| [MaxFilesBytes](#member-59b0c0e052382883) | Field |
| [MaxSnapshotBytes](#member-7234e33d5f2e8cd6) | Field |
| [.ctor](#member-3a2f1a08a2f9b320) | Method |
| [Contains](#member-3310b6e5d62d9d9e) | Method |
| [Delete](#member-a1c0b61e31064148) | Method |
| [DeleteFile](#member-2dff6e79faeffc36) | Method |
| [Dispose](#member-fe863bc26f0ac749) | Method |
| [Flush](#member-5e19e1277286e441) | Method |
| [GetBoolean](#member-325653a0a1bdb7b9) | Method |
| [GetDouble](#member-4ecb6f7df880d0e7) | Method |
| [GetInt64](#member-8a4f75766e8c066f) | Method |
| [GetString](#member-8404b54db388fae8) | Method |
| [ReadBytes](#member-a5a19cd540eb0300) | Method |
| [ReadText](#member-f1171b154ec5c59e) | Method |
| [SetBoolean](#member-d4982c73cc22deba) | Method |
| [SetDouble](#member-6e877bd43fb1abfd) | Method |
| [SetInt64](#member-3124820be3628cdd) | Method |
| [SetString](#member-cceabf5879d036be) | Method |
| [WriteBytes](#member-908a261067b19f9c) | Method |
| [WriteText](#member-d6d142b9d8f81142) | Method |
| [Recovery](#member-f98340893693e622) | Property |

<h3 id="member-e8a33f263513c6b7" class="astra-member">MaxFileBytes</h3>

```csharp
public const int MaxFileBytes = 1048576
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-59b0c0e052382883" class="astra-member">MaxFilesBytes</h3>

```csharp
public const long MaxFilesBytes = 16777216
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7234e33d5f2e8cd6" class="astra-member">MaxSnapshotBytes</h3>

```csharp
public const int MaxSnapshotBytes = 262144
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3a2f1a08a2f9b320" class="astra-member">.ctor</h3>

```csharp
public SaveStore(string projectRoot)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `projectRoot` | `string` |  |

<h3 id="member-3310b6e5d62d9d9e" class="astra-member">Contains</h3>

```csharp
public bool Contains(string key)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |

<h3 id="member-a1c0b61e31064148" class="astra-member">Delete</h3>

```csharp
public bool Delete(string key)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |

<h3 id="member-2dff6e79faeffc36" class="astra-member">DeleteFile</h3>

```csharp
public bool DeleteFile(string safeRelativePath)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-fe863bc26f0ac749" class="astra-member">Dispose</h3>

```csharp
public void Dispose()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5e19e1277286e441" class="astra-member">Flush</h3>

```csharp
public void Flush()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-325653a0a1bdb7b9" class="astra-member">GetBoolean</h3>

```csharp
public bool GetBoolean(string key, bool fallback = false)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `bool` |  · Opcional: `False` |

<h3 id="member-4ecb6f7df880d0e7" class="astra-member">GetDouble</h3>

```csharp
public double GetDouble(string key, double fallback = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `double` |  · Opcional: `0` |

<h3 id="member-8a4f75766e8c066f" class="astra-member">GetInt64</h3>

```csharp
public long GetInt64(string key, long fallback = 0)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `long` |  · Opcional: `0` |

<h3 id="member-8404b54db388fae8" class="astra-member">GetString</h3>

```csharp
public string GetString(string key, string fallback = "")
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `string` |  · Opcional: `` |

<h3 id="member-a5a19cd540eb0300" class="astra-member">ReadBytes</h3>

```csharp
public byte[] ReadBytes(string safeRelativePath)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-f1171b154ec5c59e" class="astra-member">ReadText</h3>

```csharp
public string ReadText(string safeRelativePath)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-d4982c73cc22deba" class="astra-member">SetBoolean</h3>

```csharp
public void SetBoolean(string key, bool value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `value` | `bool` |  |

<h3 id="member-6e877bd43fb1abfd" class="astra-member">SetDouble</h3>

```csharp
public void SetDouble(string key, double value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `value` | `double` |  |

<h3 id="member-3124820be3628cdd" class="astra-member">SetInt64</h3>

```csharp
public void SetInt64(string key, long value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `value` | `long` |  |

<h3 id="member-cceabf5879d036be" class="astra-member">SetString</h3>

```csharp
public void SetString(string key, string value)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `key` | `string` |  |
| `value` | `string` |  |

<h3 id="member-908a261067b19f9c" class="astra-member">WriteBytes</h3>

```csharp
public void WriteBytes(string safeRelativePath, System.ReadOnlySpan<byte> bytes)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `safeRelativePath` | `string` |  |
| `bytes` | `System.ReadOnlySpan&lt;byte&gt;` |  |

<h3 id="member-d6d142b9d8f81142" class="astra-member">WriteText</h3>

```csharp
public void WriteText(string safeRelativePath, string text)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `safeRelativePath` | `string` |  |
| `text` | `string` |  |

<h3 id="member-f98340893693e622" class="astra-member">Recovery</h3>

```csharp
public Astra.SaveRecovery Recovery { get; private set; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.SaveVersionException"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-saveversionexception/
---

# Astra.SaveVersionException

Class da API C# da Astra. 1 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.SaveVersionException
```

**Herda de:** `System.IO.IOException`.

## Onde acessar este tipo

No Behavior, **Save** dá acesso ao armazenamento do projeto. Use chave e versão explícitas; salvar estado de gameplay não é salvar cena autoral.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-8b8cb9e2b5580259) | Method |

<h3 id="member-8b8cb9e2b5580259" class="astra-member">.ctor</h3>

```csharp
public SaveVersionException(string message)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `message` | `string` |  |


---

---
title: "Astra.ScenesAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/
---

# Astra.ScenesAccess

Cenas do projeto em Play (Unity 6000.0 SceneManager). Nome é o caminho relativo sem extensão ou só o nome do arquivo, quando único.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.ScenesAccess
```

Cenas do projeto em Play (Unity 6000.0 SceneManager). Nome é o caminho relativo sem extensão ou só o nome do arquivo, quando único.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Load](#member-88d29d8fa451f976) | Method |
| [LoadAdditive](#member-081fb2eb70216468) | Method |
| [Active](#member-109ec8213b8c357d) | Property |
| [Names](#member-ade272bc3f09a5cf) | Property |

<h3 id="member-88d29d8fa451f976" class="astra-member">Load</h3>

```csharp
public void Load(string name)
```

Troca o mundo inteiro pela cena, no fim do quadro corrente. Os comportamentos atuais recebem Stop/Destroy; os da cena nova, Awake/Start. O documento editado não muda e volta ao parar o Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Troca o mundo inteiro pela cena, no fim do quadro corrente. Os comportamentos atuais recebem Stop/Destroy; os da cena nova, Awake/Start. O documento editado não muda e volta ao parar o Play.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |

<h3 id="member-081fb2eb70216468" class="astra-member">LoadAdditive</h3>

```csharp
public Astra.GameObject LoadAdditive(string name, Astra.GameObject? parent = null)
```

Acrescenta a cena ao mundo atual sob um objeto contêiner com o nome dela, filho de parent (raiz quando nulo). Os comportamentos da cena recebem Awake/Start como em uma instanciação.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Acrescenta a cena ao mundo atual sob um objeto contêiner com o nome dela, filho de parent (raiz quando nulo). Os comportamentos da cena recebem Awake/Start como em uma instanciação.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `name` | `string` |  |
| `parent` | `Astra.GameObject?` |  · Opcional: `` |

<h3 id="member-109ec8213b8c357d" class="astra-member">Active</h3>

```csharp
public string Active { get; }
```

A cena que iniciou ou substituiu o mundo atual.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** A cena que iniciou ou substituiu o mundo atual.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ade272bc3f09a5cf" class="astra-member">Names</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<string> Names { get; }
```

Cenas do projeto, em ordem estável.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Cenas do projeto, em ordem estável.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.ScreenRect"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-screenrect/
---

# Astra.ScreenRect

Retângulo em pixels da vista de jogo, origem no canto inferior esquerdo.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.ScreenRect
```

Retângulo em pixels da vista de jogo, origem no canto inferior esquerdo.

**Interfaces:** `System.IEquatable<Astra.ScreenRect>`.

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-dd02686f73636cc8) | Method |
| [Height](#member-49fdb04e558db503) | Property |
| [Width](#member-ffe876ba9d70720e) | Property |
| [X](#member-3f6e4a1ed5139ea4) | Property |
| [Y](#member-2eb0a44113a02da5) | Property |

<h3 id="member-dd02686f73636cc8" class="astra-member">.ctor</h3>

```csharp
public ScreenRect(float X, float Y, float Width, float Height)
```

Retângulo em pixels da vista de jogo, origem no canto inferior esquerdo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `X` | `float` |  |
| `Y` | `float` |  |
| `Width` | `float` |  |
| `Height` | `float` |  |

<h3 id="member-49fdb04e558db503" class="astra-member">Height</h3>

```csharp
public float Height { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ffe876ba9d70720e" class="astra-member">Width</h3>

```csharp
public float Width { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f6e4a1ed5139ea4" class="astra-member">X</h3>

```csharp
public float X { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2eb0a44113a02da5" class="astra-member">Y</h3>

```csharp
public float Y { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.SerializeFieldAttribute"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-serializefieldattribute/
---

# Astra.SerializeFieldAttribute

Expõe um campo não público, junto com Astra.PropertyIdAttribute (Unity: [SerializeField]). Sem ele só campos públicos entram no Inspector.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.SerializeFieldAttribute
```

Expõe um campo não público, junto com Astra.PropertyIdAttribute (Unity: [SerializeField]). Sem ele só campos públicos entram no Inspector.

**Herda de:** `System.Attribute`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

Este tipo não declara membros públicos adicionais neste recorte.


---

---
title: "Astra.ShapeQuery"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-shapequery/
---

# Astra.ShapeQuery

A forma varrida ou sobreposta por uma consulta.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.ShapeQuery
```

A forma varrida ou sobreposta por uma consulta.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [HalfExtent](#member-795ed8f6a0ddc616) | Field |
| [HalfHeight](#member-5b224e33243fc6af) | Field |
| [Kind](#member-40a96eb5d6728dcc) | Field |
| [Radius](#member-cbaa48df9f903378) | Field |
| [Rotation](#member-18a4493721ec62c4) | Field |
| [Box](#member-4298f25e35b3d988) | Method |
| [Capsule](#member-9ffe2eb827ae51e8) | Method |
| [Cylinder](#member-1e732eebb5f1afba) | Method |
| [Sphere](#member-b5d9f594f6cfa0b2) | Method |

<h3 id="member-795ed8f6a0ddc616" class="astra-member">HalfExtent</h3>

```csharp
public System.Numerics.Vector3 HalfExtent
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b224e33243fc6af" class="astra-member">HalfHeight</h3>

```csharp
public float HalfHeight
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-40a96eb5d6728dcc" class="astra-member">Kind</h3>

```csharp
public Astra.QueryShapeKind Kind
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cbaa48df9f903378" class="astra-member">Radius</h3>

```csharp
public float Radius
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-18a4493721ec62c4" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Quaternion Rotation
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4298f25e35b3d988" class="astra-member">Box</h3>

```csharp
public static Astra.ShapeQuery Box(System.Numerics.Vector3 halfExtent, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `halfExtent` | `System.Numerics.Vector3` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-9ffe2eb827ae51e8" class="astra-member">Capsule</h3>

```csharp
public static Astra.ShapeQuery Capsule(float radius, float halfHeight, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |
| `halfHeight` | `float` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-1e732eebb5f1afba" class="astra-member">Cylinder</h3>

```csharp
public static Astra.ShapeQuery Cylinder(float radius, float halfHeight, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |
| `halfHeight` | `float` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-b5d9f594f6cfa0b2" class="astra-member">Sphere</h3>

```csharp
public static Astra.ShapeQuery Sphere(float radius)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |


---

---
title: "Astra.TangentMode"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-tangentmode/
---

# Astra.TangentMode

Modo de cada lado da tangente de uma chave (Unity: AnimationUtility.TangentMode).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.TangentMode
```

Modo de cada lado da tangente de uma chave (Unity: AnimationUtility.TangentMode).

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Auto](#member-750da665e87957f6) | Field |
| [ClampedAuto](#member-02972e4798db3ffa) | Field |
| [Constant](#member-93cc3ef3a9bece35) | Field |
| [Free](#member-9c3fc6c2d600ca71) | Field |
| [Linear](#member-7b7f203fb7ec1fb0) | Field |

<h3 id="member-750da665e87957f6" class="astra-member">Auto</h3>

```csharp
Auto = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-02972e4798db3ffa" class="astra-member">ClampedAuto</h3>

```csharp
ClampedAuto = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-93cc3ef3a9bece35" class="astra-member">Constant</h3>

```csharp
Constant = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c3fc6c2d600ca71" class="astra-member">Free</h3>

```csharp
Free = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7b7f203fb7ec1fb0" class="astra-member">Linear</h3>

```csharp
Linear = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TextureStreamingStats"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-texturestreamingstats/
---

# Astra.TextureStreamingStats

Memória de textura do último quadro, nos termos da Unity: CurrentBytes (currentTextureMemory), DesiredBytes (desiredTextureMemory), TargetBytes (targetTextureMemory, depois do orçamento), TotalBytes (totalTextureMemory) e NonStreamingBytes.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
struct Astra.TextureStreamingStats
```

Memória de textura do último quadro, nos termos da Unity: CurrentBytes (currentTextureMemory), DesiredBytes (desiredTextureMemory), TargetBytes (targetTextureMemory, depois do orçamento), TotalBytes (totalTextureMemory) e NonStreamingBytes.

## Onde acessar este tipo

Use configuração gráfica do projeto/ambiente ou o material/slot da malha. Leia política solicitada, resolvida e capacidades separadamente; um enum não prova backend disponível.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Active](#member-485526ff295cb78d) | Field |
| [BudgetBytes](#member-3ec63d89279088e4) | Field |
| [BudgetReducedTextures](#member-475708b654aa6e71) | Field |
| [CurrentBytes](#member-3d8154177166d420) | Field |
| [DesiredBytes](#member-c2ca80426d3a2490) | Field |
| [FailedUploads](#member-b6a6aba54a9a3e29) | Field |
| [NonStreamingBytes](#member-51f20057fe7dd9f2) | Field |
| [OverBudget](#member-e1fc4cd30958487f) | Field |
| [PendingLoads](#member-e18f3e6488acd861) | Field |
| [StreamingTextures](#member-f66681e6168afbdc) | Field |
| [TargetBytes](#member-d8a53648593eec08) | Field |
| [TotalBytes](#member-8bfe8c0f4c7f9d50) | Field |
| [UploadedBytesLastFrame](#member-b82b3368d5b434cf) | Field |
| [UploadsLastFrame](#member-1e00f5c6051a231e) | Field |

<h3 id="member-485526ff295cb78d" class="astra-member">Active</h3>

```csharp
public uint Active
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3ec63d89279088e4" class="astra-member">BudgetBytes</h3>

```csharp
public ulong BudgetBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-475708b654aa6e71" class="astra-member">BudgetReducedTextures</h3>

```csharp
public uint BudgetReducedTextures
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3d8154177166d420" class="astra-member">CurrentBytes</h3>

```csharp
public ulong CurrentBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c2ca80426d3a2490" class="astra-member">DesiredBytes</h3>

```csharp
public ulong DesiredBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b6a6aba54a9a3e29" class="astra-member">FailedUploads</h3>

```csharp
public uint FailedUploads
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-51f20057fe7dd9f2" class="astra-member">NonStreamingBytes</h3>

```csharp
public ulong NonStreamingBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e1fc4cd30958487f" class="astra-member">OverBudget</h3>

```csharp
public uint OverBudget
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e18f3e6488acd861" class="astra-member">PendingLoads</h3>

```csharp
public uint PendingLoads
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f66681e6168afbdc" class="astra-member">StreamingTextures</h3>

```csharp
public uint StreamingTextures
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8a53648593eec08" class="astra-member">TargetBytes</h3>

```csharp
public ulong TargetBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8bfe8c0f4c7f9d50" class="astra-member">TotalBytes</h3>

```csharp
public ulong TotalBytes
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b82b3368d5b434cf" class="astra-member">UploadedBytesLastFrame</h3>

```csharp
public ulong UploadedBytesLastFrame
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1e00f5c6051a231e" class="astra-member">UploadsLastFrame</h3>

```csharp
public uint UploadsLastFrame
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TimeAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-timeaccess/
---

# Astra.TimeAccess

Session-owned dispatch clock. Reads require the Play thread and an active session.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.TimeAccess
```

Session-owned dispatch clock. Reads require the Play thread and an active session.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [DeltaTime](#member-b3d74fae5a2f3255) | Property |
| [FixedDeltaTime](#member-28f27af158234ac6) | Property |
| [FixedTime](#member-463c7e40f791c4f9) | Property |
| [FrameCount](#member-f5d3e09bdb5fe227) | Property |
| [InFixedTimeStep](#member-9df19d829cbc9941) | Property |
| [Scale](#member-f035eca3a0b8d421) | Property |
| [TimeSinceStart](#member-6f5ad80d190434e4) | Property |
| [UnscaledDeltaTime](#member-1da34a1b1184f16e) | Property |
| [UnscaledTimeSinceStart](#member-679d1cd14c1101c1) | Property |

<h3 id="member-b3d74fae5a2f3255" class="astra-member">DeltaTime</h3>

```csharp
public float DeltaTime { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-28f27af158234ac6" class="astra-member">FixedDeltaTime</h3>

```csharp
public float FixedDeltaTime { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-463c7e40f791c4f9" class="astra-member">FixedTime</h3>

```csharp
public double FixedTime { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f5d3e09bdb5fe227" class="astra-member">FrameCount</h3>

```csharp
public ulong FrameCount { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9df19d829cbc9941" class="astra-member">InFixedTimeStep</h3>

```csharp
public bool InFixedTimeStep { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f035eca3a0b8d421" class="astra-member">Scale</h3>

```csharp
public float Scale { get; set; }
```

0 freezes simulation; 1 is normal; supported range is [0,4]. Takes effect next frame.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** 0 freezes simulation; 1 is normal; supported range is [0,4]. Takes effect next frame.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f5ad80d190434e4" class="astra-member">TimeSinceStart</h3>

```csharp
public double TimeSinceStart { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1da34a1b1184f16e" class="astra-member">UnscaledDeltaTime</h3>

```csharp
public float UnscaledDeltaTime { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-679d1cd14c1101c1" class="astra-member">UnscaledTimeSinceStart</h3>

```csharp
public double UnscaledTimeSinceStart { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TimerRuntimeState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-timerruntimestate/
---

# Astra.TimerRuntimeState

Struct da API C# da Astra. 7 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.TimerRuntimeState
```

**Interfaces:** `System.IEquatable<Astra.TimerRuntimeState>`.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-41e74026b7d5d9f4) | Method |
| [ActiveInHierarchy](#member-27d7a190715a8269) | Property |
| [Completed](#member-c035a41ac557fbfa) | Property |
| [Enabled](#member-a7cabbb204866baa) | Property |
| [Paused](#member-9c8a5df50f54b0c3) | Property |
| [RemainingSeconds](#member-840554e90ef17489) | Property |
| [Running](#member-5816b527c15cb490) | Property |

<h3 id="member-41e74026b7d5d9f4" class="astra-member">.ctor</h3>

```csharp
public TimerRuntimeState(double RemainingSeconds, bool Running, bool Paused, bool Completed, bool Enabled, bool ActiveInHierarchy)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `RemainingSeconds` | `double` |  |
| `Running` | `bool` |  |
| `Paused` | `bool` |  |
| `Completed` | `bool` |  |
| `Enabled` | `bool` |  |
| `ActiveInHierarchy` | `bool` |  |

<h3 id="member-27d7a190715a8269" class="astra-member">ActiveInHierarchy</h3>

```csharp
public bool ActiveInHierarchy { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c035a41ac557fbfa" class="astra-member">Completed</h3>

```csharp
public bool Completed { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a7cabbb204866baa" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9c8a5df50f54b0c3" class="astra-member">Paused</h3>

```csharp
public bool Paused { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-840554e90ef17489" class="astra-member">RemainingSeconds</h3>

```csharp
public double RemainingSeconds { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5816b527c15cb490" class="astra-member">Running</h3>

```csharp
public bool Running { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TransformSpace"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-transformspace/
---

# Astra.TransformSpace

Frame in which a displacement or rotation is expressed.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.TransformSpace
```

Frame in which a displacement or rotation is expressed.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Local](#member-a17a4157c5b0dd3a) | Field |
| [World](#member-80c164e251363ca2) | Field |

<h3 id="member-a17a4157c5b0dd3a" class="astra-member">Local</h3>

```csharp
Local = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-80c164e251363ca2" class="astra-member">World</h3>

```csharp
World = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TransformTweenRuntime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-transformtweenruntime/
---

# Astra.TransformTweenRuntime

Controls the session-owned transform evaluator. Runtime state is not serialized.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.TransformTweenRuntime
```

Controls the session-owned transform evaluator. Runtime state is not serialized.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Cancel](#member-ffcdb93f3956b116) | Method |
| [Pause](#member-985e8ca603b9fc99) | Method |
| [Restart](#member-34979a1a90fba01e) | Method |
| [Resume](#member-d8eaf4d1a84859dd) | Method |
| [State](#member-d8df3043e435fad4) | Method |

<h3 id="member-ffcdb93f3956b116" class="astra-member">Cancel</h3>

```csharp
public static void Cancel(Astra.Components.TransformTween tween)
```

Stops writing and preserves the current runtime pose.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Stops writing and preserves the current runtime pose.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tween` | `Astra.Components.TransformTween` |  |

<h3 id="member-985e8ca603b9fc99" class="astra-member">Pause</h3>

```csharp
public static void Pause(Astra.Components.TransformTween tween)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tween` | `Astra.Components.TransformTween` |  |

<h3 id="member-34979a1a90fba01e" class="astra-member">Restart</h3>

```csharp
public static void Restart(Astra.Components.TransformTween tween)
```

Captures the current local pose on the next evaluation and restarts delay. Keeps local pause.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Captures the current local pose on the next evaluation and restarts delay. Keeps local pause.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tween` | `Astra.Components.TransformTween` |  |

<h3 id="member-d8eaf4d1a84859dd" class="astra-member">Resume</h3>

```csharp
public static void Resume(Astra.Components.TransformTween tween)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tween` | `Astra.Components.TransformTween` |  |

<h3 id="member-d8df3043e435fad4" class="astra-member">State</h3>

```csharp
public static Astra.TweenRuntimeState State(Astra.Components.TransformTween tween)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `tween` | `Astra.Components.TransformTween` |  |


---

---
title: "Astra.TransformValue"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-transformvalue/
---

# Astra.TransformValue

Struct da API C# da Astra. 4 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.TransformValue
```

**Interfaces:** `System.IEquatable<Astra.TransformValue>`.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-7f0ced0f5f27db3e) | Method |
| [Position](#member-32b9ce2c3b50de65) | Property |
| [Rotation](#member-d9897283b8316792) | Property |
| [Scale](#member-9fddb0ffb168312b) | Property |

<h3 id="member-7f0ced0f5f27db3e" class="astra-member">.ctor</h3>

```csharp
public TransformValue(System.Numerics.Vector3 Position, System.Numerics.Quaternion Rotation, System.Numerics.Vector3 Scale)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Position` | `System.Numerics.Vector3` |  |
| `Rotation` | `System.Numerics.Quaternion` |  |
| `Scale` | `System.Numerics.Vector3` |  |

<h3 id="member-32b9ce2c3b50de65" class="astra-member">Position</h3>

```csharp
public System.Numerics.Vector3 Position { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9897283b8316792" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Quaternion Rotation { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9fddb0ffb168312b" class="astra-member">Scale</h3>

```csharp
public System.Numerics.Vector3 Scale { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TweenRuntimeState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-tweenruntimestate/
---

# Astra.TweenRuntimeState

Struct da API C# da Astra. 6 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.TweenRuntimeState
```

**Interfaces:** `System.IEquatable<Astra.TweenRuntimeState>`.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ec499d5f45481757) | Method |
| [ActiveInHierarchy](#member-60e08522113db325) | Property |
| [ElapsedSeconds](#member-44c791b59c7f9606) | Property |
| [Enabled](#member-debf22ec3a051cd4) | Property |
| [Paused](#member-d7a216919849a46c) | Property |
| [Status](#member-a6f8b94cdd30b25a) | Property |

<h3 id="member-ec499d5f45481757" class="astra-member">.ctor</h3>

```csharp
public TweenRuntimeState(Astra.TweenRuntimeStatus Status, double ElapsedSeconds, bool Paused, bool Enabled, bool ActiveInHierarchy)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Status` | `Astra.TweenRuntimeStatus` |  |
| `ElapsedSeconds` | `double` |  |
| `Paused` | `bool` |  |
| `Enabled` | `bool` |  |
| `ActiveInHierarchy` | `bool` |  |

<h3 id="member-60e08522113db325" class="astra-member">ActiveInHierarchy</h3>

```csharp
public bool ActiveInHierarchy { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-44c791b59c7f9606" class="astra-member">ElapsedSeconds</h3>

```csharp
public double ElapsedSeconds { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-debf22ec3a051cd4" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d7a216919849a46c" class="astra-member">Paused</h3>

```csharp
public bool Paused { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a6f8b94cdd30b25a" class="astra-member">Status</h3>

```csharp
public Astra.TweenRuntimeStatus Status { get; init; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.TweenRuntimeStatus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-tweenruntimestatus/
---

# Astra.TweenRuntimeStatus

Enum da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.TweenRuntimeStatus
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Authority](#member-285a7e47968211d0) | Field |
| [Cancelled](#member-995725f02ead3f82) | Field |
| [CompetingWriter](#member-4dddd99dcac50ab0) | Field |
| [Completed](#member-8c4834330b40268e) | Field |
| [Delayed](#member-ee49ee980858e6d2) | Field |
| [Idle](#member-6e6226c0fed761df) | Field |
| [InvalidPose](#member-032f8973548fbc3b) | Field |
| [NoChannels](#member-d9481d9e3276392b) | Field |
| [Running](#member-01f66f24c2982c15) | Field |

<h3 id="member-285a7e47968211d0" class="astra-member">Authority</h3>

```csharp
Authority = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-995725f02ead3f82" class="astra-member">Cancelled</h3>

```csharp
Cancelled = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4dddd99dcac50ab0" class="astra-member">CompetingWriter</h3>

```csharp
CompetingWriter = 6
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8c4834330b40268e" class="astra-member">Completed</h3>

```csharp
Completed = 3
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ee49ee980858e6d2" class="astra-member">Delayed</h3>

```csharp
Delayed = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6e6226c0fed761df" class="astra-member">Idle</h3>

```csharp
Idle = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-032f8973548fbc3b" class="astra-member">InvalidPose</h3>

```csharp
InvalidPose = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d9481d9e3276392b" class="astra-member">NoChannels</h3>

```csharp
NoChannels = 8
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01f66f24c2982c15" class="astra-member">Running</h3>

```csharp
Running = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WaitForFixedUpdate"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-waitforfixedupdate/
---

# Astra.WaitForFixedUpdate

Resumes after the next dispatched physical fixed step, never from Update.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WaitForFixedUpdate
```

Resumes after the next dispatched physical fixed step, never from Update.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

Este tipo não declara membros públicos adicionais neste recorte.


---

---
title: "Astra.WaitForSeconds"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-waitforseconds/
---

# Astra.WaitForSeconds

Waits for simulation seconds delivered by the native Update callback. Resume is always on a later frame.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WaitForSeconds
```

Waits for simulation seconds delivered by the native Update callback. Resume is always on a later frame.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-797db1f5a89b64a1) | Method |
| [Seconds](#member-ac1ae18e08839d5b) | Property |

<h3 id="member-797db1f5a89b64a1" class="astra-member">.ctor</h3>

```csharp
public WaitForSeconds(double seconds)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |

<h3 id="member-ac1ae18e08839d5b" class="astra-member">Seconds</h3>

```csharp
public double Seconds { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WaitForSecondsRealtime"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-waitforsecondsrealtime/
---

# Astra.WaitForSecondsRealtime

Waits for monotonic real time. When dispatch is paused, completion is delivered on the next running Update.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WaitForSecondsRealtime
```

Waits for monotonic real time. When dispatch is paused, completion is delivered on the next running Update.

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-cc3f9c4cb5760d94) | Method |
| [Seconds](#member-1a07de45213691ad) | Property |

<h3 id="member-cc3f9c4cb5760d94" class="astra-member">.ctor</h3>

```csharp
public WaitForSecondsRealtime(double seconds)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seconds` | `double` |  |

<h3 id="member-1a07de45213691ad" class="astra-member">Seconds</h3>

```csharp
public double Seconds { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WaitUntil"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-waituntil/
---

# Astra.WaitUntil

Class da API C# da Astra. 1 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WaitUntil
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-66239a18442b9a00) | Method |

<h3 id="member-66239a18442b9a00" class="astra-member">.ctor</h3>

```csharp
public WaitUntil(System.Func<bool> predicate)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `predicate` | `System.Func&lt;bool&gt;` |  |


---

---
title: "Astra.WaitWhile"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-waitwhile/
---

# Astra.WaitWhile

Class da API C# da Astra. 1 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WaitWhile
```

## Onde acessar este tipo

No Behavior, use **Time**, StartCoroutine/StartAsync ou o componente Timer/Transform Tween associado ao objeto. Dados de estado retornam do consumidor runtime; não se instanciam para iniciar uma simulação por conta própria.

## Roadmap e uso

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-98180570a33dff1c) | Method |

<h3 id="member-98180570a33dff1c" class="astra-member">.ctor</h3>

```csharp
public WaitWhile(System.Func<bool> predicate)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `predicate` | `System.Func&lt;bool&gt;` |  |


---

---
title: "Astra.WorldException"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-worldexception/
---

# Astra.WorldException

Class da API C# da Astra. 2 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.WorldException
```

**Herda de:** `System.InvalidOperationException`.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-113b5506617613d0) | Method |
| [Status](#member-10e90aca421d90d2) | Property |

<h3 id="member-113b5506617613d0" class="astra-member">.ctor</h3>

```csharp
public WorldException(Astra.WorldStatus status, string operation)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `status` | `Astra.WorldStatus` |  |
| `operation` | `string` |  |

<h3 id="member-10e90aca421d90d2" class="astra-member">Status</h3>

```csharp
public Astra.WorldStatus Status { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WorldOperation"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-worldoperation/
---

# Astra.WorldOperation

Resultado de uma edição estrutural no ponto seguro do Play.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.WorldOperation
```

Resultado de uma edição estrutural no ponto seguro do Play.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Read](#member-4254e995af8ecdc2) | Method |
| [Id](#member-970b29a4ecfccdf2) | Property |

<h3 id="member-4254e995af8ecdc2" class="astra-member">Read</h3>

```csharp
public (Astra.WorldOperationState State, Astra.WorldStatus Result) Read()
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-970b29a4ecfccdf2" class="astra-member">Id</h3>

```csharp
public ulong Id { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WorldOperationState"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-worldoperationstate/
---

# Astra.WorldOperationState

Enum da API C# da Astra. 3 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.WorldOperationState
```

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [Applied](#member-4481494a2a829ff5) | Field |
| [Failed](#member-7e087f53ea8bcccc) | Field |
| [Pending](#member-493be33ae707236c) | Field |

<h3 id="member-4481494a2a829ff5" class="astra-member">Applied</h3>

```csharp
Applied = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7e087f53ea8bcccc" class="astra-member">Failed</h3>

```csharp
Failed = 2
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-493be33ae707236c" class="astra-member">Pending</h3>

```csharp
Pending = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Astra.WorldStatus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-worldstatus/
---

# Astra.WorldStatus

Por que uma chamada do mundo de execução foi recusada. Espelha ae::runtime::WorldStatus (implementação da engine) por posição: acrescentar valor só no fim, e nunca reordenar.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Enum

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
enum Astra.WorldStatus
```

Por que uma chamada do mundo de execução foi recusada. Espelha ae::runtime::WorldStatus (implementação da engine) por posição: acrescentar valor só no fim, e nunca reordenar.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ClipNotInComponent](#member-920ecbc9a6c39a60) | Field |
| [ComponentInUse](#member-0d330c81538c002b) | Field |
| [ComponentMissing](#member-57bdb69dfb03769d) | Field |
| [ComponentUnavailable](#member-0db8580372776b40) | Field |
| [ForeignWorld](#member-d441829f6677d663) | Field |
| [InvalidArgument](#member-2e0d6cc1675377ef) | Field |
| [LimitReached](#member-00c60ebd49ef39e8) | Field |
| [NotMutableInPlay](#member-5147ef502aaaafa9) | Field |
| [NotRunning](#member-d1c66671bcb83404) | Field |
| [Ok](#member-356e446ec550fbb7) | Field |
| [OperationExpired](#member-e270a5222954d24e) | Field |
| [PropertyAlreadyTweening](#member-d8d9328cc1a68a34) | Field |
| [PropertyNotTweenable](#member-d13385bbf3e45f41) | Field |
| [PropertyWrittenExternally](#member-a9beb9ef63cc5e8f) | Field |
| [Rejected](#member-a38d122a8bdcb8fb) | Field |
| [ResourceTypeMismatch](#member-8b781b43ea615ae9) | Field |
| [StaleHandle](#member-5c79004c9151e4f5) | Field |
| [TransformOwnedByPhysics](#member-3f8038950511ff95) | Field |
| [UnknownComponent](#member-b7bd7d3ecba060e4) | Field |
| [UnknownElement](#member-78225220f3ade5aa) | Field |
| [UnknownObject](#member-ae6fd391d1d7466f) | Field |
| [UnknownOperation](#member-f67926912d4c8c70) | Field |
| [UnknownResource](#member-1bdb76667b7e441b) | Field |

<h3 id="member-920ecbc9a6c39a60" class="astra-member">ClipNotInComponent</h3>

```csharp
ClipNotInComponent = 16
```

O clipe existe mas não está na lista do componente Animation.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0d330c81538c002b" class="astra-member">ComponentInUse</h3>

```csharp
ComponentInUse = 8
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-57bdb69dfb03769d" class="astra-member">ComponentMissing</h3>

```csharp
ComponentMissing = 6
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0db8580372776b40" class="astra-member">ComponentUnavailable</h3>

```csharp
ComponentUnavailable = 7
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d441829f6677d663" class="astra-member">ForeignWorld</h3>

```csharp
ForeignWorld = 2
```

A referência veio de outra sessão de Play.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2e0d6cc1675377ef" class="astra-member">InvalidArgument</h3>

```csharp
InvalidArgument = 11
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00c60ebd49ef39e8" class="astra-member">LimitReached</h3>

```csharp
LimitReached = 12
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5147ef502aaaafa9" class="astra-member">NotMutableInPlay</h3>

```csharp
NotMutableInPlay = 9
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d1c66671bcb83404" class="astra-member">NotRunning</h3>

```csharp
NotRunning = 1
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-356e446ec550fbb7" class="astra-member">Ok</h3>

```csharp
Ok = 0
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e270a5222954d24e" class="astra-member">OperationExpired</h3>

```csharp
OperationExpired = 18
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d8d9328cc1a68a34" class="astra-member">PropertyAlreadyTweening</h3>

```csharp
PropertyAlreadyTweening = 20
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d13385bbf3e45f41" class="astra-member">PropertyNotTweenable</h3>

```csharp
PropertyNotTweenable = 19
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9beb9ef63cc5e8f" class="astra-member">PropertyWrittenExternally</h3>

```csharp
PropertyWrittenExternally = 21
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a38d122a8bdcb8fb" class="astra-member">Rejected</h3>

```csharp
Rejected = 13
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8b781b43ea615ae9" class="astra-member">ResourceTypeMismatch</h3>

```csharp
ResourceTypeMismatch = 15
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5c79004c9151e4f5" class="astra-member">StaleHandle</h3>

```csharp
StaleHandle = 3
```

O objeto foi destruído; a referência venceu.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f8038950511ff95" class="astra-member">TransformOwnedByPhysics</h3>

```csharp
TransformOwnedByPhysics = 10
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b7bd7d3ecba060e4" class="astra-member">UnknownComponent</h3>

```csharp
UnknownComponent = 5
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-78225220f3ade5aa" class="astra-member">UnknownElement</h3>

```csharp
UnknownElement = 17
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ae6fd391d1d7466f" class="astra-member">UnknownObject</h3>

```csharp
UnknownObject = 4
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f67926912d4c8c70" class="astra-member">UnknownOperation</h3>

```csharp
UnknownOperation = 22
```

O tipo do componente não declara esse método ou evento.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bdb76667b7e441b" class="astra-member">UnknownResource</h3>

```csharp
UnknownResource = 14
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Opção deste enum. Use apenas no argumento/campo desse tipo; a presença da opção não comprova suporte da plataforma.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.


---

---
title: "Mola de posição"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-spring-position/
---

# Mola de posição

Segue fonte com velocidade e amortecimento persistentes no runtime

**Família:** Lógica · **Grupo:** Molas · **Identificador:** `astra.spring.position` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Segue fonte com velocidade e amortecimento persistentes no runtime

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de posição**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.SpringPositionConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springpositionconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Position Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/): Escolha restrição direta ou mola para posição
- [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/): Parent Constraint já escreve posição

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Fonte

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Influência**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Influência · <code>weight</code></h4>

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Influência**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Mola de posição** → **Fonte** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Resposta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Frequência**](#field-frequency)<br/>`frequency` | número · Hz | 3 | 0.01 … 60 |
| [**Razão de amortecimento**](#field-damping-ratio)<br/>`damping_ratio` | número | 1 | 0 … 10 |
| [**Velocidade máxima**](#field-max-speed)<br/>`max_speed` | número · m/s | 1000 | 0.001 … 100000 |

<h4 id="field-frequency">Frequência · <code>frequency</code></h4>

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Frequência**.

**Uso e efeito:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Valor:** 3 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.01 … 60.



<h4 id="field-damping-ratio">Razão de amortecimento · <code>damping_ratio</code></h4>

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Razão de amortecimento**.

**Uso e efeito:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.



<h4 id="field-max-speed">Velocidade máxima · <code>max_speed</code></h4>

**Onde:** Inspector → **Mola de posição** → **Resposta** → **Velocidade máxima**.

**Uso e efeito:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Valor:** 1000 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0.001 … 100000.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Offset X**](#field-offset-x)<br/>`offset_x` | número | 0 | -10000 … 10000 |
| [**Offset Y**](#field-offset-y)<br/>`offset_y` | número | 0 | -10000 … 10000 |
| [**Offset Z**](#field-offset-z)<br/>`offset_z` | número | 0 | -10000 … 10000 |

<h4 id="field-offset-x">Offset X · <code>offset_x</code></h4>

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Offset Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Offset Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Mola de posição** → **Ajustes** → **Offset Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Mola de posição** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-PositionConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Mola de rotação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-spring-rotation/
---

# Mola de rotação

Segue orientação por quaternion com amortecimento e caminho curto

**Família:** Lógica · **Grupo:** Molas · **Identificador:** `astra.spring.rotation` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Segue orientação por quaternion com amortecimento e caminho curto

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de rotação**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.SpringRotationConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springrotationconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Rotation Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-rotation/): Escolha restrição direta ou mola para rotação
- [Aim Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-aim/): Aim já escreve rotação
- [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/): Parent Constraint já escreve rotação
- [Look At Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-look-at/): Look At já escreve rotação

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Fonte

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Influência**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Influência · <code>weight</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Fonte** → **Influência**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Fonte** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Fonte** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Resposta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Frequência**](#field-frequency)<br/>`frequency` | número · Hz | 3 | 0.01 … 60 |
| [**Razão de amortecimento**](#field-damping-ratio)<br/>`damping_ratio` | número | 1 | 0 … 10 |
| [**Velocidade máxima**](#field-max-speed)<br/>`max_speed` | número · graus/s | 1000 | 0.001 … 100000 |

<h4 id="field-frequency">Frequência · <code>frequency</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Resposta** → **Frequência**.

**Uso e efeito:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Valor:** 3 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.01 … 60.



<h4 id="field-damping-ratio">Razão de amortecimento · <code>damping_ratio</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Resposta** → **Razão de amortecimento**.

**Uso e efeito:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.



<h4 id="field-max-speed">Velocidade máxima · <code>max_speed</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Resposta** → **Velocidade máxima**.

**Uso e efeito:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Valor:** 1000 · **Tipo:** número · **Unidade:** graus/s · **Domínio:** 0.001 … 100000.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Offset X**](#field-offset-x)<br/>`offset_x` | número | 0 | -10000 … 10000 |
| [**Offset Y**](#field-offset-y)<br/>`offset_y` | número | 0 | -10000 … 10000 |
| [**Offset Z**](#field-offset-z)<br/>`offset_z` | número | 0 | -10000 … 10000 |

<h4 id="field-offset-x">Offset X · <code>offset_x</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Ajustes** → **Offset X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Offset Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Ajustes** → **Offset Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Offset Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Mola de rotação** → **Ajustes** → **Offset Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Mola de rotação** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-RotationConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Mola de escala"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-spring-scale/
---

# Mola de escala

Segue escala positiva sem publicar escala singular

**Família:** Lógica · **Grupo:** Molas · **Identificador:** `astra.spring.scale` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Segue escala positiva sem publicar escala singular

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Molas** → **Mola de escala**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.SpringScaleConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springscaleconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Scale Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-scale/): Escolha restrição direta ou mola para escala

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Fonte

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Influência**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Influência · <code>weight</code></h4>

**Onde:** Inspector → **Mola de escala** → **Fonte** → **Influência**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Mola de escala** → **Fonte** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Mola de escala** → **Fonte** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Resposta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Frequência**](#field-frequency)<br/>`frequency` | número · Hz | 3 | 0.01 … 60 |
| [**Razão de amortecimento**](#field-damping-ratio)<br/>`damping_ratio` | número | 1 | 0 … 10 |
| [**Velocidade máxima**](#field-max-speed)<br/>`max_speed` | número · x/s | 1000 | 0.001 … 100000 |

<h4 id="field-frequency">Frequência · <code>frequency</code></h4>

**Onde:** Inspector → **Mola de escala** → **Resposta** → **Frequência**.

**Uso e efeito:** Frequência da resposta da mola; valores maiores reagem mais rápido ao movimento do alvo.

**Valor:** 3 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.01 … 60.



<h4 id="field-damping-ratio">Razão de amortecimento · <code>damping_ratio</code></h4>

**Onde:** Inspector → **Mola de escala** → **Resposta** → **Razão de amortecimento**.

**Uso e efeito:** Amortecimento da mola: controla a oscilação em torno do alvo; use a faixa e compare aproximação, não apenas posição final.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.



<h4 id="field-max-speed">Velocidade máxima · <code>max_speed</code></h4>

**Onde:** Inspector → **Mola de escala** → **Resposta** → **Velocidade máxima**.

**Uso e efeito:** Limita a velocidade da aproximação da mola, na unidade indicada para posição/rotação/escala.

**Valor:** 1000 · **Tipo:** número · **Unidade:** x/s · **Domínio:** 0.001 … 100000.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Offset X**](#field-offset-x)<br/>`offset_x` | número | 1 | 0.0001 … 10000 |
| [**Offset Y**](#field-offset-y)<br/>`offset_y` | número | 1 | 0.0001 … 10000 |
| [**Offset Z**](#field-offset-z)<br/>`offset_z` | número | 1 | 0.0001 … 10000 |

<h4 id="field-offset-x">Offset X · <code>offset_x</code></h4>

**Onde:** Inspector → **Mola de escala** → **Ajustes** → **Offset X**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.0001 … 10000.



<h4 id="field-offset-y">Offset Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Mola de escala** → **Ajustes** → **Offset Y**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.0001 … 10000.



<h4 id="field-offset-z">Offset Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Mola de escala** → **Ajustes** → **Offset Z**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.0001 … 10000.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Mola de escala** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-ScaleConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Position Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/
---

# Position Constraint

Restrição de mundo com uma fonte

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.position` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Restrição de mundo com uma fonte

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Position Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.PositionConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-positionconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Position Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Position Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Position Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento X**](#field-offset-x)<br/>`offset_x` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento Y**](#field-offset-y)<br/>`offset_y` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento Z**](#field-offset-z)<br/>`offset_z` | número · u | 0 | -10000 … 10000 |
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-offset-x">Deslocamento X · <code>offset_x</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Deslocamento X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Deslocamento Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Deslocamento Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Deslocamento Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Deslocamento Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Position Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Position Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-PositionConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Rotation Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-rotation/
---

# Rotation Constraint

Restrição de mundo com uma fonte

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.rotation` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Restrição de mundo com uma fonte

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Rotation Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.RotationConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-rotationconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento X**](#field-offset-x)<br/>`offset_x` | número · graus | 0 | -10000 … 10000 |
| [**Deslocamento Y**](#field-offset-y)<br/>`offset_y` | número · graus | 0 | -10000 … 10000 |
| [**Deslocamento Z**](#field-offset-z)<br/>`offset_z` | número · graus | 0 | -10000 … 10000 |
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-offset-x">Deslocamento X · <code>offset_x</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Deslocamento X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Deslocamento Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Deslocamento Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Deslocamento Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Deslocamento Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Rotation Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Rotation Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-RotationConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Scale Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-scale/
---

# Scale Constraint

Restrição de mundo com uma fonte

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.scale` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Restrição de mundo com uma fonte

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Scale Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.ScaleConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-scaleconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Fator X**](#field-offset-x)<br/>`offset_x` | número · x | 1 | 0 … 10000 |
| [**Fator Y**](#field-offset-y)<br/>`offset_y` | número · x | 1 | 0 … 10000 |
| [**Fator Z**](#field-offset-z)<br/>`offset_z` | número · x | 1 | 0 … 10000 |
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-offset-x">Fator X · <code>offset_x</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Fator X**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** 0 … 10000.



<h4 id="field-offset-y">Fator Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Fator Y**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** 0 … 10000.



<h4 id="field-offset-z">Fator Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Fator Z**.

**Uso e efeito:** Fator de escala no eixo indicado, combinado à escala da fonte. Valor 1 mantém o fator unitário; não é deslocamento em metros.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** 0 … 10000.



<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Scale Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Scale Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-ScaleConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Aim Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-aim/
---

# Aim Constraint

Restrição de mundo com uma fonte

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.aim` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Restrição de mundo com uma fonte

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Aim Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AimConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento X**](#field-offset-x)<br/>`offset_x` | número · graus | 0 | -10000 … 10000 |
| [**Deslocamento Y**](#field-offset-y)<br/>`offset_y` | número · graus | 0 | -10000 … 10000 |
| [**Deslocamento Z**](#field-offset-z)<br/>`offset_z` | número · graus | 0 | -10000 … 10000 |
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |
| [**Eixo de mira**](#field-aim-axis)<br/>`aim_axis` | enumeração | +Z | +X \| +Y \| +Z \| -X \| -Y \| -Z |
| [**Vertical de mundo**](#field-up-axis)<br/>`up_axis` | enumeração | Y | Y \| Z \| X |

<h4 id="field-offset-x">Deslocamento X · <code>offset_x</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Deslocamento X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Deslocamento Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Deslocamento Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Deslocamento Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Deslocamento Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-aim-axis">Eixo de mira · <code>aim_axis</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Eixo de mira**.

**Uso e efeito:** Escolhe o eixo local alinhado à direção do alvo.

**Valor:** +Z · **Tipo:** enumeração · **Domínio:** +X \| +Y \| +Z \| -X \| -Y \| -Z.



<h4 id="field-up-axis">Vertical de mundo · <code>up_axis</code></h4>

**Onde:** Inspector → **Aim Constraint** → **Ajustes** → **Vertical de mundo**.

**Uso e efeito:** Define a convenção de vertical da orientação; evite direção degenerada.

**Valor:** Y · **Tipo:** enumeração · **Domínio:** Y \| Z \| X.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Aim Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-AimConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Parent Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/
---

# Parent Constraint

Segue posição e rotação da fonte sem herdar escala

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.parent` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Segue posição e rotação da fonte sem herdar escala

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Parent Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.ParentConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-parentconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento X**](#field-offset-x)<br/>`offset_x` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento Y**](#field-offset-y)<br/>`offset_y` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento Z**](#field-offset-z)<br/>`offset_z` | número · u | 0 | -10000 … 10000 |
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-offset-x">Deslocamento X · <code>offset_x</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Deslocamento X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Deslocamento Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Deslocamento Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Deslocamento Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Deslocamento Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.



<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Rotação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Rotação offset X**](#field-rotation-offset-x)<br/>`rotation_offset_x` | número · graus | 0 | -10000 … 10000 |
| [**Rotação offset Y**](#field-rotation-offset-y)<br/>`rotation_offset_y` | número · graus | 0 | -10000 … 10000 |
| [**Rotação offset Z**](#field-rotation-offset-z)<br/>`rotation_offset_z` | número · graus | 0 | -10000 … 10000 |
| [**Rotação X**](#field-rotation-x)<br/>`rotation_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Rotação Y**](#field-rotation-y)<br/>`rotation_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Rotação Z**](#field-rotation-z)<br/>`rotation_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-rotation-offset-x">Rotação offset X · <code>rotation_offset_x</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação offset X**.

**Uso e efeito:** Offset angular da orientação resultante, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-rotation-offset-y">Rotação offset Y · <code>rotation_offset_y</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação offset Y**.

**Uso e efeito:** Offset angular da orientação resultante, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-rotation-offset-z">Rotação offset Z · <code>rotation_offset_z</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação offset Z**.

**Uso e efeito:** Offset angular da orientação resultante, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -10000 … 10000.



<h4 id="field-rotation-x">Rotação X · <code>rotation_x</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação X**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo X.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-rotation-y">Rotação Y · <code>rotation_y</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação Y**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Y.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-rotation-z">Rotação Z · <code>rotation_z</code></h4>

**Onde:** Inspector → **Parent Constraint** → **Rotação** → **Rotação Z**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Parent Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-ParentConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Look At Constraint"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-constraint-look-at/
---

# Look At Constraint

Orienta +Z para a fonte com vertical e roll

**Família:** Lógica · **Grupo:** Restrições · **Identificador:** `astra.constraint.look_at` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Orienta +Z para a fonte com vertical e roll

Ligue a fonte/alvo no Inspector; escolha os eixos e a influência. Use em um objeto cuja pose não esteja sob autoridade incompatível da física ou de outro controlador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Restrições** → **Look At Constraint**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.LookAtConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-lookatconstraint/).



## Exemplo de uso

Crie um objeto visual e uma fonte. Atribua a fonte, mova-a em Play e compare o objeto com Peso 0 e Peso 1. Para mola, compare duas frequências e observe a aproximação ao alvo.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Influência

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Fonte**](#field-target)<br/>`target` | referência | Escolher fonte | qualquer objeto · fora da subárvore |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Influência** → **Peso**.

**Uso e efeito:** Influência do resultado: 0 não influencia e 1 aplica integralmente. Compare com a pose sem a restrição.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Influência** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-target">Fonte · <code>target</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Influência** → **Fonte**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher fonte · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Mira

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Roll**](#field-roll)<br/>`roll` | número · graus | 0 | -360 … 360 |
| [**Vertical de mundo**](#field-up-axis)<br/>`up_axis` | enumeração | Y | Y \| Z \| X |

<h4 id="field-roll">Roll · <code>roll</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Mira** → **Roll**.

**Uso e efeito:** Rotação em torno do eixo de mira; não muda a posição do alvo.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -360 … 360.



<h4 id="field-up-axis">Vertical de mundo · <code>up_axis</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Mira** → **Vertical de mundo**.

**Uso e efeito:** Define a convenção de vertical da orientação; evite direção degenerada.

**Valor:** Y · **Tipo:** enumeração · **Domínio:** Y \| Z \| X.



### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Aplicar X**](#field-axis-x)<br/>`axis_x` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Y**](#field-axis-y)<br/>`axis_y` | booleano | verdadeiro | verdadeiro \| falso |
| [**Aplicar Z**](#field-axis-z)<br/>`axis_z` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-axis-x">Aplicar X · <code>axis_x</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Ajustes** → **Aplicar X**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-y">Aplicar Y · <code>axis_y</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Ajustes** → **Aplicar Y**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-axis-z">Aplicar Z · <code>axis_z</code></h4>

**Onde:** Inspector → **Look At Constraint** → **Ajustes** → **Aplicar Z**.

**Uso e efeito:** Aplica a restrição no eixo indicado; desligar conserva esse canal fora da influência.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Restrições e molas](/pt-br/snapshot-2026-10-06/roadmap/restricoes-e-molas/). Consolidar autoria de fontes, limites de composição e aceite de lifecycle/pose por família. Não há cronograma individual publicado para cada setter. A presença de uma restrição não implica suporte a toda a família de constraints da Unity.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Look At Constraint** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-LookAtConstraint.html). Essa referência não representa paridade funcional.


---

---
title: "Transform Tween"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-tween-transform/
---

# Transform Tween

Interpola canais locais com espera, curva e repetição

**Família:** Lógica · **Grupo:** Tempo · **Identificador:** `astra.tween.transform` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Interpola canais locais com espera, curva e repetição

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.TransformTween](/pt-br/snapshot-2026-10-06/api/astra-components-transformtween/).



## Exemplo de uso

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Tempo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Duração**](#field-duration)<br/>`duration` | número · s | 1 | 0.001 … 36000 |
| [**Espera**](#field-delay)<br/>`delay` | número · s | 0 | 0 … 36000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Iniciar no Play**](#field-autoplay)<br/>`autoplay` | booleano | verdadeiro | verdadeiro \| falso |
| [**Ignorar escala de tempo**](#field-ignore-time-scale)<br/>`ignore_time_scale` | booleano | falso | verdadeiro \| falso |
| [**Curva**](#field-easing)<br/>`easing` | enumeração | Linear | Linear \| Smoothstep \| Quadrático entrada \| Quadrático saída |

<h4 id="field-duration">Duração · <code>duration</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Duração**.

**Uso e efeito:** Tempo da reprodução/interpolação; configure na unidade indicada. Valor curto acelera a transição.

**Valor:** 1 · **Tipo:** número · **Unidade:** s · **Domínio:** 0.001 … 36000.



<h4 id="field-delay">Espera · <code>delay</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Espera**.

**Uso e efeito:** Espera inicial antes de reproduzir a transição.

**Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 36000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-autoplay">Iniciar no Play · <code>autoplay</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Iniciar no Play**.

**Uso e efeito:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-ignore-time-scale">Ignorar escala de tempo · <code>ignore_time_scale</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Ignorar escala de tempo**.

**Uso e efeito:** Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-easing">Curva · <code>easing</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Curva**.

**Uso e efeito:** Escolhe a curva de interpolação; altera a velocidade ao longo da transição, não o valor final.

**Valor:** Linear · **Tipo:** enumeração · **Domínio:** Linear \| Smoothstep \| Quadrático entrada \| Quadrático saída.



### Destino

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Destino X**](#field-position-x)<br/>`position_x` | número · u | 0 | -100000 … 100000 |
| [**Destino Y**](#field-position-y)<br/>`position_y` | número · u | 0 | -100000 … 100000 |
| [**Destino Z**](#field-position-z)<br/>`position_z` | número · u | 0 | -100000 … 100000 |
| [**Rotação X**](#field-rotation-x)<br/>`rotation_x` | número · graus | 0 | -100000 … 100000 |
| [**Rotação Y**](#field-rotation-y)<br/>`rotation_y` | número · graus | 0 | -100000 … 100000 |
| [**Rotação Z**](#field-rotation-z)<br/>`rotation_z` | número · graus | 0 | -100000 … 100000 |
| [**Escala X**](#field-scale-x)<br/>`scale_x` | número · x | 1 | -100000 … 100000 |
| [**Escala Y**](#field-scale-y)<br/>`scale_y` | número · x | 1 | -100000 … 100000 |
| [**Escala Z**](#field-scale-z)<br/>`scale_z` | número · x | 1 | -100000 … 100000 |
| [**Destino relativo**](#field-relative)<br/>`relative` | booleano | falso | verdadeiro \| falso |
| [**Mover**](#field-position)<br/>`position` | booleano | verdadeiro | verdadeiro \| falso |
| [**Girar**](#field-rotation)<br/>`rotation` | booleano | falso | verdadeiro \| falso |
| [**Escalar**](#field-scale)<br/>`scale` | booleano | falso | verdadeiro \| falso |

<h4 id="field-position-x">Destino X · <code>position_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino X**.

**Uso e efeito:** Destino do canal de posição do tween, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-position-y">Destino Y · <code>position_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino Y**.

**Uso e efeito:** Destino do canal de posição do tween, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-position-z">Destino Z · <code>position_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino Z**.

**Uso e efeito:** Destino do canal de posição do tween, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-x">Rotação X · <code>rotation_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação X**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-y">Rotação Y · <code>rotation_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação Y**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-z">Rotação Z · <code>rotation_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação Z**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-scale-x">Escala X · <code>scale_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala X**.

**Uso e efeito:** Destino do canal de escala do tween, eixo X.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-scale-y">Escala Y · <code>scale_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala Y**.

**Uso e efeito:** Destino do canal de escala do tween, eixo Y.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-scale-z">Escala Z · <code>scale_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala Z**.

**Uso e efeito:** Destino do canal de escala do tween, eixo Z.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-relative">Destino relativo · <code>relative</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino relativo**.

**Uso e efeito:** Interpreta os valores da transição como deslocamento relativo, conforme o canal.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-position">Mover · <code>position</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Mover**.

**Uso e efeito:** Seleciona a participação do canal de posição no tween.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-rotation">Girar · <code>rotation</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Girar**.

**Uso e efeito:** Seleciona a participação do canal de rotação no tween.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-scale">Escalar · <code>scale</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escalar**.

**Uso e efeito:** Seleciona a participação do canal de escala no tween.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Repetição

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ida e volta**](#field-pingpong)<br/>`pingpong` | booleano | falso | verdadeiro \| falso |
| [**Ciclos**](#field-loops)<br/>`loops` | enumeração | Uma vez | Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes |

<h4 id="field-pingpong">Ida e volta · <code>pingpong</code></h4>

**Onde:** Inspector → **Transform Tween** → **Repetição** → **Ida e volta**.

**Uso e efeito:** Alterna ida e volta na reprodução.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-loops">Ciclos · <code>loops</code></h4>

**Onde:** Inspector → **Transform Tween** → **Repetição** → **Ciclos**.

**Uso e efeito:** Número/política de repetições no domínio indicado; confira a opção de repetição contínua na enumeração/contrato.

**Valor:** Uma vez · **Tipo:** enumeração · **Domínio:** Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes.



### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ao concluir**](#field-finished-action)<br/>`finished_action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto |
| [**Receptor**](#field-finished-target)<br/>`finished_target` | referência | Escolher objeto | qualquer objeto |

<h4 id="field-finished-action">Ao concluir · <code>finished_action</code></h4>

**Onde:** Inspector → **Transform Tween** → **Conexão** → **Ao concluir**.

**Uso e efeito:** Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto.



<h4 id="field-finished-target">Receptor · <code>finished_target</code></h4>

**Onde:** Inspector → **Transform Tween** → **Conexão** → **Receptor**.

**Uso e efeito:** Referência persistente remapeada ao clonar; controla activeSelf do receptor

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Transform Tween** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_tween.html). Essa referência não representa paridade funcional.


---

---
title: "Timer"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-time-timer/
---

# Timer

Dispara eventos temporizados e ações persistentes de ativação de objetos

**Família:** Lógica · **Grupo:** Tempo · **Identificador:** `astra.time.timer` · **Payload:** 4

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Dispara eventos temporizados e ações persistentes de ativação de objetos

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Timer**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.GameTimer](/pt-br/snapshot-2026-10-06/api/astra-components-gametimer/).



## Exemplo de uso

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 4 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Disparo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Intervalo**](#field-interval-seconds)<br/>`interval_seconds` | número · s | 1 | 0.05 … 3600 |
| [**Iniciar automaticamente**](#field-auto-start)<br/>`auto_start` | booleano | verdadeiro | verdadeiro \| falso |
| [**Repetir**](#field-repeat)<br/>`repeat` | booleano | verdadeiro | verdadeiro \| falso |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Ignorar escala de tempo**](#field-ignore-time-scale)<br/>`ignore_time_scale` | booleano | falso | verdadeiro \| falso |

<h4 id="field-interval-seconds">Intervalo · <code>interval_seconds</code></h4>

**Onde:** Inspector → **Timer** → **Disparo** → **Intervalo**.

**Uso e efeito:** Tempo entre disparos; uma vez quando Repetir está desligado

**Valor:** 1 · **Tipo:** número · **Unidade:** s · **Domínio:** 0.05 … 3600.



<h4 id="field-auto-start">Iniciar automaticamente · <code>auto_start</code></h4>

**Onde:** Inspector → **Timer** → **Disparo** → **Iniciar automaticamente**.

**Uso e efeito:** Inicia ao entrar em Play ou criar a instância; desligado exige Start. Alteração não reinicia timer já criado

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-repeat">Repetir · <code>repeat</code></h4>

**Onde:** Inspector → **Timer** → **Disparo** → **Repetir**.

**Uso e efeito:** Repete o intervalo; desligado produz um disparo e termina.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Timer** → **Disparo** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-ignore-time-scale">Ignorar escala de tempo · <code>ignore_time_scale</code></h4>

**Onde:** Inspector → **Timer** → **Disparo** → **Ignorar escala de tempo**.

**Uso e efeito:** Usa o intervalo não escalado aceito do quadro; a pausa do editor interrompe ambos os relógios

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ao disparar**](#field-elapsed-action)<br/>`elapsed_action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto |
| [**Receptor**](#field-elapsed-target)<br/>`elapsed_target` | referência | Escolher objeto | qualquer objeto |

<h4 id="field-elapsed-action">Ao disparar · <code>elapsed_action</code></h4>

**Onde:** Inspector → **Timer** → **Conexão** → **Ao disparar**.

**Uso e efeito:** Executa uma ação no alvo antes de entregar TimerElapsed; alternar preserva a paridade dos disparos agregados

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto.



<h4 id="field-elapsed-target">Receptor · <code>elapsed_target</code></h4>

**Onde:** Inspector → **Timer** → **Conexão** → **Receptor**.

**Uso e efeito:** Alvo da ação; usa referência persistente remapeada por clone/prefab

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Timer** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_timer.html). Essa referência não representa paridade funcional.


---

---
title: "Conexão de evento"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-logic-event-connection/
---

# Conexão de evento

Evento deste objeto aciona objetos ou métodos, sem script

**Família:** Lógica · **Grupo:** Eventos · **Identificador:** `astra.logic.event_connection` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Evento deste objeto aciona objetos ou métodos, sem script

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Eventos** → **Conexão de evento**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.EventConnection](/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection/).



## Exemplo de uso

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Então

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Valor**](#field-argument)<br/>`argument` | número · s | 0 | 0 … 3600 |
| [**Ação**](#field-action)<br/>`action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto \| Chamar método |
| [**Método**](#field-method)<br/>`method` | enumeração | Nenhum | Nenhum \| Áudio: tocar \| Áudio: parar \| Áudio: pausar \| Áudio: retomar \| Áudio: posicionar \| Timer: iniciar \| Timer: parar \| Timer: pausar \| Timer: retomar \| Tween: reiniciar \| Tween: cancelar \| Tween: pausar \| Tween: retomar \| Percurso: reiniciar \| Percurso: parar |
| [**Receptor**](#field-receiver)<br/>`receiver` | referência | Este objeto | qualquer objeto |

<h4 id="field-argument">Valor · <code>argument</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Então** → **Valor**.

**Uso e efeito:** Timer: intervalo (zero usa o autorado). Áudio: posição do cursor

**Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-action">Ação · <code>action</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Então** → **Ação**.

**Uso e efeito:** Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto \| Chamar método.



<h4 id="field-method">Método · <code>method</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Então** → **Método**.

**Uso e efeito:** Chamado no primeiro componente do tipo correspondente no receptor

**Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** Nenhum \| Áudio: tocar \| Áudio: parar \| Áudio: pausar \| Áudio: retomar \| Áudio: posicionar \| Timer: iniciar \| Timer: parar \| Timer: pausar \| Timer: retomar \| Tween: reiniciar \| Tween: cancelar \| Tween: pausar \| Tween: retomar \| Percurso: reiniciar \| Percurso: parar.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-receiver">Receptor · <code>receiver</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Então** → **Receptor**.

**Uso e efeito:** Objeto ativado ou dono do componente chamado; vazio usa o próprio emissor

**Valor:** Este objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Uma vez**](#field-once)<br/>`once` | booleano | falso | verdadeiro \| falso |

<h4 id="field-enabled">Ativa · <code>enabled</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Conexão** → **Ativa**.

**Uso e efeito:** Desligada não reage a eventos; a configuração é preservada

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-once">Uma vez · <code>once</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Conexão** → **Uma vez**.

**Uso e efeito:** Reage só ao primeiro evento de cada execução de Play

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Quando

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Evento**](#field-event)<br/>`event` | enumeração | Nenhum | Nenhum \| Timer disparou \| Tween concluiu \| Sensor 3D: entrou \| Sensor 3D: saiu \| Colisão 3D: começou \| Colisão 3D: terminou \| Sensor 2D: entrou \| Sensor 2D: saiu \| Colisão 2D: começou \| Colisão 2D: terminou |
| [**Outro objeto**](#field-other-filter)<br/>`other_filter` | referência | Qualquer objeto | qualquer objeto |

<h4 id="field-event">Evento · <code>event</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Quando** → **Evento**.

**Uso e efeito:** Emitido por um componente deste objeto; sem o componente, a conexão não dispara

**Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** Nenhum \| Timer disparou \| Tween concluiu \| Sensor 3D: entrou \| Sensor 3D: saiu \| Colisão 3D: começou \| Colisão 3D: terminou \| Sensor 2D: entrou \| Sensor 2D: saiu \| Colisão 2D: começou \| Colisão 2D: terminou.



<h4 id="field-other-filter">Outro objeto · <code>other_filter</code></h4>

**Onde:** Inspector → **Conexão de evento** → **Quando** → **Outro objeto**.

**Uso e efeito:** Opcional: só contatos com este outro objeto

**Valor:** Qualquer objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Conexão de evento** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Events.UnityEvent.html). Essa referência não representa paridade funcional.


---

---
title: "Comportamento"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-script-behavior/
---

# Comportamento

Código C# do projeto

**Família:** Lógica · **Grupo:** Código · **Identificador:** `astra.script.behavior` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Código C# do projeto

Crie um Behavior C# com ComponentId estável, compile o projeto e anexe ao objeto. Campos públicos suportados e PropertyId aparecem no Inspector; callbacks recebem o mundo do Play.

## Criar e configurar

Área de código → crie/compile o Behavior → anexe ao objeto. Este registro não é criado pelo menu genérico.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. Não há fachada C# gerada para este tipo; não invente um nome de classe equivalente.



## Exemplo de uso

Anexe PlayerHealth ao Jogador e HeartHud ao HUD; atribua a referência Player, compile e entre em Play.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | não permitido |
| Alterar propriedades em Play | não permitido |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Execução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Comportamento** → **Execução** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Consolidar cenas, prefabs, contratos de scripts e mensagens, com referência remapeada e lifecycle correto. Contagem de APIs não mede fechamento funcional. Comportamento não validado deve permanecer explicitamente sem aceite.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Comportamento** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/MonoBehaviour.html). Essa referência não representa paridade funcional.


---

---
title: "Canvas UI"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-ui-canvas/
---

# Canvas UI

Instância independente de documento de UI, na tela ou no objeto

**Família:** Renderização · **Grupo:** Interface · **Identificador:** `astra.ui.canvas` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Instância independente de documento de UI, na tela ou no objeto

Salve um documento .aeui, atribua Documento UI e escolha Tela para HUD ou Mundo para plano na cena. Elementos Image/Text/Button são criados dentro desse documento.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Interface** → **Canvas UI**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.UiCanvas](/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas/).

O recurso Documento UI não entra na tabela numérica abaixo. Ele é escolhido por recurso registrado; em C#, use GetDocument/SetDocument. Image está dentro do .aeui, não neste componente.

## Exemplo de uso

Siga o tutorial HUD de corações: três Images cheias sobre três vazias e HeartHud ligado a PlayerHealth.

[HUD de corações completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/) · [Image e seus campos](/pt-br/snapshot-2026-10-06/ui/image/) · [Onde fica a UI](/pt-br/snapshot-2026-10-06/ui/comece-aqui/)

## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Apresentação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Posição X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -100000 … 100000 |
| [**Posição Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -100000 … 100000 |
| [**Posição Z**](#field-offset-z)<br/>`offset_z` | número · m | 0 | -100000 … 100000 |
| [**Rotação X**](#field-rotation-x)<br/>`rotation_x` | número · ° | 0 | -36000 … 36000 |
| [**Rotação Y**](#field-rotation-y)<br/>`rotation_y` | número · ° | 0 | -36000 … 36000 |
| [**Rotação Z**](#field-rotation-z)<br/>`rotation_z` | número · ° | 0 | -36000 … 36000 |

<h4 id="field-offset-x">Posição X · <code>offset_x</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Posição X**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-y">Posição Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Posição Y**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-z">Posição Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Posição Z**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-x">Rotação X · <code>rotation_x</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Rotação X**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -36000 … 36000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-y">Rotação Y · <code>rotation_y</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Rotação Y**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -36000 … 36000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-z">Rotação Z · <code>rotation_z</code></h4>

**Onde:** Inspector → **Canvas UI** → **Apresentação** → **Rotação Z**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -36000 … 36000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Canvas

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Largura**](#field-width)<br/>`width` | número · px | 800 | 1 … 16384 |
| [**Altura**](#field-height)<br/>`height` | número · px | 600 | 1 … 16384 |
| [**Unidades por pixel**](#field-units-per-pixel)<br/>`units_per_pixel` | número · m/px | 0.005 | 0.00001 … 10 |
| [**Ordem**](#field-order)<br/>`order` | número | 0 | -10000 … 10000 |
| [**Habilitado**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Oclusão no mundo**](#field-occlusion)<br/>`occlusion` | booleano | verdadeiro | verdadeiro \| falso |
| [**Apresentação**](#field-mode)<br/>`mode` | enumeração | Tela | Tela \| Mundo / objeto |

<h4 id="field-width">Largura · <code>width</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Largura**.

**Uso e efeito:** Resolução local do plano no modo Mundo. No modo Tela, o retângulo é o viewport; não é resolução de referência para escala.

**Valor:** 800 · **Tipo:** número · **Unidade:** px · **Domínio:** 1 … 16384.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-height">Altura · <code>height</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Altura**.

**Uso e efeito:** Resolução local do plano no modo Mundo. No modo Tela, o retângulo é o viewport; não é resolução de referência para escala.

**Valor:** 600 · **Tipo:** número · **Unidade:** px · **Domínio:** 1 … 16384.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-units-per-pixel">Unidades por pixel · <code>units_per_pixel</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Unidades por pixel**.

**Uso e efeito:** Aplica-se ao Canvas no mundo; Tela usa o viewport.

**Valor:** 0.005 · **Tipo:** número · **Unidade:** m/px · **Domínio:** 0.00001 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-order">Ordem · <code>order</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Ordem**.

**Uso e efeito:** Ordena apresentação dos Canvas; compare sobreposição e entrada com o modo efetivo.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Habilitado · <code>enabled</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Habilitado**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-occlusion">Oclusão no mundo · <code>occlusion</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Oclusão no mundo**.

**Uso e efeito:** Depth e hit de Canvas no mundo.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-mode">Apresentação · <code>mode</code></h4>

**Onde:** Inspector → **Canvas UI** → **Canvas** → **Apresentação**.

**Uso e efeito:** Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

**Valor:** Tela · **Tipo:** enumeração · **Domínio:** Tela \| Mundo / objeto.



### Entrada

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Espaço do movimento**](#field-movement-space)<br/>`movement_space` | enumeração | Mundo | Mundo \| Local do jogador \| Camera de entrada |
| [**Jogador / receptor**](#field-input-receiver)<br/>`input_receiver` | referência | Acoes globais | objeto compatível com o receptor |
| [**Camera de entrada**](#field-input-camera)<br/>`input_camera` | referência | Nenhuma | astra.camera |

<h4 id="field-movement-space">Espaço do movimento · <code>movement_space</code></h4>

**Onde:** Inspector → **Canvas UI** → **Entrada** → **Espaço do movimento**.

**Uso e efeito:** Escolhe espaço do vetor de movimento: mundo, jogador ou câmera de entrada.

**Valor:** Mundo · **Tipo:** enumeração · **Domínio:** Mundo \| Local do jogador \| Camera de entrada.



<h4 id="field-input-receiver">Jogador / receptor · <code>input_receiver</code></h4>

**Onde:** Inspector → **Canvas UI** → **Entrada** → **Jogador / receptor**.

**Uso e efeito:** Character ou motor de corpo dinâmico ativo.

**Valor:** Acoes globais · **Tipo:** referência · **Domínio:** objeto compatível com o receptor.



<h4 id="field-input-camera">Camera de entrada · <code>input_camera</code></h4>

**Onde:** Inspector → **Canvas UI** → **Entrada** → **Camera de entrada**.

**Uso e efeito:** Câmera usada para o espaço de movimento/olhar dos controles do Canvas.

**Valor:** Nenhuma · **Tipo:** referência · **Domínio:** astra.camera.



## Roadmap deste componente

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). R0–R12: imagem/skins, autoria, foco/input, controles, layout, texto, bindings, inventário, apresentações, animação, templates e acesso. Consulte estados e critérios por função na página dedicada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Canvas UI** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/class-Canvas.html). Essa referência não representa paridade funcional.


---

---
title: "Malha"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-render-mesh/
---

# Malha

Geometria e material

**Família:** Renderização · **Grupo:** Geometria · **Identificador:** `astra.render.mesh` · **Payload:** 9

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Geometria e material

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Geometria** → **Malha**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.MeshRenderer](/pt-br/snapshot-2026-10-06/api/astra-components-meshrenderer/).



## Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 9 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Geral

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cor R**](#field-base-color-r)<br/>`base_color.r` | número | 1 | 0 … 1 |
| [**Cor G**](#field-base-color-g)<br/>`base_color.g` | número | 1 | 0 … 1 |
| [**Cor B**](#field-base-color-b)<br/>`base_color.b` | número | 1 | 0 … 1 |
| [**Rugosidade**](#field-roughness)<br/>`roughness` | número | 0.5 | 0 … 1 |
| [**Metálico**](#field-metallic)<br/>`metallic` | número | 0 | 0 … 1 |
| [**Intensidade da normal**](#field-normal-scale)<br/>`normal_scale` | número | 1 | 0 … 16 |
| [**Especular**](#field-specular)<br/>`specular` | número | 1 | 0 … 1 |
| [**Emissão R**](#field-emission-r)<br/>`emission.r` | número | 0 | 0 … 1 |
| [**Emissão G**](#field-emission-g)<br/>`emission.g` | número | 0 | 0 … 1 |
| [**Emissão B**](#field-emission-b)<br/>`emission.b` | número | 0 | 0 … 1 |
| [**Potência de emissão**](#field-emission-strength)<br/>`emission_strength` | número | 1 | 0 … 10000 |
| [**Renderizar**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-base-color-r">Cor R · <code>base_color.r</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Cor R**.

**Uso e efeito:** Canal R da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-base-color-g">Cor G · <code>base_color.g</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Cor G**.

**Uso e efeito:** Canal G da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-base-color-b">Cor B · <code>base_color.b</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Cor B**.

**Uso e efeito:** Canal B da cor base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-roughness">Rugosidade · <code>roughness</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Rugosidade**.

**Uso e efeito:** Rugosidade PBR: menor valor produz reflexão mais concentrada; maior torna a superfície mais áspera.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-metallic">Metálico · <code>metallic</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Metálico**.

**Uso e efeito:** Participação metálica no material PBR; altera resposta difusa/especular.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-normal-scale">Intensidade da normal · <code>normal_scale</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Intensidade da normal**.

**Uso e efeito:** Intensidade do normal map; exige textura e canal compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 16.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-specular">Especular · <code>specular</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Especular**.

**Uso e efeito:** Ajuste especular do material dentro do contrato do renderer.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-emission-r">Emissão R · <code>emission.r</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Emissão R**.

**Uso e efeito:** Canal R da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-emission-g">Emissão G · <code>emission.g</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Emissão G**.

**Uso e efeito:** Canal G da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-emission-b">Emissão B · <code>emission.b</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Emissão B**.

**Uso e efeito:** Canal B da cor emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-emission-strength">Potência de emissão · <code>emission_strength</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Potência de emissão**.

**Uso e efeito:** Multiplica a emissão do material; não adiciona uma luz iluminando objetos vizinhos.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10000.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-enabled">Renderizar · <code>enabled</code></h4>

**Onde:** Inspector → **Malha** → **Geral** → **Renderizar**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Lightmap

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Escala U**](#field-lightmap-scale-u)<br/>`lightmap.scale_u` | número<br/>Por slot | 1 | 0.00001 … 1 |
| [**Escala V**](#field-lightmap-scale-v)<br/>`lightmap.scale_v` | número<br/>Por slot | 1 | 0.00001 … 1 |
| [**Deslocamento U**](#field-lightmap-offset-u)<br/>`lightmap.offset_u` | número<br/>Por slot | 0 | 0 … 1 |
| [**Deslocamento V**](#field-lightmap-offset-v)<br/>`lightmap.offset_v` | número<br/>Por slot | 0 | 0 … 1 |
| [**Intensidade**](#field-lightmap-intensity)<br/>`lightmap.intensity` | número<br/>Por slot | 1 | 0 … 10000 |
| [**Receber lightmap indireto**](#field-lightmap-enabled)<br/>`lightmap.enabled` | enumeração<br/>Por slot | Desativado | Desativado \| Lightmap indireto externo |

<h4 id="field-lightmap-scale-u">Escala U · <code>lightmap.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Escala U** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.00001 … 1.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-lightmap-scale-v">Escala V · <code>lightmap.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Escala V** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.00001 … 1.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-lightmap-offset-u">Deslocamento U · <code>lightmap.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-lightmap-offset-v">Deslocamento V · <code>lightmap.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-lightmap-intensity">Intensidade · <code>lightmap.intensity</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Intensidade** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10000.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-lightmap-enabled">Receber lightmap indireto · <code>lightmap.enabled</code></h4>

**Onde:** Inspector → **Malha** → **Lightmap** → **Receber lightmap indireto** → escolha o slot/recurso.

**Uso e efeito:** Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno.

**Valor:** Desativado · **Tipo:** enumeração · **Domínio:** Desativado \| Lightmap indireto externo.

RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes Capacidade necessária: `render.gi.lightmap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Superfície

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Corte do alfa**](#field-surface-alpha-cutoff)<br/>`surface.alpha_cutoff` | número<br/>Por slot | 0.5 | 0 … 1 |
| [**Rugosidade**](#field-material-roughness)<br/>`material.roughness` | número<br/>Por slot | 0.5 | 0 … 1 |
| [**Metálico**](#field-material-metallic)<br/>`material.metallic` | número<br/>Por slot | 0 | 0 … 1 |
| [**Intensidade da normal**](#field-material-normal-scale)<br/>`material.normal_scale` | número<br/>Por slot | 1 | 0 … 16 |
| [**Especular**](#field-material-specular)<br/>`material.specular` | número<br/>Por slot | 1 | 0 … 1 |
| [**Tipo de superfície**](#field-surface-alpha-mode)<br/>`surface.alpha_mode` | enumeração<br/>Por slot | Herdar | Herdar \| Opaco \| Recorte \| Mistura |
| [**Faces**](#field-surface-sides)<br/>`surface.sides` | enumeração<br/>Por slot | Herdar | Herdar \| Face única \| Face dupla |

<h4 id="field-surface-alpha-cutoff">Corte do alfa · <code>surface.alpha_cutoff</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Corte do alfa** → escolha o slot/recurso.

**Uso e efeito:** Limiar de corte de alpha no modo máscara; não cria transparência blend.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-roughness">Rugosidade · <code>material.roughness</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Rugosidade** → escolha o slot/recurso.

**Uso e efeito:** Valor do slot quando o override de material estiver ativo. Rugosidade PBR: menor valor produz reflexão mais concentrada; maior torna a superfície mais áspera.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-metallic">Metálico · <code>material.metallic</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Metálico** → escolha o slot/recurso.

**Uso e efeito:** Valor do slot quando o override de material estiver ativo. Participação metálica no material PBR; altera resposta difusa/especular.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-normal-scale">Intensidade da normal · <code>material.normal_scale</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Intensidade da normal** → escolha o slot/recurso.

**Uso e efeito:** Valor do slot quando o override de material estiver ativo. Intensidade do normal map; exige textura e canal compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 16.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-specular">Especular · <code>material.specular</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Especular** → escolha o slot/recurso.

**Uso e efeito:** Valor do slot quando o override de material estiver ativo. Ajuste especular do material dentro do contrato do renderer.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-surface-alpha-mode">Tipo de superfície · <code>surface.alpha_mode</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Tipo de superfície** → escolha o slot/recurso.

**Uso e efeito:** Escolhe tratamento opaco/máscara/blend no domínio do contrato.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Opaco \| Recorte \| Mistura.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-surface-sides">Faces · <code>surface.sides</code></h4>

**Onde:** Inspector → **Malha** → **Superfície** → **Faces** → escolha o slot/recurso.

**Uso e efeito:** Define tratamento de faces/lados do material.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Face única \| Face dupla.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Canais

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Força da oclusão**](#field-channels-occlusion-strength)<br/>`channels.occlusion_strength` | número<br/>Por slot | -1 | -1 … 1 |
| [**Canal da rugosidade**](#field-channels-roughness)<br/>`channels.roughness` | enumeração<br/>Por slot | Herdar | Herdar \| R \| G \| B \| A |
| [**Canal do metálico**](#field-channels-metallic)<br/>`channels.metallic` | enumeração<br/>Por slot | Herdar | Herdar \| R \| G \| B \| A |
| [**Canal da oclusão**](#field-channels-occlusion)<br/>`channels.occlusion` | enumeração<br/>Por slot | Herdar | Herdar \| R \| G \| B \| A |
| [**Origem da oclusão**](#field-channels-occlusion-source)<br/>`channels.occlusion_source` | enumeração<br/>Por slot | Herdar | Herdar \| Sem oclusão \| No mapa metal/rugosidade \| Textura própria |
| [**Inverter Y da normal**](#field-channels-normal-flip-y)<br/>`channels.normal_flip_y` | enumeração<br/>Por slot | Herdar | Herdar \| Não \| Sim |
| [**Origem do alfa**](#field-channels-alpha-source)<br/>`channels.alpha_source` | enumeração<br/>Por slot | Herdar | Herdar \| Alfa da cor base \| Sempre opaco \| Luminância da cor base |

<h4 id="field-channels-occlusion-strength">Força da oclusão · <code>channels.occlusion_strength</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Força da oclusão** → escolha o slot/recurso.

**Uso e efeito:** Intensidade da oclusão do material, se a origem/canal tiver recurso.

**Valor:** -1 · **Tipo:** número · **Domínio:** -1 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-roughness">Canal da rugosidade · <code>channels.roughness</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Canal da rugosidade** → escolha o slot/recurso.

**Uso e efeito:** Seleciona qual canal da textura fornece o sinal indicado; confira a organização real da imagem importada.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| R \| G \| B \| A.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-metallic">Canal do metálico · <code>channels.metallic</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Canal do metálico** → escolha o slot/recurso.

**Uso e efeito:** Seleciona qual canal da textura fornece o sinal indicado; confira a organização real da imagem importada.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| R \| G \| B \| A.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-occlusion">Canal da oclusão · <code>channels.occlusion</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Canal da oclusão** → escolha o slot/recurso.

**Uso e efeito:** Seleciona qual canal da textura fornece o sinal indicado; confira a organização real da imagem importada.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| R \| G \| B \| A.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-occlusion-source">Origem da oclusão · <code>channels.occlusion_source</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Origem da oclusão** → escolha o slot/recurso.

**Uso e efeito:** Seleciona a origem de oclusão do material, separada do AO global.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Sem oclusão \| No mapa metal/rugosidade \| Textura própria.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-normal-flip-y">Inverter Y da normal · <code>channels.normal_flip_y</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Inverter Y da normal** → escolha o slot/recurso.

**Uso e efeito:** Inverte o eixo Y do normal map para ajustar convenção da textura.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Não \| Sim.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-channels-alpha-source">Origem do alfa · <code>channels.alpha_source</code></h4>

**Onde:** Inspector → **Malha** → **Canais** → **Origem do alfa** → escolha o slot/recurso.

**Uso e efeito:** Escolhe a origem usada para alpha da superfície.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Alfa da cor base \| Sempre opaco \| Luminância da cor base.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Amostragem

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento U**](#field-sampling-offset-u)<br/>`sampling.offset_u` | número<br/>Por slot | 0 | -100 … 100 |
| [**Deslocamento V**](#field-sampling-offset-v)<br/>`sampling.offset_v` | número<br/>Por slot | 0 | -100 … 100 |
| [**Escala U**](#field-sampling-scale-u)<br/>`sampling.scale_u` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Escala V**](#field-sampling-scale-v)<br/>`sampling.scale_v` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Rotação da UV**](#field-sampling-rotation)<br/>`sampling.rotation` | número<br/>Por slot | 0 | -360 … 360 |
| [**Cor base / Deslocamento U**](#field-sampling-base-color-offset-u)<br/>`sampling.base_color.offset_u` | número<br/>Por slot | 0 | -100 … 100 |
| [**Cor base / Deslocamento V**](#field-sampling-base-color-offset-v)<br/>`sampling.base_color.offset_v` | número<br/>Por slot | 0 | -100 … 100 |
| [**Cor base / Escala U**](#field-sampling-base-color-scale-u)<br/>`sampling.base_color.scale_u` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Cor base / Escala V**](#field-sampling-base-color-scale-v)<br/>`sampling.base_color.scale_v` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Cor base / Rotação**](#field-sampling-base-color-rotation)<br/>`sampling.base_color.rotation` | número<br/>Por slot | 0 | -360 … 360 |
| [**Normal / Deslocamento U**](#field-sampling-normal-offset-u)<br/>`sampling.normal.offset_u` | número<br/>Por slot | 0 | -100 … 100 |
| [**Normal / Deslocamento V**](#field-sampling-normal-offset-v)<br/>`sampling.normal.offset_v` | número<br/>Por slot | 0 | -100 … 100 |
| [**Normal / Escala U**](#field-sampling-normal-scale-u)<br/>`sampling.normal.scale_u` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Normal / Escala V**](#field-sampling-normal-scale-v)<br/>`sampling.normal.scale_v` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Normal / Rotação**](#field-sampling-normal-rotation)<br/>`sampling.normal.rotation` | número<br/>Por slot | 0 | -360 … 360 |
| [**Metal / rugosidade / Deslocamento U**](#field-sampling-metallic-roughness-offset-u)<br/>`sampling.metallic_roughness.offset_u` | número<br/>Por slot | 0 | -100 … 100 |
| [**Metal / rugosidade / Deslocamento V**](#field-sampling-metallic-roughness-offset-v)<br/>`sampling.metallic_roughness.offset_v` | número<br/>Por slot | 0 | -100 … 100 |
| [**Metal / rugosidade / Escala U**](#field-sampling-metallic-roughness-scale-u)<br/>`sampling.metallic_roughness.scale_u` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Metal / rugosidade / Escala V**](#field-sampling-metallic-roughness-scale-v)<br/>`sampling.metallic_roughness.scale_v` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Metal / rugosidade / Rotação**](#field-sampling-metallic-roughness-rotation)<br/>`sampling.metallic_roughness.rotation` | número<br/>Por slot | 0 | -360 … 360 |
| [**Emissão / Deslocamento U**](#field-sampling-emissive-offset-u)<br/>`sampling.emissive.offset_u` | número<br/>Por slot | 0 | -100 … 100 |
| [**Emissão / Deslocamento V**](#field-sampling-emissive-offset-v)<br/>`sampling.emissive.offset_v` | número<br/>Por slot | 0 | -100 … 100 |
| [**Emissão / Escala U**](#field-sampling-emissive-scale-u)<br/>`sampling.emissive.scale_u` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Emissão / Escala V**](#field-sampling-emissive-scale-v)<br/>`sampling.emissive.scale_v` | número<br/>Por slot | 1 | 0.01 … 100 |
| [**Emissão / Rotação**](#field-sampling-emissive-rotation)<br/>`sampling.emissive.rotation` | número<br/>Por slot | 0 | -360 … 360 |
| [**Conjunto de UV**](#field-sampling-uv-set)<br/>`sampling.uv_set` | enumeração<br/>Por slot | Herdar | Herdar \| UV 0 \| UV 1 \| Mundo (triplanar) |
| [**Repetição**](#field-sampling-wrap)<br/>`sampling.wrap` | enumeração<br/>Por slot | Herdar | Herdar \| Repetir \| Fixar na borda \| Espelhar |
| [**Filtro**](#field-sampling-filter)<br/>`sampling.filter` | enumeração<br/>Por slot | Herdar | Herdar \| Linear \| Vizinho mais próximo |
| [**Cor base / UV**](#field-sampling-base-color-uv-set)<br/>`sampling.base_color.uv_set` | enumeração<br/>Por slot | Herdar | Herdar \| UV 0 \| UV 1 \| Mundo (triplanar) |
| [**Cor base / Repetição**](#field-sampling-base-color-wrap)<br/>`sampling.base_color.wrap` | enumeração<br/>Por slot | Herdar | Herdar \| Repetir \| Fixar na borda \| Espelhar |
| [**Cor base / Filtro**](#field-sampling-base-color-filter)<br/>`sampling.base_color.filter` | enumeração<br/>Por slot | Herdar | Herdar \| Linear \| Vizinho mais próximo |
| [**Normal / UV**](#field-sampling-normal-uv-set)<br/>`sampling.normal.uv_set` | enumeração<br/>Por slot | Herdar | Herdar \| UV 0 \| UV 1 \| Mundo (triplanar) |
| [**Normal / Repetição**](#field-sampling-normal-wrap)<br/>`sampling.normal.wrap` | enumeração<br/>Por slot | Herdar | Herdar \| Repetir \| Fixar na borda \| Espelhar |
| [**Normal / Filtro**](#field-sampling-normal-filter)<br/>`sampling.normal.filter` | enumeração<br/>Por slot | Herdar | Herdar \| Linear \| Vizinho mais próximo |
| [**Metal / rugosidade / UV**](#field-sampling-metallic-roughness-uv-set)<br/>`sampling.metallic_roughness.uv_set` | enumeração<br/>Por slot | Herdar | Herdar \| UV 0 \| UV 1 \| Mundo (triplanar) |
| [**Metal / rugosidade / Repetição**](#field-sampling-metallic-roughness-wrap)<br/>`sampling.metallic_roughness.wrap` | enumeração<br/>Por slot | Herdar | Herdar \| Repetir \| Fixar na borda \| Espelhar |
| [**Metal / rugosidade / Filtro**](#field-sampling-metallic-roughness-filter)<br/>`sampling.metallic_roughness.filter` | enumeração<br/>Por slot | Herdar | Herdar \| Linear \| Vizinho mais próximo |
| [**Emissão / UV**](#field-sampling-emissive-uv-set)<br/>`sampling.emissive.uv_set` | enumeração<br/>Por slot | Herdar | Herdar \| UV 0 \| UV 1 \| Mundo (triplanar) |
| [**Emissão / Repetição**](#field-sampling-emissive-wrap)<br/>`sampling.emissive.wrap` | enumeração<br/>Por slot | Herdar | Herdar \| Repetir \| Fixar na borda \| Espelhar |
| [**Emissão / Filtro**](#field-sampling-emissive-filter)<br/>`sampling.emissive.filter` | enumeração<br/>Por slot | Herdar | Herdar \| Linear \| Vizinho mais próximo |

<h4 id="field-sampling-offset-u">Deslocamento U · <code>sampling.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-offset-v">Deslocamento V · <code>sampling.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-scale-u">Escala U · <code>sampling.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Escala U** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-scale-v">Escala V · <code>sampling.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Escala V** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-rotation">Rotação da UV · <code>sampling.rotation</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Rotação da UV** → escolha o slot/recurso.

**Uso e efeito:** Gira as coordenadas UV da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -360 … 360.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-offset-u">Cor base / Deslocamento U · <code>sampling.base_color.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-offset-v">Cor base / Deslocamento V · <code>sampling.base_color.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-scale-u">Cor base / Escala U · <code>sampling.base_color.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Escala U** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-scale-v">Cor base / Escala V · <code>sampling.base_color.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Escala V** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-rotation">Cor base / Rotação · <code>sampling.base_color.rotation</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Rotação** → escolha o slot/recurso.

**Uso e efeito:** Gira as coordenadas UV da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -360 … 360.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-offset-u">Normal / Deslocamento U · <code>sampling.normal.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-offset-v">Normal / Deslocamento V · <code>sampling.normal.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-scale-u">Normal / Escala U · <code>sampling.normal.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Escala U** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-scale-v">Normal / Escala V · <code>sampling.normal.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Escala V** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-rotation">Normal / Rotação · <code>sampling.normal.rotation</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Rotação** → escolha o slot/recurso.

**Uso e efeito:** Gira as coordenadas UV da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -360 … 360.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-offset-u">Metal / rugosidade / Deslocamento U · <code>sampling.metallic_roughness.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-offset-v">Metal / rugosidade / Deslocamento V · <code>sampling.metallic_roughness.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-scale-u">Metal / rugosidade / Escala U · <code>sampling.metallic_roughness.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Escala U** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-scale-v">Metal / rugosidade / Escala V · <code>sampling.metallic_roughness.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Escala V** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-rotation">Metal / rugosidade / Rotação · <code>sampling.metallic_roughness.rotation</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Rotação** → escolha o slot/recurso.

**Uso e efeito:** Gira as coordenadas UV da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -360 … 360.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-offset-u">Emissão / Deslocamento U · <code>sampling.emissive.offset_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Deslocamento U** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-offset-v">Emissão / Deslocamento V · <code>sampling.emissive.offset_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Deslocamento V** → escolha o slot/recurso.

**Uso e efeito:** Desloca a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-scale-u">Emissão / Escala U · <code>sampling.emissive.scale_u</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Escala U** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada U da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-scale-v">Emissão / Escala V · <code>sampling.emissive.scale_v</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Escala V** → escolha o slot/recurso.

**Uso e efeito:** Multiplica a coordenada V da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.01 … 100.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-rotation">Emissão / Rotação · <code>sampling.emissive.rotation</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Rotação** → escolha o slot/recurso.

**Uso e efeito:** Gira as coordenadas UV da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** 0 · **Tipo:** número · **Domínio:** -360 … 360.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-uv-set">Conjunto de UV · <code>sampling.uv_set</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Conjunto de UV** → escolha o slot/recurso.

**Uso e efeito:** Escolhe o conjunto UV existente na geometria da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| UV 0 \| UV 1 \| Mundo (triplanar).

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-wrap">Repetição · <code>sampling.wrap</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Repetição** → escolha o slot/recurso.

**Uso e efeito:** Escolhe repetição/clamp da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Repetir \| Fixar na borda \| Espelhar.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-filter">Filtro · <code>sampling.filter</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Filtro** → escolha o slot/recurso.

**Uso e efeito:** Escolhe filtragem da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Linear \| Vizinho mais próximo.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-uv-set">Cor base / UV · <code>sampling.base_color.uv_set</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / UV** → escolha o slot/recurso.

**Uso e efeito:** Escolhe o conjunto UV existente na geometria da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| UV 0 \| UV 1 \| Mundo (triplanar).

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-wrap">Cor base / Repetição · <code>sampling.base_color.wrap</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Repetição** → escolha o slot/recurso.

**Uso e efeito:** Escolhe repetição/clamp da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Repetir \| Fixar na borda \| Espelhar.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-base-color-filter">Cor base / Filtro · <code>sampling.base_color.filter</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Cor base / Filtro** → escolha o slot/recurso.

**Uso e efeito:** Escolhe filtragem da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Linear \| Vizinho mais próximo.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-uv-set">Normal / UV · <code>sampling.normal.uv_set</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / UV** → escolha o slot/recurso.

**Uso e efeito:** Escolhe o conjunto UV existente na geometria da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| UV 0 \| UV 1 \| Mundo (triplanar).

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-wrap">Normal / Repetição · <code>sampling.normal.wrap</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Repetição** → escolha o slot/recurso.

**Uso e efeito:** Escolhe repetição/clamp da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Repetir \| Fixar na borda \| Espelhar.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-normal-filter">Normal / Filtro · <code>sampling.normal.filter</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Normal / Filtro** → escolha o slot/recurso.

**Uso e efeito:** Escolhe filtragem da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Linear \| Vizinho mais próximo.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-uv-set">Metal / rugosidade / UV · <code>sampling.metallic_roughness.uv_set</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / UV** → escolha o slot/recurso.

**Uso e efeito:** Escolhe o conjunto UV existente na geometria da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| UV 0 \| UV 1 \| Mundo (triplanar).

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-wrap">Metal / rugosidade / Repetição · <code>sampling.metallic_roughness.wrap</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Repetição** → escolha o slot/recurso.

**Uso e efeito:** Escolhe repetição/clamp da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Repetir \| Fixar na borda \| Espelhar.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-metallic-roughness-filter">Metal / rugosidade / Filtro · <code>sampling.metallic_roughness.filter</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Metal / rugosidade / Filtro** → escolha o slot/recurso.

**Uso e efeito:** Escolhe filtragem da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Linear \| Vizinho mais próximo.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-uv-set">Emissão / UV · <code>sampling.emissive.uv_set</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / UV** → escolha o slot/recurso.

**Uso e efeito:** Escolhe o conjunto UV existente na geometria da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| UV 0 \| UV 1 \| Mundo (triplanar).

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-wrap">Emissão / Repetição · <code>sampling.emissive.wrap</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Repetição** → escolha o slot/recurso.

**Uso e efeito:** Escolhe repetição/clamp da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Repetir \| Fixar na borda \| Espelhar.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sampling-emissive-filter">Emissão / Filtro · <code>sampling.emissive.filter</code></h4>

**Onde:** Inspector → **Malha** → **Amostragem** → **Emissão / Filtro** → escolha o slot/recurso.

**Uso e efeito:** Escolhe filtragem da amostragem da textura/canal indicado. Não cria UVs ou recurso ausente.

**Valor:** Herdar · **Tipo:** enumeração · **Domínio:** Herdar \| Linear \| Vizinho mais próximo.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Cor

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cor R**](#field-material-base-color-r)<br/>`material.base_color.r` | número<br/>Por slot | 1 | 0 … 1 |
| [**Cor G**](#field-material-base-color-g)<br/>`material.base_color.g` | número<br/>Por slot | 1 | 0 … 1 |
| [**Cor B**](#field-material-base-color-b)<br/>`material.base_color.b` | número<br/>Por slot | 1 | 0 … 1 |
| [**Material**](#field-material-override)<br/>`material.override` | enumeração<br/>Por slot | Herdado da fonte | Herdado da fonte \| Substituído nesta instância |

<h4 id="field-material-base-color-r">Cor R · <code>material.base_color.r</code></h4>

**Onde:** Inspector → **Malha** → **Cor** → **Cor R** → escolha o slot/recurso.

**Uso e efeito:** Canal R da cor material.base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-base-color-g">Cor G · <code>material.base_color.g</code></h4>

**Onde:** Inspector → **Malha** → **Cor** → **Cor G** → escolha o slot/recurso.

**Uso e efeito:** Canal G da cor material.base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-base-color-b">Cor B · <code>material.base_color.b</code></h4>

**Onde:** Inspector → **Malha** → **Cor** → **Cor B** → escolha o slot/recurso.

**Uso e efeito:** Canal B da cor material.base_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-override">Material · <code>material.override</code></h4>

**Onde:** Inspector → **Malha** → **Cor** → **Material** → escolha o slot/recurso.

**Uso e efeito:** Habilita os valores de material autorados no override do slot.

**Valor:** Herdado da fonte · **Tipo:** enumeração · **Domínio:** Herdado da fonte \| Substituído nesta instância.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Emissão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Emissão R**](#field-material-emission-r)<br/>`material.emission.r` | número<br/>Por slot | 0 | 0 … 1 |
| [**Emissão G**](#field-material-emission-g)<br/>`material.emission.g` | número<br/>Por slot | 0 | 0 … 1 |
| [**Emissão B**](#field-material-emission-b)<br/>`material.emission.b` | número<br/>Por slot | 0 | 0 … 1 |
| [**Potência de emissão**](#field-material-emission-strength)<br/>`material.emission_strength` | número<br/>Por slot | 1 | 0 … 10000 |

<h4 id="field-material-emission-r">Emissão R · <code>material.emission.r</code></h4>

**Onde:** Inspector → **Malha** → **Emissão** → **Emissão R** → escolha o slot/recurso.

**Uso e efeito:** Canal R da cor material.emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-emission-g">Emissão G · <code>material.emission.g</code></h4>

**Onde:** Inspector → **Malha** → **Emissão** → **Emissão G** → escolha o slot/recurso.

**Uso e efeito:** Canal G da cor material.emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-emission-b">Emissão B · <code>material.emission.b</code></h4>

**Onde:** Inspector → **Malha** → **Emissão** → **Emissão B** → escolha o slot/recurso.

**Uso e efeito:** Canal B da cor material.emission no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-material-emission-strength">Potência de emissão · <code>material.emission_strength</code></h4>

**Onde:** Inspector → **Malha** → **Emissão** → **Potência de emissão** → escolha o slot/recurso.

**Uso e efeito:** Valor do slot quando o override de material estiver ativo. Multiplica a emissão do material; não adiciona uma luz iluminando objetos vizinhos.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10000.

Capacidade necessária: `render.material.pbr`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Malha** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-MeshRenderer.html). Essa referência não representa paridade funcional.


---

---
title: "Malha deformável"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-render-skinned-mesh/
---

# Malha deformável

Esqueleto e blend shapes da Malha

**Família:** Renderização · **Grupo:** Geometria · **Identificador:** `astra.render.skinned_mesh` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Esqueleto e blend shapes da Malha

Atribua clipes/recursos e escolha reprodução. SkinnedMesh precisa dos dados de deformação compatíveis; um nome de clip ou blend shape não cria esse recurso.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Geometria** → **Malha deformável**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.SkinnedMesh](/pt-br/snapshot-2026-10-06/api/astra-components-skinnedmesh/).



## Exemplo de uso

Use um recurso com clipe real, compare Speed 0/1 e modos de repetição; confira deformação e bounds antes de usar culling.



## Dependências

- [Malha](/pt-br/snapshot-2026-10-06/componentes/astra-render-mesh/): Adicione Malha a este objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Skin

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Vetor de movimento da deformação**](#field-skinned-motion-vectors)<br/>`skinned_motion_vectors` | booleano | verdadeiro | verdadeiro \| falso |
| [**Qualidade**](#field-quality)<br/>`quality` | enumeração | Automática | Automática \| 1 osso \| 2 ossos \| 4 ossos |

<h4 id="field-skinned-motion-vectors">Vetor de movimento da deformação · <code>skinned_motion_vectors</code></h4>

**Onde:** Inspector → **Malha deformável** → **Skin** → **Vetor de movimento da deformação**.

**Uso e efeito:** A reprojeção temporal usa a pose anterior dos ossos e dos blend shapes, não só a do objeto

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Transparência e água usam as máscaras de reatividade/composição, não vetor próprio Capacidade necessária: `render.motion_vectors`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-quality">Qualidade · <code>quality</code></h4>

**Onde:** Inspector → **Malha deformável** → **Skin** → **Qualidade**.

**Uso e efeito:** Influências por vértice usadas na deformação (Skin Weights)

**Valor:** Automática · **Tipo:** enumeração · **Domínio:** Automática \| 1 osso \| 2 ossos \| 4 ossos.

Até 4 influências por vértice e 256 juntas por skin; morph targets não são importados Capacidade necessária: `render.skinning`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Blend shapes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso do blend shape**](#field-blend-shape-weight)<br/>`blend_shape_weight` | número · %<br/>Por slot | Depende do contexto | -1000 … 1000 |

<h4 id="field-blend-shape-weight">Peso do blend shape · <code>blend_shape_weight</code></h4>

**Onde:** Inspector → **Malha deformável** → **Blend shapes** → **Peso do blend shape** → escolha o slot/recurso.

**Uso e efeito:** 0 é a forma base, 100 é o alvo inteiro

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** % · **Domínio:** -1000 … 1000.

Até 4 influências por vértice e 256 juntas por skin; morph targets não são importados Capacidade necessária: `render.skinning`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Ampliar importação, composição, edição de clipes e aceite de deformação/motion vectors. Timeline de UI é outro sistema e continua parcial. Não pressupõe Animator completo.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Malha deformável** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-SkinnedMeshRenderer.html). Essa referência não representa paridade funcional.


---

---
title: "LOD Group"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-render-lod-group/
---

# LOD Group

Nível de detalhe pela altura na tela

**Família:** Renderização · **Grupo:** Desempenho · **Identificador:** `astra.render.lod_group` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Nível de detalhe pela altura na tela

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.LodGroup](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup/).



## Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Níveis

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Transição LOD 0**](#field-transition-0)<br/>`transition_0` | número · % | 60 | 0.1 … 100 |
| [**Transição LOD 1**](#field-transition-1)<br/>`transition_1` | número · % | 30 | 0.1 … 100 |
| [**Transição LOD 2**](#field-transition-2)<br/>`transition_2` | número · % | 10 | 0.1 … 100 |
| [**Transição LOD 3**](#field-transition-3)<br/>`transition_3` | número · % | 5 | 0.1 … 100 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Níveis**](#field-level-count)<br/>`level_count` | enumeração | 3 | 1 \| 2 \| 3 \| 4 |
| [**Objetos LOD 0**](#field-level-0)<br/>`level_0` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 1**](#field-level-1)<br/>`level_1` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 2**](#field-level-2)<br/>`level_2` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 3**](#field-level-3)<br/>`level_3` | referência | Nenhum | qualquer objeto · abaixo deste objeto |

<h4 id="field-transition-0">Transição LOD 0 · <code>transition_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 0**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 60 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-1">Transição LOD 1 · <code>transition_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 1**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 30 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-2">Transição LOD 2 · <code>transition_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 2**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 10 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-3">Transição LOD 3 · <code>transition_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 3**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 5 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Ativo**.

**Uso e efeito:** Desligar libera os renderizadores do controle deste grupo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-count">Níveis · <code>level_count</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Níveis**.

**Uso e efeito:** Quantidade de níveis ativos de LOD. Atribua malhas/objetos por nível.

**Valor:** 3 · **Tipo:** enumeração · **Domínio:** 1 \| 2 \| 3 \| 4.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-0">Objetos LOD 0 · <code>level_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 0**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-1">Objetos LOD 1 · <code>level_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 1**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-2">Objetos LOD 2 · <code>level_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 2**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-3">Objetos LOD 3 · <code>level_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 3**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Limites

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Tamanho**](#field-size)<br/>`size` | número | 1 | 0.001 … 1000000 |

<h4 id="field-size">Tamanho · <code>size</code></h4>

**Onde:** Inspector → **LOD Group** → **Limites** → **Tamanho**.

**Uso e efeito:** Maior extensão do nível mais detalhado; Recalcular mede a malha

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.001 … 1000000.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Fade

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Largura do fade LOD 0**](#field-fade-width-0)<br/>`fade_width_0` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 1**](#field-fade-width-1)<br/>`fade_width_1` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 2**](#field-fade-width-2)<br/>`fade_width_2` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 3**](#field-fade-width-3)<br/>`fade_width_3` | número | 0.2 | 0 … 1 |
| [**Animate Cross-fading**](#field-animate-cross-fading)<br/>`animate_cross_fading` | booleano | falso | verdadeiro \| falso |
| [**Fade Mode**](#field-fade-mode)<br/>`fade_mode` | enumeração | Nenhum | Nenhum \| Cross Fade |

<h4 id="field-fade-width-0">Largura do fade LOD 0 · <code>fade_width_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 0**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-1">Largura do fade LOD 1 · <code>fade_width_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 1**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-2">Largura do fade LOD 2 · <code>fade_width_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 2**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-3">Largura do fade LOD 3 · <code>fade_width_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 3**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-animate-cross-fading">Animate Cross-fading · <code>animate_cross_fading</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Animate Cross-fading**.

**Uso e efeito:** Troca por tempo em vez da faixa de largura

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-mode">Fade Mode · <code>fade_mode</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Fade Mode**.

**Uso e efeito:** Seleciona a política de transição de LOD, no domínio indicado.

**Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** Nenhum \| Cross Fade.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Execução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Forçar nível**](#field-force-level)<br/>`force_level` | enumeração | Automático | Automático \| LOD 0 \| LOD 1 \| LOD 2 \| LOD 3 |

<h4 id="field-force-level">Forçar nível · <code>force_level</code></h4>

**Onde:** Inspector → **LOD Group** → **Execução** → **Forçar nível**.

**Uso e efeito:** Estado de execução: 0 automático, n força o LOD n-1

**Valor:** Automático · **Tipo:** enumeração · **Domínio:** Automático \| LOD 0 \| LOD 1 \| LOD 2 \| LOD 3.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **LOD Group** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-LODGroup.html). Essa referência não representa paridade funcional.


---

---
title: "Ambiente"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-render-environment/
---

# Ambiente

Céu, atmosfera, neblina e pós globais ou por volume

**Família:** Renderização · **Grupo:** Ambiente · **Identificador:** `astra.render.environment` · **Payload:** 12

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Céu, atmosfera, neblina e pós globais ou por volume

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Ambiente** → **Ambiente**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.EnvironmentVolume](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume/).



## Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 12 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Geral

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Prioridade**](#field-priority)<br/>`priority` | número | 0 | -1000 … 1000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-priority">Prioridade · <code>priority</code></h4>

**Onde:** Inspector → **Ambiente** → **Geral** → **Prioridade**.

**Uso e efeito:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1000 … 1000.

Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Ambiente** → **Geral** → **Ativo**.

**Uso e efeito:** Participa da seleção por prioridade

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Atmosfera

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Zênite R**](#field-sky-zenith-r)<br/>`sky_zenith.r` | número | 0.025 | 0 … 1 |
| [**Zênite G**](#field-sky-zenith-g)<br/>`sky_zenith.g` | número | 0.1 | 0 … 1 |
| [**Zênite B**](#field-sky-zenith-b)<br/>`sky_zenith.b` | número | 0.32 | 0 … 1 |
| [**Horizonte R**](#field-sky-horizon-r)<br/>`sky_horizon.r` | número | 0.28 | 0 … 1 |
| [**Horizonte G**](#field-sky-horizon-g)<br/>`sky_horizon.g` | número | 0.42 | 0 … 1 |
| [**Horizonte B**](#field-sky-horizon-b)<br/>`sky_horizon.b` | número | 0.62 | 0 … 1 |
| [**Chão R**](#field-ground-r)<br/>`ground.r` | número | 0.11 | 0 … 1 |
| [**Chão G**](#field-ground-g)<br/>`ground.g` | número | 0.12 | 0 … 1 |
| [**Chão B**](#field-ground-b)<br/>`ground.b` | número | 0.14 | 0 … 1 |
| [**Força atmosférica**](#field-atmosphere)<br/>`atmosphere` | número | 1 | 0 … 1 |
| [**Diâmetro do sol**](#field-sun-disk-degrees)<br/>`sun_disk_degrees` | número · ° | 0.53 | 0.05 … 10 |
| [**Brilho do disco solar**](#field-sun-disk-intensity)<br/>`sun_disk_intensity` | número | 8 | 0 … 100 |
| [**Céu**](#field-sky)<br/>`sky` | enumeração | Atmosfera | HDRI \| Atmosfera \| Atmosfera física |

<h4 id="field-sky-zenith-r">Zênite R · <code>sky_zenith.r</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Zênite R**.

**Uso e efeito:** Canal R da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.025 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky-zenith-g">Zênite G · <code>sky_zenith.g</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Zênite G**.

**Uso e efeito:** Canal G da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.1 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky-zenith-b">Zênite B · <code>sky_zenith.b</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Zênite B**.

**Uso e efeito:** Canal B da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.32 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky-horizon-r">Horizonte R · <code>sky_horizon.r</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Horizonte R**.

**Uso e efeito:** Canal R da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.28 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky-horizon-g">Horizonte G · <code>sky_horizon.g</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Horizonte G**.

**Uso e efeito:** Canal G da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.42 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky-horizon-b">Horizonte B · <code>sky_horizon.b</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Horizonte B**.

**Uso e efeito:** Canal B da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.62 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ground-r">Chão R · <code>ground.r</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Chão R**.

**Uso e efeito:** Canal R da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.11 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ground-g">Chão G · <code>ground.g</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Chão G**.

**Uso e efeito:** Canal G da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.12 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ground-b">Chão B · <code>ground.b</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Chão B**.

**Uso e efeito:** Canal B da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.14 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-atmosphere">Força atmosférica · <code>atmosphere</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Força atmosférica**.

**Uso e efeito:** Quantidade da contribuição atmosférica no modelo de céu selecionado.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sun-disk-degrees">Diâmetro do sol · <code>sun_disk_degrees</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Diâmetro do sol**.

**Uso e efeito:** Tamanho angular do disco solar desenhado no céu.

**Valor:** 0.53 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0.05 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sun-disk-intensity">Brilho do disco solar · <code>sun_disk_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Brilho do disco solar**.

**Uso e efeito:** Brilho do disco solar; não substitui a intensidade de uma luz direcional.

**Valor:** 8 · **Tipo:** número · **Domínio:** 0 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sky">Céu · <code>sky</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera** → **Céu**.

**Uso e efeito:** Fonte visual do céu

**Valor:** Atmosfera · **Tipo:** enumeração · **Domínio:** HDRI \| Atmosfera \| Atmosfera física.

Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Neblina

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Neblina R**](#field-fog-color-r)<br/>`fog_color.r` | número | 0.58 | 0 … 1 |
| [**Neblina G**](#field-fog-color-g)<br/>`fog_color.g` | número | 0.67 | 0 … 1 |
| [**Neblina B**](#field-fog-color-b)<br/>`fog_color.b` | número | 0.76 | 0 … 1 |
| [**Energia da neblina**](#field-fog-light-energy)<br/>`fog_light_energy` | número · × | 1 | 0 … 65504 |
| [**Densidade**](#field-fog-density)<br/>`fog_density` | número · 1/m | 0.008 | 0 … 1 |
| [**Início**](#field-fog-start)<br/>`fog_start` | número · m | 8 | 0 … 10000 |
| [**Altura base**](#field-fog-base-height)<br/>`fog_base_height` | número · m | 0 | -100000 … 100000 |
| [**Decaimento por altura**](#field-fog-height-falloff)<br/>`fog_height_falloff` | número · 1/m | 0 | 0 … 10 |
| [**Neblina**](#field-fog)<br/>`fog` | booleano | falso | verdadeiro \| falso |

<h4 id="field-fog-color-r">Neblina R · <code>fog_color.r</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Neblina R**.

**Uso e efeito:** Canal R da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.58 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-color-g">Neblina G · <code>fog_color.g</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Neblina G**.

**Uso e efeito:** Canal G da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.67 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-color-b">Neblina B · <code>fog_color.b</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Neblina B**.

**Uso e efeito:** Canal B da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 0.76 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-light-energy">Energia da neblina · <code>fog_light_energy</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Energia da neblina**.

**Uso e efeito:** Energia de luz na neblina conforme o modelo de fog.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 65504.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-density">Densidade · <code>fog_density</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Densidade**.

**Uso e efeito:** Densidade da neblina; aumentar reduz visibilidade ao longo do percurso.

**Valor:** 0.008 · **Tipo:** número · **Unidade:** 1/m · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-start">Início · <code>fog_start</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Início**.

**Uso e efeito:** Distância a partir da qual a neblina começa.

**Valor:** 8 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-base-height">Altura base · <code>fog_base_height</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Altura base**.

**Uso e efeito:** Altura de referência da neblina de altura.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog-height-falloff">Decaimento por altura · <code>fog_height_falloff</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Decaimento por altura**.

**Uso e efeito:** Queda da densidade conforme altura.

**Valor:** 0 · **Tipo:** número · **Unidade:** 1/m · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fog">Neblina · <code>fog</code></h4>

**Onde:** Inspector → **Ambiente** → **Neblina** → **Neblina**.

**Uso e efeito:** Aplica neblina exponencial uniforme ou com decaimento por altura

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.environment.fog`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Exposição

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Compensação**](#field-exposure-ev)<br/>`exposure_ev` | número · EV | 0 | -16 … 16 |
| [**EV mínimo**](#field-auto-exposure-min-ev)<br/>`auto_exposure_min_ev` | número · EV | -8 | -16 … 16 |
| [**EV máximo**](#field-auto-exposure-max-ev)<br/>`auto_exposure_max_ev` | número · EV | 8 | -16 … 16 |
| [**Corte baixo**](#field-auto-exposure-low-percent)<br/>`auto_exposure_low_percent` | número | 0.05 | 0 … 1 |
| [**Corte alto**](#field-auto-exposure-high-percent)<br/>`auto_exposure_high_percent` | número | 0.95 | 0 … 1 |
| [**Cinza alvo**](#field-auto-exposure-target-grey)<br/>`auto_exposure_target_grey` | número | 0.18 | 0.01 … 1 |
| [**Velocidade ao escurecer**](#field-auto-exposure-speed-up)<br/>`auto_exposure_speed_up` | número · EV/s | 2 | 0.01 … 20 |
| [**Velocidade ao clarear**](#field-auto-exposure-speed-down)<br/>`auto_exposure_speed_down` | número · EV/s | 3 | 0.01 … 20 |
| [**Exposição automática**](#field-auto-exposure)<br/>`auto_exposure` | booleano | falso | verdadeiro \| falso |
| [**Peso central**](#field-auto-exposure-center-weighted)<br/>`auto_exposure_center_weighted` | booleano | falso | verdadeiro \| falso |

<h4 id="field-exposure-ev">Compensação · <code>exposure_ev</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Compensação**.

**Uso e efeito:** Exposição manual em EV antes do tonemapping; compare com auto exposição desligada.

**Valor:** 0 · **Tipo:** número · **Unidade:** EV · **Domínio:** -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-min-ev">EV mínimo · <code>auto_exposure_min_ev</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **EV mínimo**.

**Uso e efeito:** Limite inferior de exposição automática.

**Valor:** -8 · **Tipo:** número · **Unidade:** EV · **Domínio:** -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-max-ev">EV máximo · <code>auto_exposure_max_ev</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **EV máximo**.

**Uso e efeito:** Limite superior de exposição automática.

**Valor:** 8 · **Tipo:** número · **Unidade:** EV · **Domínio:** -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-low-percent">Corte baixo · <code>auto_exposure_low_percent</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Corte baixo**.

**Uso e efeito:** Percentil inferior do histograma para auto exposição.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-high-percent">Corte alto · <code>auto_exposure_high_percent</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Corte alto**.

**Uso e efeito:** Percentil superior do histograma para auto exposição.

**Valor:** 0.95 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-target-grey">Cinza alvo · <code>auto_exposure_target_grey</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Cinza alvo**.

**Uso e efeito:** Nível cinza alvo da medição automática.

**Valor:** 0.18 · **Tipo:** número · **Domínio:** 0.01 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-speed-up">Velocidade ao escurecer · <code>auto_exposure_speed_up</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Velocidade ao escurecer**.

**Uso e efeito:** Velocidade de adaptação ao elevar exposição.

**Valor:** 2 · **Tipo:** número · **Unidade:** EV/s · **Domínio:** 0.01 … 20.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-speed-down">Velocidade ao clarear · <code>auto_exposure_speed_down</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Velocidade ao clarear**.

**Uso e efeito:** Velocidade de adaptação ao reduzir exposição.

**Valor:** 3 · **Tipo:** número · **Unidade:** EV/s · **Domínio:** 0.01 … 20.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure">Exposição automática · <code>auto_exposure</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Exposição automática**.

**Uso e efeito:** Mede luminância HDR e adapta a exposição por câmera

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-auto-exposure-center-weighted">Peso central · <code>auto_exposure_center_weighted</code></h4>

**Onde:** Inspector → **Ambiente** → **Exposição** → **Peso central**.

**Uso e efeito:** Prioriza o centro da imagem na medição

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: `render.post.auto_exposure`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Pós

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limiar do bloom**](#field-bloom-threshold)<br/>`bloom_threshold` | número | 1 | 0 … 64 |
| [**Intensidade do bloom**](#field-bloom-intensity)<br/>`bloom_intensity` | número | 0.1 | 0 … 2 |
| [**Contraste**](#field-contrast)<br/>`contrast` | número | 1 | 0.5 … 2 |
| [**Saturação**](#field-saturation)<br/>`saturation` | número | 1 | 0 … 2 |
| [**Intensidade da vinheta**](#field-vignette-intensity)<br/>`vignette_intensity` | número | 0.18 | 0 … 1 |
| [**Intensidade do grão**](#field-film-grain-intensity)<br/>`film_grain_intensity` | número | 0.05 | 0 … 1 |
| [**Pós-processamento**](#field-post)<br/>`post` | booleano | verdadeiro | verdadeiro \| falso |
| [**Bloom**](#field-bloom)<br/>`bloom` | booleano | verdadeiro | verdadeiro \| falso |
| [**Vinheta**](#field-vignette)<br/>`vignette` | booleano | falso | verdadeiro \| falso |
| [**Grão de filme**](#field-film-grain)<br/>`film_grain` | booleano | falso | verdadeiro \| falso |
| [**Tonemapping**](#field-tone-mapper)<br/>`tone_mapper` | enumeração | ACES | Reinhard \| ACES \| AgX |

<h4 id="field-bloom-threshold">Limiar do bloom · <code>bloom_threshold</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Limiar do bloom**.

**Uso e efeito:** Limiar de brilho que participa do bloom.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 64.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.bloom`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-bloom-intensity">Intensidade do bloom · <code>bloom_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Intensidade do bloom**.

**Uso e efeito:** Intensidade do bloom habilitado.

**Valor:** 0.1 · **Tipo:** número · **Domínio:** 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.bloom`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-contrast">Contraste · <code>contrast</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Contraste**.

**Uso e efeito:** Contraste do pós-processamento.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.5 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-saturation">Saturação · <code>saturation</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Saturação**.

**Uso e efeito:** Saturação do pós-processamento.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-vignette-intensity">Intensidade da vinheta · <code>vignette_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Intensidade da vinheta**.

**Uso e efeito:** Força da vinheta habilitada.

**Valor:** 0.18 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-film-grain-intensity">Intensidade do grão · <code>film_grain_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Intensidade do grão**.

**Uso e efeito:** Força do grain habilitado.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.film_grain`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-post">Pós-processamento · <code>post</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Pós-processamento**.

**Uso e efeito:** Ativa os overrides autorais desta cena

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-bloom">Bloom · <code>bloom</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Bloom**.

**Uso e efeito:** Espalha altas luzes antes do tonemap

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.bloom`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-vignette">Vinheta · <code>vignette</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Vinheta**.

**Uso e efeito:** Escurece gradualmente as bordas

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-film-grain">Grão de filme · <code>film_grain</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Grão de filme**.

**Uso e efeito:** Adiciona grão sensível à luminância depois da resolução temporal

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.film_grain`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-tone-mapper">Tonemapping · <code>tone_mapper</code></h4>

**Onde:** Inspector → **Ambiente** → **Pós** → **Tonemapping**.

**Uso e efeito:** Curva aplicada ao HDR antes da saída

**Valor:** ACES · **Tipo:** enumeração · **Domínio:** Reinhard \| ACES \| AgX.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.tonemap`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Oclusão ambiente

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Raio**](#field-ambient-occlusion-radius)<br/>`ambient_occlusion_radius` | número · m | 1 | 0.05 … 10 |
| [**Intensidade**](#field-ambient-occlusion-intensity)<br/>`ambient_occlusion_intensity` | número | 1 | 0 … 4 |
| [**Potência**](#field-ambient-occlusion-power)<br/>`ambient_occlusion_power` | número | 1.5 | 0.1 … 4 |
| [**Viés**](#field-ambient-occlusion-bias)<br/>`ambient_occlusion_bias` | número · m | 0.02 | 0 … 1 |
| [**Oclusão ambiente**](#field-ambient-occlusion)<br/>`ambient_occlusion` | booleano | falso | verdadeiro \| falso |

<h4 id="field-ambient-occlusion-radius">Raio · <code>ambient_occlusion_radius</code></h4>

**Onde:** Inspector → **Ambiente** → **Oclusão ambiente** → **Raio**.

**Uso e efeito:** Raio de amostragem do AO global.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.05 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.ambient_occlusion`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ambient-occlusion-intensity">Intensidade · <code>ambient_occlusion_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Oclusão ambiente** → **Intensidade**.

**Uso e efeito:** Peso visual do AO global.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.ambient_occlusion`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ambient-occlusion-power">Potência · <code>ambient_occlusion_power</code></h4>

**Onde:** Inspector → **Ambiente** → **Oclusão ambiente** → **Potência**.

**Uso e efeito:** Curva de contraste do AO.

**Valor:** 1.5 · **Tipo:** número · **Domínio:** 0.1 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.ambient_occlusion`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ambient-occlusion-bias">Viés · <code>ambient_occlusion_bias</code></h4>

**Onde:** Inspector → **Ambiente** → **Oclusão ambiente** → **Viés**.

**Uso e efeito:** Bias para evitar auto oclusão excessiva.

**Valor:** 0.02 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.ambient_occlusion`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ambient-occlusion">Oclusão ambiente · <code>ambient_occlusion</code></h4>

**Onde:** Inspector → **Ambiente** → **Oclusão ambiente** → **Oclusão ambiente**.

**Uso e efeito:** Escurece contatos e concavidades a partir da profundidade da câmera

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.post.ambient_occlusion`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Peso**](#field-weight)<br/>`weight` | número | 1 | 0 … 1 |
| [**Distância de mistura**](#field-blend-distance)<br/>`blend_distance` | número · m | 0 | 0 … 100000 |
| [**Tamanho X**](#field-box-size-x)<br/>`box_size.x` | número · m | 10 | 0.01 … 100000 |
| [**Tamanho Y**](#field-box-size-y)<br/>`box_size.y` | número · m | 10 | 0.01 … 100000 |
| [**Tamanho Z**](#field-box-size-z)<br/>`box_size.z` | número · m | 10 | 0.01 … 100000 |
| [**Raio**](#field-sphere-radius)<br/>`sphere_radius` | número · m | 5 | 0.01 … 100000 |
| [**Sobrescrever céu**](#field-override-sky)<br/>`override_sky` | booleano | verdadeiro | verdadeiro \| falso |
| [**Sobrescrever neblina**](#field-override-fog)<br/>`override_fog` | booleano | verdadeiro | verdadeiro \| falso |
| [**Sobrescrever pós**](#field-override-post)<br/>`override_post` | booleano | verdadeiro | verdadeiro \| falso |
| [**Sobrescrever luz indireta**](#field-override-indirect)<br/>`override_indirect` | booleano | verdadeiro | verdadeiro \| falso |
| [**Modo**](#field-volume-shape)<br/>`volume_shape` | enumeração | Global | Global \| Caixa \| Esfera |
| [**Camada**](#field-volume-layer)<br/>`volume_layer` | enumeração | Ambiente 0 | Ambiente 0 \| Ambiente 1 \| Ambiente 2 \| Ambiente 3 \| Ambiente 4 \| Ambiente 5 \| Ambiente 6 \| Ambiente 7 |

<h4 id="field-weight">Peso · <code>weight</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Peso**.

**Uso e efeito:** Peso da mistura do volume, combinado com shape, distância e prioridade.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-blend-distance">Distância de mistura · <code>blend_distance</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Distância de mistura**.

**Uso e efeito:** Distância de mistura na borda do volume de ambiente.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-box-size-x">Tamanho X · <code>box_size.x</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Tamanho X**.

**Uso e efeito:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

**Valor:** 10 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-box-size-y">Tamanho Y · <code>box_size.y</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Tamanho Y**.

**Uso e efeito:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

**Valor:** 10 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-box-size-z">Tamanho Z · <code>box_size.z</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Tamanho Z**.

**Uso e efeito:** Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

**Valor:** 10 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-sphere-radius">Raio · <code>sphere_radius</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Raio**.

**Uso e efeito:** Raio do volume esférico, quando esse shape está selecionado.

**Valor:** 5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-override-sky">Sobrescrever céu · <code>override_sky</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Sobrescrever céu**.

**Uso e efeito:** Participa da mistura de céu e atmosfera

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-override-fog">Sobrescrever neblina · <code>override_fog</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Sobrescrever neblina**.

**Uso e efeito:** Participa da mistura de neblina

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-override-post">Sobrescrever pós · <code>override_post</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Sobrescrever pós**.

**Uso e efeito:** Participa da mistura de exposição e pós

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-override-indirect">Sobrescrever luz indireta · <code>override_indirect</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Sobrescrever luz indireta**.

**Uso e efeito:** Participa da mistura de difuso e reflexo indiretos

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-volume-shape">Modo · <code>volume_shape</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Modo**.

**Uso e efeito:** Global afeta toda vista; formas usam o Transform do objeto

**Valor:** Global · **Tipo:** enumeração · **Domínio:** Global \| Caixa \| Esfera.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-volume-layer">Camada · <code>volume_layer</code></h4>

**Onde:** Inspector → **Ambiente** → **Volume** → **Camada**.

**Uso e efeito:** Filtro consultado pela câmera

**Valor:** Ambiente 0 · **Tipo:** enumeração · **Domínio:** Ambiente 0 \| Ambiente 1 \| Ambiente 2 \| Ambiente 3 \| Ambiente 4 \| Ambiente 5 \| Ambiente 6 \| Ambiente 7.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Luz indireta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Difuso indireto**](#field-indirect-diffuse)<br/>`indirect_diffuse` | número · × | 1 | 0 … 4 |
| [**Reflexo indireto**](#field-indirect-specular)<br/>`indirect_specular` | número · × | 1 | 0 … 4 |

<h4 id="field-indirect-diffuse">Difuso indireto · <code>indirect_diffuse</code></h4>

**Onde:** Inspector → **Ambiente** → **Luz indireta** → **Difuso indireto**.

**Uso e efeito:** Escala da iluminação indireta difusa disponível; não calcula GI bake.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 4.

Capacidade necessária: `render.ambient.hemispheric`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-indirect-specular">Reflexo indireto · <code>indirect_specular</code></h4>

**Onde:** Inspector → **Ambiente** → **Luz indireta** → **Reflexo indireto**.

**Uso e efeito:** Escala do reflexo especular do ambiente.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 4.

Capacidade necessária: `render.ambient.specular`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Atmosfera física

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Intensidade**](#field-physical-sky-intensity)<br/>`physical_sky_intensity` | número · × | 1 | 0 … 16 |
| [**Densidade do ar**](#field-air-density)<br/>`air_density` | número · × | 1 | 0 … 8 |
| [**Densidade de aerossóis**](#field-aerosol-density)<br/>`aerosol_density` | número · × | 1 | 0 … 8 |
| [**Anisotropia dos aerossóis**](#field-aerosol-anisotropy)<br/>`aerosol_anisotropy` | número · g | 0.76 | 0 … 0.95 |
| [**Raio do planeta**](#field-planet-radius-km)<br/>`planet_radius_km` | número · km | 6371 | 1 … 100000 |
| [**Altura do observador**](#field-observer-height-km)<br/>`observer_height_km` | número · km | 0.002 | 0 … 1000 |
| [**Escala Rayleigh**](#field-rayleigh-scale-height-km)<br/>`rayleigh_scale_height_km` | número · km | 8 | 0.1 … 100 |
| [**Escala de aerossóis**](#field-aerosol-scale-height-km)<br/>`aerosol_scale_height_km` | número · km | 1.2 | 0.05 … 50 |
| [**Altura da atmosfera**](#field-atmosphere-height-km)<br/>`atmosphere_height_km` | número · km | 100 | 1 … 1000 |
| [**Albedo médio do solo**](#field-ground-albedo)<br/>`ground_albedo` | número | 0.1 | 0 … 1 |
| [**Alta qualidade**](#field-physical-atmosphere-high-quality)<br/>`physical_atmosphere_high_quality` | booleano | falso | verdadeiro \| falso |

<h4 id="field-physical-sky-intensity">Intensidade · <code>physical_sky_intensity</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Intensidade**.

**Uso e efeito:** Multiplica a energia do céu físico.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-air-density">Densidade do ar · <code>air_density</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Densidade do ar**.

**Uso e efeito:** Densidade do ar usada pelo céu físico.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 8.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-aerosol-density">Densidade de aerossóis · <code>aerosol_density</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Densidade de aerossóis**.

**Uso e efeito:** Densidade do aerosol usada pelo céu físico.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 8.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-aerosol-anisotropy">Anisotropia dos aerossóis · <code>aerosol_anisotropy</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Anisotropia dos aerossóis**.

**Uso e efeito:** Anisotropia da dispersão de aerosol.

**Valor:** 0.76 · **Tipo:** número · **Unidade:** g · **Domínio:** 0 … 0.95.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-planet-radius-km">Raio do planeta · <code>planet_radius_km</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Raio do planeta**.

**Uso e efeito:** Raio do planeta do modelo atmosférico em km.

**Valor:** 6371 · **Tipo:** número · **Unidade:** km · **Domínio:** 1 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-observer-height-km">Altura do observador · <code>observer_height_km</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Altura do observador**.

**Uso e efeito:** Altura do observador atmosférico em km.

**Valor:** 0.002 · **Tipo:** número · **Unidade:** km · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-rayleigh-scale-height-km">Escala Rayleigh · <code>rayleigh_scale_height_km</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Escala Rayleigh**.

**Uso e efeito:** Altura característica da dispersão Rayleigh.

**Valor:** 8 · **Tipo:** número · **Unidade:** km · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-aerosol-scale-height-km">Escala de aerossóis · <code>aerosol_scale_height_km</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Escala de aerossóis**.

**Uso e efeito:** Altura característica do aerosol.

**Valor:** 1.2 · **Tipo:** número · **Unidade:** km · **Domínio:** 0.05 … 50.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-atmosphere-height-km">Altura da atmosfera · <code>atmosphere_height_km</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Altura da atmosfera**.

**Uso e efeito:** Espessura da atmosfera do modelo.

**Valor:** 100 · **Tipo:** número · **Unidade:** km · **Domínio:** 1 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-ground-albedo">Albedo médio do solo · <code>ground_albedo</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Albedo médio do solo**.

**Uso e efeito:** Refletância do chão do céu físico.

**Valor:** 0.1 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-physical-atmosphere-high-quality">Alta qualidade · <code>physical_atmosphere_high_quality</code></h4>

**Onde:** Inspector → **Ambiente** → **Atmosfera física** → **Alta qualidade**.

**Uso e efeito:** Aumenta as amostras de vista e luz; custa mais GPU

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.physical_atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### HDRI

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Rotação HDRI**](#field-hdri-rotation-degrees)<br/>`hdri_rotation_degrees` | número · ° | 0 | -360 … 360 |
| [**Exposição HDRI**](#field-hdri-exposure-ev)<br/>`hdri_exposure_ev` | número · EV | 0 | -16 … 16 |

<h4 id="field-hdri-rotation-degrees">Rotação HDRI · <code>hdri_rotation_degrees</code></h4>

**Onde:** Inspector → **Ambiente** → **HDRI** → **Rotação HDRI**.

**Uso e efeito:** Gira a orientação do ambiente HDRI em graus.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -360 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-hdri-exposure-ev">Exposição HDRI · <code>hdri_exposure_ev</code></h4>

**Onde:** Inspector → **Ambiente** → **HDRI** → **Exposição HDRI**.

**Uso e efeito:** Exposição do recurso HDRI em EV.

**Valor:** 0 · **Tipo:** número · **Unidade:** EV · **Domínio:** -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.environment.atmosphere`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Ambiente** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/Volumes.html). Essa referência não representa paridade funcional.


---

---
title: "Luz"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-render-light/
---

# Luz

Direcional, pontual ou spot

**Família:** Luz · **Grupo:** Luzes · **Identificador:** `astra.render.light` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Direcional, pontual ou spot

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Luz**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.Light](/pt-br/snapshot-2026-10-06/api/astra-components-light/).



## Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Emissão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cor R**](#field-color-r)<br/>`color.r` | número | 1 | 0 … 1 |
| [**Cor G**](#field-color-g)<br/>`color.g` | número | 1 | 0 … 1 |
| [**Cor B**](#field-color-b)<br/>`color.b` | número | 1 | 0 … 1 |
| [**Temperatura**](#field-color-temperature)<br/>`color_temperature` | número · K | 6500 | 1667 … 25000 |
| [**Intensidade**](#field-intensity)<br/>`intensity` | número | 1000 | 0 … 1000000 |
| [**Filtro por temperatura**](#field-use-color-temperature)<br/>`use_color_temperature` | booleano | falso | verdadeiro \| falso |
| [**Unidade**](#field-unit)<br/>`unit` | enumeração | Lux / lúmen | Interna (legada) \| Lux / candela \| Lux / lúmen |

<h4 id="field-color-r">Cor R · <code>color.r</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Cor R**.

**Uso e efeito:** Canal R da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Aceita tween numérico via contrato de propriedade.

<h4 id="field-color-g">Cor G · <code>color.g</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Cor G**.

**Uso e efeito:** Canal G da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Aceita tween numérico via contrato de propriedade.

<h4 id="field-color-b">Cor B · <code>color.b</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Cor B**.

**Uso e efeito:** Canal B da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Aceita tween numérico via contrato de propriedade.

<h4 id="field-color-temperature">Temperatura · <code>color_temperature</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Temperatura**.

**Uso e efeito:** Multiplicada pela cor linear; D65 é 6500 K

**Valor:** 6500 · **Tipo:** número · **Unidade:** K · **Domínio:** 1667 … 25000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.  Capacidade necessária: `render.light.temperature`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-intensity">Intensidade · <code>intensity</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Intensidade**.

**Uso e efeito:** Energia da luz na unidade selecionada; compare com distância/alcance constantes.

**Valor:** 1000 · **Tipo:** número · **Domínio:** 0 … 1000000.

Aceita tween numérico via contrato de propriedade.

<h4 id="field-use-color-temperature">Filtro por temperatura · <code>use_color_temperature</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Filtro por temperatura**.

**Uso e efeito:** Multiplica a cor pela temperatura de corpo negro

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Capacidade necessária: `render.light.temperature`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-unit">Unidade · <code>unit</code></h4>

**Onde:** Inspector → **Luz** → **Emissão** → **Unidade**.

**Uso e efeito:** Direcional usa lux; luz local usa candela ou lúmen

**Valor:** Lux / lúmen · **Tipo:** enumeração · **Domínio:** Interna (legada) \| Lux / candela \| Lux / lúmen.

Capacidade necessária: `render.light.photometric`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Alcance**](#field-range)<br/>`range` | número · m | 10 | 0.01 … 1000 |
| [**Meio-cone interno**](#field-inner-angle)<br/>`inner_angle` | número · ° | 20 | 0 … 89 |
| [**Meio-cone externo**](#field-outer-angle)<br/>`outer_angle` | número · ° | 35 | 0 … 89 |

<h4 id="field-range">Alcance · <code>range</code></h4>

**Onde:** Inspector → **Luz** → **Volume** → **Alcance**.

**Uso e efeito:** Alcance de contribuição da luz pontual/spot.

**Valor:** 10 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-inner-angle">Meio-cone interno · <code>inner_angle</code></h4>

**Onde:** Inspector → **Luz** → **Volume** → **Meio-cone interno**.

**Uso e efeito:** Ângulo interno do cone spot; região de contribuição central.

**Valor:** 20 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 89.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-outer-angle">Meio-cone externo · <code>outer_angle</code></h4>

**Onde:** Inspector → **Luz** → **Volume** → **Meio-cone externo**.

**Uso e efeito:** Ângulo externo do cone spot; limite de contribuição.

**Valor:** 35 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 89.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Sombra

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Força da sombra**](#field-shadow-strength)<br/>`shadow_strength` | número | 1 | 0 … 1 |
| [**Desvio**](#field-shadow-bias)<br/>`shadow_bias` | número · texel | 0.05 | 0 … 2 |
| [**Desvio na normal**](#field-shadow-normal-bias)<br/>`shadow_normal_bias` | número · texel | 0.4 | 0 … 2 |
| [**Plano próximo da sombra**](#field-shadow-near-plane)<br/>`shadow_near_plane` | número · m | 0.2 | 0.01 … 10 |
| [**Sombra**](#field-shadow-mode)<br/>`shadow_mode` | enumeração | Nenhuma | Nenhuma \| Dura \| Suave |
| [**Resolução da sombra**](#field-shadow-resolution)<br/>`shadow_resolution` | enumeração | Automática | Automática \| Baixa \| Média \| Alta \| Muito alta |

<h4 id="field-shadow-strength">Força da sombra · <code>shadow_strength</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Força da sombra**.

**Uso e efeito:** 1 é sombra opaca; abaixo disso a luz vaza pelo oclusor

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-shadow-bias">Desvio · <code>shadow_bias</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Desvio**.

**Uso e efeito:** Afasta a comparação de profundidade e some com a acne

**Valor:** 0.05 · **Tipo:** número · **Unidade:** texel · **Domínio:** 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-shadow-normal-bias">Desvio na normal · <code>shadow_normal_bias</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Desvio na normal**.

**Uso e efeito:** Desloca a amostra ao longo da normal; some com o serrilhado da borda

**Valor:** 0.4 · **Tipo:** número · **Unidade:** texel · **Domínio:** 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-shadow-near-plane">Plano próximo da sombra · <code>shadow_near_plane</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Plano próximo da sombra**.

**Uso e efeito:** Perto demais perde precisão; longe demais corta o que está junto da lâmpada

**Valor:** 0.2 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-shadow-mode">Sombra · <code>shadow_mode</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Sombra**.

**Uso e efeito:** Projeção de sombra desta luz no atlas local

**Valor:** Nenhuma · **Tipo:** enumeração · **Domínio:** Nenhuma \| Dura \| Suave.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-shadow-resolution">Resolução da sombra · <code>shadow_resolution</code></h4>

**Onde:** Inspector → **Luz** → **Sombra** → **Resolução da sombra**.

**Uso e efeito:** Automática escolhe pelo tamanho da luz na tela

**Valor:** Automática · **Tipo:** enumeração · **Domínio:** Automática \| Baixa \| Média \| Alta \| Muito alta.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Atlas em quadtree: spot ocupa um mapa, pontual seis faces Capacidade necessária: `render.shadow.punctual`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Geral

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acesa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Modalidade**](#field-kind)<br/>`kind` | enumeração | Pontual | Direcional \| Pontual \| Spot |

<h4 id="field-enabled">Acesa · <code>enabled</code></h4>

**Onde:** Inspector → **Luz** → **Geral** → **Acesa**.

**Uso e efeito:** Ativa a contribuição desta luz

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-kind">Modalidade · <code>kind</code></h4>

**Onde:** Inspector → **Luz** → **Geral** → **Modalidade**.

**Uso e efeito:** Tipo de emissão da luz

**Valor:** Pontual · **Tipo:** enumeração · **Domínio:** Direcional \| Pontual \| Spot.



## Roadmap deste componente

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Luz** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-Light.html). Essa referência não representa paridade funcional.


---

---
title: "Câmera"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-camera/
---

# Câmera

Projeção e enquadramento

**Família:** Câmera · **Grupo:** Projeção · **Identificador:** `astra.camera` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Projeção e enquadramento

Crie uma câmera ativa; escolha projeção e planos. Olhar recebe entrada e Acompanhar alvo recebe uma referência. Não use a pose da câmera como fonte implícita de física do jogador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Projeção** → **Câmera**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.Camera](/pt-br/snapshot-2026-10-06/api/astra-components-camera/).



## Exemplo de uso

Atribua um alvo a Acompanhar alvo e mova-o. Compare Damping 0 com um tempo maior. Teste perspectiva/ortográfica com a mesma malha enquadrada.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Lente

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Campo vertical**](#field-vertical-fov)<br/>`vertical_fov` | número · ° | 60 | 1 … 170 |
| [**Próximo**](#field-near-plane)<br/>`near_plane` | número · m | 0.1 | 0.001 … 10000 |
| [**Distante**](#field-far-plane)<br/>`far_plane` | número · m | 2000 | 0.01 … 1000000 |
| [**Meia altura**](#field-orthographic-half-height)<br/>`orthographic_half_height` | número · m | 5 | 0.001 … 100000 |
| [**Projeção**](#field-projection)<br/>`projection` | enumeração | Perspectiva | Perspectiva \| Ortográfica |

<h4 id="field-vertical-fov">Campo vertical · <code>vertical_fov</code></h4>

**Onde:** Inspector → **Câmera** → **Lente** → **Campo vertical**.

**Uso e efeito:** Campo de visão vertical da perspectiva, em graus.

**Valor:** 60 · **Tipo:** número · **Unidade:** ° · **Domínio:** 1 … 170.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Aceita tween numérico via contrato de propriedade.

<h4 id="field-near-plane">Próximo · <code>near_plane</code></h4>

**Onde:** Inspector → **Câmera** → **Lente** → **Próximo**.

**Uso e efeito:** Plano de corte próximo; valor exageradamente baixo reduz precisão de depth.

**Valor:** 0.1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.



<h4 id="field-far-plane">Distante · <code>far_plane</code></h4>

**Onde:** Inspector → **Câmera** → **Lente** → **Distante**.

**Uso e efeito:** Plano de corte distante; objetos além ficam cortados.

**Valor:** 2000 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 1000000.



<h4 id="field-orthographic-half-height">Meia altura · <code>orthographic_half_height</code></h4>

**Onde:** Inspector → **Câmera** → **Lente** → **Meia altura**.

**Uso e efeito:** Metade da altura visível. Zoom altera esta extensão.

**Valor:** 5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Aceita tween numérico via contrato de propriedade.

<h4 id="field-projection">Projeção · <code>projection</code></h4>

**Onde:** Inspector → **Câmera** → **Lente** → **Projeção**.

**Uso e efeito:** Seleciona perspectiva ou ortográfica.

**Valor:** Perspectiva · **Tipo:** enumeração · **Domínio:** Perspectiva \| Ortográfica.



### Saída

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Prioridade**](#field-priority)<br/>`priority` | número | 0 | -10000 … 10000 |
| [**Usar no Play**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Ambientes**](#field-environment-mask)<br/>`environment_mask` | enumeração | Todos os ambientes | Todos os ambientes \| Ambiente 0 \| Ambiente 1 \| Ambiente 2 \| Ambiente 3 \| Ambiente 4 \| Ambiente 5 \| Ambiente 6 \| Ambiente 7 |

<h4 id="field-priority">Prioridade · <code>priority</code></h4>

**Onde:** Inspector → **Câmera** → **Saída** → **Prioridade**.

**Uso e efeito:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Usar no Play · <code>enabled</code></h4>

**Onde:** Inspector → **Câmera** → **Saída** → **Usar no Play**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-environment-mask">Ambientes · <code>environment_mask</code></h4>

**Onde:** Inspector → **Câmera** → **Saída** → **Ambientes**.

**Uso e efeito:** Volumes que esta câmera consulta

**Valor:** Todos os ambientes · **Tipo:** enumeração · **Domínio:** Todos os ambientes \| Ambiente 0 \| Ambiente 1 \| Ambiente 2 \| Ambiente 3 \| Ambiente 4 \| Ambiente 5 \| Ambiente 6 \| Ambiente 7.

Capacidade necessária: `render.environment.volumes`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Consolidar composição de rigs, apresentação e aceite de input/viewports. Pareamento geral de jogadores/câmeras pertence também ao roadmap UI R4/R9; não há data por método.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Câmera** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-Camera.html). Essa referência não representa paridade funcional.


---

---
title: "Olhar"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-camera-look/
---

# Olhar

Rotação local da câmera por entrada ou script

**Família:** Câmera · **Grupo:** Controle · **Identificador:** `astra.camera.look` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Rotação local da câmera por entrada ou script

Crie uma câmera ativa; escolha projeção e planos. Olhar recebe entrada e Acompanhar alvo recebe uma referência. Não use a pose da câmera como fonte implícita de física do jogador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Controle** → **Olhar**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.CameraLook](/pt-br/snapshot-2026-10-06/api/astra-components-cameralook/).



## Exemplo de uso

Atribua um alvo a Acompanhar alvo e mova-o. Compare Damping 0 com um tempo maior. Teste perspectiva/ortográfica com a mesma malha enquadrada.



## Dependências

- [Câmera](/pt-br/snapshot-2026-10-06/componentes/astra-camera/): Adicione Câmera a este objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Sensibilidade

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Sensibilidade horizontal graus/tela**](#field-yaw-sensitivity)<br/>`yaw_sensitivity` | número · ° | 300 | 0 … 720 |
| [**Sensibilidade vertical graus/tela**](#field-pitch-sensitivity)<br/>`pitch_sensitivity` | número · ° | 195 | 0 … 720 |

<h4 id="field-yaw-sensitivity">Sensibilidade horizontal graus/tela · <code>yaw_sensitivity</code></h4>

**Onde:** Inspector → **Olhar** → **Sensibilidade** → **Sensibilidade horizontal graus/tela**.

**Uso e efeito:** Ganho horizontal do olhar.

**Valor:** 300 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 720.



<h4 id="field-pitch-sensitivity">Sensibilidade vertical graus/tela · <code>pitch_sensitivity</code></h4>

**Onde:** Inspector → **Olhar** → **Sensibilidade** → **Sensibilidade vertical graus/tela**.

**Uso e efeito:** Ganho vertical do olhar.

**Valor:** 195 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 720.



### Limites

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite vertical graus**](#field-pitch-limit)<br/>`pitch_limit` | número · ° | 83 | 1 … 89 |

<h4 id="field-pitch-limit">Limite vertical graus · <code>pitch_limit</code></h4>

**Onde:** Inspector → **Olhar** → **Limites** → **Limite vertical graus**.

**Uso e efeito:** Limita inclinação vertical da câmera.

**Valor:** 83 · **Tipo:** número · **Unidade:** ° · **Domínio:** 1 … 89.



### Controle

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Olhar** → **Controle** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Consolidar composição de rigs, apresentação e aceite de input/viewports. Pareamento geral de jogadores/câmeras pertence também ao roadmap UI R4/R9; não há data por método.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Olhar** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/Packages/com.unity.cinemachine@3.1/manual/CinemachinePanTilt.html). Essa referência não representa paridade funcional.


---

---
title: "Acompanhar alvo"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-camera-follow/
---

# Acompanhar alvo

Posiciona a câmera após física e animação

**Família:** Câmera · **Grupo:** Controle · **Identificador:** `astra.camera.follow` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Posiciona a câmera após física e animação

Crie uma câmera ativa; escolha projeção e planos. Olhar recebe entrada e Acompanhar alvo recebe uma referência. Não use a pose da câmera como fonte implícita de física do jogador.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Câmera** / **Controle** → **Acompanhar alvo**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.CameraFollow](/pt-br/snapshot-2026-10-06/api/astra-components-camerafollow/).



## Exemplo de uso

Atribua um alvo a Acompanhar alvo e mova-o. Compare Damping 0 com um tempo maior. Teste perspectiva/ortográfica com a mesma malha enquadrada.



## Dependências

- [Câmera](/pt-br/snapshot-2026-10-06/componentes/astra-camera/): Adicione Câmera a este objeto

## Conflitos

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): A câmera seguidora não pode receber pose do corpo físico
- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): A câmera seguidora não pode receber pose do personagem

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Posição

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Deslocamento Y**](#field-offset-y)<br/>`offset_y` | número · m | 2 | -10000 … 10000 |
| [**Deslocamento Z**](#field-offset-z)<br/>`offset_z` | número · m | -5 | -10000 … 10000 |
| [**Alvo**](#field-target)<br/>`target` | referência | Escolher objeto | qualquer objeto · fora da subárvore |

<h4 id="field-offset-x">Deslocamento X · <code>offset_x</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Posição** → **Deslocamento X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Deslocamento Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Posição** → **Deslocamento Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 2 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Deslocamento Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Posição** → **Deslocamento Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** -5 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-target">Alvo · <code>target</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Posição** → **Alvo**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto · fora da subárvore.



### Resposta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Amortecimento**](#field-damping-seconds)<br/>`damping_seconds` | número · s | 0.2 | 0 … 30 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-damping-seconds">Amortecimento · <code>damping_seconds</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Resposta** → **Amortecimento**.

**Uso e efeito:** Tempo de suavização da aproximação da câmera ao alvo.

**Valor:** 0.2 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 30.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Acompanhar alvo** → **Resposta** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Consolidar composição de rigs, apresentação e aceite de input/viewports. Pareamento geral de jogadores/câmeras pertence também ao roadmap UI R4/R9; não há data por método.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Acompanhar alvo** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/Packages/com.unity.cinemachine@3.1/manual/CinemachineFollow.html). Essa referência não representa paridade funcional.


---

---
title: "Receita de colisão"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-collision-recipe/
---

# Receita de colisão

Fontes e base das partes para regeneração explícita preservando edições

**Família:** Física 3D · **Grupo:** Autoria · **Identificador:** `astra.physics.collision_recipe` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Fontes e base das partes para regeneração explícita preservando edições

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Área de código → crie/compile o Behavior → anexe ao objeto. Este registro não é criado pelo menu genérico.

O schema permite uma única instância desse tipo por objeto. Não há fachada C# gerada para este tipo; não invente um nome de classe equivalente.



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Adicione Corpo físico a este objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | não permitido |
| Alterar propriedades em Play | não permitido |
| Múltiplas instâncias | Não |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Fontes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Fonte da colisão**](#field-source-0)<br/>`source_0` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-1)<br/>`source_1` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-2)<br/>`source_2` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-3)<br/>`source_3` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-4)<br/>`source_4` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-5)<br/>`source_5` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-6)<br/>`source_6` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-7)<br/>`source_7` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-8)<br/>`source_8` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-9)<br/>`source_9` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-10)<br/>`source_10` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-11)<br/>`source_11` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-12)<br/>`source_12` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-13)<br/>`source_13` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-14)<br/>`source_14` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-15)<br/>`source_15` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-16)<br/>`source_16` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-17)<br/>`source_17` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-18)<br/>`source_18` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-19)<br/>`source_19` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-20)<br/>`source_20` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-21)<br/>`source_21` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-22)<br/>`source_22` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-23)<br/>`source_23` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-24)<br/>`source_24` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-25)<br/>`source_25` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-26)<br/>`source_26` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-27)<br/>`source_27` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-28)<br/>`source_28` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-29)<br/>`source_29` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-30)<br/>`source_30` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-31)<br/>`source_31` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-32)<br/>`source_32` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-33)<br/>`source_33` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-34)<br/>`source_34` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-35)<br/>`source_35` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-36)<br/>`source_36` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-37)<br/>`source_37` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-38)<br/>`source_38` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-39)<br/>`source_39` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-40)<br/>`source_40` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-41)<br/>`source_41` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-42)<br/>`source_42` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-43)<br/>`source_43` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-44)<br/>`source_44` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-45)<br/>`source_45` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-46)<br/>`source_46` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-47)<br/>`source_47` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-48)<br/>`source_48` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-49)<br/>`source_49` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-50)<br/>`source_50` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-51)<br/>`source_51` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-52)<br/>`source_52` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-53)<br/>`source_53` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-54)<br/>`source_54` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-55)<br/>`source_55` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-56)<br/>`source_56` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-57)<br/>`source_57` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-58)<br/>`source_58` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-59)<br/>`source_59` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-60)<br/>`source_60` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-61)<br/>`source_61` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-62)<br/>`source_62` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-63)<br/>`source_63` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-64)<br/>`source_64` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-65)<br/>`source_65` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-66)<br/>`source_66` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-67)<br/>`source_67` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-68)<br/>`source_68` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-69)<br/>`source_69` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-70)<br/>`source_70` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-71)<br/>`source_71` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-72)<br/>`source_72` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-73)<br/>`source_73` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-74)<br/>`source_74` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-75)<br/>`source_75` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-76)<br/>`source_76` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-77)<br/>`source_77` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-78)<br/>`source_78` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-79)<br/>`source_79` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-80)<br/>`source_80` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-81)<br/>`source_81` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-82)<br/>`source_82` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-83)<br/>`source_83` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-84)<br/>`source_84` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-85)<br/>`source_85` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-86)<br/>`source_86` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-87)<br/>`source_87` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-88)<br/>`source_88` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-89)<br/>`source_89` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-90)<br/>`source_90` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-91)<br/>`source_91` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-92)<br/>`source_92` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-93)<br/>`source_93` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-94)<br/>`source_94` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-95)<br/>`source_95` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-96)<br/>`source_96` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-97)<br/>`source_97` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-98)<br/>`source_98` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-99)<br/>`source_99` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-100)<br/>`source_100` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-101)<br/>`source_101` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-102)<br/>`source_102` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-103)<br/>`source_103` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-104)<br/>`source_104` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-105)<br/>`source_105` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-106)<br/>`source_106` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-107)<br/>`source_107` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-108)<br/>`source_108` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-109)<br/>`source_109` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-110)<br/>`source_110` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-111)<br/>`source_111` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-112)<br/>`source_112` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-113)<br/>`source_113` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-114)<br/>`source_114` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-115)<br/>`source_115` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-116)<br/>`source_116` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-117)<br/>`source_117` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-118)<br/>`source_118` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-119)<br/>`source_119` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-120)<br/>`source_120` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-121)<br/>`source_121` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-122)<br/>`source_122` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-123)<br/>`source_123` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-124)<br/>`source_124` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-125)<br/>`source_125` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-126)<br/>`source_126` | referência | Fonte ausente | qualquer objeto |
| [**Fonte da colisão**](#field-source-127)<br/>`source_127` | referência | Fonte ausente | qualquer objeto |

<h4 id="field-source-0">Fonte da colisão · <code>source_0</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-1">Fonte da colisão · <code>source_1</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-2">Fonte da colisão · <code>source_2</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-3">Fonte da colisão · <code>source_3</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-4">Fonte da colisão · <code>source_4</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-5">Fonte da colisão · <code>source_5</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-6">Fonte da colisão · <code>source_6</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-7">Fonte da colisão · <code>source_7</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-8">Fonte da colisão · <code>source_8</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-9">Fonte da colisão · <code>source_9</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-10">Fonte da colisão · <code>source_10</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-11">Fonte da colisão · <code>source_11</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-12">Fonte da colisão · <code>source_12</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-13">Fonte da colisão · <code>source_13</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-14">Fonte da colisão · <code>source_14</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-15">Fonte da colisão · <code>source_15</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-16">Fonte da colisão · <code>source_16</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-17">Fonte da colisão · <code>source_17</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-18">Fonte da colisão · <code>source_18</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-19">Fonte da colisão · <code>source_19</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-20">Fonte da colisão · <code>source_20</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-21">Fonte da colisão · <code>source_21</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-22">Fonte da colisão · <code>source_22</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-23">Fonte da colisão · <code>source_23</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-24">Fonte da colisão · <code>source_24</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-25">Fonte da colisão · <code>source_25</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-26">Fonte da colisão · <code>source_26</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-27">Fonte da colisão · <code>source_27</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-28">Fonte da colisão · <code>source_28</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-29">Fonte da colisão · <code>source_29</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-30">Fonte da colisão · <code>source_30</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-31">Fonte da colisão · <code>source_31</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-32">Fonte da colisão · <code>source_32</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-33">Fonte da colisão · <code>source_33</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-34">Fonte da colisão · <code>source_34</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-35">Fonte da colisão · <code>source_35</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-36">Fonte da colisão · <code>source_36</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-37">Fonte da colisão · <code>source_37</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-38">Fonte da colisão · <code>source_38</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-39">Fonte da colisão · <code>source_39</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-40">Fonte da colisão · <code>source_40</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-41">Fonte da colisão · <code>source_41</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-42">Fonte da colisão · <code>source_42</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-43">Fonte da colisão · <code>source_43</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-44">Fonte da colisão · <code>source_44</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-45">Fonte da colisão · <code>source_45</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-46">Fonte da colisão · <code>source_46</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-47">Fonte da colisão · <code>source_47</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-48">Fonte da colisão · <code>source_48</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-49">Fonte da colisão · <code>source_49</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-50">Fonte da colisão · <code>source_50</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-51">Fonte da colisão · <code>source_51</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-52">Fonte da colisão · <code>source_52</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-53">Fonte da colisão · <code>source_53</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-54">Fonte da colisão · <code>source_54</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-55">Fonte da colisão · <code>source_55</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-56">Fonte da colisão · <code>source_56</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-57">Fonte da colisão · <code>source_57</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-58">Fonte da colisão · <code>source_58</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-59">Fonte da colisão · <code>source_59</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-60">Fonte da colisão · <code>source_60</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-61">Fonte da colisão · <code>source_61</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-62">Fonte da colisão · <code>source_62</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-63">Fonte da colisão · <code>source_63</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-64">Fonte da colisão · <code>source_64</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-65">Fonte da colisão · <code>source_65</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-66">Fonte da colisão · <code>source_66</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-67">Fonte da colisão · <code>source_67</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-68">Fonte da colisão · <code>source_68</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-69">Fonte da colisão · <code>source_69</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-70">Fonte da colisão · <code>source_70</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-71">Fonte da colisão · <code>source_71</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-72">Fonte da colisão · <code>source_72</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-73">Fonte da colisão · <code>source_73</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-74">Fonte da colisão · <code>source_74</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-75">Fonte da colisão · <code>source_75</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-76">Fonte da colisão · <code>source_76</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-77">Fonte da colisão · <code>source_77</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-78">Fonte da colisão · <code>source_78</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-79">Fonte da colisão · <code>source_79</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-80">Fonte da colisão · <code>source_80</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-81">Fonte da colisão · <code>source_81</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-82">Fonte da colisão · <code>source_82</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-83">Fonte da colisão · <code>source_83</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-84">Fonte da colisão · <code>source_84</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-85">Fonte da colisão · <code>source_85</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-86">Fonte da colisão · <code>source_86</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-87">Fonte da colisão · <code>source_87</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-88">Fonte da colisão · <code>source_88</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-89">Fonte da colisão · <code>source_89</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-90">Fonte da colisão · <code>source_90</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-91">Fonte da colisão · <code>source_91</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-92">Fonte da colisão · <code>source_92</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-93">Fonte da colisão · <code>source_93</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-94">Fonte da colisão · <code>source_94</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-95">Fonte da colisão · <code>source_95</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-96">Fonte da colisão · <code>source_96</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-97">Fonte da colisão · <code>source_97</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-98">Fonte da colisão · <code>source_98</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-99">Fonte da colisão · <code>source_99</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-100">Fonte da colisão · <code>source_100</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-101">Fonte da colisão · <code>source_101</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-102">Fonte da colisão · <code>source_102</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-103">Fonte da colisão · <code>source_103</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-104">Fonte da colisão · <code>source_104</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-105">Fonte da colisão · <code>source_105</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-106">Fonte da colisão · <code>source_106</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-107">Fonte da colisão · <code>source_107</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-108">Fonte da colisão · <code>source_108</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-109">Fonte da colisão · <code>source_109</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-110">Fonte da colisão · <code>source_110</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-111">Fonte da colisão · <code>source_111</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-112">Fonte da colisão · <code>source_112</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-113">Fonte da colisão · <code>source_113</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-114">Fonte da colisão · <code>source_114</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-115">Fonte da colisão · <code>source_115</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-116">Fonte da colisão · <code>source_116</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-117">Fonte da colisão · <code>source_117</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-118">Fonte da colisão · <code>source_118</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-119">Fonte da colisão · <code>source_119</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-120">Fonte da colisão · <code>source_120</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-121">Fonte da colisão · <code>source_121</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-122">Fonte da colisão · <code>source_122</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-123">Fonte da colisão · <code>source_123</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-124">Fonte da colisão · <code>source_124</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-125">Fonte da colisão · <code>source_125</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-126">Fonte da colisão · <code>source_126</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

<h4 id="field-source-127">Fonte da colisão · <code>source_127</code></h4>

**Onde:** Inspector → **Receita de colisão** → **Fontes** → **Fonte da colisão**.

**Uso e efeito:** Objeto/slot persistentes; regeneração é uma ação explícita

**Valor:** Fonte ausente · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Escrita condicionada pelo descritor; trate recusa e verifique autoridade/runtime.

## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Receita de colisão** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/tutorials/assets_pipeline/import_process.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de gravidade"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-gravity/
---

# Campo de gravidade

Gravidade local em volume sobre corpos dinâmicos

**Família:** Física 3D · **Grupo:** Campos · **Identificador:** `astra.physics.field.gravity` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Gravidade local em volume sobre corpos dinâmicos

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de gravidade**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.GravityField](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Z**](#field-half-z)<br/>`half_z` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Centro Z**](#field-offset-z)<br/>`offset_z` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Esfera |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-z">Meia extensão Z · <code>half_z</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Meia extensão Z**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Centro Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Centro Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Esfera.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Vetor X**](#field-vector-x)<br/>`vector_x` | número · m/s² | 0 | -10000 … 10000 |
| [**Vetor Y**](#field-vector-y)<br/>`vector_y` | número · m/s² | -9.81 | -10000 … 10000 |
| [**Vetor Z**](#field-vector-z)<br/>`vector_z` | número · m/s² | 0 | -10000 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Substituir gravidade do mundo**](#field-replace-world-gravity)<br/>`replace_world_gravity` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-vector-x">Vetor X · <code>vector_x</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Efeito** → **Vetor X**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-vector-y">Vetor Y · <code>vector_y</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Efeito** → **Vetor Y**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Y.

**Valor:** -9.81 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-vector-z">Vetor Z · <code>vector_z</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Efeito** → **Vetor Z**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-replace-world-gravity">Substituir gravidade do mundo · <code>replace_world_gravity</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Efeito** → **Substituir gravidade do mundo**.

**Uso e efeito:** Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de gravidade** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de gravidade** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area3d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de vento"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-wind/
---

# Campo de vento

Arrasto para velocidade local do ar, dependente da massa

**Família:** Física 3D · **Grupo:** Campos · **Identificador:** `astra.physics.field.wind` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Arrasto para velocidade local do ar, dependente da massa

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de vento**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.WindField](/pt-br/snapshot-2026-10-06/api/astra-components-windfield/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Z**](#field-half-z)<br/>`half_z` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Centro Z**](#field-offset-z)<br/>`offset_z` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Esfera |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-z">Meia extensão Z · <code>half_z</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Meia extensão Z**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Centro Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Centro Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de vento** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Esfera.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Vetor X**](#field-vector-x)<br/>`vector_x` | número · m/s | 5 | -10000 … 10000 |
| [**Vetor Y**](#field-vector-y)<br/>`vector_y` | número · m/s | 0 | -10000 … 10000 |
| [**Vetor Z**](#field-vector-z)<br/>`vector_z` | número · m/s | 0 | -10000 … 10000 |
| [**Acoplamento**](#field-coefficient)<br/>`coefficient` | número · kg/s | 1 | 0 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-vector-x">Vetor X · <code>vector_x</code></h4>

**Onde:** Inspector → **Campo de vento** → **Efeito** → **Vetor X**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo X.

**Valor:** 5 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.



<h4 id="field-vector-y">Vetor Y · <code>vector_y</code></h4>

**Onde:** Inspector → **Campo de vento** → **Efeito** → **Vetor Y**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.



<h4 id="field-vector-z">Vetor Z · <code>vector_z</code></h4>

**Onde:** Inspector → **Campo de vento** → **Efeito** → **Vetor Z**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.



<h4 id="field-coefficient">Acoplamento · <code>coefficient</code></h4>

**Onde:** Inspector → **Campo de vento** → **Efeito** → **Acoplamento**.

**Uso e efeito:** Coeficiente da contribuição de vento, combinado com o vetor/campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** kg/s · **Domínio:** 0 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de vento** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de vento** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de vento** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de vento** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de vento** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area3d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de arrasto"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-drag/
---

# Campo de arrasto

Amortecimento linear e angular local

**Família:** Física 3D · **Grupo:** Campos · **Identificador:** `astra.physics.field.drag` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Amortecimento linear e angular local

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo de arrasto**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.DragField](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Z**](#field-half-z)<br/>`half_z` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Centro Z**](#field-offset-z)<br/>`offset_z` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Esfera |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-z">Meia extensão Z · <code>half_z</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Meia extensão Z**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Centro Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Centro Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Esfera.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Arrasto linear**](#field-linear-drag)<br/>`linear_drag` | número · 1/s | 1 | 0 … 1000 |
| [**Arrasto angular**](#field-angular-drag)<br/>`angular_drag` | número · 1/s | 1 | 0 … 1000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-linear-drag">Arrasto linear · <code>linear_drag</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Efeito** → **Arrasto linear**.

**Uso e efeito:** Arrasto linear aplicado pelo campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** 1/s · **Domínio:** 0 … 1000.



<h4 id="field-angular-drag">Arrasto angular · <code>angular_drag</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Efeito** → **Arrasto angular**.

**Uso e efeito:** Arrasto angular aplicado pelo campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** 1/s · **Domínio:** 0 … 1000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de arrasto** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de arrasto** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area3d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo radial"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-radial/
---

# Campo radial

Atração, repulsão e vórtice ao redor do centro

**Família:** Física 3D · **Grupo:** Campos · **Identificador:** `astra.physics.field.radial` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Atração, repulsão e vórtice ao redor do centro

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Campos** → **Campo radial**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.RadialField](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Z**](#field-half-z)<br/>`half_z` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Centro Z**](#field-offset-z)<br/>`offset_z` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Esfera |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-z">Meia extensão Z · <code>half_z</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Meia extensão Z**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-z">Centro Z · <code>offset_z</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Centro Z**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo radial** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Esfera.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Aceleração radial**](#field-acceleration)<br/>`acceleration` | número · m/s² | -9.81 | -10000 … 10000 |
| [**Aceleração tangencial**](#field-tangential-acceleration)<br/>`tangential_acceleration` | número · m/s² | 0 | -10000 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-acceleration">Aceleração radial · <code>acceleration</code></h4>

**Onde:** Inspector → **Campo radial** → **Efeito** → **Aceleração radial**.

**Uso e efeito:** Aceleração radial em relação à origem do campo.

**Valor:** -9.81 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-tangential-acceleration">Aceleração tangencial · <code>tangential_acceleration</code></h4>

**Onde:** Inspector → **Campo radial** → **Efeito** → **Aceleração tangencial**.

**Uso e efeito:** Aceleração tangencial em torno da origem.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo radial** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo radial** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo radial** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo radial** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo radial** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area3d.html). Essa referência não representa paridade funcional.


---

---
title: "Conexão física 3D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-event-connection/
---

# Conexão física 3D

Evento de sensor/contato altera a ativação de um receptor

**Família:** Física 3D · **Grupo:** Eventos · **Identificador:** `astra.physics.event_connection` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Evento de sensor/contato altera a ativação de um receptor

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Eventos** → **Conexão física 3D**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.PhysicsEventConnection3D](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Adicione Corpo físico ao emissor da conexão
- [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/): Adicione Colisor 3D ao emissor da conexão

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Evento**](#field-event)<br/>`event` | enumeração | Entrada sensor | Entrada sensor \| Perm. sensor \| Saída sensor \| Entrada contato \| Perm. contato \| Saída contato |
| [**Ação**](#field-action)<br/>`action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto |
| [**Receptor**](#field-receiver)<br/>`receiver` | referência | Escolher objeto | qualquer objeto |

<h4 id="field-enabled">Ativa · <code>enabled</code></h4>

**Onde:** Inspector → **Conexão física 3D** → **Conexão** → **Ativa**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-event">Evento · <code>event</code></h4>

**Onde:** Inspector → **Conexão física 3D** → **Conexão** → **Evento**.

**Uso e efeito:** Sensor exige Sensor ligado no Corpo físico; contato sólido exige desligado

**Valor:** Entrada sensor · **Tipo:** enumeração · **Domínio:** Entrada sensor \| Perm. sensor \| Saída sensor \| Entrada contato \| Perm. contato \| Saída contato.



<h4 id="field-action">Ação · <code>action</code></h4>

**Onde:** Inspector → **Conexão física 3D** → **Conexão** → **Ação**.

**Uso e efeito:** Executada antes do callback C#; permanência pode disparar a cada passo físico

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto.



<h4 id="field-receiver">Receptor · <code>receiver</code></h4>

**Onde:** Inspector → **Conexão física 3D** → **Conexão** → **Receptor**.

**Uso e efeito:** Objeto cuja ativação será alterada

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Filtro

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Outro objeto**](#field-other-filter)<br/>`other_filter` | referência | Qualquer objeto | qualquer objeto |

<h4 id="field-other-filter">Outro objeto · <code>other_filter</code></h4>

**Onde:** Inspector → **Conexão física 3D** → **Filtro** → **Outro objeto**.

**Uso e efeito:** Opcional: somente eventos com este outro objeto; vazio aceita todos

**Valor:** Qualquer objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Conexão física 3D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area3d.html). Essa referência não representa paridade funcional.


---

---
title: "Força constante"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-constant-force/
---

# Força constante

Força e torque contínuos sobre corpo dinâmico

**Família:** Física 3D · **Grupo:** Forças · **Identificador:** `astra.physics.constant_force` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Força e torque contínuos sobre corpo dinâmico

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Forças** → **Força constante**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.ConstantForce](/pt-br/snapshot-2026-10-06/api/astra-components-constantforce/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Adicione Corpo físico a este objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Força mundo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Força X**](#field-force-x)<br/>`force_x` | número · N | 0 | -10000000 … 10000000 |
| [**Força Y**](#field-force-y)<br/>`force_y` | número · N | 0 | -10000000 … 10000000 |
| [**Força Z**](#field-force-z)<br/>`force_z` | número · N | 0 | -10000000 … 10000000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-force-x">Força X · <code>force_x</code></h4>

**Onde:** Inspector → **Força constante** → **Força mundo** → **Força X**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



<h4 id="field-force-y">Força Y · <code>force_y</code></h4>

**Onde:** Inspector → **Força constante** → **Força mundo** → **Força Y**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



<h4 id="field-force-z">Força Z · <code>force_z</code></h4>

**Onde:** Inspector → **Força constante** → **Força mundo** → **Força Z**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Força constante** → **Força mundo** → **Ativo**.

**Uso e efeito:** Requer Corpo físico dinâmico no mesmo objeto; desligado permite configurar sem aplicar.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Força local

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Força local X**](#field-relative-force-x)<br/>`relative_force_x` | número · N | 0 | -10000000 … 10000000 |
| [**Força local Y**](#field-relative-force-y)<br/>`relative_force_y` | número · N | 0 | -10000000 … 10000000 |
| [**Força local Z**](#field-relative-force-z)<br/>`relative_force_z` | número · N | 0 | -10000000 … 10000000 |

<h4 id="field-relative-force-x">Força local X · <code>relative_force_x</code></h4>

**Onde:** Inspector → **Força constante** → **Força local** → **Força local X**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



<h4 id="field-relative-force-y">Força local Y · <code>relative_force_y</code></h4>

**Onde:** Inspector → **Força constante** → **Força local** → **Força local Y**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



<h4 id="field-relative-force-z">Força local Z · <code>relative_force_z</code></h4>

**Onde:** Inspector → **Força constante** → **Força local** → **Força local Z**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -10000000 … 10000000.



### Torque mundo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Torque X**](#field-torque-x)<br/>`torque_x` | número · N·m | 0 | -10000000 … 10000000 |
| [**Torque Y**](#field-torque-y)<br/>`torque_y` | número · N·m | 0 | -10000000 … 10000000 |
| [**Torque Z**](#field-torque-z)<br/>`torque_z` | número · N·m | 0 | -10000000 … 10000000 |

<h4 id="field-torque-x">Torque X · <code>torque_x</code></h4>

**Onde:** Inspector → **Força constante** → **Torque mundo** → **Torque X**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



<h4 id="field-torque-y">Torque Y · <code>torque_y</code></h4>

**Onde:** Inspector → **Força constante** → **Torque mundo** → **Torque Y**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



<h4 id="field-torque-z">Torque Z · <code>torque_z</code></h4>

**Onde:** Inspector → **Força constante** → **Torque mundo** → **Torque Z**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



### Torque local

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Torque local X**](#field-relative-torque-x)<br/>`relative_torque_x` | número · N·m | 0 | -10000000 … 10000000 |
| [**Torque local Y**](#field-relative-torque-y)<br/>`relative_torque_y` | número · N·m | 0 | -10000000 … 10000000 |
| [**Torque local Z**](#field-relative-torque-z)<br/>`relative_torque_z` | número · N·m | 0 | -10000000 … 10000000 |

<h4 id="field-relative-torque-x">Torque local X · <code>relative_torque_x</code></h4>

**Onde:** Inspector → **Força constante** → **Torque local** → **Torque local X**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



<h4 id="field-relative-torque-y">Torque local Y · <code>relative_torque_y</code></h4>

**Onde:** Inspector → **Força constante** → **Torque local** → **Torque local Y**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



<h4 id="field-relative-torque-z">Torque local Z · <code>relative_torque_z</code></h4>

**Onde:** Inspector → **Força constante** → **Torque local** → **Torque local Z**.

**Uso e efeito:** Aplicado a cada passo físico; não multiplique pelo tempo.

**Valor:** 0 · **Tipo:** número · **Unidade:** N·m · **Domínio:** -10000000 … 10000000.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Força constante** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-ConstantForce.html). Essa referência não representa paridade funcional.


---

---
title: "Corpo físico"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/
---

# Corpo físico

Massa e resposta física

**Família:** Física 3D · **Grupo:** Corpos · **Identificador:** `astra.physics.body` · **Payload:** 4

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Massa e resposta física

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Corpo físico**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.PhysicsBody](/pt-br/snapshot-2026-10-06/api/astra-components-physicsbody/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): Incompatível com personagem cápsula

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | não permitido |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 4 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Corpo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Massa kg**](#field-mass)<br/>`mass` | número · kg | 1 | 0.01 … 1000000 |
| [**Atrito**](#field-friction)<br/>`friction` | número | 0.5 | 0 … 1 |
| [**Restituição**](#field-restitution)<br/>`restitution` | número | 0 | 0 … 1 |
| [**Sensor sem resposta**](#field-sensor)<br/>`sensor` | booleano | falso | verdadeiro \| falso |
| [**Permitir repouso**](#field-allow-sleep)<br/>`allow_sleep` | booleano | verdadeiro | verdadeiro \| falso |
| [**Movimento**](#field-motion)<br/>`motion` | enumeração | Estático | Estático \| Cinemático \| Dinâmico |

<h4 id="field-mass">Massa kg · <code>mass</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Massa kg**.

**Uso e efeito:** Massa do corpo dinâmico em kg; influencia resposta a força/impulso.

**Valor:** 1 · **Tipo:** número · **Unidade:** kg · **Domínio:** 0.01 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-friction">Atrito · <code>friction</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Atrito**.

**Uso e efeito:** Atrito nos contatos; compare deslizamento com o mesmo par de superfícies.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-restitution">Restituição · <code>restitution</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Restituição**.

**Uso e efeito:** Restituição nos contatos; controla ressalto conforme a combinação física.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-sensor">Sensor sem resposta · <code>sensor</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Sensor sem resposta**.

**Uso e efeito:** Participa como sensor/sobreposição; não é uma superfície sólida de contato.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-allow-sleep">Permitir repouso · <code>allow_sleep</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Permitir repouso**.

**Uso e efeito:** Permite dormir quando o corpo pode ficar em repouso.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motion">Movimento · <code>motion</code></h4>

**Onde:** Inspector → **Corpo físico** → **Corpo** → **Movimento**.

**Uso e efeito:** Escolhe autoridade estática/cinemática/dinâmica no domínio do corpo.

**Valor:** Estático · **Tipo:** enumeração · **Domínio:** Estático \| Cinemático \| Dinâmico.



### Início

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade inicial X**](#field-velocity-x)<br/>`velocity_x` | número · m/s | 0 | -1000 … 1000 |
| [**Velocidade inicial Y**](#field-velocity-y)<br/>`velocity_y` | número · m/s | 0 | -1000 … 1000 |
| [**Velocidade inicial Z**](#field-velocity-z)<br/>`velocity_z` | número · m/s | 0 | -1000 … 1000 |
| [**Giro inicial X · rad/s**](#field-angular-x)<br/>`angular_x` | número · rad/s | 0 | -1000 … 1000 |
| [**Giro inicial Y · rad/s**](#field-angular-y)<br/>`angular_y` | número · rad/s | 0 | -1000 … 1000 |
| [**Giro inicial Z · rad/s**](#field-angular-z)<br/>`angular_z` | número · rad/s | 0 | -1000 … 1000 |

<h4 id="field-velocity-x">Velocidade inicial X · <code>velocity_x</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Velocidade inicial X**.

**Uso e efeito:** Velocidade linear inicial/autorada do corpo, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-velocity-y">Velocidade inicial Y · <code>velocity_y</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Velocidade inicial Y**.

**Uso e efeito:** Velocidade linear inicial/autorada do corpo, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-velocity-z">Velocidade inicial Z · <code>velocity_z</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Velocidade inicial Z**.

**Uso e efeito:** Velocidade linear inicial/autorada do corpo, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x">Giro inicial X · rad/s · <code>angular_x</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Giro inicial X · rad/s**.

**Uso e efeito:** Velocidade angular do corpo, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** rad/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y">Giro inicial Y · rad/s · <code>angular_y</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Giro inicial Y · rad/s**.

**Uso e efeito:** Velocidade angular do corpo, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** rad/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z">Giro inicial Z · rad/s · <code>angular_z</code></h4>

**Onde:** Inspector → **Corpo físico** → **Início** → **Giro inicial Z · rad/s**.

**Uso e efeito:** Velocidade angular do corpo, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** rad/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Amortecimento

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Amortecimento linear**](#field-linear-damping)<br/>`linear_damping` | número | 0.05 | 0 … 10 |
| [**Amortecimento angular**](#field-angular-damping)<br/>`angular_damping` | número | 0.05 | 0 … 10 |
| [**Multiplicador da gravidade**](#field-gravity-factor)<br/>`gravity_factor` | número | 1 | -100 … 100 |

<h4 id="field-linear-damping">Amortecimento linear · <code>linear_damping</code></h4>

**Onde:** Inspector → **Corpo físico** → **Amortecimento** → **Amortecimento linear**.

**Uso e efeito:** Amortecimento de velocidade linear.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-damping">Amortecimento angular · <code>angular_damping</code></h4>

**Onde:** Inspector → **Corpo físico** → **Amortecimento** → **Amortecimento angular**.

**Uso e efeito:** Amortecimento de velocidade angular.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-gravity-factor">Multiplicador da gravidade · <code>gravity_factor</code></h4>

**Onde:** Inspector → **Corpo físico** → **Amortecimento** → **Multiplicador da gravidade**.

**Uso e efeito:** Multiplica gravidade mundial deste corpo 3D.

**Valor:** 1 · **Tipo:** número · **Domínio:** -100 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Simulação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite linear**](#field-max-linear-velocity)<br/>`max_linear_velocity` | número · m/s | 500 | 0.001 … 100000 |
| [**Limite angular**](#field-max-angular-velocity)<br/>`max_angular_velocity` | número · rad/s | 47.12389 | 0.001 … 100000 |
| [**Iterações de velocidade**](#field-solver-velocity-steps)<br/>`solver_velocity_steps` | número | 0 | 0 … 255 |
| [**Colisão contínua**](#field-continuous-collision)<br/>`continuous_collision` | booleano | falso | verdadeiro \| falso |

<h4 id="field-max-linear-velocity">Limite linear · <code>max_linear_velocity</code></h4>

**Onde:** Inspector → **Corpo físico** → **Simulação** → **Limite linear**.

**Uso e efeito:** Limite de velocidade linear do corpo.

**Valor:** 500 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0.001 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-angular-velocity">Limite angular · <code>max_angular_velocity</code></h4>

**Onde:** Inspector → **Corpo físico** → **Simulação** → **Limite angular**.

**Uso e efeito:** Limite de velocidade angular do corpo.

**Valor:** 47.12389 · **Tipo:** número · **Unidade:** rad/s · **Domínio:** 0.001 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-solver-velocity-steps">Iterações de velocidade · <code>solver_velocity_steps</code></h4>

**Onde:** Inspector → **Corpo físico** → **Simulação** → **Iterações de velocidade**.

**Uso e efeito:** 0 usa as iterações do mundo; aumenta custo por ilha de contato

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 255.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-continuous-collision">Colisão contínua · <code>continuous_collision</code></h4>

**Onde:** Inspector → **Corpo físico** → **Simulação** → **Colisão contínua**.

**Uso e efeito:** Varredura linear Jolt; não detecta varredura apenas angular

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Restrições

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Travar posição X**](#field-freeze-position-x)<br/>`freeze_position_x` | booleano | falso | verdadeiro \| falso |
| [**Travar posição Y**](#field-freeze-position-y)<br/>`freeze_position_y` | booleano | falso | verdadeiro \| falso |
| [**Travar posição Z**](#field-freeze-position-z)<br/>`freeze_position_z` | booleano | falso | verdadeiro \| falso |
| [**Travar rotação X**](#field-freeze-rotation-x)<br/>`freeze_rotation_x` | booleano | falso | verdadeiro \| falso |
| [**Travar rotação Y**](#field-freeze-rotation-y)<br/>`freeze_rotation_y` | booleano | falso | verdadeiro \| falso |
| [**Travar rotação Z**](#field-freeze-rotation-z)<br/>`freeze_rotation_z` | booleano | falso | verdadeiro \| falso |

<h4 id="field-freeze-position-x">Travar posição X · <code>freeze_position_x</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar posição X**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-freeze-position-y">Travar posição Y · <code>freeze_position_y</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar posição Y**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-freeze-position-z">Travar posição Z · <code>freeze_position_z</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar posição Z**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-freeze-rotation-x">Travar rotação X · <code>freeze_rotation_x</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar rotação X**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-freeze-rotation-y">Travar rotação Y · <code>freeze_rotation_y</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar rotação Y**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-freeze-rotation-z">Travar rotação Z · <code>freeze_rotation_z</code></h4>

**Onde:** Inspector → **Corpo físico** → **Restrições** → **Travar rotação Z**.

**Uso e efeito:** Eixos do mundo; bloquear todos exige corpo estático

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Corpo físico** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-Rigidbody.html). Essa referência não representa paridade funcional.


---

---
title: "Personagem"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/
---

# Personagem

Locomoção com cápsula

**Família:** Física 3D · **Grupo:** Corpos · **Identificador:** `astra.physics.character` · **Payload:** 4

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Locomoção com cápsula

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Personagem**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.Character](/pt-br/snapshot-2026-10-06/api/astra-components-character/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Incompatível com corpo físico
- [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/): O personagem traz a própria cápsula; remova o Colisor 3D
- [Motor dinâmico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/): Escolha Character ou motor de corpo dinâmico

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | não permitido |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 4 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Cápsula

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Raio m**](#field-radius)<br/>`radius` | número · m | 0.45 | 0.01 … 10 |
| [**Meia altura do cilindro m**](#field-half-height)<br/>`half_height` | número · m | 0.55 | 0.01 … 10 |
| [**Altura dos olhos m**](#field-eye-height)<br/>`eye_height` | número · m | 1.65 | 0.02 … 20 |

<h4 id="field-radius">Raio m · <code>radius</code></h4>

**Onde:** Inspector → **Personagem** → **Cápsula** → **Raio m**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 0.45 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 10.



<h4 id="field-half-height">Meia altura do cilindro m · <code>half_height</code></h4>

**Onde:** Inspector → **Personagem** → **Cápsula** → **Meia altura do cilindro m**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.55 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 10.



<h4 id="field-eye-height">Altura dos olhos m · <code>eye_height</code></h4>

**Onde:** Inspector → **Personagem** → **Cápsula** → **Altura dos olhos m**.

**Uso e efeito:** Altura de referência dos olhos do Character.

**Valor:** 1.65 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.02 … 20.



### Locomoção

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade m/s**](#field-speed)<br/>`speed` | número · m/s | 8 | 0.01 … 100 |
| [**Inclinação máxima graus**](#field-slope-degrees)<br/>`slope_degrees` | número · ° | 45 | 1 … 89 |
| [**Velocidade do salto m/s**](#field-jump-speed)<br/>`jump_speed` | número · m/s | 5 | 0 … 100 |
| [**Gravidade**](#field-gravity)<br/>`gravity` | número · m/s² | 9.81 | 0 … 1000 |

<h4 id="field-speed">Velocidade m/s · <code>speed</code></h4>

**Onde:** Inspector → **Personagem** → **Locomoção** → **Velocidade m/s**.

**Uso e efeito:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Valor:** 8 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0.01 … 100.



<h4 id="field-slope-degrees">Inclinação máxima graus · <code>slope_degrees</code></h4>

**Onde:** Inspector → **Personagem** → **Locomoção** → **Inclinação máxima graus**.

**Uso e efeito:** Inclinação máxima de apoio do Character.

**Valor:** 45 · **Tipo:** número · **Unidade:** ° · **Domínio:** 1 … 89.



<h4 id="field-jump-speed">Velocidade do salto m/s · <code>jump_speed</code></h4>

**Onde:** Inspector → **Personagem** → **Locomoção** → **Velocidade do salto m/s**.

**Uso e efeito:** Velocidade alvo inicial de salto.

**Valor:** 5 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0 … 100.



<h4 id="field-gravity">Gravidade · <code>gravity</code></h4>

**Onde:** Inspector → **Personagem** → **Locomoção** → **Gravidade**.

**Uso e efeito:** Aceleração de gravidade do Character.

**Valor:** 9.81 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** 0 … 1000.



### Chão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Altura do degrau**](#field-step-height)<br/>`step_height` | número · m | 0.4 | 0 … 10 |
| [**Aderência ao chão**](#field-floor-snap-length)<br/>`floor_snap_length` | número · m | 0.5 | 0 … 10 |
| [**Impulso ao sair**](#field-inherit-platform-horizontal)<br/>`inherit_platform_horizontal` | booleano | falso | verdadeiro \| falso |

<h4 id="field-step-height">Altura do degrau · <code>step_height</code></h4>

**Onde:** Inspector → **Personagem** → **Chão** → **Altura do degrau**.

**Uso e efeito:** Altura de degrau que o Character pode transpor.

**Valor:** 0.4 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 10.



<h4 id="field-floor-snap-length">Aderência ao chão · <code>floor_snap_length</code></h4>

**Onde:** Inspector → **Personagem** → **Chão** → **Aderência ao chão**.

**Uso e efeito:** Distância de snap ao chão; confira degraus e bordas.

**Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 10.



<h4 id="field-inherit-platform-horizontal">Impulso ao sair · <code>inherit_platform_horizontal</code></h4>

**Onde:** Inspector → **Personagem** → **Chão** → **Impulso ao sair**.

**Uso e efeito:** Conserva X/Z da superfície no ar; desligar remove apenas esse impulso, sem recriar a cápsula.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Personagem** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-CharacterController.html). Essa referência não representa paridade funcional.


---

---
title: "Colisor 3D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/
---

# Colisor 3D

Volume de contato

**Família:** Física 3D · **Grupo:** Formas · **Identificador:** `astra.physics.collider` · **Payload:** 8

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Volume de contato

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Formas** → **Colisor 3D**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.Collider](/pt-br/snapshot-2026-10-06/api/astra-components-collider/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): O personagem já possui cápsula própria

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | não permitido |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 8 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Forma

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número | 0.5 | 0.01 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número | 0.5 | 0.01 … 10000 |
| [**Meia extensão Z**](#field-half-z)<br/>`half_z` | número | 0.5 | 0.01 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número | 0.5 | 0.01 … 10000 |
| [**Meia altura cilíndrica**](#field-half-height)<br/>`half_height` | número | 0.5 | 0.01 … 10000 |
| [**Convexo**](#field-convex)<br/>`convex` | booleano | falso | verdadeiro \| falso |
| [**Pose local da malha**](#field-mesh-local-pose)<br/>`mesh_local_pose` | booleano | falso | verdadeiro \| falso |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Esfera \| Cápsula \| Malha \| Cilindro |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0.01 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0.01 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-z">Meia extensão Z · <code>half_z</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Meia extensão Z**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0.01 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0.01 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-height">Meia altura cilíndrica · <code>half_height</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Meia altura cilíndrica**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0.01 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-convex">Convexo · <code>convex</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Convexo**.

**Uso e efeito:** Casco convexo da malha: aceita corpo dinâmico. Desligado usa os triângulos exatos e só vale em corpo estático ou cinemático.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-mesh-local-pose">Pose local da malha · <code>mesh_local_pose</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Pose local da malha**.

**Uso e efeito:** Aplica centro e rotação locais à geometria física; não altera a malha visual. Desligado mantém a pose legada do objeto.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Forma** → **Forma**.

**Uso e efeito:** Escolhe a geometria do colisor/campo no domínio indicado; os campos relevantes mudam por forma.

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Esfera \| Cápsula \| Malha \| Cilindro.



### Pose

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Centro X**](#field-center-x)<br/>`center_x` | número | 0 | -10000000 … 10000000 |
| [**Centro Y**](#field-center-y)<br/>`center_y` | número | 0 | -10000000 … 10000000 |
| [**Centro Z**](#field-center-z)<br/>`center_z` | número | 0 | -10000000 … 10000000 |
| [**Rotação local X**](#field-rotation-x)<br/>`rotation_x` | número · ° | 0 | -10000000 … 10000000 |
| [**Rotação local Y**](#field-rotation-y)<br/>`rotation_y` | número · ° | 0 | -10000000 … 10000000 |
| [**Rotação local Z**](#field-rotation-z)<br/>`rotation_z` | número · ° | 0 | -10000000 … 10000000 |

<h4 id="field-center-x">Centro X · <code>center_x</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Centro X**.

**Uso e efeito:** Centro local da forma de colisão, eixo X.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-center-y">Centro Y · <code>center_y</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Centro Y**.

**Uso e efeito:** Centro local da forma de colisão, eixo Y.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-center-z">Centro Z · <code>center_z</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Centro Z**.

**Uso e efeito:** Centro local da forma de colisão, eixo Z.

**Valor:** 0 · **Tipo:** número · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-x">Rotação local X · <code>rotation_x</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Rotação local X**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-y">Rotação local Y · <code>rotation_y</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Rotação local Y**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rotation-z">Rotação local Z · <code>rotation_z</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Pose** → **Rotação local Z**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -10000000 … 10000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Cozimento

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Tolerância do casco**](#field-hull-tolerance)<br/>`hull_tolerance` | número · u | 0.001 | 0.00001 … 1 |
| [**Ângulo de aresta ativa**](#field-active-edge-angle)<br/>`active_edge_angle` | número · ° | 5 | 0 … 90 |
| [**Soldar vértices iguais**](#field-weld-vertices)<br/>`weld_vertices` | booleano | verdadeiro | verdadeiro \| falso |
| [**Otimizar para o jogo**](#field-optimize-cooking)<br/>`optimize_cooking` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-hull-tolerance">Tolerância do casco · <code>hull_tolerance</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Cozimento** → **Tolerância do casco**.

**Uso e efeito:** Pontos até esta distância podem ficar fora do casco; valores maiores geram cascos mais simples.

**Valor:** 0.001 · **Tipo:** número · **Unidade:** u · **Domínio:** 0.00001 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-active-edge-angle">Ângulo de aresta ativa · <code>active_edge_angle</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Cozimento** → **Ângulo de aresta ativa**.

**Uso e efeito:** Separa arestas de contato em superfícies com mudança de normal acima deste ângulo.

**Valor:** 5 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 90.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-weld-vertices">Soldar vértices iguais · <code>weld_vertices</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Cozimento** → **Soldar vértices iguais**.

**Uso e efeito:** Compartilha vértices coincidentes antes de criar a malha física, reduzindo costuras internas.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-optimize-cooking">Otimizar para o jogo · <code>optimize_cooking</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Cozimento** → **Otimizar para o jogo**.

**Uso e efeito:** Constrói uma árvore de busca mais eficiente; desligue para cozinhar mais rápido durante iterações.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Geral

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Geral** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Vínculo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Corpo proprietário**](#field-owner)<br/>`owner` | referência | Neste objeto | astra.physics.body · neste objeto ou ancestral |

<h4 id="field-owner">Corpo proprietário · <code>owner</code></h4>

**Onde:** Inspector → **Colisor 3D** → **Vínculo** → **Corpo proprietário**.

**Uso e efeito:** Escolhe o dono do corpo/forma no domínio do colisor.

**Valor:** Neste objeto · **Tipo:** referência · **Domínio:** astra.physics.body · neste objeto ou ancestral.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Colisor 3D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-BoxCollider.html). Essa referência não representa paridade funcional.


---

---
title: "Junta"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-joint/
---

# Junta

Nove mecanismos Jolt com limites, referenciais e motores

**Família:** Física 3D · **Grupo:** Juntas · **Identificador:** `astra.physics.joint` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Nove mecanismos Jolt com limites, referenciais e motores

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Juntas** → **Junta**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.Joint](/pt-br/snapshot-2026-10-06/api/astra-components-joint/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Adicione Corpo físico a este objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Âncoras

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Âncora A · X**](#field-anchor-a-x)<br/>`anchor_a_x` | número | 0 | -100000 … 100000 |
| [**Âncora A · Y**](#field-anchor-a-y)<br/>`anchor_a_y` | número | 0 | -100000 … 100000 |
| [**Âncora A · Z**](#field-anchor-a-z)<br/>`anchor_a_z` | número | 0 | -100000 … 100000 |
| [**Âncora B · X**](#field-anchor-b-x)<br/>`anchor_b_x` | número | 0 | -100000 … 100000 |
| [**Âncora B · Y**](#field-anchor-b-y)<br/>`anchor_b_y` | número | 0 | -100000 … 100000 |
| [**Âncora B · Z**](#field-anchor-b-z)<br/>`anchor_b_z` | número | 0 | -100000 … 100000 |
| [**Conectar corpo**](#field-connected-body)<br/>`connected_body` | referência | Escolher corpo | astra.physics.body · outro objeto |

<h4 id="field-anchor-a-x">Âncora A · X · <code>anchor_a_x</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora A · X**.

**Uso e efeito:** Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-anchor-a-y">Âncora A · Y · <code>anchor_a_y</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora A · Y**.

**Uso e efeito:** Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-anchor-a-z">Âncora A · Z · <code>anchor_a_z</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora A · Z**.

**Uso e efeito:** Posição da âncora no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-anchor-b-x">Âncora B · X · <code>anchor_b_x</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora B · X**.

**Uso e efeito:** Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-anchor-b-y">Âncora B · Y · <code>anchor_b_y</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora B · Y**.

**Uso e efeito:** Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-anchor-b-z">Âncora B · Z · <code>anchor_b_z</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Âncora B · Z**.

**Uso e efeito:** Posição da âncora no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-connected-body">Conectar corpo · <code>connected_body</code></h4>

**Onde:** Inspector → **Junta** → **Âncoras** → **Conectar corpo**.

**Uso e efeito:** Objeto com o corpo conectado; confira a cadeia de dependências.

**Valor:** Escolher corpo · **Tipo:** referência · **Domínio:** astra.physics.body · outro objeto.



### Eixos

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Eixo A · X**](#field-axis-a-x)<br/>`axis_a_x` | número | 0 | -1 … 1 |
| [**Eixo A · Y**](#field-axis-a-y)<br/>`axis_a_y` | número | 1 | -1 … 1 |
| [**Eixo A · Z**](#field-axis-a-z)<br/>`axis_a_z` | número | 0 | -1 … 1 |
| [**Eixo B · X**](#field-axis-b-x)<br/>`axis_b_x` | número | 0 | -1 … 1 |
| [**Eixo B · Y**](#field-axis-b-y)<br/>`axis_b_y` | número | 1 | -1 … 1 |
| [**Eixo B · Z**](#field-axis-b-z)<br/>`axis_b_z` | número | 0 | -1 … 1 |
| [**Plano A · X**](#field-normal-a-x)<br/>`normal_a_x` | número | 1 | -1 … 1 |
| [**Plano A · Y**](#field-normal-a-y)<br/>`normal_a_y` | número | 0 | -1 … 1 |
| [**Plano A · Z**](#field-normal-a-z)<br/>`normal_a_z` | número | 0 | -1 … 1 |
| [**Plano B · X**](#field-normal-b-x)<br/>`normal_b_x` | número | 1 | -1 … 1 |
| [**Plano B · Y**](#field-normal-b-y)<br/>`normal_b_y` | número | 0 | -1 … 1 |
| [**Plano B · Z**](#field-normal-b-z)<br/>`normal_b_z` | número | 0 | -1 … 1 |

<h4 id="field-axis-a-x">Eixo A · X · <code>axis_a_x</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo A · X**.

**Uso e efeito:** Direção do eixo no frame do corpo A, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-a-y">Eixo A · Y · <code>axis_a_y</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo A · Y**.

**Uso e efeito:** Direção do eixo no frame do corpo A, componente Y. Configure os dois frames compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-a-z">Eixo A · Z · <code>axis_a_z</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo A · Z**.

**Uso e efeito:** Direção do eixo no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-b-x">Eixo B · X · <code>axis_b_x</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo B · X**.

**Uso e efeito:** Direção do eixo no frame do corpo B, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-b-y">Eixo B · Y · <code>axis_b_y</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo B · Y**.

**Uso e efeito:** Direção do eixo no frame do corpo B, componente Y. Configure os dois frames compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-b-z">Eixo B · Z · <code>axis_b_z</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Eixo B · Z**.

**Uso e efeito:** Direção do eixo no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-a-x">Plano A · X · <code>normal_a_x</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano A · X**.

**Uso e efeito:** Normal de referência no frame do corpo A, componente X. Configure os dois frames compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-a-y">Plano A · Y · <code>normal_a_y</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano A · Y**.

**Uso e efeito:** Normal de referência no frame do corpo A, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-a-z">Plano A · Z · <code>normal_a_z</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano A · Z**.

**Uso e efeito:** Normal de referência no frame do corpo A, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-b-x">Plano B · X · <code>normal_b_x</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano B · X**.

**Uso e efeito:** Normal de referência no frame do corpo B, componente X. Configure os dois frames compatíveis.

**Valor:** 1 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-b-y">Plano B · Y · <code>normal_b_y</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano B · Y**.

**Uso e efeito:** Normal de referência no frame do corpo B, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-normal-b-z">Plano B · Z · <code>normal_b_z</code></h4>

**Onde:** Inspector → **Junta** → **Eixos** → **Plano B · Z**.

**Uso e efeito:** Normal de referência no frame do corpo B, componente Z. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Movimento

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-limit-min)<br/>`limit_min` | número | 0 | -100000 … 100000 |
| [**Limite máximo**](#field-limit-max)<br/>`limit_max` | número | 1 | -100000 … 100000 |

<h4 id="field-limit-min">Limite mínimo · <code>limit_min</code></h4>

**Onde:** Inspector → **Junta** → **Movimento** → **Limite mínimo**.

**Uso e efeito:** Limite inferior da junta na unidade do tipo.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-limit-max">Limite máximo · <code>limit_max</code></h4>

**Onde:** Inspector → **Junta** → **Movimento** → **Limite máximo**.

**Uso e efeito:** Limite superior da junta na unidade do tipo.

**Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Motor

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade do motor**](#field-motor-velocity)<br/>`motor_velocity` | número | 0 | -1000 … 1000 |
| [**Alvo do motor**](#field-motor-position)<br/>`motor_position` | número | 0 | -100000 … 100000 |
| [**Força / torque máximo**](#field-motor-force)<br/>`motor_force` | número | 100 | 0 … 1000000 |
| [**Frequência · Hz**](#field-spring-frequency)<br/>`spring_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento da mola**](#field-spring-damping)<br/>`spring_damping` | número | 1 | 0 … 10 |
| [**Motor**](#field-motor)<br/>`motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-motor-velocity">Velocidade do motor · <code>motor_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Velocidade do motor**.

**Uso e efeito:** Velocidade alvo do motor da junta.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor-position">Alvo do motor · <code>motor_position</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Alvo do motor**.

**Uso e efeito:** Posição alvo do motor da junta.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor-force">Força / torque máximo · <code>motor_force</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Força / torque máximo**.

**Uso e efeito:** Força/torque máximo do motor, conforme o tipo de junta.

**Valor:** 100 · **Tipo:** número · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-frequency">Frequência · Hz · <code>spring_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Frequência · Hz**.

**Uso e efeito:** Frequência da mola da junta.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-damping">Amortecimento da mola · <code>spring_damping</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Amortecimento da mola**.

**Uso e efeito:** Amortecimento da mola da junta.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor">Motor · <code>motor</code></h4>

**Onde:** Inspector → **Junta** → **Motor** → **Motor**.

**Uso e efeito:** Modo de motor da junta; exige tipo e limites compatíveis.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Rotação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cone · semiângulo Y**](#field-swing-y)<br/>`swing_y` | número · ° | 45 | 0 … 180 |
| [**Cone · semiângulo Z**](#field-swing-z)<br/>`swing_z` | número · ° | 45 | 0 … 180 |
| [**Torção mínima**](#field-twist-min)<br/>`twist_min` | número · ° | -45 | -180 … 180 |
| [**Torção máxima**](#field-twist-max)<br/>`twist_max` | número · ° | 45 | -180 … 180 |

<h4 id="field-swing-y">Cone · semiângulo Y · <code>swing_y</code></h4>

**Onde:** Inspector → **Junta** → **Rotação** → **Cone · semiângulo Y**.

**Uso e efeito:** Limite de swing no eixo Y da junta.

**Valor:** 45 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-swing-z">Cone · semiângulo Z · <code>swing_z</code></h4>

**Onde:** Inspector → **Junta** → **Rotação** → **Cone · semiângulo Z**.

**Uso e efeito:** Limite de swing no eixo Z da junta.

**Valor:** 45 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-twist-min">Torção mínima · <code>twist_min</code></h4>

**Onde:** Inspector → **Junta** → **Rotação** → **Torção mínima**.

**Uso e efeito:** Limite inferior de twist.

**Valor:** -45 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-twist-max">Torção máxima · <code>twist_max</code></h4>

**Onde:** Inspector → **Junta** → **Rotação** → **Torção máxima**.

**Uso e efeito:** Limite superior de twist.

**Valor:** 45 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Translação X

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-linear-x-minimum)<br/>`linear_x_minimum` | número · u | -1 | -100000 … 100000 |
| [**Limite máximo**](#field-linear-x-maximum)<br/>`linear_x_maximum` | número · u | 1 | -100000 … 100000 |
| [**Atrito máximo**](#field-linear-x-friction)<br/>`linear_x_friction` | número · N | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-linear-x-velocity)<br/>`linear_x_velocity` | número · u/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-linear-x-position)<br/>`linear_x_position` | número · u | 0 | -100000 … 100000 |
| [**Força máxima**](#field-linear-x-force)<br/>`linear_x_force` | número · N | 100 | 0 … 1000000 |
| [**Frequência**](#field-linear-x-frequency)<br/>`linear_x_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-linear-x-damping)<br/>`linear_x_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-linear-x-motion)<br/>`linear_x_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-linear-x-motor)<br/>`linear_x_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-linear-x-minimum">Limite mínimo · <code>linear_x_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-maximum">Limite máximo · <code>linear_x_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-friction">Atrito máximo · <code>linear_x_friction</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-velocity">Velocidade alvo · <code>linear_x_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-position">Posição alvo · <code>linear_x_position</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-force">Força máxima · <code>linear_x_force</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-frequency">Frequência · <code>linear_x_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-damping">Amortecimento · <code>linear_x_damping</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-motion">Movimento · <code>linear_x_motion</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-x-motor">Motor · <code>linear_x_motor</code></h4>

**Onde:** Inspector → **Junta** → **Translação X** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Translação Y

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-linear-y-minimum)<br/>`linear_y_minimum` | número · u | -1 | -100000 … 100000 |
| [**Limite máximo**](#field-linear-y-maximum)<br/>`linear_y_maximum` | número · u | 1 | -100000 … 100000 |
| [**Atrito máximo**](#field-linear-y-friction)<br/>`linear_y_friction` | número · N | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-linear-y-velocity)<br/>`linear_y_velocity` | número · u/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-linear-y-position)<br/>`linear_y_position` | número · u | 0 | -100000 … 100000 |
| [**Força máxima**](#field-linear-y-force)<br/>`linear_y_force` | número · N | 100 | 0 … 1000000 |
| [**Frequência**](#field-linear-y-frequency)<br/>`linear_y_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-linear-y-damping)<br/>`linear_y_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-linear-y-motion)<br/>`linear_y_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-linear-y-motor)<br/>`linear_y_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-linear-y-minimum">Limite mínimo · <code>linear_y_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-maximum">Limite máximo · <code>linear_y_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-friction">Atrito máximo · <code>linear_y_friction</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-velocity">Velocidade alvo · <code>linear_y_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-position">Posição alvo · <code>linear_y_position</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-force">Força máxima · <code>linear_y_force</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-frequency">Frequência · <code>linear_y_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-damping">Amortecimento · <code>linear_y_damping</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-motion">Movimento · <code>linear_y_motion</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-y-motor">Motor · <code>linear_y_motor</code></h4>

**Onde:** Inspector → **Junta** → **Translação Y** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Translação Z

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-linear-z-minimum)<br/>`linear_z_minimum` | número · u | -1 | -100000 … 100000 |
| [**Limite máximo**](#field-linear-z-maximum)<br/>`linear_z_maximum` | número · u | 1 | -100000 … 100000 |
| [**Atrito máximo**](#field-linear-z-friction)<br/>`linear_z_friction` | número · N | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-linear-z-velocity)<br/>`linear_z_velocity` | número · u/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-linear-z-position)<br/>`linear_z_position` | número · u | 0 | -100000 … 100000 |
| [**Força máxima**](#field-linear-z-force)<br/>`linear_z_force` | número · N | 100 | 0 … 1000000 |
| [**Frequência**](#field-linear-z-frequency)<br/>`linear_z_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-linear-z-damping)<br/>`linear_z_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-linear-z-motion)<br/>`linear_z_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-linear-z-motor)<br/>`linear_z_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-linear-z-minimum">Limite mínimo · <code>linear_z_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-maximum">Limite máximo · <code>linear_z_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-friction">Atrito máximo · <code>linear_z_friction</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-velocity">Velocidade alvo · <code>linear_z_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-position">Posição alvo · <code>linear_z_position</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-force">Força máxima · <code>linear_z_force</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-frequency">Frequência · <code>linear_z_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-damping">Amortecimento · <code>linear_z_damping</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-motion">Movimento · <code>linear_z_motion</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-z-motor">Motor · <code>linear_z_motor</code></h4>

**Onde:** Inspector → **Junta** → **Translação Z** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Rotação X

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-angular-x-minimum)<br/>`angular_x_minimum` | número · ° | -1 | -180 … 180 |
| [**Limite máximo**](#field-angular-x-maximum)<br/>`angular_x_maximum` | número · ° | 1 | -180 … 180 |
| [**Atrito máximo**](#field-angular-x-friction)<br/>`angular_x_friction` | número · Nm | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-angular-x-velocity)<br/>`angular_x_velocity` | número · °/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-angular-x-position)<br/>`angular_x_position` | número · ° | 0 | -180 … 180 |
| [**Força máxima**](#field-angular-x-force)<br/>`angular_x_force` | número · Nm | 100 | 0 … 1000000 |
| [**Frequência**](#field-angular-x-frequency)<br/>`angular_x_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-angular-x-damping)<br/>`angular_x_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-angular-x-motion)<br/>`angular_x_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-angular-x-motor)<br/>`angular_x_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-angular-x-minimum">Limite mínimo · <code>angular_x_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-maximum">Limite máximo · <code>angular_x_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-friction">Atrito máximo · <code>angular_x_friction</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-velocity">Velocidade alvo · <code>angular_x_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** °/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-position">Posição alvo · <code>angular_x_position</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-force">Força máxima · <code>angular_x_force</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-frequency">Frequência · <code>angular_x_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-damping">Amortecimento · <code>angular_x_damping</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-motion">Movimento · <code>angular_x_motion</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-x-motor">Motor · <code>angular_x_motor</code></h4>

**Onde:** Inspector → **Junta** → **Rotação X** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Rotação Y

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-angular-y-minimum)<br/>`angular_y_minimum` | número · ° | -1 | -180 … 180 |
| [**Limite máximo**](#field-angular-y-maximum)<br/>`angular_y_maximum` | número · ° | 1 | -180 … 180 |
| [**Atrito máximo**](#field-angular-y-friction)<br/>`angular_y_friction` | número · Nm | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-angular-y-velocity)<br/>`angular_y_velocity` | número · °/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-angular-y-position)<br/>`angular_y_position` | número · ° | 0 | -180 … 180 |
| [**Força máxima**](#field-angular-y-force)<br/>`angular_y_force` | número · Nm | 100 | 0 … 1000000 |
| [**Frequência**](#field-angular-y-frequency)<br/>`angular_y_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-angular-y-damping)<br/>`angular_y_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-angular-y-motion)<br/>`angular_y_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-angular-y-motor)<br/>`angular_y_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-angular-y-minimum">Limite mínimo · <code>angular_y_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-maximum">Limite máximo · <code>angular_y_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-friction">Atrito máximo · <code>angular_y_friction</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-velocity">Velocidade alvo · <code>angular_y_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** °/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-position">Posição alvo · <code>angular_y_position</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-force">Força máxima · <code>angular_y_force</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-frequency">Frequência · <code>angular_y_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-damping">Amortecimento · <code>angular_y_damping</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-motion">Movimento · <code>angular_y_motion</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-y-motor">Motor · <code>angular_y_motor</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Y** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Rotação Z

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Limite mínimo**](#field-angular-z-minimum)<br/>`angular_z_minimum` | número · ° | -1 | -180 … 180 |
| [**Limite máximo**](#field-angular-z-maximum)<br/>`angular_z_maximum` | número · ° | 1 | -180 … 180 |
| [**Atrito máximo**](#field-angular-z-friction)<br/>`angular_z_friction` | número · Nm | 0 | 0 … 1000000 |
| [**Velocidade alvo**](#field-angular-z-velocity)<br/>`angular_z_velocity` | número · °/s | 0 | -1000 … 1000 |
| [**Posição alvo**](#field-angular-z-position)<br/>`angular_z_position` | número · ° | 0 | -180 … 180 |
| [**Força máxima**](#field-angular-z-force)<br/>`angular_z_force` | número · Nm | 100 | 0 … 1000000 |
| [**Frequência**](#field-angular-z-frequency)<br/>`angular_z_frequency` | número · Hz | 2 | 0.001 … 1000 |
| [**Amortecimento**](#field-angular-z-damping)<br/>`angular_z_damping` | número | 1 | 0 … 10 |
| [**Movimento**](#field-angular-z-motion)<br/>`angular_z_motion` | enumeração | Travado | Travado \| Limitado \| Livre |
| [**Motor**](#field-angular-z-motor)<br/>`angular_z_motor` | enumeração | Desligado | Desligado \| Velocidade \| Posição \| Posição e velocidade |

<h4 id="field-angular-z-minimum">Limite mínimo · <code>angular_z_minimum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Limite mínimo**.

**Uso e efeito:** Junta: limite inferior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** -1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-maximum">Limite máximo · <code>angular_z_maximum</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Limite máximo**.

**Uso e efeito:** Junta: limite superior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-friction">Atrito máximo · <code>angular_z_friction</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Atrito máximo**.

**Uso e efeito:** Junta: fricção no grau de liberdade do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-velocity">Velocidade alvo · <code>angular_z_velocity</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Velocidade alvo**.

**Uso e efeito:** Junta: velocidade alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** °/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-position">Posição alvo · <code>angular_z_position</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Posição alvo**.

**Uso e efeito:** Junta: posição/ângulo alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-force">Força máxima · <code>angular_z_force</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Força máxima**.

**Uso e efeito:** Junta: força/torque máximo do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 100 · **Tipo:** número · **Unidade:** Nm · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-frequency">Frequência · <code>angular_z_frequency</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Frequência**.

**Uso e efeito:** Junta: frequência da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 2 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0.001 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-damping">Amortecimento · <code>angular_z_damping</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Amortecimento**.

**Uso e efeito:** Junta: amortecimento da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-motion">Movimento · <code>angular_z_motion</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Movimento**.

**Uso e efeito:** Junta: política livre/limitado/travado do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Travado · **Tipo:** enumeração · **Domínio:** Travado \| Limitado \| Livre.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-z-motor">Motor · <code>angular_z_motor</code></h4>

**Onde:** Inspector → **Junta** → **Rotação Z** → **Motor**.

**Uso e efeito:** Junta: modo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

**Valor:** Desligado · **Tipo:** enumeração · **Domínio:** Desligado \| Velocidade \| Posição \| Posição e velocidade.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Geral

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Tipo**](#field-kind)<br/>`kind` | enumeração | Distância | Ponto \| Dobradiça \| Deslizante \| Distância \| Fixa \| Cone \| Swing / Twist \| Configurável 6DOF \| Mola |

<h4 id="field-enabled">Ativa · <code>enabled</code></h4>

**Onde:** Inspector → **Junta** → **Geral** → **Ativa**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-kind">Tipo · <code>kind</code></h4>

**Onde:** Inspector → **Junta** → **Geral** → **Tipo**.

**Uso e efeito:** Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais.

**Valor:** Distância · **Tipo:** enumeração · **Domínio:** Ponto \| Dobradiça \| Deslizante \| Distância \| Fixa \| Cone \| Swing / Twist \| Configurável 6DOF \| Mola.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Junta** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_generic6dofjoint3d.html). Essa referência não representa paridade funcional.


---

---
title: "Motor dinâmico"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/
---

# Motor dinâmico

Locomoção por força e salto com apoio sobre Corpo físico dinâmico

**Família:** Física 3D · **Grupo:** Corpos · **Identificador:** `astra.physics.dynamic_motor` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Locomoção por força e salto com apoio sobre Corpo físico dinâmico

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Motor dinâmico**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.DynamicBodyMotor](/pt-br/snapshot-2026-10-06/api/astra-components-dynamicbodymotor/).



## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Adicione Corpo físico dinâmico ao receptor

## Conflitos

- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): Incompatível com personagem cápsula

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Locomoção

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade**](#field-speed)<br/>`speed` | número · m/s | 6 | 0 … 100 |
| [**Aceleração**](#field-acceleration)<br/>`acceleration` | número · m/s² | 24 | 0 … 1000 |
| [**Frenagem**](#field-braking)<br/>`braking` | número · m/s² | 36 | 0 … 1000 |
| [**Controle no ar**](#field-air-control)<br/>`air_control` | número | 0.25 | 0 … 1 |
| [**Velocidade do salto**](#field-jump-speed)<br/>`jump_speed` | número · m/s | 6 | 0 … 100 |
| [**Habilitado**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-speed">Velocidade · <code>speed</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Velocidade**.

**Uso e efeito:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Valor:** 6 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0 … 100.



<h4 id="field-acceleration">Aceleração · <code>acceleration</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Aceleração**.

**Uso e efeito:** Limita a força de correção para atingir a velocidade alvo; usa a massa real, sem escrever Transform diretamente.

**Valor:** 24 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** 0 … 1000.



<h4 id="field-braking">Frenagem · <code>braking</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Frenagem**.

**Uso e efeito:** Limita a correção da velocidade quando não há comando de movimento.

**Valor:** 36 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** 0 … 1000.



<h4 id="field-air-control">Controle no ar · <code>air_control</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Controle no ar**.

**Uso e efeito:** Multiplicador de controle enquanto sem apoio.

**Valor:** 0.25 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-jump-speed">Velocidade do salto · <code>jump_speed</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Velocidade do salto**.

**Uso e efeito:** Velocidade alvo inicial de salto.

**Valor:** 6 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0 … 100.



<h4 id="field-enabled">Habilitado · <code>enabled</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Habilitado**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Chão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Centro até os pés**](#field-probe-height)<br/>`probe_height` | número · m | 1 | 0.01 … 100 |
| [**Alcance abaixo dos pés**](#field-probe-distance)<br/>`probe_distance` | número · m | 0.15 | 0.001 … 2 |
| [**Raio de sondagem**](#field-support-radius)<br/>`support_radius` | número · m | 0.3 | 0 … 10 |
| [**Rampa máxima**](#field-max-slope)<br/>`max_slope` | número · ° | 50 | 0 … 89 |
| [**Acompanhar plataforma**](#field-inherit-platform-velocity)<br/>`inherit_platform_velocity` | booleano | verdadeiro | verdadeiro \| falso |
| [**Apoio pela colisão**](#field-automatic-support)<br/>`automatic_support` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-probe-height">Centro até os pés · <code>probe_height</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Centro até os pés**.

**Uso e efeito:** Usado somente quando Apoio pela colisão está desligado.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-probe-distance">Alcance abaixo dos pés · <code>probe_distance</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Alcance abaixo dos pés**.

**Uso e efeito:** Alcance da consulta de apoio.

**Valor:** 0.15 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 2.



<h4 id="field-support-radius">Raio de sondagem · <code>support_radius</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Raio de sondagem**.

**Uso e efeito:** Usado somente quando Apoio pela colisão está desligado.

**Valor:** 0.3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-slope">Rampa máxima · <code>max_slope</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Rampa máxima**.

**Uso e efeito:** Inclinação máxima de apoio do motor.

**Valor:** 50 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 89.



<h4 id="field-inherit-platform-velocity">Acompanhar plataforma · <code>inherit_platform_velocity</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Acompanhar plataforma**.

**Uso e efeito:** Herda velocidade da plataforma de apoio quando permitido.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-automatic-support">Apoio pela colisão · <code>automatic_support</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Apoio pela colisão**.

**Uso e efeito:** Sonda a superfície real do colisor do solver, com escala, rotação e partes compostas. Cinco amostras; alcance abaixo da forma em metros.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Motor dinâmico** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_rigidbody3d.html). Essa referência não representa paridade funcional.


---

---
title: "Animação"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-animation/
---

# Animação

Clipes tocados e misturados no Play

**Família:** Animação · **Grupo:** Clipes · **Identificador:** `astra.animation` · **Payload:** 4

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Clipes tocados e misturados no Play

Atribua clipes/recursos e escolha reprodução. SkinnedMesh precisa dos dados de deformação compatíveis; um nome de clip ou blend shape não cria esse recurso.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Animação** / **Clipes** → **Animação**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.Animation](/pt-br/snapshot-2026-10-06/api/astra-components-animation/).



## Exemplo de uso

Use um recurso com clipe real, compare Speed 0/1 e modos de repetição; confira deformação e bounds antes de usar culling.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 4 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Reprodução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade**](#field-speed)<br/>`speed` | número · x | 1 | -10 … 10 |
| [**Ativa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Tocar ao iniciar**](#field-play-automatically)<br/>`play_automatically` | booleano | verdadeiro | verdadeiro \| falso |
| [**Repetição**](#field-wrap-mode)<br/>`wrap_mode` | enumeração | Repetir | Uma vez \| Repetir \| Vai e volta \| Segurar no fim |

<h4 id="field-speed">Velocidade · <code>speed</code></h4>

**Onde:** Inspector → **Animação** → **Reprodução** → **Velocidade**.

**Uso e efeito:** Multiplica a velocidade de reprodução dos clipes; exige estado/recurso de animação válido.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -10 … 10.

Translação, rotação e escala; pesos de morph não; sem mistura entre clipes Capacidade necessária: `animation.clip`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-enabled">Ativa · <code>enabled</code></h4>

**Onde:** Inspector → **Animação** → **Reprodução** → **Ativa**.

**Uso e efeito:** Desligar suspende tempo e avaliação; religar retoma os estados

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Translação, rotação e escala; pesos de morph não; sem mistura entre clipes Capacidade necessária: `animation.clip`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-play-automatically">Tocar ao iniciar · <code>play_automatically</code></h4>

**Onde:** Inspector → **Animação** → **Reprodução** → **Tocar ao iniciar**.

**Uso e efeito:** Play Automatically: o clipe padrão começa a tocar quando o Play inicia

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Translação, rotação e escala; pesos de morph não; sem mistura entre clipes Capacidade necessária: `animation.clip`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-wrap-mode">Repetição · <code>wrap_mode</code></h4>

**Onde:** Inspector → **Animação** → **Reprodução** → **Repetição**.

**Uso e efeito:** Wrap Mode padrão dos clipes: o que acontece depois do fim

**Valor:** Repetir · **Tipo:** enumeração · **Domínio:** Uma vez \| Repetir \| Vai e volta \| Segurar no fim.

Translação, rotação e escala; pesos de morph não; sem mistura entre clipes Capacidade necessária: `animation.clip`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Clipes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Quantidade de clipes**](#field-clip-count)<br/>`clip_count` | enumeração | 0 | 0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10 \| 11 \| 12 \| 13 \| 14 \| 15 \| 16 \| 17 \| 18 \| 19 \| 20 \| 21 \| 22 \| 23 \| 24 \| 25 \| 26 \| 27 \| 28 \| 29 \| 30 \| 31 \| 32 |

<h4 id="field-clip-count">Quantidade de clipes · <code>clip_count</code></h4>

**Onde:** Inspector → **Animação** → **Clipes** → **Quantidade de clipes**.

**Uso e efeito:** Quantidade de entradas de clipe autoradas; recurso e estado de reprodução são separados.

**Valor:** 0 · **Tipo:** enumeração · **Domínio:** 0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10 \| 11 \| 12 \| 13 \| 14 \| 15 \| 16 \| 17 \| 18 \| 19 \| 20 \| 21 \| 22 \| 23 \| 24 \| 25 \| 26 \| 27 \| 28 \| 29 \| 30 \| 31 \| 32.

Translação, rotação e escala; pesos de morph não; sem mistura entre clipes Capacidade necessária: `animation.clip`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Ampliar importação, composição, edição de clipes e aceite de deformação/motion vectors. Timeline de UI é outro sistema e continua parcial. Não pressupõe Animator completo.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Animação** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-Animation.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de gravidade 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-gravity/
---

# Campo de gravidade 2D

Gravidade XY em área sobre corpos dinâmicos 2D

**Família:** Física 2D · **Grupo:** Campos · **Identificador:** `astra.physics2d.field.gravity` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Gravidade XY em área sobre corpos dinâmicos 2D

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de gravidade 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.GravityField2D](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Retângulo | Retângulo \| Círculo |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Retângulo · **Tipo:** enumeração · **Domínio:** Retângulo \| Círculo.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Vetor X**](#field-vector-x)<br/>`vector_x` | número · m/s² | 0 | -10000 … 10000 |
| [**Vetor Y**](#field-vector-y)<br/>`vector_y` | número · m/s² | -9.81 | -10000 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Substituir gravidade do mundo**](#field-replace-world-gravity)<br/>`replace_world_gravity` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-vector-x">Vetor X · <code>vector_x</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Efeito** → **Vetor X**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-vector-y">Vetor Y · <code>vector_y</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Efeito** → **Vetor Y**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Y.

**Valor:** -9.81 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-replace-world-gravity">Substituir gravidade do mundo · <code>replace_world_gravity</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Efeito** → **Substituir gravidade do mundo**.

**Uso e efeito:** Sobrepostos somam vetores e cancelam a gravidade padrão uma única vez

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de gravidade 2D** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de gravidade 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area2d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de vento 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-wind/
---

# Campo de vento 2D

Acoplamento XY à velocidade do ar com massa real

**Família:** Física 2D · **Grupo:** Campos · **Identificador:** `astra.physics2d.field.wind` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Acoplamento XY à velocidade do ar com massa real

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de vento 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.WindField2D](/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Retângulo | Retângulo \| Círculo |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Retângulo · **Tipo:** enumeração · **Domínio:** Retângulo \| Círculo.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Vetor X**](#field-vector-x)<br/>`vector_x` | número · m/s | 5 | -10000 … 10000 |
| [**Vetor Y**](#field-vector-y)<br/>`vector_y` | número · m/s | 0 | -10000 … 10000 |
| [**Acoplamento**](#field-coefficient)<br/>`coefficient` | número · kg/s | 1 | 0 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-vector-x">Vetor X · <code>vector_x</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Efeito** → **Vetor X**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo X.

**Valor:** 5 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.



<h4 id="field-vector-y">Vetor Y · <code>vector_y</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Efeito** → **Vetor Y**.

**Uso e efeito:** Componente do vetor de contribuição do campo, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.



<h4 id="field-coefficient">Acoplamento · <code>coefficient</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Efeito** → **Acoplamento**.

**Uso e efeito:** Coeficiente da contribuição de vento, combinado com o vetor/campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** kg/s · **Domínio:** 0 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de vento 2D** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de vento 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area2d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo de arrasto 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-drag/
---

# Campo de arrasto 2D

Amortecimento linear XY e angular de Body2D

**Família:** Física 2D · **Grupo:** Campos · **Identificador:** `astra.physics2d.field.drag` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Amortecimento linear XY e angular de Body2D

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo de arrasto 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.DragField2D](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Retângulo | Retângulo \| Círculo |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Retângulo · **Tipo:** enumeração · **Domínio:** Retângulo \| Círculo.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Arrasto linear**](#field-linear-drag)<br/>`linear_drag` | número · 1/s | 1 | 0 … 1000 |
| [**Arrasto angular**](#field-angular-drag)<br/>`angular_drag` | número · 1/s | 1 | 0 … 1000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-linear-drag">Arrasto linear · <code>linear_drag</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Efeito** → **Arrasto linear**.

**Uso e efeito:** Arrasto linear aplicado pelo campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** 1/s · **Domínio:** 0 … 1000.



<h4 id="field-angular-drag">Arrasto angular · <code>angular_drag</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Efeito** → **Arrasto angular**.

**Uso e efeito:** Arrasto angular aplicado pelo campo.

**Valor:** 1 · **Tipo:** número · **Unidade:** 1/s · **Domínio:** 0 … 1000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo de arrasto 2D** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo de arrasto 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area2d.html). Essa referência não representa paridade funcional.


---

---
title: "Campo radial 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-radial/
---

# Campo radial 2D

Atração, repulsão e vórtice no plano XY

**Família:** Física 2D · **Grupo:** Campos · **Identificador:** `astra.physics2d.field.radial` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Atração, repulsão e vórtice no plano XY

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.RadialField2D](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Volume

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia extensão X**](#field-half-x)<br/>`half_x` | número · m | 3 | 0.001 … 10000 |
| [**Meia extensão Y**](#field-half-y)<br/>`half_y` | número · m | 3 | 0.001 … 10000 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 3 | 0.001 … 10000 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -10000 … 10000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -10000 … 10000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Retângulo | Retângulo \| Círculo |

<h4 id="field-half-x">Meia extensão X · <code>half_x</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Meia extensão X**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia extensão Y · <code>half_y</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Meia extensão Y**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -10000 … 10000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Volume** → **Forma**.

**Uso e efeito:** Escala e orientação são as do objeto e de seus pais

**Valor:** Retângulo · **Tipo:** enumeração · **Domínio:** Retângulo \| Círculo.



### Efeito

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Aceleração radial**](#field-acceleration)<br/>`acceleration` | número · m/s² | -9.81 | -10000 … 10000 |
| [**Aceleração tangencial**](#field-tangential-acceleration)<br/>`tangential_acceleration` | número · m/s² | 0 | -10000 … 10000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-acceleration">Aceleração radial · <code>acceleration</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Efeito** → **Aceleração radial**.

**Uso e efeito:** Aceleração radial em relação à origem do campo.

**Valor:** -9.81 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-tangential-acceleration">Aceleração tangencial · <code>tangential_acceleration</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Efeito** → **Aceleração tangencial**.

**Uso e efeito:** Aceleração tangencial em torno da origem.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** -10000 … 10000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Efeito** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Alcance

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Acordar corpos**](#field-wake-bodies)<br/>`wake_bodies` | booleano | verdadeiro | verdadeiro \| falso |
| [**Queda de influência**](#field-falloff)<br/>`falloff` | enumeração | Uniforme | Uniforme \| Linear \| Suave |
| [**Camada afetada**](#field-affected-layer)<br/>`affected_layer` | enumeração | Todas | Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31 |

<h4 id="field-wake-bodies">Acordar corpos · <code>wake_bodies</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Alcance** → **Acordar corpos**.

**Uso e efeito:** Desligado: corpos em repouso permanecem dormindo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-falloff">Queda de influência · <code>falloff</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Alcance** → **Queda de influência**.

**Uso e efeito:** Centro vale 1; Linear e Suave chegam a zero na borda

**Valor:** Uniforme · **Tipo:** enumeração · **Domínio:** Uniforme \| Linear \| Suave.



<h4 id="field-affected-layer">Camada afetada · <code>affected_layer</code></h4>

**Onde:** Inspector → **Campo radial 2D** → **Alcance** → **Camada afetada**.

**Uso e efeito:** Todas ou uma camada física do projeto; não altera a matriz de colisão

**Valor:** Todas · **Tipo:** enumeração · **Domínio:** Todas \| Camada 0 \| Camada 1 \| Camada 2 \| Camada 3 \| Camada 4 \| Camada 5 \| Camada 6 \| Camada 7 \| Camada 8 \| Camada 9 \| Camada 10 \| Camada 11 \| Camada 12 \| Camada 13 \| Camada 14 \| Camada 15 \| Camada 16 \| Camada 17 \| Camada 18 \| Camada 19 \| Camada 20 \| Camada 21 \| Camada 22 \| Camada 23 \| Camada 24 \| Camada 25 \| Camada 26 \| Camada 27 \| Camada 28 \| Camada 29 \| Camada 30 \| Camada 31.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Campo radial 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area2d.html). Essa referência não representa paridade funcional.


---

---
title: "Conexão física 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-event-connection/
---

# Conexão física 2D

Evento real de sensor/contato 2D altera ativação do receptor

**Família:** Física 2D · **Grupo:** Eventos · **Identificador:** `astra.physics2d.event_connection` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Evento real de sensor/contato 2D altera ativação do receptor

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Eventos** → **Conexão física 2D**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.PhysicsEventConnection2D](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

- [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/): Adicione Body2D ao objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativa**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Evento**](#field-event)<br/>`event` | enumeração | Entrada sensor | Entrada sensor \| Perm. sensor \| Saída sensor \| Entrada contato \| Perm. contato \| Saída contato |
| [**Ação**](#field-action)<br/>`action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto |
| [**Receptor**](#field-receiver)<br/>`receiver` | referência | Escolher objeto | qualquer objeto |

<h4 id="field-enabled">Ativa · <code>enabled</code></h4>

**Onde:** Inspector → **Conexão física 2D** → **Conexão** → **Ativa**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-event">Evento · <code>event</code></h4>

**Onde:** Inspector → **Conexão física 2D** → **Conexão** → **Evento**.

**Uso e efeito:** Sensor exige um Colisor 2D sensor; contato exige uma forma sólida no emissor

**Valor:** Entrada sensor · **Tipo:** enumeração · **Domínio:** Entrada sensor \| Perm. sensor \| Saída sensor \| Entrada contato \| Perm. contato \| Saída contato.



<h4 id="field-action">Ação · <code>action</code></h4>

**Onde:** Inspector → **Conexão física 2D** → **Conexão** → **Ação**.

**Uso e efeito:** Executada antes do callback C#; permanência pode disparar a cada passo físico

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto.



<h4 id="field-receiver">Receptor · <code>receiver</code></h4>

**Onde:** Inspector → **Conexão física 2D** → **Conexão** → **Receptor**.

**Uso e efeito:** Objeto cuja ativação será alterada

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Filtro

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Outro objeto**](#field-other-filter)<br/>`other_filter` | referência | Qualquer objeto | qualquer objeto |

<h4 id="field-other-filter">Outro objeto · <code>other_filter</code></h4>

**Onde:** Inspector → **Conexão física 2D** → **Filtro** → **Outro objeto**.

**Uso e efeito:** Opcional: somente eventos com este outro objeto; vazio aceita todos

**Valor:** Qualquer objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Conexão física 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_area2d.html). Essa referência não representa paridade funcional.


---

---
title: "Força constante 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-constant-force/
---

# Força constante 2D

Força XY e torque contínuos sobre Body2D dinâmico

**Família:** Física 2D · **Grupo:** Forças · **Identificador:** `astra.physics2d.constant-force` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Força XY e torque contínuos sobre Body2D dinâmico

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Forças** → **Força constante 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.ConstantForce2D](/pt-br/snapshot-2026-10-06/api/astra-components-constantforce2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

- [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/): Adicione Body2D ao objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Propulsão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Força X**](#field-force-x)<br/>`force_x` | número · N | 0 | -1000000 … 1000000 |
| [**Força Y**](#field-force-y)<br/>`force_y` | número · N | 0 | -1000000 … 1000000 |
| [**Força local X**](#field-relative-force-x)<br/>`relative_force_x` | número · N | 0 | -1000000 … 1000000 |
| [**Força local Y**](#field-relative-force-y)<br/>`relative_force_y` | número · N | 0 | -1000000 … 1000000 |
| [**Torque**](#field-torque)<br/>`torque` | número · N m | 0 | -1000000 … 1000000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-force-x">Força X · <code>force_x</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Força X**.

**Uso e efeito:** Força contínua em espaço mundial, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -1000000 … 1000000.



<h4 id="field-force-y">Força Y · <code>force_y</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Força Y**.

**Uso e efeito:** Força contínua em espaço mundial, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -1000000 … 1000000.



<h4 id="field-relative-force-x">Força local X · <code>relative_force_x</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Força local X**.

**Uso e efeito:** Força contínua no espaço local do objeto, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -1000000 … 1000000.



<h4 id="field-relative-force-y">Força local Y · <code>relative_force_y</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Força local Y**.

**Uso e efeito:** Força contínua no espaço local do objeto, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** N · **Domínio:** -1000000 … 1000000.



<h4 id="field-torque">Torque · <code>torque</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Torque**.

**Uso e efeito:** Torque contínuo sobre o Body2D dinâmico; não é orientação autoral.

**Valor:** 0 · **Tipo:** número · **Unidade:** N m · **Domínio:** -1000000 … 1000000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Força constante 2D** → **Propulsão** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Força constante 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/ConstantForce2D.html). Essa referência não representa paridade funcional.


---

---
title: "Junta 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-joint/
---

# Junta 2D

Fixed/Weld, Revolute, Prismatic ou Distance reais

**Família:** Física 2D · **Grupo:** Juntas · **Identificador:** `astra.physics2d.joint` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Fixed/Weld, Revolute, Prismatic ou Distance reais

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Juntas** → **Junta 2D**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.Joint2D](/pt-br/snapshot-2026-10-06/api/astra-components-joint2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

- [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/): Adicione Body2D ao objeto

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Anchors

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Anchor A X**](#field-anchor-a-x)<br/>`anchor_a_x` | número · m | 0 | -1000 … 1000 |
| [**Anchor A Y**](#field-anchor-a-y)<br/>`anchor_a_y` | número · m | 0 | -1000 … 1000 |
| [**Anchor B X**](#field-anchor-b-x)<br/>`anchor_b_x` | número · m | 0 | -1000 … 1000 |
| [**Anchor B Y**](#field-anchor-b-y)<br/>`anchor_b_y` | número · m | 0 | -1000 … 1000 |

<h4 id="field-anchor-a-x">Anchor A X · <code>anchor_a_x</code></h4>

**Onde:** Inspector → **Junta 2D** → **Anchors** → **Anchor A X**.

**Uso e efeito:** Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-anchor-a-y">Anchor A Y · <code>anchor_a_y</code></h4>

**Onde:** Inspector → **Junta 2D** → **Anchors** → **Anchor A Y**.

**Uso e efeito:** Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-anchor-b-x">Anchor B X · <code>anchor_b_x</code></h4>

**Onde:** Inspector → **Junta 2D** → **Anchors** → **Anchor B X**.

**Uso e efeito:** Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-anchor-b-y">Anchor B Y · <code>anchor_b_y</code></h4>

**Onde:** Inspector → **Junta 2D** → **Anchors** → **Anchor B Y**.

**Uso e efeito:** Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Ajustes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ângulo referência**](#field-reference-angle-degrees)<br/>`reference_angle_degrees` | número · graus | 0 | -180 … 180 |
| [**Eixo local A**](#field-axis-angle-degrees)<br/>`axis_angle_degrees` | número · graus | 0 | -180 … 180 |
| [**Comprimento repouso**](#field-length)<br/>`length` | número · m | 1 | 0.005 … 1000 |
| [**Comprimento mínimo**](#field-min-length)<br/>`min_length` | número · m | 0.005 | 0.005 … 1000 |
| [**Comprimento máximo**](#field-max-length)<br/>`max_length` | número · m | 100 | 0.005 … 1000 |
| [**Limite inferior**](#field-lower-limit)<br/>`lower_limit` | número | -1 | -178 … 178 |
| [**Limite superior**](#field-upper-limit)<br/>`upper_limit` | número | 1 | -178 … 178 |
| [**Velocidade motor**](#field-motor-speed)<br/>`motor_speed` | número · m/s | 1 | -1000 … 1000 |
| [**Motor angular**](#field-motor-angular-speed-degrees)<br/>`motor_angular_speed_degrees` | número · graus/s | 90 | -36000 … 36000 |
| [**Força máxima motor**](#field-max-motor-force)<br/>`max_motor_force` | número · N | 100 | 0 … 1000000 |
| [**Torque máximo motor**](#field-max-motor-torque)<br/>`max_motor_torque` | número · N m | 100 | 0 … 1000000 |
| [**Frequência mola**](#field-spring-hertz)<br/>`spring_hertz` | número · Hz | 5 | 0 … 120 |
| [**Razão amortecimento**](#field-spring-damping)<br/>`spring_damping` | número | 0.7 | 0 … 10 |
| [**Translação alvo**](#field-spring-target-translation)<br/>`spring_target_translation` | número · m | 0 | -1000 … 1000 |
| [**Ângulo alvo**](#field-spring-target-angle-degrees)<br/>`spring_target_angle_degrees` | número · graus | 0 | -180 … 180 |
| [**Mola linear weld**](#field-linear-hertz)<br/>`linear_hertz` | número · Hz | 0 | 0 … 120 |
| [**Mola angular weld**](#field-angular-hertz)<br/>`angular_hertz` | número · Hz | 0 | 0 … 120 |
| [**Amortecimento linear weld**](#field-linear-damping-ratio)<br/>`linear_damping_ratio` | número | 1 | 0 … 10 |
| [**Amortecimento angular weld**](#field-angular-damping-ratio)<br/>`angular_damping_ratio` | número | 1 | 0 … 10 |
| [**Limites**](#field-limit-enabled)<br/>`limit_enabled` | booleano | falso | verdadeiro \| falso |
| [**Motor**](#field-motor-enabled)<br/>`motor_enabled` | booleano | falso | verdadeiro \| falso |
| [**Mola**](#field-spring-enabled)<br/>`spring_enabled` | booleano | falso | verdadeiro \| falso |

<h4 id="field-reference-angle-degrees">Ângulo referência · <code>reference_angle_degrees</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Ângulo referência**.

**Uso e efeito:** Ângulo de referência relativo da junta 2D em graus.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-axis-angle-degrees">Eixo local A · <code>axis_angle_degrees</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Eixo local A**.

**Uso e efeito:** Direção do eixo da junta 2D em graus.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-length">Comprimento repouso · <code>length</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Comprimento repouso**.

**Uso e efeito:** Comprimento de referência da junta Distance.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-min-length">Comprimento mínimo · <code>min_length</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Comprimento mínimo**.

**Uso e efeito:** Comprimento mínimo da junta Distance.

**Valor:** 0.005 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-length">Comprimento máximo · <code>max_length</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Comprimento máximo**.

**Uso e efeito:** Comprimento máximo da junta Distance.

**Valor:** 100 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-lower-limit">Limite inferior · <code>lower_limit</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Limite inferior**.

**Uso e efeito:** Limite inferior da junta 2D.

**Valor:** -1 · **Tipo:** número · **Domínio:** -178 … 178.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-upper-limit">Limite superior · <code>upper_limit</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Limite superior**.

**Uso e efeito:** Limite superior da junta 2D.

**Valor:** 1 · **Tipo:** número · **Domínio:** -178 … 178.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor-speed">Velocidade motor · <code>motor_speed</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Velocidade motor**.

**Uso e efeito:** Velocidade linear alvo do motor da junta 2D.

**Valor:** 1 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor-angular-speed-degrees">Motor angular · <code>motor_angular_speed_degrees</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Motor angular**.

**Uso e efeito:** Velocidade angular alvo do motor 2D em graus/s.

**Valor:** 90 · **Tipo:** número · **Unidade:** graus/s · **Domínio:** -36000 … 36000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-motor-force">Força máxima motor · <code>max_motor_force</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Força máxima motor**.

**Uso e efeito:** Limite de força do motor linear 2D.

**Valor:** 100 · **Tipo:** número · **Unidade:** N · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-motor-torque">Torque máximo motor · <code>max_motor_torque</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Torque máximo motor**.

**Uso e efeito:** Limite de torque do motor angular 2D.

**Valor:** 100 · **Tipo:** número · **Unidade:** N m · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-hertz">Frequência mola · <code>spring_hertz</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Frequência mola**.

**Uso e efeito:** Frequência da mola 2D.

**Valor:** 5 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0 … 120.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-damping">Razão amortecimento · <code>spring_damping</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Razão amortecimento**.

**Uso e efeito:** Amortecimento da mola da junta.

**Valor:** 0.7 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-target-translation">Translação alvo · <code>spring_target_translation</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Translação alvo**.

**Uso e efeito:** Translação alvo da mola 2D.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-target-angle-degrees">Ângulo alvo · <code>spring_target_angle_degrees</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Ângulo alvo**.

**Uso e efeito:** Ângulo alvo da mola 2D.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -180 … 180.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-hertz">Mola linear weld · <code>linear_hertz</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Mola linear weld**.

**Uso e efeito:** Frequência da ligação linear 2D.

**Valor:** 0 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0 … 120.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-hertz">Mola angular weld · <code>angular_hertz</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Mola angular weld**.

**Uso e efeito:** Frequência da ligação angular 2D.

**Valor:** 0 · **Tipo:** número · **Unidade:** Hz · **Domínio:** 0 … 120.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-damping-ratio">Amortecimento linear weld · <code>linear_damping_ratio</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Amortecimento linear weld**.

**Uso e efeito:** Razão de amortecimento linear 2D.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-damping-ratio">Amortecimento angular weld · <code>angular_damping_ratio</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Amortecimento angular weld**.

**Uso e efeito:** Razão de amortecimento angular 2D.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-limit-enabled">Limites · <code>limit_enabled</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Limites**.

**Uso e efeito:** Ativa os limites configurados da junta 2D.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motor-enabled">Motor · <code>motor_enabled</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Motor**.

**Uso e efeito:** Ativa motor da junta 2D.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-spring-enabled">Mola · <code>spring_enabled</code></h4>

**Onde:** Inspector → **Junta 2D** → **Ajustes** → **Mola**.

**Uso e efeito:** Ativa mola da junta 2D.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Conectar ao mundo**](#field-world-anchor)<br/>`world_anchor` | booleano | falso | verdadeiro \| falso |
| [**Colidir conectados**](#field-collide-connected)<br/>`collide_connected` | booleano | falso | verdadeiro \| falso |
| [**Modo**](#field-kind)<br/>`kind` | enumeração | Fixed / Weld | Fixed / Weld \| Revolute \| Prismatic \| Distance |
| [**Corpo conectado**](#field-target)<br/>`target` | referência | Escolher Body2D | astra.physics2d.body · outro objeto |

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Junta 2D** → **Conexão** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-world-anchor">Conectar ao mundo · <code>world_anchor</code></h4>

**Onde:** Inspector → **Junta 2D** → **Conexão** → **Conectar ao mundo**.

**Uso e efeito:** Interpreta a âncora conforme a opção de mundo da junta 2D.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-collide-connected">Colidir conectados · <code>collide_connected</code></h4>

**Onde:** Inspector → **Junta 2D** → **Conexão** → **Colidir conectados**.

**Uso e efeito:** Permite colisão entre os corpos conectados.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-kind">Modo · <code>kind</code></h4>

**Onde:** Inspector → **Junta 2D** → **Conexão** → **Modo**.

**Uso e efeito:** Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais.

**Valor:** Fixed / Weld · **Tipo:** enumeração · **Domínio:** Fixed / Weld \| Revolute \| Prismatic \| Distance.



<h4 id="field-target">Corpo conectado · <code>target</code></h4>

**Onde:** Inspector → **Junta 2D** → **Conexão** → **Corpo conectado**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher Body2D · **Tipo:** referência · **Domínio:** astra.physics2d.body · outro objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Junta 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Joint2D.html). Essa referência não representa paridade funcional.


---

---
title: "Corpo 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/
---

# Corpo 2D

Corpo XY independente de física 3D

**Família:** Física 2D · **Grupo:** Corpos · **Identificador:** `astra.physics2d.body` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Corpo XY independente de física 3D

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Corpos** → **Corpo 2D**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.Body2D](/pt-br/snapshot-2026-10-06/api/astra-components-body2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

- [Colisor 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-collider/): Adicione uma forma 2D ao corpo

## Conflitos

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Corpos 2D e 3D não compartilham o mesmo objeto
- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): Personagem 3D possui a pose deste objeto
- [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/): Colisores 2D e 3D usam mundos separados

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Corpo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Massa**](#field-mass)<br/>`mass` | número · kg | 1 | 0.001 … 100000 |
| [**Escala gravidade**](#field-gravity-scale)<br/>`gravity_scale` | número | 1 | -100 … 100 |
| [**Movimento**](#field-motion)<br/>`motion` | enumeração | Dinâmico | Estático \| Cinemático \| Dinâmico |

<h4 id="field-mass">Massa · <code>mass</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Corpo** → **Massa**.

**Uso e efeito:** Massa do corpo dinâmico em kg; influencia resposta a força/impulso.

**Valor:** 1 · **Tipo:** número · **Unidade:** kg · **Domínio:** 0.001 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-gravity-scale">Escala gravidade · <code>gravity_scale</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Corpo** → **Escala gravidade**.

**Uso e efeito:** Multiplica gravidade mundial deste corpo 2D.

**Valor:** 1 · **Tipo:** número · **Domínio:** -100 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-motion">Movimento · <code>motion</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Corpo** → **Movimento**.

**Uso e efeito:** Escolhe autoridade estática/cinemática/dinâmica no domínio do corpo.

**Valor:** Dinâmico · **Tipo:** enumeração · **Domínio:** Estático \| Cinemático \| Dinâmico.



### Movimento

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade X**](#field-velocity-x)<br/>`velocity_x` | número · m/s | 0 | -10000 … 10000 |
| [**Velocidade Y**](#field-velocity-y)<br/>`velocity_y` | número · m/s | 0 | -10000 … 10000 |
| [**Velocidade angular**](#field-angular-velocity-degrees)<br/>`angular_velocity_degrees` | número · graus/s | 0 | -36000 … 36000 |
| [**Arrasto linear**](#field-linear-damping)<br/>`linear_damping` | número | 0.05 | 0 … 100 |
| [**Arrasto angular**](#field-angular-damping)<br/>`angular_damping` | número | 0.05 | 0 … 100 |
| [**Fixar rotação**](#field-fixed-rotation)<br/>`fixed_rotation` | booleano | falso | verdadeiro \| falso |
| [**Permitir repouso**](#field-allow-sleep)<br/>`allow_sleep` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-velocity-x">Velocidade X · <code>velocity_x</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Velocidade X**.

**Uso e efeito:** Velocidade linear inicial/autorada do corpo, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-velocity-y">Velocidade Y · <code>velocity_y</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Velocidade Y**.

**Uso e efeito:** Velocidade linear inicial/autorada do corpo, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m/s · **Domínio:** -10000 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-velocity-degrees">Velocidade angular · <code>angular_velocity_degrees</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Velocidade angular**.

**Uso e efeito:** Velocidade angular 2D em graus/s; não confundir com rad/s da API matemática.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus/s · **Domínio:** -36000 … 36000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-linear-damping">Arrasto linear · <code>linear_damping</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Arrasto linear**.

**Uso e efeito:** Amortecimento de velocidade linear.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-angular-damping">Arrasto angular · <code>angular_damping</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Arrasto angular**.

**Uso e efeito:** Amortecimento de velocidade angular.

**Valor:** 0.05 · **Tipo:** número · **Domínio:** 0 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-fixed-rotation">Fixar rotação · <code>fixed_rotation</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Fixar rotação**.

**Uso e efeito:** Trava a rotação física do Body2D.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-allow-sleep">Permitir repouso · <code>allow_sleep</code></h4>

**Onde:** Inspector → **Corpo 2D** → **Movimento** → **Permitir repouso**.

**Uso e efeito:** Permite dormir quando o corpo pode ficar em repouso.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Corpo 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_rigidbody2d.html). Essa referência não representa paridade funcional.


---

---
title: "Colisor 2D"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-collider/
---

# Colisor 2D

Caixa, círculo ou cápsula; sensor real

**Família:** Física 2D · **Grupo:** Formas · **Identificador:** `astra.physics2d.collider` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Caixa, círculo ou cápsula; sensor real

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Formas** → **Colisor 2D**.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é [Astra.Components.Collider2D](/pt-br/snapshot-2026-10-06/api/astra-components-collider2d/).



## Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/): Corpos 2D e 3D não compartilham o mesmo objeto
- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/): Personagem 3D possui a pose deste objeto
- [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/): Colisores 2D e 3D usam mundos separados

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Sim |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Forma

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Meia largura**](#field-half-x)<br/>`half_x` | número · m | 0.5 | 0.005 … 500 |
| [**Meia altura**](#field-half-y)<br/>`half_y` | número · m | 0.5 | 0.005 … 500 |
| [**Raio**](#field-radius)<br/>`radius` | número · m | 0.5 | 0.005 … 500 |
| [**Meia distância centros**](#field-capsule-half-length)<br/>`capsule_half_length` | número · m | 0.5 | 0.005 … 500 |
| [**Centro X**](#field-offset-x)<br/>`offset_x` | número · m | 0 | -1000 … 1000 |
| [**Centro Y**](#field-offset-y)<br/>`offset_y` | número · m | 0 | -1000 … 1000 |
| [**Forma**](#field-shape)<br/>`shape` | enumeração | Caixa | Caixa \| Círculo \| Cápsula Y |

<h4 id="field-half-x">Meia largura · <code>half_x</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Meia largura**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 500.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-half-y">Meia altura · <code>half_y</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Meia altura**.

**Uso e efeito:** Meia dimensão da forma/volume no eixo indicado. Dimensão total é o dobro; aplica-se à forma selecionada.

**Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 500.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-radius">Raio · <code>radius</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Raio**.

**Uso e efeito:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

**Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 500.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-capsule-half-length">Meia distância centros · <code>capsule_half_length</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Meia distância centros**.

**Uso e efeito:** Metade da distância entre centros da cápsula 2D; raio é configurado separadamente.

**Valor:** 0.5 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.005 … 500.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-x">Centro X · <code>offset_x</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Centro X**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.



<h4 id="field-offset-y">Centro Y · <code>offset_y</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Centro Y**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** m · **Domínio:** -1000 … 1000.



<h4 id="field-shape">Forma · <code>shape</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Forma** → **Forma**.

**Uso e efeito:** Escolhe a geometria do colisor/campo no domínio indicado; os campos relevantes mudam por forma.

**Valor:** Caixa · **Tipo:** enumeração · **Domínio:** Caixa \| Círculo \| Cápsula Y.



### Contato

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Atrito**](#field-friction)<br/>`friction` | número | 0.5 | 0 … 1 |
| [**Restituição**](#field-restitution)<br/>`restitution` | número | 0 | 0 … 1 |
| [**Sensor sem resposta**](#field-sensor)<br/>`sensor` | booleano | falso | verdadeiro \| falso |

<h4 id="field-friction">Atrito · <code>friction</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Contato** → **Atrito**.

**Uso e efeito:** Atrito nos contatos; compare deslizamento com o mesmo par de superfícies.

**Valor:** 0.5 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-restitution">Restituição · <code>restitution</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Contato** → **Restituição**.

**Uso e efeito:** Restituição nos contatos; controla ressalto conforme a combinação física.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-sensor">Sensor sem resposta · <code>sensor</code></h4>

**Onde:** Inspector → **Colisor 2D** → **Contato** → **Sensor sem resposta**.

**Uso e efeito:** Participa como sensor/sobreposição; não é uma superfície sólida de contato.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Colisor 2D** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_collisionshape2d.html). Essa referência não representa paridade funcional.


---

---
title: "Audio Source"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/
---

# Audio Source

Clipe de projeto com reprodução e espaço acústico

**Família:** Áudio · **Grupo:** Reprodução · **Identificador:** `astra.audio.source` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Clipe de projeto com reprodução e espaço acústico

Atribua um clipe do projeto ao Audio Source e confira reprodução, volume, mute e bus. Escolha escuta e espacialização; prioridade decide o listener efetivo.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Reprodução** → **Audio Source**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AudioSource](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/).



## Exemplo de uso

Um Audio Source e um Audio Listener: toque um clipe, altere volume/mute e depois compare estéreo com 3D movendo a fonte.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Som

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Volume**](#field-volume)<br/>`volume` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Silenciar**](#field-mute)<br/>`mute` | booleano | falso | verdadeiro \| falso |
| [**Bus**](#field-bus)<br/>`bus` | referência | Master | astra.audio.bus |

<h4 id="field-volume">Volume · <code>volume</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Volume**.

**Uso e efeito:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-mute">Silenciar · <code>mute</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Silenciar**.

**Uso e efeito:** Silencia sem remover o componente.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-bus">Bus · <code>bus</code></h4>

**Onde:** Inspector → **Audio Source** → **Som** → **Bus**.

**Uso e efeito:** Destino de mixer da fonte.

**Valor:** Master · **Tipo:** referência · **Domínio:** astra.audio.bus.



### Reprodução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade / pitch**](#field-pitch)<br/>`pitch` | número · × | 1 | 0.1 … 4 |
| [**Repetir**](#field-loop)<br/>`loop` | booleano | falso | verdadeiro \| falso |
| [**Pedido**](#field-playback)<br/>`playback` | enumeração | Tocar | Parar \| Tocar \| Pausar |

<h4 id="field-pitch">Velocidade / pitch · <code>pitch</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Velocidade / pitch**.

**Uso e efeito:** Velocidade/pitch da reprodução; não altera o arquivo original.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0.1 … 4.



<h4 id="field-loop">Repetir · <code>loop</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Repetir**.

**Uso e efeito:** Repete a reprodução/percurso no fim.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-playback">Pedido · <code>playback</code></h4>

**Onde:** Inspector → **Audio Source** → **Reprodução** → **Pedido**.

**Uso e efeito:** Pedido persistido; consulte o estado real na nota do componente.

**Valor:** Tocar · **Tipo:** enumeração · **Domínio:** Parar \| Tocar \| Pausar.



### Espaço

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Pan estéreo**](#field-pan)<br/>`pan` | número | 0 | -1 … 1 |
| [**Distância mínima**](#field-min-distance)<br/>`min_distance` | número · m | 1 | 0.01 … 100000 |
| [**Distância máxima**](#field-max-distance)<br/>`max_distance` | número · m | 100 | 0.02 … 100001 |
| [**Decaimento**](#field-rolloff-factor)<br/>`rolloff_factor` | número | 1 | 0 … 10 |
| [**Dimensão**](#field-dimension)<br/>`dimension` | enumeração | 2D / estéreo | 2D / estéreo \| 3D / espacial |
| [**Atenuação**](#field-rolloff)<br/>`rolloff` | enumeração | Inverso | Linear \| Inverso \| Exponencial |

<h4 id="field-pan">Pan estéreo · <code>pan</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Pan estéreo**.

**Uso e efeito:** Pan estéreo, de esquerda a direita; é condicional à espacialização.

**Valor:** 0 · **Tipo:** número · **Domínio:** -1 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-min-distance">Distância mínima · <code>min_distance</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Distância mínima**.

**Uso e efeito:** Distância próxima de referência da atenuação 3D.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-distance">Distância máxima · <code>max_distance</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Distância máxima**.

**Uso e efeito:** Distância máxima de referência da atenuação 3D.

**Valor:** 100 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.02 … 100001.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-rolloff-factor">Decaimento · <code>rolloff_factor</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Decaimento**.

**Uso e efeito:** Fator de queda de ganho do modelo de atenuação.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-dimension">Dimensão · <code>dimension</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Dimensão**.

**Uso e efeito:** Seleciona áudio estéreo ou espacial conforme o domínio.

**Valor:** 2D / estéreo · **Tipo:** enumeração · **Domínio:** 2D / estéreo \| 3D / espacial.



<h4 id="field-rolloff">Atenuação · <code>rolloff</code></h4>

**Onde:** Inspector → **Audio Source** → **Espaço** → **Atenuação**.

**Uso e efeito:** Modelo de atenuação por distância.

**Valor:** Inverso · **Tipo:** enumeração · **Domínio:** Linear \| Inverso \| Exponencial.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

### Emissão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Cone interno**](#field-cone-inner)<br/>`cone_inner` | número · ° | 360 | 0 … 360 |
| [**Cone externo**](#field-cone-outer)<br/>`cone_outer` | número · ° | 360 | 0 … 360 |
| [**Ganho fora do cone**](#field-cone-gain)<br/>`cone_gain` | número | 0 | 0 … 1 |
| [**Doppler**](#field-doppler)<br/>`doppler` | número · × | 1 | 0 … 4 |

<h4 id="field-cone-inner">Cone interno · <code>cone_inner</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Cone interno**.

**Uso e efeito:** Ângulo interno do cone acústico.

**Valor:** 360 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-cone-outer">Cone externo · <code>cone_outer</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Cone externo**.

**Uso e efeito:** Ângulo externo do cone acústico.

**Valor:** 360 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-cone-gain">Ganho fora do cone · <code>cone_gain</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Ganho fora do cone**.

**Uso e efeito:** Ganho fora da região interna do cone.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-doppler">Doppler · <code>doppler</code></h4>

**Onde:** Inspector → **Audio Source** → **Emissão** → **Doppler**.

**Uso e efeito:** Fator do efeito Doppler.

**Valor:** 1 · **Tipo:** número · **Unidade:** × · **Domínio:** 0 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Ampliar transporte, formatos, mixer e diagnóstico de backend. Seek não deve ser presumido como disponível porque há cursor de reprodução. Conferir saída física no aparelho é uma evidência separada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Audio Source** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-AudioSource.html). Essa referência não representa paridade funcional.


---

---
title: "Audio Listener"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-audio-listener/
---

# Audio Listener

Pose e volume de escuta escolhidos por prioridade

**Família:** Áudio · **Grupo:** Escuta · **Identificador:** `astra.audio.listener` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Pose e volume de escuta escolhidos por prioridade

Atribua um clipe do projeto ao Audio Source e confira reprodução, volume, mute e bus. Escolha escuta e espacialização; prioridade decide o listener efetivo.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Escuta** → **Audio Listener**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AudioListener](/pt-br/snapshot-2026-10-06/api/astra-components-audiolistener/).



## Exemplo de uso

Um Audio Source e um Audio Listener: toque um clipe, altere volume/mute e depois compare estéreo com 3D movendo a fonte.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Escuta

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Volume global**](#field-volume)<br/>`volume` | número | 1 | 0 … 1 |
| [**Prioridade**](#field-priority)<br/>`priority` | número | 0 | 0 … 255 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-volume">Volume global · <code>volume</code></h4>

**Onde:** Inspector → **Audio Listener** → **Escuta** → **Volume global**.

**Uso e efeito:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-priority">Prioridade · <code>priority</code></h4>

**Onde:** Inspector → **Audio Listener** → **Escuta** → **Prioridade**.

**Uso e efeito:** Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

**Valor:** 0 · **Tipo:** número · **Domínio:** 0 … 255.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Audio Listener** → **Escuta** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Ampliar transporte, formatos, mixer e diagnóstico de backend. Seek não deve ser presumido como disponível porque há cursor de reprodução. Conferir saída física no aparelho é uma evidência separada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Audio Listener** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-AudioListener.html). Essa referência não representa paridade funcional.


---

---
title: "Audio Bus"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-audio-bus/
---

# Audio Bus

Roteamento de ganho, mute e solo até Master

**Família:** Áudio · **Grupo:** Mixer · **Identificador:** `astra.audio.bus` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Roteamento de ganho, mute e solo até Master

Atribua um clipe do projeto ao Audio Source e confira reprodução, volume, mute e bus. Escolha escuta e espacialização; prioridade decide o listener efetivo.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Áudio** / **Mixer** → **Audio Bus**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.AudioBus](/pt-br/snapshot-2026-10-06/api/astra-components-audiobus/).



## Exemplo de uso

Um Audio Source e um Audio Listener: toque um clipe, altere volume/mute e depois compare estéreo com 3D movendo a fonte.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Mixer

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ganho**](#field-volume)<br/>`volume` | número | 1 | 0 … 1 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Silenciar**](#field-mute)<br/>`mute` | booleano | falso | verdadeiro \| falso |
| [**Solo**](#field-solo)<br/>`solo` | booleano | falso | verdadeiro \| falso |
| [**Saída**](#field-output)<br/>`output` | referência | Master | astra.audio.bus · outro objeto |

<h4 id="field-volume">Ganho · <code>volume</code></h4>

**Onde:** Inspector → **Audio Bus** → **Mixer** → **Ganho**.

**Uso e efeito:** Ganho linear de áudio do consumidor correspondente; 0 silencia e 1 conserva ganho unitário.

**Valor:** 1 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Audio Bus** → **Mixer** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-mute">Silenciar · <code>mute</code></h4>

**Onde:** Inspector → **Audio Bus** → **Mixer** → **Silenciar**.

**Uso e efeito:** Silencia sem remover o componente.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-solo">Solo · <code>solo</code></h4>

**Onde:** Inspector → **Audio Bus** → **Mixer** → **Solo**.

**Uso e efeito:** Isola esse bus conforme o roteamento do mixer.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-output">Saída · <code>output</code></h4>

**Onde:** Inspector → **Audio Bus** → **Mixer** → **Saída**.

**Uso e efeito:** Bus de saída; confira ciclos e destino Master.

**Valor:** Master · **Tipo:** referência · **Domínio:** astra.audio.bus · outro objeto.



## Roadmap deste componente

[Áudio](/pt-br/snapshot-2026-10-06/roadmap/audio/). Ampliar transporte, formatos, mixer e diagnóstico de backend. Seek não deve ser presumido como disponível porque há cursor de reprodução. Conferir saída física no aparelho é uma evidência separada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Audio Bus** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/tutorials/audio/audio_buses.html). Essa referência não representa paridade funcional.


---

---
title: "Path"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-path/
---

# Path

Curva Bézier local com pontos persistentes

**Família:** Lógica · **Grupo:** Caminhos · **Identificador:** `astra.path` · **Payload:** 2

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Curva Bézier local com pontos persistentes

Crie Path com pontos/tangentes persistentes e atribua o objeto ao Path Follow. Distância e orientação dependem da curva e da pose mundial.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.PathComponent](/pt-br/snapshot-2026-10-06/api/astra-components-pathcomponent/).



## Exemplo de uso

Autore uma curva com três pontos, atribua o alvo e percorra em velocidade constante; salve/reabra os pontos e compare orientação +Z e direção reversa.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 2 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Orientação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Up X**](#field-up-x)<br/>`up_x` | número | 0 | -100000 … 100000 |
| [**Up Y**](#field-up-y)<br/>`up_y` | número | 1 | -100000 … 100000 |
| [**Up Z**](#field-up-z)<br/>`up_z` | número | 0 | -100000 … 100000 |
| [**Roll**](#field-point-roll)<br/>`point_roll` | número · °<br/>Por slot | Depende do contexto | -3600 … 3600 |

<h4 id="field-up-x">Up X · <code>up_x</code></h4>

**Onde:** Inspector → **Path** → **Orientação** → **Up X**.

**Uso e efeito:** Up inicial local; vetor zero é inválido.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-up-y">Up Y · <code>up_y</code></h4>

**Onde:** Inspector → **Path** → **Orientação** → **Up Y**.

**Uso e efeito:** Vetor vertical inicial do frame do caminho; vetor total zero é inválido, eixo Y.

**Valor:** 1 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-up-z">Up Z · <code>up_z</code></h4>

**Onde:** Inspector → **Path** → **Orientação** → **Up Z**.

**Uso e efeito:** Vetor vertical inicial do frame do caminho; vetor total zero é inválido, eixo Z.

**Valor:** 0 · **Tipo:** número · **Domínio:** -100000 … 100000.



<h4 id="field-point-roll">Roll · <code>point_roll</code></h4>

**Onde:** Inspector → **Path** → **Orientação** → **Roll** → escolha o slot/recurso.

**Uso e efeito:** Ângulo contínuo, sem reduzir módulo 360.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** ° · **Domínio:** -3600 … 3600.



### Caminho

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Fechado**](#field-closed)<br/>`closed` | booleano | falso | verdadeiro \| falso |

<h4 id="field-closed">Fechado · <code>closed</code></h4>

**Onde:** Inspector → **Path** → **Caminho** → **Fechado**.

**Uso e efeito:** Fecha a curva ligando o último ponto ao primeiro.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Posição

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Posição X**](#field-point-position-x)<br/>`point_position_x` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Posição Y**](#field-point-position-y)<br/>`point_position_y` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Posição Z**](#field-point-position-z)<br/>`point_position_z` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |

<h4 id="field-point-position-x">Posição X · <code>point_position_x</code></h4>

**Onde:** Inspector → **Path** → **Posição** → **Posição X** → escolha o slot/recurso.

**Uso e efeito:** Posição local do ponto selecionado da curva, eixo X.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-position-y">Posição Y · <code>point_position_y</code></h4>

**Onde:** Inspector → **Path** → **Posição** → **Posição Y** → escolha o slot/recurso.

**Uso e efeito:** Posição local do ponto selecionado da curva, eixo Y.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-position-z">Posição Z · <code>point_position_z</code></h4>

**Onde:** Inspector → **Path** → **Posição** → **Posição Z** → escolha o slot/recurso.

**Uso e efeito:** Posição local do ponto selecionado da curva, eixo Z.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



### Tangentes

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Entrada X**](#field-point-in-x)<br/>`point_in_x` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Entrada Y**](#field-point-in-y)<br/>`point_in_y` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Entrada Z**](#field-point-in-z)<br/>`point_in_z` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Saída X**](#field-point-out-x)<br/>`point_out_x` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Saída Y**](#field-point-out-y)<br/>`point_out_y` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |
| [**Saída Z**](#field-point-out-z)<br/>`point_out_z` | número · u<br/>Por slot | Depende do contexto | -100000 … 100000 |

<h4 id="field-point-in-x">Entrada X · <code>point_in_x</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Entrada X** → escolha o slot/recurso.

**Uso e efeito:** Tangente de entrada do ponto selecionado da curva, eixo X.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-in-y">Entrada Y · <code>point_in_y</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Entrada Y** → escolha o slot/recurso.

**Uso e efeito:** Tangente de entrada do ponto selecionado da curva, eixo Y.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-in-z">Entrada Z · <code>point_in_z</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Entrada Z** → escolha o slot/recurso.

**Uso e efeito:** Tangente de entrada do ponto selecionado da curva, eixo Z.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-out-x">Saída X · <code>point_out_x</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Saída X** → escolha o slot/recurso.

**Uso e efeito:** Tangente de saída do ponto selecionado da curva, eixo X.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-out-y">Saída Y · <code>point_out_y</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Saída Y** → escolha o slot/recurso.

**Uso e efeito:** Tangente de saída do ponto selecionado da curva, eixo Y.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-point-out-z">Saída Z · <code>point_out_z</code></h4>

**Onde:** Inspector → **Path** → **Tangentes** → **Saída Z** → escolha o slot/recurso.

**Uso e efeito:** Tangente de saída do ponto selecionado da curva, eixo Z.

**Valor:** dependente do contexto · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



## Roadmap deste componente

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Aprofundar ferramentas de pontos/tangentes, visualização e cenários de escala/lifecycle. Path não é navmesh, pathfinding ou spline universal importada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Path** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_path3d.html). Essa referência não representa paridade funcional.


---

---
title: "Path Follow"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/astra-path-follow/
---

# Path Follow

Percorre curva em distância mundial e orienta +Z

**Família:** Lógica · **Grupo:** Caminhos · **Identificador:** `astra.path.follow` · **Payload:** 1

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Percorre curva em distância mundial e orienta +Z

Crie Path com pontos/tangentes persistentes e atribua o objeto ao Path Follow. Distância e orientação dependem da curva e da pose mundial.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path Follow**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.PathFollow](/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow/).



## Exemplo de uso

Autore uma curva com três pontos, atribua o alvo e percorra em velocidade constante; salve/reabra os pontos e compare orientação +Z e direção reversa.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 1 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Percurso

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Distância inicial**](#field-progress-distance)<br/>`progress_distance` | número · u | 0 | 0 … 1000000 |
| [**Velocidade**](#field-speed)<br/>`speed` | número · u/s | 1 | 0 … 100000 |
| [**Duração**](#field-duration)<br/>`duration` | número · s | 5 | 0.001 … 100000 |
| [**Avanço**](#field-mode)<br/>`mode` | enumeração | Velocidade mundial | Velocidade mundial \| Duração do percurso |
| [**Caminho**](#field-target)<br/>`target` | referência | Escolher Path | astra.path · outro objeto |

<h4 id="field-progress-distance">Distância inicial · <code>progress_distance</code></h4>

**Onde:** Inspector → **Path Follow** → **Percurso** → **Distância inicial**.

**Uso e efeito:** Distância inicial mundial ao longo da curva.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** 0 … 1000000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-speed">Velocidade · <code>speed</code></h4>

**Onde:** Inspector → **Path Follow** → **Percurso** → **Velocidade**.

**Uso e efeito:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Valor:** 1 · **Tipo:** número · **Unidade:** u/s · **Domínio:** 0 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-duration">Duração · <code>duration</code></h4>

**Onde:** Inspector → **Path Follow** → **Percurso** → **Duração**.

**Uso e efeito:** Tempo para completar o percurso no modo por duração; modo velocidade usa Speed.

**Valor:** 5 · **Tipo:** número · **Unidade:** s · **Domínio:** 0.001 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-mode">Avanço · <code>mode</code></h4>

**Onde:** Inspector → **Path Follow** → **Percurso** → **Avanço**.

**Uso e efeito:** Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

**Valor:** Velocidade mundial · **Tipo:** enumeração · **Domínio:** Velocidade mundial \| Duração do percurso.



<h4 id="field-target">Caminho · <code>target</code></h4>

**Onde:** Inspector → **Path Follow** → **Percurso** → **Caminho**.

**Uso e efeito:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Valor:** Escolher Path · **Tipo:** referência · **Domínio:** astra.path · outro objeto.



### Orientação

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Deslocamento lateral**](#field-offset-x)<br/>`offset_x` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento vertical**](#field-offset-y)<br/>`offset_y` | número · u | 0 | -10000 … 10000 |
| [**Deslocamento tangente**](#field-offset-z)<br/>`offset_z` | número · u | 0 | -10000 … 10000 |
| [**Orientar +Z**](#field-orient)<br/>`orient` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-offset-x">Deslocamento lateral · <code>offset_x</code></h4>

**Onde:** Inspector → **Path Follow** → **Orientação** → **Deslocamento lateral**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-y">Deslocamento vertical · <code>offset_y</code></h4>

**Onde:** Inspector → **Path Follow** → **Orientação** → **Deslocamento vertical**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-offset-z">Deslocamento tangente · <code>offset_z</code></h4>

**Onde:** Inspector → **Path Follow** → **Orientação** → **Deslocamento tangente**.

**Uso e efeito:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -10000 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-orient">Orientar +Z · <code>orient</code></h4>

**Onde:** Inspector → **Path Follow** → **Orientação** → **Orientar +Z**.

**Uso e efeito:** Alinha orientação ao frame do caminho.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Execução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Iniciar no Play**](#field-autoplay)<br/>`autoplay` | booleano | verdadeiro | verdadeiro \| falso |
| [**Repetir percurso**](#field-loop)<br/>`loop` | booleano | falso | verdadeiro \| falso |
| [**Sentido inverso**](#field-backwards)<br/>`backwards` | booleano | falso | verdadeiro \| falso |

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Path Follow** → **Execução** → **Ativo**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-autoplay">Iniciar no Play · <code>autoplay</code></h4>

**Onde:** Inspector → **Path Follow** → **Execução** → **Iniciar no Play**.

**Uso e efeito:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-loop">Repetir percurso · <code>loop</code></h4>

**Onde:** Inspector → **Path Follow** → **Execução** → **Repetir percurso**.

**Uso e efeito:** Repete a reprodução/percurso no fim.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-backwards">Sentido inverso · <code>backwards</code></h4>

**Onde:** Inspector → **Path Follow** → **Execução** → **Sentido inverso**.

**Uso e efeito:** Percorre a curva na direção reversa.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



## Roadmap deste componente

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Aprofundar ferramentas de pontos/tangentes, visualização e cenários de escala/lifecycle. Path não é navmesh, pathfinding ou spline universal importada.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Path Follow** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_pathfollow3d.html). Essa referência não representa paridade funcional.


---

---
title: "Componentes"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/componentes/
---

# Componentes

Encontre o componente, entenda suas propriedades e componha sua cena.

# Componentes

Contratos de fonte; execução por plataforma não validada nesta publicação.

[UI de jogo](/pt-br/snapshot-2026-10-06/ui/elementos/) · [Image](/pt-br/snapshot-2026-10-06/ui/image/) · [HUD de corações](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/)

- [Mola de posição](/pt-br/snapshot-2026-10-06/componentes/astra-spring-position/)
- [Mola de rotação](/pt-br/snapshot-2026-10-06/componentes/astra-spring-rotation/)
- [Mola de escala](/pt-br/snapshot-2026-10-06/componentes/astra-spring-scale/)
- [Position Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-position/)
- [Rotation Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-rotation/)
- [Scale Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-scale/)
- [Aim Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-aim/)
- [Parent Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-parent/)
- [Look At Constraint](/pt-br/snapshot-2026-10-06/componentes/astra-constraint-look-at/)
- [Transform Tween](/pt-br/snapshot-2026-10-06/componentes/astra-tween-transform/)
- [Timer](/pt-br/snapshot-2026-10-06/componentes/astra-time-timer/)
- [Conexão de evento](/pt-br/snapshot-2026-10-06/componentes/astra-logic-event-connection/)
- [Comportamento](/pt-br/snapshot-2026-10-06/componentes/astra-script-behavior/)
- [Canvas UI](/pt-br/snapshot-2026-10-06/componentes/astra-ui-canvas/)
- [Malha](/pt-br/snapshot-2026-10-06/componentes/astra-render-mesh/)
- [Malha deformável](/pt-br/snapshot-2026-10-06/componentes/astra-render-skinned-mesh/)
- [LOD Group](/pt-br/snapshot-2026-10-06/componentes/astra-render-lod-group/)
- [Ambiente](/pt-br/snapshot-2026-10-06/componentes/astra-render-environment/)
- [Luz](/pt-br/snapshot-2026-10-06/componentes/astra-render-light/)
- [Câmera](/pt-br/snapshot-2026-10-06/componentes/astra-camera/)
- [Olhar](/pt-br/snapshot-2026-10-06/componentes/astra-camera-look/)
- [Acompanhar alvo](/pt-br/snapshot-2026-10-06/componentes/astra-camera-follow/)
- [Receita de colisão](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collision-recipe/)
- [Campo de gravidade](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-gravity/)
- [Campo de vento](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-wind/)
- [Campo de arrasto](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-drag/)
- [Campo radial](/pt-br/snapshot-2026-10-06/componentes/astra-physics-field-radial/)
- [Conexão física 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-event-connection/)
- [Força constante](/pt-br/snapshot-2026-10-06/componentes/astra-physics-constant-force/)
- [Corpo físico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-body/)
- [Personagem](/pt-br/snapshot-2026-10-06/componentes/astra-physics-character/)
- [Colisor 3D](/pt-br/snapshot-2026-10-06/componentes/astra-physics-collider/)
- [Junta](/pt-br/snapshot-2026-10-06/componentes/astra-physics-joint/)
- [Motor dinâmico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/)
- [Animação](/pt-br/snapshot-2026-10-06/componentes/astra-animation/)
- [Campo de gravidade 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-gravity/)
- [Campo de vento 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-wind/)
- [Campo de arrasto 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-drag/)
- [Campo radial 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-field-radial/)
- [Conexão física 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-event-connection/)
- [Força constante 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-constant-force/)
- [Junta 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-joint/)
- [Corpo 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-body/)
- [Colisor 2D](/pt-br/snapshot-2026-10-06/componentes/astra-physics2d-collider/)
- [Audio Source](/pt-br/snapshot-2026-10-06/componentes/astra-audio-source/)
- [Audio Listener](/pt-br/snapshot-2026-10-06/componentes/astra-audio-listener/)
- [Audio Bus](/pt-br/snapshot-2026-10-06/componentes/astra-audio-bus/)
- [Path](/pt-br/snapshot-2026-10-06/componentes/astra-path/)
- [Path Follow](/pt-br/snapshot-2026-10-06/componentes/astra-path-follow/)


---

---
title: "Referência C#"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/
---

# Referência C#

Encontre tipos, propriedades e métodos da API C# deste snapshot.

# Referência C#

Contratos de fonte; execução por plataforma não validada nesta publicação.

[UI de jogo](/pt-br/snapshot-2026-10-06/ui/elementos/) · [Image](/pt-br/snapshot-2026-10-06/ui/image/) · [HUD de corações](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/)

- [Astra.AnimationClipEntry](/pt-br/snapshot-2026-10-06/api/astra-animationclipentry/)
- [Astra.AnimationCurve](/pt-br/snapshot-2026-10-06/api/astra-animationcurve/)
- [Astra.AnimationPlayMode](/pt-br/snapshot-2026-10-06/api/astra-animationplaymode/)
- [Astra.AnimationPlayer](/pt-br/snapshot-2026-10-06/api/astra-animationplayer/)
- [Astra.AnimationState](/pt-br/snapshot-2026-10-06/api/astra-animationstate/)
- [Astra.AnimationStateValue](/pt-br/snapshot-2026-10-06/api/astra-animationstatevalue/)
- [Astra.AnimationWrapMode](/pt-br/snapshot-2026-10-06/api/astra-animationwrapmode/)
- [Astra.AssetGuid](/pt-br/snapshot-2026-10-06/api/astra-assetguid/)
- [Astra.AssetReference](/pt-br/snapshot-2026-10-06/api/astra-assetreference/)
- [Astra.AudioVoice](/pt-br/snapshot-2026-10-06/api/astra-audiovoice/)
- [Astra.AudioVoiceSnapshot](/pt-br/snapshot-2026-10-06/api/astra-audiovoicesnapshot/)
- [Astra.AudioVoiceState](/pt-br/snapshot-2026-10-06/api/astra-audiovoicestate/)
- [Astra.Behavior](/pt-br/snapshot-2026-10-06/api/astra-behavior/)
- [Astra.BehaviorAwaitable](/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitable/)
- [Astra.BehaviorAwaitables](/pt-br/snapshot-2026-10-06/api/astra-behaviorawaitables/)
- [Astra.Body2DAccess](/pt-br/snapshot-2026-10-06/api/astra-body2daccess/)
- [Astra.BodyVelocity2D](/pt-br/snapshot-2026-10-06/api/astra-bodyvelocity2d/)
- [Astra.CameraFollowRig](/pt-br/snapshot-2026-10-06/api/astra-camerafollowrig/)
- [Astra.CharacterGroundState](/pt-br/snapshot-2026-10-06/api/astra-charactergroundstate/)
- [Astra.CharacterRuntimeState](/pt-br/snapshot-2026-10-06/api/astra-characterruntimestate/)
- [Astra.Collision](/pt-br/snapshot-2026-10-06/api/astra-collision/)
- [Astra.Color](/pt-br/snapshot-2026-10-06/api/astra-color/)
- [Astra.ColorUsageAttribute](/pt-br/snapshot-2026-10-06/api/astra-colorusageattribute/)
- [Astra.Component](/pt-br/snapshot-2026-10-06/api/astra-component/)
- [Astra.ComponentEventArgs](/pt-br/snapshot-2026-10-06/api/astra-componenteventargs/)
- [Astra.ComponentIdAttribute](/pt-br/snapshot-2026-10-06/api/astra-componentidattribute/)
- [Astra.ComponentIds](/pt-br/snapshot-2026-10-06/api/astra-componentids/)
- [Astra.ComponentSubscription](/pt-br/snapshot-2026-10-06/api/astra-componentsubscription/)
- [Astra.ComponentValue](/pt-br/snapshot-2026-10-06/api/astra-componentvalue/)
- [Astra.ComponentValueKind](/pt-br/snapshot-2026-10-06/api/astra-componentvaluekind/)
- [Astra.Components.AimConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint/)
- [Astra.Components.AimConstraint.AimAxisOption](/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint-aimaxisoption/)
- [Astra.Components.AimConstraint.UpAxisOption](/pt-br/snapshot-2026-10-06/api/astra-components-aimconstraint-upaxisoption/)
- [Astra.Components.Animation](/pt-br/snapshot-2026-10-06/api/astra-components-animation/)
- [Astra.Components.Animation.ClipCountOption](/pt-br/snapshot-2026-10-06/api/astra-components-animation-clipcountoption/)
- [Astra.Components.Animation.WrapModeOption](/pt-br/snapshot-2026-10-06/api/astra-components-animation-wrapmodeoption/)
- [Astra.Components.AudioBus](/pt-br/snapshot-2026-10-06/api/astra-components-audiobus/)
- [Astra.Components.AudioListener](/pt-br/snapshot-2026-10-06/api/astra-components-audiolistener/)
- [Astra.Components.AudioSource](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource/)
- [Astra.Components.AudioSource.DimensionOption](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-dimensionoption/)
- [Astra.Components.AudioSource.PlaybackOption](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-playbackoption/)
- [Astra.Components.AudioSource.RolloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-audiosource-rolloffoption/)
- [Astra.Components.Body2D](/pt-br/snapshot-2026-10-06/api/astra-components-body2d/)
- [Astra.Components.Body2D.MotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-body2d-motionoption/)
- [Astra.Components.Camera](/pt-br/snapshot-2026-10-06/api/astra-components-camera/)
- [Astra.Components.Camera.EnvironmentMaskOption](/pt-br/snapshot-2026-10-06/api/astra-components-camera-environmentmaskoption/)
- [Astra.Components.Camera.ProjectionOption](/pt-br/snapshot-2026-10-06/api/astra-components-camera-projectionoption/)
- [Astra.Components.CameraFollow](/pt-br/snapshot-2026-10-06/api/astra-components-camerafollow/)
- [Astra.Components.CameraLook](/pt-br/snapshot-2026-10-06/api/astra-components-cameralook/)
- [Astra.Components.Character](/pt-br/snapshot-2026-10-06/api/astra-components-character/)
- [Astra.Components.Collider](/pt-br/snapshot-2026-10-06/api/astra-components-collider/)
- [Astra.Components.Collider.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-collider-shapeoption/)
- [Astra.Components.Collider2D](/pt-br/snapshot-2026-10-06/api/astra-components-collider2d/)
- [Astra.Components.Collider2D.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-collider2d-shapeoption/)
- [Astra.Components.ComponentFacadeExtensions](/pt-br/snapshot-2026-10-06/api/astra-components-componentfacadeextensions/)
- [Astra.Components.ComponentQueries](/pt-br/snapshot-2026-10-06/api/astra-components-componentqueries/)
- [Astra.Components.ConstantForce](/pt-br/snapshot-2026-10-06/api/astra-components-constantforce/)
- [Astra.Components.ConstantForce2D](/pt-br/snapshot-2026-10-06/api/astra-components-constantforce2d/)
- [Astra.Components.DragField](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield/)
- [Astra.Components.DragField.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-affectedlayeroption/)
- [Astra.Components.DragField.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-falloffoption/)
- [Astra.Components.DragField.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield-shapeoption/)
- [Astra.Components.DragField2D](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d/)
- [Astra.Components.DragField2D.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-affectedlayeroption/)
- [Astra.Components.DragField2D.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-falloffoption/)
- [Astra.Components.DragField2D.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-dragfield2d-shapeoption/)
- [Astra.Components.DynamicBodyMotor](/pt-br/snapshot-2026-10-06/api/astra-components-dynamicbodymotor/)
- [Astra.Components.EnvironmentVolume](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume/)
- [Astra.Components.EnvironmentVolume.SkyOption](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-skyoption/)
- [Astra.Components.EnvironmentVolume.ToneMapperOption](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-tonemapperoption/)
- [Astra.Components.EnvironmentVolume.VolumeLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-volumelayeroption/)
- [Astra.Components.EnvironmentVolume.VolumeShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume-volumeshapeoption/)
- [Astra.Components.EventConnection](/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection/)
- [Astra.Components.EventConnection.ActionOption](/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-actionoption/)
- [Astra.Components.EventConnection.EventOption](/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-eventoption/)
- [Astra.Components.EventConnection.MethodOption](/pt-br/snapshot-2026-10-06/api/astra-components-eventconnection-methodoption/)
- [Astra.Components.GameTimer](/pt-br/snapshot-2026-10-06/api/astra-components-gametimer/)
- [Astra.Components.GameTimer.ElapsedActionOption](/pt-br/snapshot-2026-10-06/api/astra-components-gametimer-elapsedactionoption/)
- [Astra.Components.GravityField](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield/)
- [Astra.Components.GravityField.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-affectedlayeroption/)
- [Astra.Components.GravityField.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-falloffoption/)
- [Astra.Components.GravityField.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield-shapeoption/)
- [Astra.Components.GravityField2D](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d/)
- [Astra.Components.GravityField2D.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-affectedlayeroption/)
- [Astra.Components.GravityField2D.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-falloffoption/)
- [Astra.Components.GravityField2D.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-gravityfield2d-shapeoption/)
- [Astra.Components.Joint](/pt-br/snapshot-2026-10-06/api/astra-components-joint/)
- [Astra.Components.Joint.AngularXMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularxmotionoption/)
- [Astra.Components.Joint.AngularXMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularxmotoroption/)
- [Astra.Components.Joint.AngularYMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularymotionoption/)
- [Astra.Components.Joint.AngularYMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularymotoroption/)
- [Astra.Components.Joint.AngularZMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularzmotionoption/)
- [Astra.Components.Joint.AngularZMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-angularzmotoroption/)
- [Astra.Components.Joint.KindOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-kindoption/)
- [Astra.Components.Joint.LinearXMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearxmotionoption/)
- [Astra.Components.Joint.LinearXMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearxmotoroption/)
- [Astra.Components.Joint.LinearYMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearymotionoption/)
- [Astra.Components.Joint.LinearYMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearymotoroption/)
- [Astra.Components.Joint.LinearZMotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearzmotionoption/)
- [Astra.Components.Joint.LinearZMotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-linearzmotoroption/)
- [Astra.Components.Joint.MotorOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint-motoroption/)
- [Astra.Components.Joint2D](/pt-br/snapshot-2026-10-06/api/astra-components-joint2d/)
- [Astra.Components.Joint2D.KindOption](/pt-br/snapshot-2026-10-06/api/astra-components-joint2d-kindoption/)
- [Astra.Components.Light](/pt-br/snapshot-2026-10-06/api/astra-components-light/)
- [Astra.Components.Light.KindOption](/pt-br/snapshot-2026-10-06/api/astra-components-light-kindoption/)
- [Astra.Components.Light.ShadowModeOption](/pt-br/snapshot-2026-10-06/api/astra-components-light-shadowmodeoption/)
- [Astra.Components.Light.ShadowResolutionOption](/pt-br/snapshot-2026-10-06/api/astra-components-light-shadowresolutionoption/)
- [Astra.Components.Light.UnitOption](/pt-br/snapshot-2026-10-06/api/astra-components-light-unitoption/)
- [Astra.Components.LodGroup](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup/)
- [Astra.Components.LodGroup.FadeModeOption](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-fademodeoption/)
- [Astra.Components.LodGroup.ForceLevelOption](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-forceleveloption/)
- [Astra.Components.LodGroup.LevelCountOption](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup-levelcountoption/)
- [Astra.Components.LookAtConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-lookatconstraint/)
- [Astra.Components.LookAtConstraint.UpAxisOption](/pt-br/snapshot-2026-10-06/api/astra-components-lookatconstraint-upaxisoption/)
- [Astra.Components.MeshRenderer](/pt-br/snapshot-2026-10-06/api/astra-components-meshrenderer/)
- [Astra.Components.ParentConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-parentconstraint/)
- [Astra.Components.PathComponent](/pt-br/snapshot-2026-10-06/api/astra-components-pathcomponent/)
- [Astra.Components.PathFollow](/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow/)
- [Astra.Components.PathFollow.ModeOption](/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow-modeoption/)
- [Astra.Components.PhysicsBody](/pt-br/snapshot-2026-10-06/api/astra-components-physicsbody/)
- [Astra.Components.PhysicsBody.MotionOption](/pt-br/snapshot-2026-10-06/api/astra-components-physicsbody-motionoption/)
- [Astra.Components.PhysicsEventConnection2D](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d/)
- [Astra.Components.PhysicsEventConnection2D.ActionOption](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d-actionoption/)
- [Astra.Components.PhysicsEventConnection2D.EventOption](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection2d-eventoption/)
- [Astra.Components.PhysicsEventConnection3D](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d/)
- [Astra.Components.PhysicsEventConnection3D.ActionOption](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d-actionoption/)
- [Astra.Components.PhysicsEventConnection3D.EventOption](/pt-br/snapshot-2026-10-06/api/astra-components-physicseventconnection3d-eventoption/)
- [Astra.Components.PositionConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-positionconstraint/)
- [Astra.Components.RadialField](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield/)
- [Astra.Components.RadialField.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-affectedlayeroption/)
- [Astra.Components.RadialField.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-falloffoption/)
- [Astra.Components.RadialField.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield-shapeoption/)
- [Astra.Components.RadialField2D](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d/)
- [Astra.Components.RadialField2D.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-affectedlayeroption/)
- [Astra.Components.RadialField2D.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-falloffoption/)
- [Astra.Components.RadialField2D.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-radialfield2d-shapeoption/)
- [Astra.Components.RotationConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-rotationconstraint/)
- [Astra.Components.ScaleConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-scaleconstraint/)
- [Astra.Components.SkinnedMesh](/pt-br/snapshot-2026-10-06/api/astra-components-skinnedmesh/)
- [Astra.Components.SkinnedMesh.QualityOption](/pt-br/snapshot-2026-10-06/api/astra-components-skinnedmesh-qualityoption/)
- [Astra.Components.SpringPositionConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springpositionconstraint/)
- [Astra.Components.SpringRotationConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springrotationconstraint/)
- [Astra.Components.SpringScaleConstraint](/pt-br/snapshot-2026-10-06/api/astra-components-springscaleconstraint/)
- [Astra.Components.TransformTween](/pt-br/snapshot-2026-10-06/api/astra-components-transformtween/)
- [Astra.Components.TransformTween.EasingOption](/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-easingoption/)
- [Astra.Components.TransformTween.FinishedActionOption](/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-finishedactionoption/)
- [Astra.Components.TransformTween.LoopsOption](/pt-br/snapshot-2026-10-06/api/astra-components-transformtween-loopsoption/)
- [Astra.Components.UiCanvas](/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas/)
- [Astra.Components.UiCanvas.ModeOption](/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas-modeoption/)
- [Astra.Components.UiCanvas.MovementSpaceOption](/pt-br/snapshot-2026-10-06/api/astra-components-uicanvas-movementspaceoption/)
- [Astra.Components.WindField](/pt-br/snapshot-2026-10-06/api/astra-components-windfield/)
- [Astra.Components.WindField.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield-affectedlayeroption/)
- [Astra.Components.WindField.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield-falloffoption/)
- [Astra.Components.WindField.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield-shapeoption/)
- [Astra.Components.WindField2D](/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d/)
- [Astra.Components.WindField2D.AffectedLayerOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-affectedlayeroption/)
- [Astra.Components.WindField2D.FalloffOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-falloffoption/)
- [Astra.Components.WindField2D.ShapeOption](/pt-br/snapshot-2026-10-06/api/astra-components-windfield2d-shapeoption/)
- [Astra.Coroutine](/pt-br/snapshot-2026-10-06/api/astra-coroutine/)
- [Astra.CoroutineStatus](/pt-br/snapshot-2026-10-06/api/astra-coroutinestatus/)
- [Astra.CurvePath](/pt-br/snapshot-2026-10-06/api/astra-curvepath/)
- [Astra.CurvePoint3D](/pt-br/snapshot-2026-10-06/api/astra-curvepoint3d/)
- [Astra.CurveWrapMode](/pt-br/snapshot-2026-10-06/api/astra-curvewrapmode/)
- [Astra.DebugDraw](/pt-br/snapshot-2026-10-06/api/astra-debugdraw/)
- [Astra.DeformableMesh](/pt-br/snapshot-2026-10-06/api/astra-deformablemesh/)
- [Astra.DynamicMotorRuntime](/pt-br/snapshot-2026-10-06/api/astra-dynamicmotorruntime/)
- [Astra.FrameStatistics](/pt-br/snapshot-2026-10-06/api/astra-framestatistics/)
- [Astra.GameObject](/pt-br/snapshot-2026-10-06/api/astra-gameobject/)
- [Astra.GameTimerRuntime](/pt-br/snapshot-2026-10-06/api/astra-gametimerruntime/)
- [Astra.GameViewAccess](/pt-br/snapshot-2026-10-06/api/astra-gameviewaccess/)
- [Astra.GameViewPlatform](/pt-br/snapshot-2026-10-06/api/astra-gameviewplatform/)
- [Astra.GameViewState](/pt-br/snapshot-2026-10-06/api/astra-gameviewstate/)
- [Astra.Gradient](/pt-br/snapshot-2026-10-06/api/astra-gradient/)
- [Astra.GradientAlphaKey](/pt-br/snapshot-2026-10-06/api/astra-gradientalphakey/)
- [Astra.GradientColorKey](/pt-br/snapshot-2026-10-06/api/astra-gradientcolorkey/)
- [Astra.GradientMode](/pt-br/snapshot-2026-10-06/api/astra-gradientmode/)
- [Astra.GradientUsageAttribute](/pt-br/snapshot-2026-10-06/api/astra-gradientusageattribute/)
- [Astra.Graphics](/pt-br/snapshot-2026-10-06/api/astra-graphics/)
- [Astra.GraphicsAmbient](/pt-br/snapshot-2026-10-06/api/astra-graphicsambient/)
- [Astra.GraphicsAntiAliasing](/pt-br/snapshot-2026-10-06/api/astra-graphicsantialiasing/)
- [Astra.GraphicsCapabilities](/pt-br/snapshot-2026-10-06/api/astra-graphicscapabilities/)
- [Astra.GraphicsFeature](/pt-br/snapshot-2026-10-06/api/astra-graphicsfeature/)
- [Astra.GraphicsPost](/pt-br/snapshot-2026-10-06/api/astra-graphicspost/)
- [Astra.GraphicsQuality](/pt-br/snapshot-2026-10-06/api/astra-graphicsquality/)
- [Astra.GraphicsSettings](/pt-br/snapshot-2026-10-06/api/astra-graphicssettings/)
- [Astra.GraphicsShadows](/pt-br/snapshot-2026-10-06/api/astra-graphicsshadows/)
- [Astra.GraphicsSnapshot](/pt-br/snapshot-2026-10-06/api/astra-graphicssnapshot/)
- [Astra.GraphicsTemporalAvailability](/pt-br/snapshot-2026-10-06/api/astra-graphicstemporalavailability/)
- [Astra.GraphicsTemporalQuality](/pt-br/snapshot-2026-10-06/api/astra-graphicstemporalquality/)
- [Astra.GraphicsTextures](/pt-br/snapshot-2026-10-06/api/astra-graphicstextures/)
- [Astra.GraphicsUpscaling](/pt-br/snapshot-2026-10-06/api/astra-graphicsupscaling/)
- [Astra.GraphicsWaterMesh](/pt-br/snapshot-2026-10-06/api/astra-graphicswatermesh/)
- [Astra.GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/)
- [Astra.GuiActionBinding](/pt-br/snapshot-2026-10-06/api/astra-guiactionbinding/)
- [Astra.GuiAlignment](/pt-br/snapshot-2026-10-06/api/astra-guialignment/)
- [Astra.GuiAnimation](/pt-br/snapshot-2026-10-06/api/astra-guianimation/)
- [Astra.GuiCanvas](/pt-br/snapshot-2026-10-06/api/astra-guicanvas/)
- [Astra.GuiCanvasMode](/pt-br/snapshot-2026-10-06/api/astra-guicanvasmode/)
- [Astra.GuiClickAction](/pt-br/snapshot-2026-10-06/api/astra-guiclickaction/)
- [Astra.GuiControlSettings](/pt-br/snapshot-2026-10-06/api/astra-guicontrolsettings/)
- [Astra.GuiControlSnapshot](/pt-br/snapshot-2026-10-06/api/astra-guicontrolsnapshot/)
- [Astra.GuiEasing](/pt-br/snapshot-2026-10-06/api/astra-guieasing/)
- [Astra.GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/)
- [Astra.GuiEvent](/pt-br/snapshot-2026-10-06/api/astra-guievent/)
- [Astra.GuiEventKind](/pt-br/snapshot-2026-10-06/api/astra-guieventkind/)
- [Astra.GuiImageFit](/pt-br/snapshot-2026-10-06/api/astra-guiimagefit/)
- [Astra.GuiImageStyle](/pt-br/snapshot-2026-10-06/api/astra-guiimagestyle/)
- [Astra.GuiInputAccess](/pt-br/snapshot-2026-10-06/api/astra-guiinputaccess/)
- [Astra.GuiInteraction](/pt-br/snapshot-2026-10-06/api/astra-guiinteraction/)
- [Astra.GuiKind](/pt-br/snapshot-2026-10-06/api/astra-guikind/)
- [Astra.GuiLayout](/pt-br/snapshot-2026-10-06/api/astra-guilayout/)
- [Astra.GuiPose](/pt-br/snapshot-2026-10-06/api/astra-guipose/)
- [Astra.GuiSizing](/pt-br/snapshot-2026-10-06/api/astra-guisizing/)
- [Astra.GuiSnapshot](/pt-br/snapshot-2026-10-06/api/astra-guisnapshot/)
- [Astra.GuiStateStyle](/pt-br/snapshot-2026-10-06/api/astra-guistatestyle/)
- [Astra.GuiStickAxis](/pt-br/snapshot-2026-10-06/api/astra-guistickaxis/)
- [Astra.GuiStickGate](/pt-br/snapshot-2026-10-06/api/astra-guistickgate/)
- [Astra.GuiStickMode](/pt-br/snapshot-2026-10-06/api/astra-guistickmode/)
- [Astra.GuiStyle](/pt-br/snapshot-2026-10-06/api/astra-guistyle/)
- [Astra.GuiTransitions](/pt-br/snapshot-2026-10-06/api/astra-guitransitions/)
- [Astra.HapticsAccess](/pt-br/snapshot-2026-10-06/api/astra-hapticsaccess/)
- [Astra.HideInInspectorAttribute](/pt-br/snapshot-2026-10-06/api/astra-hideininspectorattribute/)
- [Astra.InputAccess](/pt-br/snapshot-2026-10-06/api/astra-inputaccess/)
- [Astra.InputActionState](/pt-br/snapshot-2026-10-06/api/astra-inputactionstate/)
- [Astra.InputBindingValue](/pt-br/snapshot-2026-10-06/api/astra-inputbindingvalue/)
- [Astra.InputCaptureStatus](/pt-br/snapshot-2026-10-06/api/astra-inputcapturestatus/)
- [Astra.InputDeviceGroups](/pt-br/snapshot-2026-10-06/api/astra-inputdevicegroups/)
- [Astra.InputInteraction](/pt-br/snapshot-2026-10-06/api/astra-inputinteraction/)
- [Astra.InputPhase](/pt-br/snapshot-2026-10-06/api/astra-inputphase/)
- [Astra.InputRole](/pt-br/snapshot-2026-10-06/api/astra-inputrole/)
- [Astra.InputSource](/pt-br/snapshot-2026-10-06/api/astra-inputsource/)
- [Astra.Keyframe](/pt-br/snapshot-2026-10-06/api/astra-keyframe/)
- [Astra.MaterialAlphaMode](/pt-br/snapshot-2026-10-06/api/astra-materialalphamode/)
- [Astra.MaterialAlphaSource](/pt-br/snapshot-2026-10-06/api/astra-materialalphasource/)
- [Astra.MaterialChannel](/pt-br/snapshot-2026-10-06/api/astra-materialchannel/)
- [Astra.MaterialFilter](/pt-br/snapshot-2026-10-06/api/astra-materialfilter/)
- [Astra.MaterialOcclusionSource](/pt-br/snapshot-2026-10-06/api/astra-materialocclusionsource/)
- [Astra.MaterialSides](/pt-br/snapshot-2026-10-06/api/astra-materialsides/)
- [Astra.MaterialSlot](/pt-br/snapshot-2026-10-06/api/astra-materialslot/)
- [Astra.MaterialTextureBinding](/pt-br/snapshot-2026-10-06/api/astra-materialtexturebinding/)
- [Astra.MaterialTextureSampling](/pt-br/snapshot-2026-10-06/api/astra-materialtexturesampling/)
- [Astra.MaterialToggle](/pt-br/snapshot-2026-10-06/api/astra-materialtoggle/)
- [Astra.MaterialUvSet](/pt-br/snapshot-2026-10-06/api/astra-materialuvset/)
- [Astra.MaterialWrap](/pt-br/snapshot-2026-10-06/api/astra-materialwrap/)
- [Astra.Mathf](/pt-br/snapshot-2026-10-06/api/astra-mathf/)
- [Astra.MessageOptions](/pt-br/snapshot-2026-10-06/api/astra-messageoptions/)
- [Astra.NumberTween](/pt-br/snapshot-2026-10-06/api/astra-numbertween/)
- [Astra.NumberTweenCreation](/pt-br/snapshot-2026-10-06/api/astra-numbertweencreation/)
- [Astra.NumberTweenEasing](/pt-br/snapshot-2026-10-06/api/astra-numbertweeneasing/)
- [Astra.NumberTweenState](/pt-br/snapshot-2026-10-06/api/astra-numbertweenstate/)
- [Astra.NumberTweenStatus](/pt-br/snapshot-2026-10-06/api/astra-numbertweenstatus/)
- [Astra.ObjectReference](/pt-br/snapshot-2026-10-06/api/astra-objectreference/)
- [Astra.PathFollower](/pt-br/snapshot-2026-10-06/api/astra-pathfollower/)
- [Astra.PathFrame](/pt-br/snapshot-2026-10-06/api/astra-pathframe/)
- [Astra.PathSample](/pt-br/snapshot-2026-10-06/api/astra-pathsample/)
- [Astra.Physics2DAccess](/pt-br/snapshot-2026-10-06/api/astra-physics2daccess/)
- [Astra.PhysicsAccess](/pt-br/snapshot-2026-10-06/api/astra-physicsaccess/)
- [Astra.PhysicsBodyRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsbodyruntime/)
- [Astra.PhysicsBodyState](/pt-br/snapshot-2026-10-06/api/astra-physicsbodystate/)
- [Astra.PhysicsField2DRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsfield2druntime/)
- [Astra.PhysicsFieldRuntime](/pt-br/snapshot-2026-10-06/api/astra-physicsfieldruntime/)
- [Astra.PhysicsFieldSample](/pt-br/snapshot-2026-10-06/api/astra-physicsfieldsample/)
- [Astra.PhysicsFieldSample2D](/pt-br/snapshot-2026-10-06/api/astra-physicsfieldsample2d/)
- [Astra.PhysicsHit2D](/pt-br/snapshot-2026-10-06/api/astra-physicshit2d/)
- [Astra.PrimitiveType](/pt-br/snapshot-2026-10-06/api/astra-primitivetype/)
- [Astra.PropertyIdAttribute](/pt-br/snapshot-2026-10-06/api/astra-propertyidattribute/)
- [Astra.QueryFilter](/pt-br/snapshot-2026-10-06/api/astra-queryfilter/)
- [Astra.QueryShapeKind](/pt-br/snapshot-2026-10-06/api/astra-queryshapekind/)
- [Astra.RandomStream](/pt-br/snapshot-2026-10-06/api/astra-randomstream/)
- [Astra.RandomStream.Snapshot](/pt-br/snapshot-2026-10-06/api/astra-randomstream-snapshot/)
- [Astra.Ray](/pt-br/snapshot-2026-10-06/api/astra-ray/)
- [Astra.RayHit](/pt-br/snapshot-2026-10-06/api/astra-rayhit/)
- [Astra.ReparentPosePolicy](/pt-br/snapshot-2026-10-06/api/astra-reparentposepolicy/)
- [Astra.ResolvedGraphicsSettings](/pt-br/snapshot-2026-10-06/api/astra-resolvedgraphicssettings/)
- [Astra.SaveRecovery](/pt-br/snapshot-2026-10-06/api/astra-saverecovery/)
- [Astra.SaveStore](/pt-br/snapshot-2026-10-06/api/astra-savestore/)
- [Astra.SaveVersionException](/pt-br/snapshot-2026-10-06/api/astra-saveversionexception/)
- [Astra.ScenesAccess](/pt-br/snapshot-2026-10-06/api/astra-scenesaccess/)
- [Astra.ScreenRect](/pt-br/snapshot-2026-10-06/api/astra-screenrect/)
- [Astra.SerializeFieldAttribute](/pt-br/snapshot-2026-10-06/api/astra-serializefieldattribute/)
- [Astra.ShapeQuery](/pt-br/snapshot-2026-10-06/api/astra-shapequery/)
- [Astra.TangentMode](/pt-br/snapshot-2026-10-06/api/astra-tangentmode/)
- [Astra.TextureStreamingStats](/pt-br/snapshot-2026-10-06/api/astra-texturestreamingstats/)
- [Astra.TimeAccess](/pt-br/snapshot-2026-10-06/api/astra-timeaccess/)
- [Astra.TimerRuntimeState](/pt-br/snapshot-2026-10-06/api/astra-timerruntimestate/)
- [Astra.TransformSpace](/pt-br/snapshot-2026-10-06/api/astra-transformspace/)
- [Astra.TransformTweenRuntime](/pt-br/snapshot-2026-10-06/api/astra-transformtweenruntime/)
- [Astra.TransformValue](/pt-br/snapshot-2026-10-06/api/astra-transformvalue/)
- [Astra.TweenRuntimeState](/pt-br/snapshot-2026-10-06/api/astra-tweenruntimestate/)
- [Astra.TweenRuntimeStatus](/pt-br/snapshot-2026-10-06/api/astra-tweenruntimestatus/)
- [Astra.WaitForFixedUpdate](/pt-br/snapshot-2026-10-06/api/astra-waitforfixedupdate/)
- [Astra.WaitForSeconds](/pt-br/snapshot-2026-10-06/api/astra-waitforseconds/)
- [Astra.WaitForSecondsRealtime](/pt-br/snapshot-2026-10-06/api/astra-waitforsecondsrealtime/)
- [Astra.WaitUntil](/pt-br/snapshot-2026-10-06/api/astra-waituntil/)
- [Astra.WaitWhile](/pt-br/snapshot-2026-10-06/api/astra-waitwhile/)
- [Astra.WorldException](/pt-br/snapshot-2026-10-06/api/astra-worldexception/)
- [Astra.WorldOperation](/pt-br/snapshot-2026-10-06/api/astra-worldoperation/)
- [Astra.WorldOperationState](/pt-br/snapshot-2026-10-06/api/astra-worldoperationstate/)
- [Astra.WorldStatus](/pt-br/snapshot-2026-10-06/api/astra-worldstatus/)