Astra.Components.EventConnection

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

Conexão de evento: Evento deste objeto aciona objetos ou métodos, sem script. Família Lógica · Eventos.

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

Declaração

readonly struct Astra.Components.EventConnection

Conexão de evento: Evento deste objeto aciona objetos ou métodos, sem script. Família Lógica · Eventos.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Events.UnityEvent.html

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

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Eventos → Conexão de evento.

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

Roadmap e uso

Tempo, eventos e tweens: 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 Conexão de evento para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
Remove	Method
Wrap	Method
Action	Property
Argument	Property
Component	Property
Enabled	Property
Event	Property
InstanceId	Property
IsAlive	Property
Method	Property
Object	Property
Once	Property
OtherFilter	Property
Receiver	Property
TypeId	Property

.ctor

public EventConnection(Astra.Component component)

Caminho: Inspector → Conexão de evento; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

Remove

public void Remove()

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

Caminho: Inspector → Conexão de evento; ou fachada C# em um Behavior.

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

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

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

Caminho: Inspector → Conexão de evento; ou fachada C# em um Behavior.

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

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`component`	`Astra.Component`

Action

public Astra.Components.EventConnection.ActionOption Action { get; set; }

Ação. Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

Caminho: Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

Uso: Ação: Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Argument

public float Argument { get; set; }

Valor (s). Timer: intervalo (zero usa o autorado). Áudio: posição do cursor

Faixa válida: 0 a 3600.

Caminho: Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

Uso: Valor: Timer: intervalo (zero usa o autorado). Áudio: posição do cursor

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

public Astra.Component Component { get; }

Caminho: Inspector → Conexão de evento; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

public bool Enabled { get; set; }

Ativa. Desligada não reage a eventos; a configuração é preservada

Caminho: Inspector → Conexão de evento → Conexão; ou fachada C# em um Behavior.

Uso: Ativa: Desligada não reage a eventos; a configuração é preservada

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Event

public Astra.Components.EventConnection.EventOption Event { get; set; }

Evento. Emitido por um componente deste objeto; sem o componente, a conexão não dispara

Caminho: Inspector → Conexão de evento → Quando; ou fachada C# em um Behavior.

Uso: Evento: Emitido por um componente deste objeto; sem o componente, a conexão não dispara

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Conexão de evento; ou fachada C# em um Behavior.

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

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Conexão de evento; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Method

public Astra.Components.EventConnection.MethodOption Method { get; set; }

Método. Chamado no primeiro componente do tipo correspondente no receptor

Caminho: Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

Uso: Método: Chamado no primeiro componente do tipo correspondente no receptor

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Conexão de evento; ou fachada C# em um Behavior.

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

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Once

public bool Once { get; set; }

Uma vez. Reage só ao primeiro evento de cada execução de Play

Caminho: Inspector → Conexão de evento → Conexão; ou fachada C# em um Behavior.

Uso: Uma vez: Reage só ao primeiro evento de cada execução de Play

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OtherFilter

public Astra.ObjectReference OtherFilter { get; set; }

Outro objeto. Opcional: só contatos com este outro objeto

Caminho: Inspector → Conexão de evento → Quando; ou fachada C# em um Behavior.

Uso: Outro objeto: Opcional: só contatos com este outro objeto

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Receiver

public Astra.ObjectReference Receiver { get; set; }

Receptor. Objeto ativado ou dono do componente chamado; vazio usa o próprio emissor

Caminho: Inspector → Conexão de evento → Então; ou fachada C# em um Behavior.

Uso: Receptor: Objeto ativado ou dono do componente chamado; vazio usa o próprio emissor

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Conexão de evento; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.