Astra.Components.Animator

Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct

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

readonly struct Astra.Components.Animator

Animator: Máquina de estados: parâmetros, transições, misturas e camadas. Família Animação · Máquina de estados.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-AnimatorController.html

Interfaces: Astra.Components.IComponentFacade<Astra.Components.Animator>.

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Animação / Máquina de estados → Animator.

No Behavior em Play, obtenha a fachada com Object.GetComponent<Animator>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new Animator(component) envolve um componente existente; não adiciona um componente à cena.

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.

Consulte também Animator para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
GetController	Method
GetLayerBlend	Method
GetLayerReferenceHigh	Method
GetLayerReferenceLow	Method
GetLayerReferenceTime	Method
GetLayerWeight	Method
InTransition	Method
OnMachineEntered	Method
OnMachineExited	Method
OnStateEntered	Method
OnStateEvent	Method
OnTransitionInterrupted	Method
Remove	Method
ResetLayerOverrides	Method
SetController	Method
SetLayerBlend	Method
SetLayerReference	Method
SetLayerReferenceTime	Method
SetLayerWeight	Method
Wrap	Method
Component	Property
Enabled	Property
InstanceId	Property
IsAlive	Property
LayerMask0	Property
LayerMask1	Property
LayerMask2	Property
LayerMask3	Property
MotionSource	Property
Object	Property
Speed	Property
Target	Property
TypeId	Property
UnscaledTime	Property

.ctor

public Animator(Astra.Component component)

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

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

GetController

public Astra.AssetGuid GetController(uint slot = 0)

Controller. Recurso do projeto por slot

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Controller. Recurso do projeto por slot

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
slot	uint	· Opcional: 0

GetLayerBlend

public long GetLayerBlend(long layer)

Ler composição. 0 Override / 1 Additive

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Ler composição. 0 Override / 1 Additive

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

GetLayerReferenceHigh

public long GetLayerReferenceHigh(long layer)

GUID alto. Bits da referência efetiva

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: GUID alto. Bits da referência efetiva

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

GetLayerReferenceLow

public long GetLayerReferenceLow(long layer)

GUID baixo. Bits da referência efetiva

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: GUID baixo. Bits da referência efetiva

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

GetLayerReferenceTime

public double GetLayerReferenceTime(long layer)

Ler tempo de referência. Segundos no clipe

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Ler tempo de referência. Segundos no clipe

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

GetLayerWeight

public double GetLayerWeight(long layer)

Ler peso. Peso efetivo da instância

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Ler peso. Peso efetivo da instância

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

InTransition

public bool InTransition()

Em transição. Verdadeiro enquanto a camada base mistura dois estados

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Em transição. Verdadeiro enquanto a camada base mistura dois estados

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OnMachineEntered

