---
title: "Astra.AnimatorController"
version: snapshot-2026-10-09
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-09
appRelease: "0.3.0-preview.20261009"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-09/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. Parâmetros vinculados a movimento físico podem ser lidos; setters são recusados com F:Astra.WorldStatus.Rejected para preservar uma única origem do valor.

**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. Parâmetros vinculados a movimento físico podem ser lidos; setters são recusados com F:Astra.WorldStatus.Rejected para preservar uma única origem do valor.

## 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-09/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 |
| [GetLayerBlendMode](#member-3d7d5fc10c09f7da) | Method |
| [GetLayerReferenceClip](#member-66f67b5ff0063800) | Method |
| [GetLayerReferenceTime](#member-68481f4d79fe15e0) | Method |
| [GetLayerWeight](#member-c1352897b770145b) | Method |
| [Play](#member-326139e85195c449) | Method |
| [ResetLayerOverrides](#member-1d1b726b56b3b347) | Method |
| [ResetTrigger](#member-ac9205f06544a759) | Method |
| [SetBool](#member-56fc6990c65a61ca) | Method |
| [SetFloat](#member-64af60fef37575ac) | Method |
| [SetInteger](#member-8ab9ff9736b9d7da) | Method |
| [SetLayerBlendMode](#member-f4f878038d19c8e8) | Method |
| [SetLayerReferenceClip](#member-6c8ccd5eaba53a2d) | Method |
| [SetLayerReferenceTime](#member-bc409d38d42c54da) | Method |
| [SetLayerWeight](#member-0c7f10c57f8d3b97) | 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 por caminho em segundos. Durante uma mistura, preserva a pose composta exibida como origem.

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

**Uso:** Transição por caminho em segundos. Durante uma mistura, preserva a pose composta exibida como origem.

**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-3d7d5fc10c09f7da" class="astra-member">GetLayerBlendMode</h3>

```csharp
public Astra.AnimationLayerBlendMode GetLayerBlendMode(uint 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:** [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` |  |

<h3 id="member-66f67b5ff0063800" class="astra-member">GetLayerReferenceClip</h3>

```csharp
public Astra.AssetGuid GetLayerReferenceClip(uint 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:** [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` |  |

<h3 id="member-68481f4d79fe15e0" class="astra-member">GetLayerReferenceTime</h3>

```csharp
public float GetLayerReferenceTime(uint 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:** [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` |  |

<h3 id="member-c1352897b770145b" class="astra-member">GetLayerWeight</h3>

```csharp
public float GetLayerWeight(uint layer)
```

Runtime composition settings are independent per instance and do not edit controller assets.

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

**Uso:** Runtime composition settings are independent per instance and do not edit controller assets.

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

<h3 id="member-326139e85195c449" class="astra-member">Play</h3>

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

Troca a camada na hora. Aceita caminho de estado ou de grupo (entra pelo padrão); nome curto deve ser único.

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

**Uso:** Troca a camada na hora. Aceita caminho de estado ou de grupo (entra pelo padrão); nome curto deve ser único.

**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-1d1b726b56b3b347" class="astra-member">ResetLayerOverrides</h3>

```csharp
public void ResetLayerOverrides(uint 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:** [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` |  |

<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-f4f878038d19c8e8" class="astra-member">SetLayerBlendMode</h3>

```csharp
public void SetLayerBlendMode(uint layer, Astra.AnimationLayerBlendMode mode)
```

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

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O 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` |  |
| `mode` | `Astra.AnimationLayerBlendMode` |  |

<h3 id="member-6c8ccd5eaba53a2d" class="astra-member">SetLayerReferenceClip</h3>

```csharp
public void SetLayerReferenceClip(uint layer, Astra.AssetGuid 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 |
|---|---|---|
| `layer` | `uint` |  |
| `clip` | `Astra.AssetGuid` |  |

<h3 id="member-bc409d38d42c54da" class="astra-member">SetLayerReferenceTime</h3>

```csharp
public void SetLayerReferenceTime(uint layer, float 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:** [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` |  |
| `seconds` | `float` |  |

<h3 id="member-0c7f10c57f8d3b97" class="astra-member">SetLayerWeight</h3>

```csharp
public void SetLayerWeight(uint layer, 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 |
|---|---|---|
| `layer` | `uint` |  |
| `weight` | `float` |  |

<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.