---
title: "Astra.AnimatorStateInfo"
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-animatorstateinfo/
---

# Astra.AnimatorStateInfo

Estado atual de uma camada do Animator (AnimatorStateInfo da Unity).

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

Estado atual de uma camada do Animator (AnimatorStateInfo da Unity).

**Interfaces:** `System.IEquatable<Astra.AnimatorStateInfo>`.

## 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 |
|---|---|
| [.ctor](#member-0824613def613338) | Method |
| [IsInMachine](#member-cb1e6fb87e55a283) | Method |
| [IsInTransition](#member-2fa9d30be4782486) | Property |
| [LeafName](#member-5ff34c2f1808fc94) | Property |
| [Name](#member-c80a99060226d43e) | Property |
| [NextName](#member-059e1425c20cd4fd) | Property |
| [NextPath](#member-063b6ba3bbfede0e) | Property |
| [NormalizedTime](#member-4ffe784f613ecdd9) | Property |
| [Path](#member-db531087506b09c1) | Property |
| [TransitionProgress](#member-27e2ded62ed2b93d) | Property |

<h3 id="member-0824613def613338" class="astra-member">.ctor</h3>

```csharp
public AnimatorStateInfo(string Name, float NormalizedTime, bool IsInTransition, string NextName, float TransitionProgress)
```

Estado atual de uma camada do Animator (AnimatorStateInfo da Unity).

**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 |
|---|---|---|
| `Name` | `string` | Caminho do estado tocando, como Grupo/Subgrupo/Estado (origem durante uma transição). |
| `NormalizedTime` | `float` | Tempo do estado em voltas: 1,5 = uma volta e meia. |
| `IsInTransition` | `bool` | Verdadeiro enquanto mistura com NextName. |
| `NextName` | `string` | Estado de destino da transição; vazio fora dela. |
| `TransitionProgress` | `float` | 0 a 1 da transição. |

<h3 id="member-cb1e6fb87e55a283" class="astra-member">IsInMachine</h3>

```csharp
public bool IsInMachine(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:** [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 |
|---|---|---|
| `path` | `string` |  |

<h3 id="member-2fa9d30be4782486" class="astra-member">IsInTransition</h3>

```csharp
public bool IsInTransition { get; init; }
```

Verdadeiro enquanto mistura com NextName.

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

**Uso:** Verdadeiro enquanto mistura com NextName.

**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-5ff34c2f1808fc94" class="astra-member">LeafName</h3>

```csharp
public string LeafName { 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-c80a99060226d43e" class="astra-member">Name</h3>

```csharp
public string Name { get; init; }
```

Caminho do estado tocando, como Grupo/Subgrupo/Estado (origem durante uma transição).

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

**Uso:** Caminho do estado tocando, como Grupo/Subgrupo/Estado (origem durante uma transiçã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-059e1425c20cd4fd" class="astra-member">NextName</h3>

```csharp
public string NextName { get; init; }
```

Estado de destino da transição; vazio fora dela.

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

**Uso:** Estado de destino da transição; vazio fora dela.

**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-063b6ba3bbfede0e" class="astra-member">NextPath</h3>

```csharp
public string NextPath { 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-4ffe784f613ecdd9" class="astra-member">NormalizedTime</h3>

```csharp
public float NormalizedTime { get; init; }
```

Tempo do estado em voltas: 1,5 = uma volta e meia.

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

**Uso:** Tempo do estado em voltas: 1,5 = uma volta e meia.

**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-db531087506b09c1" class="astra-member">Path</h3>

```csharp
public string Path { 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-27e2ded62ed2b93d" class="astra-member">TransitionProgress</h3>

```csharp
public float TransitionProgress { get; init; }
```

0 a 1 da transição.

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

**Uso:** 0 a 1 da transiçã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.