public Astra.ComponentSubscription OnMachineEntered(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Entrou no grupo. Um grupo tornou-se ativo; da raiz até o grupo interno. Payload: Camada: inteiro, Grupo: inteiro

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Entrou no grupo. Um grupo tornou-se ativo; da raiz até o grupo interno. Payload: Camada: inteiro, Grupo: inteiro

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnMachineExited

public Astra.ComponentSubscription OnMachineExited(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Saiu do grupo. Um grupo deixou de participar da reprodução; do grupo interno à raiz. Payload: Camada: inteiro, Grupo: inteiro

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Saiu do grupo. Um grupo deixou de participar da reprodução; do grupo interno à raiz. Payload: Camada: inteiro, Grupo: inteiro

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnStateEntered

public Astra.ComponentSubscription OnStateEntered(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Entrou no estado. Emitido quando um estado começa (no início da transição para ele). Payload: Camada: inteiro, Estado: inteiro

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Entrou no estado. Emitido quando um estado começa (no início da transição para ele). Payload: Camada: inteiro, Estado: inteiro

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnStateEvent

public Astra.ComponentSubscription OnStateEvent(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Evento do estado. Emitido quando o tempo do estado passa por um evento marcado nele. Payload: Camada: inteiro, Estado: inteiro, Marca: inteiro

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Evento do estado. Emitido quando o tempo do estado passa por um evento marcado nele. Payload: Camada: inteiro, Estado: inteiro, Marca: inteiro

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

OnTransitionInterrupted

public Astra.ComponentSubscription OnTransitionInterrupted(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Mistura interrompida. Pose composta preservada; ID zero indica CrossFade solicitado pela API. Payload: Camada: inteiro, Transição cancelada: inteiro, Novo estado: inteiro

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Mistura interrompida. Pose composta preservada; ID zero indica CrossFade solicitado pela API. Payload: Camada: inteiro, Transição cancelada: inteiro, Novo estado: inteiro

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
owner	Astra.Behavior
handler	System.Action<Astra.ComponentEventArgs>

Remove

public void Remove()

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ResetLayerOverrides

public void ResetLayerOverrides(long layer)

Restaurar camada. Restaura a composição autorada, preservando estado e relógio

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Restaurar camada. Restaura a composição autorada, preservando estado e relógio

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long

SetController

public void SetController(Astra.AssetGuid value, uint slot = 0)

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

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
value	Astra.AssetGuid
slot	uint	· Opcional: 0

SetLayerBlend

public void SetLayerBlend(long layer, long mode)

Composição da instância. 0 Override / 1 Additive

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Composição da instância. 0 Override / 1 Additive

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long
mode	long

SetLayerReference

public void SetLayerReference(long layer, long high, long low)

Referência da instância. GUID zero usa a pose inicial; desconhecido é recusado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Referência da instância. GUID zero usa a pose inicial; desconhecido é recusado

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long
high	long
low	long

SetLayerReferenceTime

public void SetLayerReferenceTime(long layer, double value)

Tempo de referência. Segundos no clipe

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Tempo de referência. Segundos no clipe

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long
value	double

SetLayerWeight

public void SetLayerWeight(long layer, double value)

Peso da instância. Não altera o recurso compartilhado

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Peso da instância. Não altera o recurso compartilhado

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
layer	long
value	double

Wrap

public static Astra.Components.Animator Wrap(Astra.Component component)

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Envolve um Component existente após conferir TypeId; não cria componente.

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

Component

public Astra.Component Component { get; }

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Handle genérico da instância, usado para operações de reflexão e recursos.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

public bool Enabled { get; set; }

Ativo. Desligado congela a pose atual; parâmetros e estados são preservados

Caminho: Inspector → Animator → Animator; ou fachada C# em um Behavior.

Uso: Ativo: Desligado congela a pose atual; parâmetros e estados são preservados

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LayerMask0

public Astra.ObjectReference LayerMask0 { get; set; }

Máscara · Base. Máscara da camada por instância; remapeada em hierarquia/prefab

Caminho: Inspector → Animator → Máscaras; ou fachada C# em um Behavior.

Uso: Máscara · Base: Máscara da camada por instância; remapeada em hierarquia/prefab

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LayerMask1

public Astra.ObjectReference LayerMask1 { get; set; }

Máscara · Camada 2. Máscara da camada por instância; remapeada em hierarquia/prefab

Caminho: Inspector → Animator → Máscaras; ou fachada C# em um Behavior.

Uso: Máscara · Camada 2: Máscara da camada por instância; remapeada em hierarquia/prefab

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LayerMask2

public Astra.ObjectReference LayerMask2 { get; set; }

Máscara · Camada 3. Máscara da camada por instância; remapeada em hierarquia/prefab

Caminho: Inspector → Animator → Máscaras; ou fachada C# em um Behavior.

Uso: Máscara · Camada 3: Máscara da camada por instância; remapeada em hierarquia/prefab

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LayerMask3

public Astra.ObjectReference LayerMask3 { get; set; }

Máscara · Camada 4. Máscara da camada por instância; remapeada em hierarquia/prefab

Caminho: Inspector → Animator → Máscaras; ou fachada C# em um Behavior.

Uso: Máscara · Camada 4: Máscara da camada por instância; remapeada em hierarquia/prefab

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MotionSource

public Astra.ObjectReference MotionSource { get; set; }

Corpo / motor. Fonte dos parâmetros físicos; independe da malha e não move o corpo

Caminho: Inspector → Animator → Animator; ou fachada C# em um Behavior.

Uso: Corpo / motor: Fonte dos parâmetros físicos; independe da malha e não move o corpo

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Objeto dono deste componente; use para resolver composição.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Speed

public float Speed { get; set; }

Velocidade (×). Multiplica o tempo de todos os estados

Faixa válida: -10 a 10.

Caminho: Inspector → Animator → Animator; ou fachada C# em um Behavior.

Uso: Velocidade: Multiplica o tempo de todos os estados

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Target

public Astra.ObjectReference Target { get; set; }

Raiz animada. Objeto cuja hierarquia os clipes animam (o modelo importado)

Caminho: Inspector → Animator → Animator; ou fachada C# em um Behavior.

Uso: Raiz animada: Objeto cuja hierarquia os clipes animam (o modelo importado)

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Animator; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

UnscaledTime

public bool UnscaledTime { get; set; }

Ignorar escala de tempo. Anima em tempo real mesmo com o jogo pausado por escala (menus, cutscenes)

Caminho: Inspector → Animator → Animator; ou fachada C# em um Behavior.

Uso: Ignorar escala de tempo: Anima em tempo real mesmo com o jogo pausado por escala (menus, cutscenes)

Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.