---
title: "Astra.AnimationPlayer"
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-animationplayer/
---

# Astra.AnimationPlayer

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

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

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

## 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-73564b1b094d2cce) | Method |
| [AddClip](#member-ff97a4216f599e44) | Method |
| [Blend](#member-afda1905ba5a443e) | Method |
| [Clip](#member-a055ab61e428d438) | Method |
| [CrossFade](#member-cb588b0d998f2071) | Method |
| [IsClipPlaying](#member-895ec5978a3be8f2) | Method |
| [MoveClip](#member-c0f46374e88c38ff) | Method |
| [Play](#member-1a64eb6036da1362) | Method |
| [Play](#member-6b4cd297e84aa5dd) | Method |
| [RemoveClip](#member-430d6c18e5bd8519) | Method |
| [Rewind](#member-74ac2a5c16b49f40) | Method |
| [Rewind](#member-121f3df392feb4de) | Method |
| [SetClip](#member-5e22da2a2cc9780b) | Method |
| [Stop](#member-7cd7c17e81705f2d) | Method |
| [Stop](#member-9f3291056c3dbb02) | Method |
| [ClipEntries](#member-bc33f5a2b97040d5) | Property |
| [ClipNames](#member-f648d53b1cce504c) | Property |
| [Component](#member-3a90cfe35d6a4fe0) | Property |
| [IsPlaying](#member-874b5ffe2e849d8c) | Property |
| [this[]](#member-305b9ddfc3b32028) | Property |
| [PlayAutomatically](#member-3b7613cd9c035f98) | Property |
| [WrapMode](#member-ab2a54af7a300880) | Property |

<h3 id="member-73564b1b094d2cce" class="astra-member">.ctor</h3>

```csharp
public AnimationPlayer(Astra.Component component)
```

Reprodutor de um componente Animation (`astra.animation`) no mundo Play, no modelo do Animation legado da Unity: Play, CrossFade, Blend, Stop e Rewind por clipe, e um Astra.AnimationState por clipe com tempo, velocidade, peso, camada e repetição. Os clipes são os da lista do componente, por nome; um nome fora da lista é recusado. Tocando, tempo e peso são estado de execução: o Play sempre parte do zero.

**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 |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-ff97a4216f599e44" class="astra-member">AddClip</h3>

```csharp
public ulong AddClip(Astra.AssetGuid clip)
```

Adiciona um clipe resolvido à lista desta sessão de Play e devolve o ID da entrada.

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

**Uso:** Adiciona um clipe resolvido à lista desta sessão de Play e devolve o ID da entrada.

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

<h3 id="member-afda1905ba5a443e" class="astra-member">Blend</h3>

```csharp
public void Blend(string clip, float targetWeight = 1, float seconds = 0.3)
```

Leva o peso do clipe até targetWeight sem mexer nos outros.

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

**Uso:** Leva o peso do clipe até targetWeight sem mexer nos outros.

**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` | `string` |  |
| `targetWeight` | `float` |  · Opcional: `1` |
| `seconds` | `float` |  · Opcional: `0.3` |

<h3 id="member-a055ab61e428d438" class="astra-member">Clip</h3>

```csharp
public Astra.AssetGuid Clip(string name)
```

Identidade do clipe pelo nome; lança quando o componente não lista o nome.

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

**Uso:** Identidade do clipe pelo nome; lança quando o componente não lista o 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-cb588b0d998f2071" class="astra-member">CrossFade</h3>

```csharp
public void CrossFade(string clip, float seconds = 0.3, Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

Entra no clipe em seconds enquanto os outros da camada saem.

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

**Uso:** Entra no clipe em seconds enquanto os outros da camada saem.

**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` | `string` |  |
| `seconds` | `float` |  · Opcional: `0.3` |
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-895ec5978a3be8f2" class="astra-member">IsClipPlaying</h3>

```csharp
public bool IsClipPlaying(string 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 |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-c0f46374e88c38ff" class="astra-member">MoveClip</h3>

```csharp
public void MoveClip(ulong elementId, uint targetIndex)
```

Move a entrada para o índice indicado sem alterar seu ID.

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

**Uso:** Move a entrada para o índice indicado sem alterar seu ID.

**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 |
|---|---|---|
| `elementId` | `ulong` |  |
| `targetIndex` | `uint` |  |

<h3 id="member-1a64eb6036da1362" class="astra-member">Play</h3>

```csharp
public void Play(Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

Toca o clipe padrão, parando os outros da mesma camada. Não rebobina um clipe que já toca.

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

**Uso:** Toca o clipe padrão, parando os outros da mesma camada. Não rebobina um clipe que já toca.

**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 |
|---|---|---|
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-6b4cd297e84aa5dd" class="astra-member">Play</h3>

```csharp
public void Play(string clip, Astra.AnimationPlayMode mode = Astra.AnimationPlayMode.StopSameLayer)
```

**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 |
|---|---|---|
| `clip` | `string` |  |
| `mode` | `Astra.AnimationPlayMode` |  · Opcional: `0` |

<h3 id="member-430d6c18e5bd8519" class="astra-member">RemoveClip</h3>

```csharp
public void RemoveClip(ulong elementId)
```

Remove uma entrada por ID. Um clipe sem outra entrada e sem ser padrão para no próximo passo.

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

**Uso:** Remove uma entrada por ID. Um clipe sem outra entrada e sem ser padrão para no próximo passo.

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

<h3 id="member-74ac2a5c16b49f40" class="astra-member">Rewind</h3>

```csharp
public void Rewind()
```

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

<h3 id="member-121f3df392feb4de" class="astra-member">Rewind</h3>

```csharp
public void Rewind(string 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 |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-5e22da2a2cc9780b" class="astra-member">SetClip</h3>

```csharp
public void SetClip(ulong elementId, Astra.AssetGuid clip)
```

Troca o recurso da entrada por ID; a posição atual da entrada não importa.

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

**Uso:** Troca o recurso da entrada por ID; a posição atual da entrada não importa.

**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 |
|---|---|---|
| `elementId` | `ulong` |  |
| `clip` | `Astra.AssetGuid` |  |

<h3 id="member-7cd7c17e81705f2d" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Para e rebobina todos os clipes, como Animation.Stop da Unity. A pose atual fica.

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

**Uso:** Para e rebobina todos os clipes, como Animation.Stop da Unity. A pose atual fica.

**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-9f3291056c3dbb02" class="astra-member">Stop</h3>

```csharp
public void Stop(string 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 |
|---|---|---|
| `clip` | `string` |  |

<h3 id="member-bc33f5a2b97040d5" class="astra-member">ClipEntries</h3>

```csharp
public System.Collections.Generic.IReadOnlyList<Astra.AnimationClipEntry> ClipEntries { get; }
```

Clipes e identidades persistentes da lista, na ordem atual.

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

**Uso:** Clipes e identidades persistentes da lista, na ordem atual.

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

```csharp
public System.Collections.Generic.IReadOnlyList<string> ClipNames { get; }
```

Nomes dos clipes do componente, na ordem da lista.

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

**Uso:** Nomes dos clipes do componente, na ordem da lista.

**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-3a90cfe35d6a4fe0" 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.

<h3 id="member-874b5ffe2e849d8c" class="astra-member">IsPlaying</h3>

```csharp
public bool IsPlaying { get; }
```

Algum clipe tocando.

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

**Uso:** Algum clipe tocando.

**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-305b9ddfc3b32028" class="astra-member">this[]</h3>

```csharp
public Astra.AnimationState this[string clip] { get; }
```

AnimationState do clipe (animation["nome"] na Unity).

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

**Uso:** AnimationState do clipe (animation["nome"] na Unity).

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

```csharp
public bool PlayAutomatically { get; set; }
```

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

```csharp
public Astra.AnimationWrapMode WrapMode { get; set; }
```

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