Señales de Godot: reducir el acoplamiento sin perder el control explícito del ciclo de vida de las conexiones

Elige la relación que necesitas

Abrir una puerta y solicitar que se abra una puerta son interacciones distintas. La solicitud necesita un destinatario responsable que pueda aceptarla o rechazarla. La apertura ya completada, en cambio, puede interesar por separado al sonido, a los objetivos y al código de interfaz. Conviene distinguir estas relaciones antes de elegir un mecanismo de comunicación. Así la funcionalidad resulta más fácil de entender cuando otro sistema quiera observarla más adelante.

Las señales anuncian eventos

Las señales de Godot permiten que los objetos reaccionen a cambios sin que el emisor tenga que conocer a cada receptor. [1] Usa una señal para anunciar un cambio de estado ya completado, con contexto suficiente para que los oyentes puedan interpretarlo. Prefiere una llamada directa a un método cuando quien llama ya es propietario del destino y necesita un resultado inmediato. Ninguno de los dos mecanismos elimina la necesidad de un contrato claro sobre cuándo cambia el estado.

Las conexiones tienen ciclo de vida

Una conexión de señal normal con un callable se pierde cuando se libera el objeto de ese callable. is_connected() permite comprobar si existe una conexión antes de conectar o desconectar. [2] Ocultar un panel o retirarlo temporalmente del uso activo no equivale a liberarlo. Define si su suscripción dura todo el ciclo de vida del objeto o solo mientras participa en la funcionalidad.

Ejemplo: el panel de control de una esclusa

Imagina un panel que solicita la apertura de una esclusa mediante un método directo. La esclusa comprueba sus enclavamientos, actualiza su estado y emite airlock_opened solo cuando la apertura se ha producido realmente. Un oyente de sonido y otro de misión se suscriben de forma independiente. Un panel de estado temporal se suscribe mientras está visible, lee una instantánea del estado inicial y se desconecta cuando termina su periodo de observación. Al reabrir ese panel debe haber una sola suscripción activa, no otra capa de callbacks. Si la esclusa se abre mientras el panel no está, la instantánea muestra el estado correcto al volver; el panel no necesita que se le reproduzcan todas las señales anteriores.

Límites y verificación

Las señales son notificaciones, no un historial automático de eventos ni un sistema de propiedad. Mantén las operaciones sensibles al orden bajo un único coordinador explícito, en lugar de confiar en que oyentes sin relación entre sí se ejecuten en una secuencia conveniente. En C#, las lambdas con variables capturadas y las señales personalizadas conectadas con += tienen excepciones en la desconexión automática; sigue las reglas de limpieza documentadas. [3] Prueba la apertura repetida del panel, la destrucción de oyentes, el reemplazo de escenas y un evento emitido durante el desmontaje. Comprueba tanto las actualizaciones perdidas como las reacciones duplicadas. Ajusta las API de conexión y el comportamiento del ciclo de vida propio de cada lenguaje a la versión de Godot que use el proyecto.

Fuentes

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