Astra.Behavior

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

Class da API C# da Astra. 48 membros declarados neste snapshot.

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

Declaração

class Astra.Behavior

Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. Object, Scene e Scenes dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

Roadmap e uso

Objetos, Behaviors e composiçã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

Membro	Categoria
ApplicationFocus	Method
ApplicationPause	Method
Awake	Method
ChildrenChanged	Method
CollisionEnter	Method
CollisionExit	Method
CollisionStay	Method
Connect	Method
Destroy	Method
Disable	Method
Enable	Method
FindBehavior	Method
FindBehaviors	Method
FixedUpdate	Method
LateUpdate	Method
ParentChanged	Method
Remove	Method
Resolve	Method
Start	Method
StartAsync	Method
StartCoroutine	Method
Stop	Method
StopAllCoroutines	Method
StopCoroutine	Method
StopCoroutine	Method
TimerElapsed	Method
TriggerEnter	Method
TriggerExit	Method
TriggerStay	Method
Update	Method
Awaitable	Property
Debug	Property
Enabled	Property
Gui	Property
Haptics	Property
Input	Property
InstanceId	Property
IsAlive	Property
Object	Property
ObjectId	Property
Physics	Property
Physics2D	Property
Save	Property
Scene	Property
Scenes	Property
Time	Property
Transform	Property
View	Property

ApplicationFocus

public virtual void ApplicationFocus(bool focused)

A janela do aplicativo ganhou (true) ou perdeu (false) o foco.

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

Uso: A janela do aplicativo ganhou (true) ou perdeu (false) o foco.

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

Parâmetro	Tipo	Contrato
`focused`	`bool`

ApplicationPause

public virtual void ApplicationPause(bool paused)

O aplicativo foi para segundo plano (true) ou voltou (false).

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

Uso: O aplicativo foi para segundo plano (true) ou voltou (false).

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

Parâmetro	Tipo	Contrato
`paused`	`bool`

Awake

public virtual void Awake()

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ChildrenChanged

public virtual void ChildrenChanged()

A lista direta de filhos deste objeto mudou: criação, remoção, reparent ou reordenação (Unity 6000.0 OnTransformChildrenChanged).

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

Uso: A lista direta de filhos deste objeto mudou: criação, remoção, reparent ou reordenação (Unity 6000.0 OnTransformChildrenChanged).

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

CollisionEnter

public virtual void CollisionEnter(Astra.Collision collision)

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

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

Parâmetro	Tipo	Contrato
`collision`	`Astra.Collision`

CollisionExit

public virtual void CollisionExit(Astra.Collision collision)

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

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

Parâmetro	Tipo	Contrato
`collision`	`Astra.Collision`

CollisionStay

public virtual void CollisionStay(Astra.Collision collision)

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

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

Parâmetro	Tipo	Contrato
`collision`	`Astra.Collision`

Connect

public Astra.ComponentSubscription Connect(Astra.Component source, string eventId, System.Action<Astra.ComponentEventArgs> handler)

O comportamento de target que cumpre o contrato , ou null. T pode ser uma interface: é assim que um objeto interage com outro sem conhecer o tipo concreto dele.

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

Uso: O comportamento de target que cumpre o contrato , ou null. T pode ser uma interface: é assim que um objeto interage com outro sem conhecer o tipo concreto dele.

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

Parâmetro	Tipo	Contrato
`source`	`Astra.Component`
`eventId`	`string`
`handler`	`System.Action<Astra.ComponentEventArgs>`

Destroy

public virtual void Destroy()

Uma vez ao remover uma instância que recebeu Awake, inclusive ao encerrar Play.

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

Uso: Uma vez ao remover uma instância que recebeu Awake, inclusive ao encerrar Play.

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

Disable

public virtual void Disable()

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

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

Enable

public virtual void Enable()

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

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

FindBehavior

protected T? FindBehavior<T>(Astra.GameObject? target) where T : class

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

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

Parâmetro	Tipo	Contrato
`target`	`Astra.GameObject?`

FindBehaviors

protected System.Collections.Generic.IEnumerable<T> FindBehaviors<T>(Astra.GameObject? target) where T : class

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

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

Parâmetro	Tipo	Contrato
`target`	`Astra.GameObject?`

FixedUpdate

public virtual void FixedUpdate(float deltaTime)

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

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

Parâmetro	Tipo	Contrato
`deltaTime`	`float`

LateUpdate

public virtual void LateUpdate(float deltaTime)

Depois de animação e física no mesmo quadro: pose final dos objetos para câmeras e ajustes que dependem dela.

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

Uso: Depois de animação e física no mesmo quadro: pose final dos objetos para câmeras e ajustes que dependem dela.

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

Parâmetro	Tipo	Contrato
`deltaTime`	`float`

ParentChanged

public virtual void ParentChanged()

O pai deste objeto ou de um ancestral mudou (Unity 6000.0 OnTransformParentChanged). Entregue no despacho seguinte ao ponto seguro.

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

Uso: O pai deste objeto ou de um ancestral mudou (Unity 6000.0 OnTransformParentChanged). Entregue no despacho seguinte ao ponto seguro.

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

Remove

public void Remove()

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

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

