---
title: "Astra.AnimatorStateInfo"
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-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-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 |
|---|---|
| [.ctor](#member-0824613def613338) | Method |
| [IsInTransition](#member-2fa9d30be4782486) | Property |
| [Name](#member-c80a99060226d43e) | Property |
| [NextName](#member-059e1425c20cd4fd) | Property |
| [NormalizedTime](#member-4ffe784f613ecdd9) | 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` | Estado tocando (o de 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-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-c80a99060226d43e" class="astra-member">Name</h3>

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

Estado tocando (o de origem durante uma transição).

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

**Uso:** Estado tocando (o de 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-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-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.