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