Sinais do Godot: reduza o acoplamento mantendo explícito o ciclo de vida das conexões

Escolha a relação de que você precisa

A abertura de uma porta e o pedido para abri-la são interações diferentes. O pedido precisa de um destinatário responsável, capaz de aceitá-lo ou recusá-lo. A abertura concluída, por outro lado, pode interessar de forma independente ao código de som, de objetivos e de interface. Distinga essas relações antes de escolher o mecanismo de comunicação. Isso torna a funcionalidade mais fácil de entender quando outro sistema quiser observá-la mais tarde.

Sinais anunciam eventos

Os sinais do Godot permitem que objetos reajam a mudanças sem que o emissor precise conhecer cada receptor. [1] Use um sinal para anunciar uma mudança de estado já concluída, com contexto suficiente para que os ouvintes a interpretem. Prefira uma chamada direta de método quando quem chama já é dono do alvo e precisa de um resultado imediato. Nenhum dos dois mecanismos dispensa um contrato claro sobre o momento em que o estado muda.

Conexões têm ciclo de vida

Uma conexão normal de um sinal a um callable é perdida quando o objeto desse callable é liberado. is_connected() permite verificar se uma conexão existe antes de conectar ou desconectar. [2] Ocultar um painel ou tirá-lo temporariamente de uso ativo não equivale a liberá-lo. Defina se a assinatura dele dura durante todo o tempo de vida do objeto ou apenas enquanto ele participa da funcionalidade.

Exemplo: o painel de controle de uma câmara de descompressão

Imagine um painel que pede a abertura de uma câmara de descompressão por meio de um método direto. A câmara de descompressão verifica seus intertravamentos, atualiza seu estado e emite airlock_opened somente depois que a abertura de fato ocorreu. Um ouvinte de som e um ouvinte de missão se inscrevem de forma independente. Um painel de status temporário se inscreve enquanto está visível, lê um instantâneo do estado inicial e se desconecta quando seu período de observação termina. Reabrir esse painel deve resultar em uma única assinatura ativa, e não em mais uma camada de callbacks. Se a câmara de descompressão abrir enquanto o painel estiver ausente, o instantâneo mostra o estado correto no retorno; o painel não precisa de uma reexecução de todos os sinais anteriores.

Limites e verificação

Sinais são notificações, não um histórico automático de eventos nem um sistema de propriedade. Mantenha operações sensíveis à ordem sob um único coordenador explícito, em vez de contar com ouvintes sem relação entre si para executar em uma sequência conveniente. Em C#, lambdas com variáveis capturadas e sinais personalizados conectados com += têm exceções à desconexão automática; siga as regras de limpeza documentadas. [3] Teste a abertura repetida do painel, a destruição de ouvintes, a substituição de cena e um evento emitido durante o desmonte. Verifique tanto atualizações perdidas quanto reações duplicadas. Ajuste as APIs de conexão e o comportamento de ciclo de vida específico da linguagem à versão do Godot usada pelo projeto.

Fontes

1. Using signals — Godot Engine contributors.
2. Signal class reference — Godot Engine contributors.
3. C# signals — Godot Engine contributors.