Astra.AnimationPlayer

Astra atual · C# · 06 out. 2026Referência de assinaturas

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

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.

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)

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.

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.

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.

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.

Parâmetro	Tipo	Contrato
`clip`	`string`
`seconds`	`float`	· Opcional: `0.3`
`mode`	`Astra.AnimationPlayMode`	· Opcional: `0`

IsClipPlaying

public bool IsClipPlaying(string clip)

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.

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.

Parâmetro	Tipo	Contrato
`mode`	`Astra.AnimationPlayMode`	· Opcional: `0`

Play

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

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.

Parâmetro	Tipo	Contrato
`elementId`	`ulong`

Rewind

public void Rewind()

Rewind

public void Rewind(string clip)

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.

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.

Stop

public void Stop(string clip)

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.

ClipNames

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

Nomes dos clipes do componente, na ordem da lista.

Component

public Astra.Component Component { get; }

IsPlaying

public bool IsPlaying { get; }

Algum clipe tocando.

this[]

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

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

PlayAutomatically

public bool PlayAutomatically { get; set; }

WrapMode

public Astra.AnimationWrapMode WrapMode { get; set; }