---
title: "Astra.AnimatorController"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-animatorcontroller/
---

# Astra.AnimatorController

Parâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException.

**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.AnimatorController
```

Parâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException.

## Onde acessar este tipo

Cena → raiz do modelo → Animator → Abrir grafo. No Behavior desse objeto, **Object.Animator()** fornece AnimatorController para parâmetros/estados. AnimatorStateInfo é a leitura retornada por GetCurrentState; construir o record não muda a animação. [Ficha do Animator](/pt-br/snapshot-2026-10-07/componentes/astra-animation-animator/).

## 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 |
|---|---|
| [CrossFade](#member-ee0b00c2c83e8c30) | Method |
| [GetBool](#member-8ef2a32a2a653866) | Method |
| [GetCurrentState](#member-919338eb7450e468) | Method |
| [GetFloat](#member-531985971307ffa5) | Method |
| [GetInteger](#member-2bba9584ce83dcaf) | Method |
| [Play](#member-326139e85195c449) | Method |
| [ResetTrigger](#member-ac9205f06544a759) | Method |
| [SetBool](#member-56fc6990c65a61ca) | Method |
| [SetFloat](#member-64af60fef37575ac) | Method |
| [SetInteger](#member-8ab9ff9736b9d7da) | Method |
| [SetTrigger](#member-03ee9fc37069e00d) | Method |
| [Component](#member-43e0728084fe859d) | Property |

<h3 id="member-ee0b00c2c83e8c30" class="astra-member">CrossFade</h3>

```csharp
public void CrossFade(string state, float seconds, uint layer = 0)
```

Transição para o estado em seconds segundos.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Transição para o estado em seconds 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.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `state` | `string` |  |
| `seconds` | `float` |  |
| `layer` | `uint` |  · Opcional: `0` |

<h3 id="member-8ef2a32a2a653866" class="astra-member">GetBool</h3>

```csharp
public bool GetBool(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:** [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-919338eb7450e468" class="astra-member">GetCurrentState</h3>

```csharp
public Astra.AnimatorStateInfo GetCurrentState(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:** [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 |
|---|---|---|
| `layer` | `uint` |  · Opcional: `0` |

<h3 id="member-531985971307ffa5" class="astra-member">GetFloat</h3>

```csharp
public float GetFloat(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:** [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-2bba9584ce83dcaf" class="astra-member">GetInteger</h3>

```csharp
public int GetInteger(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:** [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-326139e85195c449" class="astra-member">Play</h3>

```csharp
public void Play(string state, uint layer = 0)
```

Troca a camada para o estado na hora, do início.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Troca a camada para o estado na hora, do início.

**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 |
|---|---|---|
| `state` | `string` |  |
| `layer` | `uint` |  · Opcional: `0` |

<h3 id="member-ac9205f06544a759" class="astra-member">ResetTrigger</h3>

```csharp
public void ResetTrigger(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:** [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-56fc6990c65a61ca" class="astra-member">SetBool</h3>

```csharp
public void SetBool(string name, 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:** [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` |  |
| `value` | `bool` |  |

<h3 id="member-64af60fef37575ac" class="astra-member">SetFloat</h3>

```csharp
public void SetFloat(string name, 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 |
|---|---|---|
| `name` | `string` |  |
| `value` | `float` |  |

<h3 id="member-8ab9ff9736b9d7da" class="astra-member">SetInteger</h3>

```csharp
public void SetInteger(string name, int 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 |
|---|---|---|
| `name` | `string` |  |
| `value` | `int` |  |

<h3 id="member-03ee9fc37069e00d" class="astra-member">SetTrigger</h3>

```csharp
public void SetTrigger(string name)
```

Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).

**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-43e0728084fe859d" 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.