--- title: "Conexão de evento" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-logic-event-connection/ --- # Conexão de evento Evento deste objeto aciona objetos ou métodos, sem script **Família:** Lógica · **Grupo:** Eventos · **Identificador:** `astra.logic.event_connection` · **Payload:** 1 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## 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. ## 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](/pt-br/snapshot-2026-10-07/api/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 | 1 | 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](/pt-br/snapshot-2026-10-06/conceitos/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. ### Então | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Valor**](#field-argument)
`argument` | número · s | 0 | 0 … 3600 | | [**Ação**](#field-action)
`action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto \| Chamar método | | [**Método**](#field-method)
`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 | | [**Receptor**](#field-receiver)
`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 **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 **Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** 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. 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. ### Conexão | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Ativa**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Uma vez**](#field-once)
`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. ### Quando | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Evento**](#field-event)
`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 | | [**Outro objeto**](#field-other-filter)
`other_filter` | referência | Qualquer objeto | qualquer objeto |

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 **Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** 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.

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. ## Roadmap deste componente [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/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 1. Crie **Conexão de evento** pelo fluxo indicado e resolva as dependências. 2. Altere uma propriedade por vez e observe o efeito esperado na cena. 3. Salve, reabra e confira os valores autorais. 4. Entre em Play e verifique o comportamento com os recursos reais do projeto. 5. 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](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/Events.UnityEvent.html). Essa referência não representa paridade funcional.