Pular para o conteúdo
AstraDOCS

Astra.AnimatorController

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Parâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException.

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

readonly struct Astra.AnimatorController

Parâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException.

Cena → raiz do modelo → Animator → Abrir grafo. No Behavior desse objeto, Object.Animator() fornece AnimatorController para parâmetros/estados. AnimatorStateInfo é a leitura retornada por GetCurrentState; construir o record não muda a animação. Ficha do Animator.

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.

Membro Categoria
CrossFade Method
GetBool Method
GetCurrentState Method
GetFloat Method
GetInteger Method
Play Method
ResetTrigger Method
SetBool Method
SetFloat Method
SetInteger Method
SetTrigger Method
Component Property

CrossFade

public void CrossFade(string state, float seconds, uint layer = 0)

Transição para o estado em seconds segundos.

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

Uso: Transição para o estado em seconds segundos.

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

Parâmetro Tipo Contrato
state string
seconds float
layer uint · Opcional: 0

GetBool

public bool GetBool(string name)

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
name string

GetCurrentState

public Astra.AnimatorStateInfo GetCurrentState(uint layer = 0)

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
layer uint · Opcional: 0

GetFloat

public float GetFloat(string name)

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
name string

GetInteger

public int GetInteger(string name)

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
name string

Play

public void Play(string state, uint layer = 0)

Troca a camada para o estado na hora, do início.

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

Uso: Troca a camada para o estado na hora, do início.

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

Parâmetro Tipo Contrato
state string
layer uint · Opcional: 0

ResetTrigger

public void ResetTrigger(string name)

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
name string

SetBool

public void SetBool(string name, bool value)

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
name string
value bool

SetFloat

public void SetFloat(string name, float value)

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
name string
value float

SetInteger

public void SetInteger(string name, int value)

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
name string
value int

SetTrigger

public void SetTrigger(string name)

Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).

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

Uso: Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).

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

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.