Conexão de evento

Astra 0.4.0-preview.20261028Conferido em fonte

Evento deste objeto aciona objetos ou métodos, sem script

Família: Lógica · Grupo: Eventos · Identificador: astra.logic.event_connection · Payload: 3

Para que usar

Evento deste objeto aciona objetos ou métodos, sem script

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

Vindo de outra engine

Na Unity, o conceito mais próximo está em Events.UnityEvent. A Astra estudou essa referência; os campos e o comportamento são os desta página, sem paridade garantida. Palavras que a busca de Adicionar componente aceita: UnityEvent, Signal, Evento, Conexao, Trigger, Gatilho.

Criar e configurar

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

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é Astra.Components.EventConnection.

Exemplo de uso

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.

Dependências

Nenhuma regra adicional declarada no schema deste componente.

Conflitos

Nenhuma regra adicional declarada no schema deste componente.

Edição e ciclo de vida

Operação	Contrato
Adicionar/remover em Play	ponto seguro
Alterar propriedades em Play	ponto seguro
Múltiplas instâncias	Sim
Versão do payload	3

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja Play e cena autoral.

Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

Recursos do projeto

Estes seletores ficam no componente e não entram na contagem dos campos numéricos. Use recursos registrados do projeto; nome ou caminho externo não substitui uma referência válida.

Recurso	Onde	Tipo	Uso
Perfil · `argument_profile`	Inspector → Conexão de evento → Então	environment_profile	Volume Profile que o Volume do receptor passa a usar (Volume.sharedProfile)
Material · `argument_material`	Inspector → Conexão de evento → Então	material	Material que o primeiro slot do Mesh Renderer do receptor passa a usar (Renderer.sharedMaterial)

Então

Propriedade	Tipo / unidade	Padrão	Domínio
Valor `argument`	número · s	0	0 … 3600
Ação `action`	enumeração	Desconectado	Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto \| Chamar método
Método `method`	enumeração	Nenhum	Nenhum \| Áudio: tocar \| Áudio: parar \| Áudio: pausar \| Áudio: retomar \| Áudio: posicionar \| Timer: iniciar \| Timer: parar \| Timer: pausar \| Timer: retomar \| Tween: reiniciar \| Tween: cancelar \| Tween: pausar \| Tween: retomar \| Percurso: reiniciar \| Percurso: parar \| Sequência: tocar \| Sequência: cancelar \| Sequência: pausar \| Sequência: retomar \| Tween de propriedade: reiniciar \| Tween de propriedade: cancelar \| Tween de propriedade: pausar \| Tween de propriedade: retomar \| Raio: atualizar agora \| Varredura: atualizar agora \| Câmera virtual: priorizar \| Câmera virtual: encaixar \| Snapshot: transicionar \| Snapshot: aplicar \| Agente: parar \| Agente: retomar \| Recuo: disparar \| Impacto: golpear de frente \| Personagem: subir/descer \| Sonda de reflexo: capturar agora \| Partículas: tocar \| Partículas: parar \| Partículas: parar e limpar \| Partículas: pausar \| Partículas: limpar \| Volume: definir peso \| Volume: trocar perfil \| Volume: usar cópia do perfil \| Malha: trocar material
Receptor `receiver`	referência	Este objeto	qualquer objeto

Valor · `argument`

Onde: Inspector → Conexão de evento → Então → Valor.

Uso e efeito: Timer: intervalo (zero usa o autorado). Áudio: posição do cursor. Volume: peso de 0 a 1

Valor: 0 · Tipo: número · Unidade: s · Domínio: 0 … 3600.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Ação · `action`

Onde: Inspector → Conexão de evento → Então → Ação.

Uso e efeito: Executada no ponto seguro seguinte ao evento, antes do próximo despacho de scripts

Valor: Desconectado · Tipo: enumeração · Domínio: Desconectado | Ativar objeto | Desativar objeto | Alternar objeto | Chamar método.

Método · `method`

Onde: Inspector → Conexão de evento → Então → Método.

Uso e efeito: Chamado no primeiro componente do tipo correspondente no receptor

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Receptor · `receiver`

Onde: Inspector → Conexão de evento → Então → Receptor.

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

Valor: Este objeto · Tipo: referência · Domínio: qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Quando