Resolve

protected Astra.GameObject? Resolve(Astra.ObjectReference reference)

Resolve uma referência autorada no inspetor para um objeto vivo.

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

Uso: Resolve uma referência autorada no inspetor para um objeto vivo.

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

Parâmetro	Tipo	Contrato
`reference`	`Astra.ObjectReference`

Start

public virtual void Start()

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

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

StartAsync

public Astra.Coroutine StartAsync(System.Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> work)

Runs an async Task with owner-bound lifecycle and observed errors. Pass its token to each Awaitable call so stopping the returned coroutine cancels suspended work.

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

Uso: Runs an async Task with owner-bound lifecycle and observed errors. Pass its token to each Awaitable call so stopping the returned coroutine cancels suspended work.

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

Parâmetro	Tipo	Contrato
`work`	`System.Func<System.Threading.CancellationToken, System.Threading.Tasks.Task>`

StartCoroutine

public Astra.Coroutine StartCoroutine(System.Collections.IEnumerator routine)

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

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

Parâmetro	Tipo	Contrato
`routine`	`System.Collections.IEnumerator`

Stop

public virtual void Stop()

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

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

StopAllCoroutines

public void StopAllCoroutines()

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

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

StopCoroutine

public void StopCoroutine(Astra.Coroutine coroutine)

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

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

Parâmetro	Tipo	Contrato
`coroutine`	`Astra.Coroutine`

StopCoroutine

public void StopCoroutine(System.Collections.IEnumerator routine)

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

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

Parâmetro	Tipo	Contrato
`routine`	`System.Collections.IEnumerator`

TimerElapsed

public virtual void TimerElapsed(ulong timerInstanceId, uint count)

Called when a Timer on this object expires. Multiple expirations in one frame are delivered together. The ID distinguishes Timer instances.

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

Uso: Called when a Timer on this object expires. Multiple expirations in one frame are delivered together. The ID distinguishes Timer instances.

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

Parâmetro	Tipo	Contrato
`timerInstanceId`	`ulong`
`count`	`uint`

TriggerEnter

public virtual void TriggerEnter(Astra.ObjectReference other)

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

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

Parâmetro	Tipo	Contrato
`other`	`Astra.ObjectReference`

TriggerExit

public virtual void TriggerExit(Astra.ObjectReference other)

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

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

Parâmetro	Tipo	Contrato
`other`	`Astra.ObjectReference`

TriggerStay

public virtual void TriggerStay(Astra.ObjectReference other)

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

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

Parâmetro	Tipo	Contrato
`other`	`Astra.ObjectReference`

Update

public virtual void Update(float deltaTime)

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

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

Parâmetro	Tipo	Contrato
`deltaTime`	`float`

Awaitable

protected Astra.BehaviorAwaitables Awaitable { get; }

Owner-bound awaits. All continuations run on the script dispatch thread.

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

Uso: Owner-bound awaits. All continuations run on the script dispatch thread.

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

Debug

protected Astra.DebugDraw Debug { get; }

Linhas de depuração visíveis no Play.

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

Uso: Linhas de depuração visíveis no Play.

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

Enabled

public bool Enabled { get; set; }

Estado local; no hospedeiro nativo lê/escreve o mesmo componente do Inspector.

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

Uso: Estado local; no hospedeiro nativo lê/escreve o mesmo componente do Inspector.

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

Gui

protected Astra.GuiAccess Gui { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Haptics

protected Astra.HapticsAccess Haptics { get; }

Vibração do aparelho, quando a plataforma oferece.

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

Uso: Vibração do aparelho, quando a plataforma oferece.

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

Input

protected Astra.InputAccess Input { get; }

As ações de entrada configuradas no projeto.

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

Uso: As ações de entrada configuradas no projeto.

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

InstanceId

public ulong InstanceId { get; private 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

protected Astra.GameObject Object { get; }

O objeto a que este comportamento está anexado. Resolvido uma vez: um Object novo a cada quadro seria lixo alocado por comportamento e por quadro, e o handle não muda enquanto o comportamento existe.

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

Uso: O objeto a que este comportamento está anexado. Resolvido uma vez: um Object novo a cada quadro seria lixo alocado por comportamento e por quadro, e o handle não muda enquanto o comportamento existe.

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

ObjectId

public ulong ObjectId { get; private 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Physics

protected Astra.PhysicsAccess Physics { get; }

As consultas físicas do mundo de execução.

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

Uso: As consultas físicas do mundo de execução.

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

Physics2D

protected Astra.Physics2DAccess Physics2D { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Save

public Astra.SaveStore Save { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Scene

protected Astra.ISceneAccess Scene { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Scenes

protected Astra.ScenesAccess Scenes { get; }

Cenas do projeto: ativa, lista, troca e carga aditiva.

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

Uso: Cenas do projeto: ativa, lista, troca e carga aditiva.

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

Time

public Astra.TimeAccess Time { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Transform

protected Astra.TransformValue Transform { 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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

View

protected Astra.GameViewAccess View { get; }

Tamanho, DPI, área segura e conversões tela/mundo da vista de jogo.

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

Uso: Tamanho, DPI, área segura e conversões tela/mundo da vista de jogo.

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