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
Declaração
Seção intitulada “Declaração”readonly struct Astra.AnimationPlayerReprodutor 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
Seção intitulada “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
Seção intitulada “Roadmap e uso”Animação e deformação: 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.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| AddClip | Method |
| Blend | Method |
| Clip | Method |
| CrossFade | Method |
| IsClipPlaying | Method |
| MoveClip | Method |
| Play | Method |
| Play | Method |
| RemoveClip | Method |
| Rewind | Method |
| Rewind | Method |
| SetClip | Method |
| Stop | Method |
| Stop | Method |
| ClipEntries | Property |
| ClipNames | Property |
| Component | Property |
| IsPlaying | Property |
| this[] | Property |
| PlayAutomatically | Property |
| WrapMode | Property |
.ctor
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
AddClip
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
clip |
Astra.AssetGuid |
Blend
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. 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 |
Clip
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
CrossFade
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. 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 |
IsClipPlaying
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
clip |
string |
MoveClip
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
elementId |
ulong |
|
targetIndex |
uint |
Play
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
mode |
Astra.AnimationPlayMode |
· Opcional: 0 |
Play
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
clip |
string |
|
mode |
Astra.AnimationPlayMode |
· Opcional: 0 |
RemoveClip
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
elementId |
ulong |
Rewind
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Rewind
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
clip |
string |
SetClip
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
elementId |
ulong |
|
clip |
Astra.AssetGuid |
Stop
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Stop
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
clip |
string |
ClipEntries
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ClipNames
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Component
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IsPlaying
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
this[]
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
PlayAutomatically
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
WrapMode
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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.