Propriedade	Tipo / unidade	Padrão	Domínio
Código do clipe `clip_tag`	número	-1	-1 … 16777215
Evento `event`	enumeração	Nenhum	Nenhum \| Timer disparou \| Tween concluiu \| Sensor 3D: entrou \| Sensor 3D: saiu \| Colisão 3D: começou \| Colisão 3D: terminou \| Sensor 2D: entrou \| Sensor 2D: saiu \| Colisão 2D: começou \| Colisão 2D: terminou \| Sequência: etapa começou \| Sequência concluiu \| Tween de propriedade concluiu \| Junta quebrou \| Personagem bateu num colisor \| Sensor 3D: dentro \| Cérebro: câmera ativada \| Cérebro: corte de câmera \| Cérebro: transição concluída \| Câmera virtual entrou ao vivo \| Câmera virtual saiu do ar \| Animator: entrou num estado \| Animator: evento do estado \| Animator: entrou num grupo \| Animator: saiu de um grupo \| Animator: mistura interrompida \| Agente: chegou \| Agente: caminho falhou \| Agente: entrou num link \| Animation: evento do clipe \| Animation: limite de eventos \| Animator: evento do clipe \| Animator: limite de eventos \| Interação: mão alcançou \| Interação: mão soltou \| Interação: objeto levantado \| Interação: entrou no gatilho \| Interação: saiu do gatilho \| Partículas: parou \| Hora do dia: hora mudou \| Hora do dia: nascer do sol \| Hora do dia: pôr do sol \| Hora do dia: dia mudou \| Entrada: ação executada \| Entrada: ação cancelada
Ação `input_action`	enumeração	Qualquer ação	Qualquer ação \| Ação 1 \| Ação 2 \| Ação 3 \| Ação 4 \| Ação 5 \| Ação 6 \| Ação 7 \| Ação 8 \| Ação 9 \| Ação 10 \| Ação 11 \| Ação 12 \| Ação 13 \| Ação 14 \| Ação 15 \| Ação 16 \| Ação 17 \| Ação 18 \| Ação 19 \| Ação 20 \| Ação 21 \| Ação 22 \| Ação 23 \| Ação 24 \| Ação 25 \| Ação 26 \| Ação 27 \| Ação 28 \| Ação 29 \| Ação 30 \| Ação 31 \| Ação 32
Outro objeto `other_filter`	referência	Qualquer objeto	qualquer objeto

Código do clipe · `clip_tag`

Onde: Inspector → Conexão de evento → Quando → Código do clipe.

Uso e efeito: -1 aceita qualquer código; 0..16777215 seleciona o evento do clipe

Valor: -1 · Tipo: número · Domínio: -1 … 16777215.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Evento · `event`

Onde: Inspector → Conexão de evento → Quando → Evento.

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

Ação · `input_action`

Onde: Inspector → Conexão de evento → Quando → Ação.

Uso e efeito: Ação do mapa de entrada da cena; Qualquer ação aceita todas as observadas pela Entrada do jogador

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Outro objeto · `other_filter`

Onde: Inspector → Conexão de evento → Quando → Outro objeto.

Uso e efeito: Opcional: só contatos com este outro objeto

Valor: Qualquer objeto · Tipo: referência · Domínio: qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Conexão

Propriedade	Tipo / unidade	Padrão	Domínio
Ativa `enabled`	booleano	verdadeiro	verdadeiro \| falso
Uma vez `once`	booleano	falso	verdadeiro \| falso

Ativa · `enabled`

Onde: Inspector → Conexão de evento → Conexão → Ativa.

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

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Uma vez · `once`

Onde: Inspector → Conexão de evento → Conexão → Uma vez.

Uso e efeito: Reage só ao primeiro evento de cada execução de Play

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Roadmap deste componente

Tempo, eventos e tweens. Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

Conferir na sua cena

Crie Conexão de evento pelo fluxo indicado e resolva as dependências.
Altere uma propriedade por vez e observe o efeito esperado na cena.
Salve, reabra e confira os valores autorais.
Entre em Play e verifique o comportamento com os recursos reais do projeto.
Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

Referência de arquitetura registrada pela engine: documentação oficial. Essa referência não representa paridade funcional.

Conexão de evento

Para que usar

Vindo de outra engine

Criar e configurar

Exemplo de uso

Dependências

Conflitos

Edição e ciclo de vida

Propriedades

Recursos do projeto

Então

Valor · argument

Ação · action

Método · method

Receptor · receiver

Quando

Código do clipe · clip_tag

Evento · event

Ação · input_action

Outro objeto · other_filter

Conexão

Ativa · enabled

Uma vez · once

Roadmap deste componente

Conferir na sua cena

Limitações da referência

Valor · `argument`

Ação · `action`

Método · `method`

Receptor · `receiver`

Código do clipe · `clip_tag`

Evento · `event`

Ação · `input_action`

Outro objeto · `other_filter`

Ativa · `enabled`

Uma vez · `once`