Сигналы Godot: уменьшение связности и явная жизнь соединений

Выберите нужное отношение

Открытие двери и запрос на её открытие — разные взаимодействия. Запросу нужен ответственный получатель, способный принять или отклонить его. Завершившееся открытие может независимо интересовать звук, цели и интерфейс. Различайте эти отношения до выбора механизма связи. Так функцию будет проще понять, когда позже за ней захочет наблюдать ещё одна система.

Сигналы сообщают о событиях

Сигналы Godot позволяют объектам реагировать на изменения без знания отправителем каждого получателя. [1] Сообщайте сигналом о завершённой смене состояния и передавайте достаточно контекста слушателям. Предпочитайте прямой вызов метода, когда вызывающая сторона уже владеет целью и нуждается в немедленном результате. Ни один механизм не отменяет ясного контракта о моменте изменения состояния.

У соединений есть время жизни

Обычное соединение сигнала с callable исчезает при освобождении объекта этого callable. is_connected() позволяет проверить наличие соединения перед подключением или отключением. [2] Скрытие панели или её временное исключение из работы не равно освобождению. Определите, действует ли подписка всю жизнь объекта или только пока он участвует в функции.

Пример: панель управления шлюзом

Представим панель, запрашивающую открытие шлюза прямым методом. Шлюз проверяет блокировки, обновляет состояние и испускает airlock_opened лишь после фактического открытия. Слушатель звука и слушатель миссии подписываются независимо. Временная панель состояния подписывается на время показа, читает начальный снимок состояния и отключается по завершении наблюдения. Повторное открытие должно давать одну активную подписку, а не новый слой callbacks. Если шлюз открылся в отсутствие панели, снимок покажет правильное состояние после её возвращения; воспроизводить все прежние сигналы ей не требуется.

Ограничения и проверка

Сигналы — уведомления, а не автоматическая история событий или система владения. Операции, чувствительные к порядку, оставляйте под явным координатором вместо надежды на удобную последовательность независимых слушателей. В C# у лямбд с захватом и собственных сигналов, подключённых через +=, есть исключения из автоматического отключения; следуйте документированным правилам очистки. [3] Проверяйте повторное открытие панели, уничтожение слушателя, замену сцены и событие во время удаления объектов. Ищите и пропущенные обновления, и повторные реакции. Согласуйте API соединений и особенности времени жизни конкретного языка с версией Godot в проекте.

Источники

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