07. HUD 와 일시정지 — 이벤트로 잇는 UI

void Update() { scoreText.text = "Score: " + SurvivalGame.Instance.Score; // ❌ healthSlider.value = Player.Instance.HitPointRatio; // ❌ }

HUDForm ← Canvas (Screen Space - Overlay, Sort Order 0) + 이 장에서 만들 HUDForm 스크립트 ├ HealthUI │ ├ HealthSlider ← Slider. 체력 바 │ └ Heart ├ DamageImage ← Image. 화면 전체를 덮는 붉은 막 ├ GameOverText ← Text. "Game Over!" ├ InfoText ← Text. 안내문 / 점수 ├ Ally Button ← 8장에서 쓴다 └ CountdownSlider ← Slider. 쿨다운 게이지

// Assets/GameMain/UI/UITable.cs namespace ToyBoxNightmare { /// <summary> /// UI 폼의 Addressables 주소와 UI 그룹 이름을 모아 둔다. /// 문자열을 코드 곳곳에 흩뿌리면 오타가 나도 <c>OpenUIForm</c> 이 조용히 실패한다. /// </summary> public static class UITable { /// <summary> /// 기본 UI 그룹(깊이 0). HUD 가 들어간다. <c>GameFramework.prefab</c> 의 UIComponent.mUIGroups 에 /// <b>같은 이름으로 등록돼 있어야 한다.</b> 없으면 OpenUIForm 이 실패한다. /// </summary> public const string DefaultGroup = "Default"; /// <summary> /// 위에 겹쳐 뜨는 폼의 UI 그룹(깊이 1). 일시정지 메뉴가 들어간다. /// 그룹 깊이가 클수록 위에 그려진다 — <see cref="UIFormBase"/> 가 깊이를 Canvas 순서로 옮긴다. /// </summary> public const string PopupGroup = "Popup"; /// <summary>HUD 폼의 Addressables 주소.</summary> public const string HudForm = "HUDForm"; /// <summary> /// 일시정지 폼의 Addressables 주소. <see cref="PopupGroup"/> 에 열어 HUD 위에 그려지게 한다. /// </summary> public const string PauseMenuForm = "PauseMenuForm"; } }

// Assets/GameMain/Procdure/ProcedureMain.cs using UnityGameFramework.Runtime; using ProcedureOwner = GameFramework.Fsm.IFsm<GameFramework.Procedure.IProcedureManager>; namespace ToyBoxNightmare { public class ProcedureMain : ProcedureBase { private SurvivalGame mGame = null; /// <summary>UI 실패 이벤트를 구독 중인가. 구독/해지 짝을 보장한다.</summary> private bool mSubscribedUIFailure = false; public override bool UseNativeDialog => false; protected override void OnEnter(ProcedureOwner procedureOwner) { base.OnEnter(procedureOwner); Log.Info("ProcedureMain: Enter"); // 구독이 먼저다. OpenUIForm 은 비동기라 실패 통지가 이 아래 호출 도중에도 올 수 있다. SubscribeUIFailure(); OpenForms(); mGame = new SurvivalGame(); mGame.Initialize(); } /// <summary> /// HUD 를 띄운다. /// </summary> private void OpenForms() { UIComponent ui = GameEntry.GetComponent<UIComponent>(); if (ui == null) { Log.Error("ProcedureMain: UIComponent 가 없다. UI 없이 진행한다."); return; } OpenOnce(ui, UITable.HudForm, UITable.DefaultGroup); } /// <summary>이미 떠 있으면 두 번 열지 않는다(프로시저 재진입 방어).</summary> private static void OpenOnce(UIComponent ui, string assetName, string uiGroupName) { if (ui.HasUIForm(assetName)) return; ui.OpenUIForm(assetName, uiGroupName); } /// <summary> /// UI 열기 실패를 잡는다. <c>OpenUIForm</c> 은 비동기 fire-and-forget 이라 /// Addressables 주소가 어긋나면 <b>아무 로그도 없이 폼이 영영 뜨지 않는다.</b> /// 엔티티 쪽(<c>ShowEntityFailure</c>)과 같은 대비를 UI 에도 둔다. /// </summary> private void SubscribeUIFailure() { EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) { Log.Error("ProcedureMain: EventComponent 가 없다. UI 열기 실패를 감지하지 못한다."); return; } events.Subscribe(OpenUIFormFailureEventArgs.EventId, OnOpenUIFormFailure); mSubscribedUIFailure = true; } /// <summary>구독한 적이 있을 때만 해지한다. 미등록 핸들러 해지는 코어에서 즉시 예외다.</summary> private void UnsubscribeUIFailure() { if (!mSubscribedUIFailure) return; mSubscribedUIFailure = false; // 종료 순서에 따라 EventComponent 가 먼저 파괴돼 있을 수 있다. EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Unsubscribe(OpenUIFormFailureEventArgs.EventId, OnOpenUIFormFailure); } private void OnOpenUIFormFailure(object sender, GameFramework.Event.GameEventArgs e) { OpenUIFormFailureEventArgs ne = e as OpenUIFormFailureEventArgs; if (ne == null) { GameAssert.Unreachable("ProcedureMain: OpenUIFormFailure 핸들러에 다른 타입이 들어왔다."); return; } Log.Error("UI 폼 '{0}'(그룹 {1}) 열기 실패: {2} — Addressables 주소와 UITable 문자열이 같은지 확인할 것.", ne.UIFormAssetName, ne.UIGroupName, ne.ErrorMessage); } protected override void OnUpdate(ProcedureOwner procedureOwner, float elapseSeconds, float realElapseSeconds) { base.OnUpdate(procedureOwner, elapseSeconds, realElapseSeconds); // OnEnter 가 아직 돌지 않았거나 이미 OnLeave 로 정리된 상태 방어. if (mGame == null) return; mGame.Update(elapseSeconds, realElapseSeconds); } protected override void OnLeave(ProcedureOwner procedureOwner, bool isShutdown) { mGame?.Shutdown(); mGame = null; UnsubscribeUIFailure(); base.OnLeave(procedureOwner, isShutdown); } } }

// Assets/GameMain/Game/ScoreChangedEventArgs.cs using GameFramework; using GameFramework.Event; namespace ToyBoxNightmare { /// <summary> /// 점수가 바뀌었을 때 발행된다. HUD 가 구독한다. /// </summary> public class ScoreChangedEventArgs : GameEventArgs { public static readonly int EventId = typeof(ScoreChangedEventArgs).GetHashCode(); public override int Id => EventId; /// <summary>변경 후 총점.</summary> public int Score { get; private set; } /// <summary>이번에 더해진 값.</summary> public int Delta { get; private set; } public static ScoreChangedEventArgs Create(int score, int delta) { var args = ReferencePool.Acquire<ScoreChangedEventArgs>(); args.Score = score; args.Delta = delta; return args; } public override void Clear() { Score = 0; Delta = 0; } } }

/// <summary>점수를 더하고 ScoreChanged 를 발행한다.</summary> public void AddScore(int delta) { if (delta == 0) return; Score += delta; EventComponent events = RequireEventComponent(); if (events == null) { // Acquire 한 인자를 Fire 하지 못하면 풀에 돌아가지 못하므로, 여기서 만들지 않는다. return; } events.Fire(this, ScoreChangedEventArgs.Create(Score, delta)); }

// Assets/GameMain/Game/PlayerHealthChangedEventArgs.cs using GameFramework; using GameFramework.Event; namespace ToyBoxNightmare { /// <summary> /// 플레이어 체력 비율이 바뀌었을 때 발행된다. HUD 가 구독해 체력 바와 피격 플래시를 갱신한다. /// /// <b>비율이 줄어들 때만 오는 것이 아니다.</b> 스폰 직후에도 한 번 발행되므로 /// (그때는 <see cref="FromRatio"/> 와 <see cref="ToRatio"/> 가 같다) HUD 가 /// 새 판의 만피 상태를 알 수 있다. 피격 연출은 두 값을 비교해서 결정할 것. /// </summary> public class PlayerHealthChangedEventArgs : GameEventArgs { public static readonly int EventId = typeof(PlayerHealthChangedEventArgs).GetHashCode(); public override int Id => EventId; /// <summary>변경 전 체력 비율(0~1).</summary> public float FromRatio { get; private set; } /// <summary>변경 후 체력 비율(0~1).</summary> public float ToRatio { get; private set; } /// <summary>이번 변화가 피해인가. 스폰 시 통보와 구분하는 데 쓴다.</summary> public bool IsDamage => ToRatio < FromRatio; public static PlayerHealthChangedEventArgs Create(float fromRatio, float toRatio) { var args = ReferencePool.Acquire<PlayerHealthChangedEventArgs>(); args.FromRatio = fromRatio; args.ToRatio = toRatio; return args; } public override void Clear() { FromRatio = 0f; ToRatio = 0f; } } }

/// <summary> /// 체력이 줄어들 때마다 HUD 에 알린다. 피격 플래시도 HUD 가 이 값으로 판단한다. /// </summary> protected override void OnHitPointChanged(float fromRatio, float toRatio) { base.OnHitPointChanged(fromRatio, toRatio); FireHealthChanged(fromRatio, toRatio); } /// <summary> /// 체력 변화를 발행한다. HUD 가 없어도 게임이 돌아야 하므로 실패해도 조용히 넘어간다. /// </summary> private void FireHealthChanged(float fromRatio, float toRatio) { EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Fire(this, PlayerHealthChangedEventArgs.Create(fromRatio, toRatio)); }

mWeaponLoadout.Equip(); // 스폰 통보. OnHitPointChanged 는 비율이 **줄어들 때만** 오므로 // 이것 없이는 HUD 가 새 판의 만피를 알 방법이 없다(이전 판 값을 물고 있게 된다). FireHealthChanged(HitPointRatio, HitPointRatio); // 상태 기계는 **맨 마지막**에 세운다. 상태가 OnEnter 에서 소유자 값을 읽기 때문이다. CreateStateMachine();

// Assets/GameMain/Game/WeaponCooldownStartedEventArgs.cs using GameFramework; using GameFramework.Event; namespace ToyBoxNightmare { /// <summary> /// 발사에 성공해 전역 쿨다운이 걸렸을 때 발행된다. HUD 의 쿨다운 게이지가 구독한다. /// /// 쿨다운은 무기별이 아니라 <see cref="WeaponLoadout"/> 이 하나만 든다. /// 그래서 게이지도 하나뿐이고, 마지막으로 쏜 무기의 쿨다운 길이가 실린다. /// Frost 는 쿨다운이 0 이라 아예 발행되지 않는다. /// </summary> public class WeaponCooldownStartedEventArgs : GameEventArgs { public static readonly int EventId = typeof(WeaponCooldownStartedEventArgs).GetHashCode(); public override int Id => EventId; /// <summary>이번에 걸린 쿨다운 길이(초).</summary> public float Cooldown { get; private set; } public static WeaponCooldownStartedEventArgs Create(float cooldown) { var args = ReferencePool.Acquire<WeaponCooldownStartedEventArgs>(); args.Cooldown = cooldown; return args; } public override void Clear() { Cooldown = 0f; } } }

private void BeginCooldown(float cooldown) { mAttackCooldown = Mathf.Max(0f, cooldown); mTimeOfLastAttack = Time.time; // 쿨다운이 0 인 무기(Frost)는 게이지를 건드리지 않는다 — 0 을 넘기면 // HUD 게이지가 가득 찼다가 즉시 비는 깜빡임이 된다. if (mAttackCooldown <= 0f) return; EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Fire(this, WeaponCooldownStartedEventArgs.Create(mAttackCooldown)); }

// Assets/GameMain/UI/HUDForm.cs using GameFramework.Event; using UnityEngine; using UnityEngine.UI; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 게임 중 HUD. 점수 / 체력 / 공격 쿨다운 / 게임오버 문구 / 피격 플래시를 담당한다. /// /// <b>이 스크립트는 프리팹에 직접 붙어 있어야 한다.</b> 엔티티와는 정반대 규약이다. /// /// 갱신은 전부 이벤트 구독으로 하며 게임 로직을 직접 폴링하지 않는다 — /// HUD 가 없어도 게임은 돌아야 하기 때문이다. /// </summary> public class HUDForm : UIFormLogic { // 프리팹 계층 계약. 자식 이름이 바뀌면 조용히 null 이 되므로 한곳에 모아 둔다. private const string HealthSliderPath = "HealthUI/HealthSlider"; private const string DamageImagePath = "DamageImage"; private const string GameOverTextPath = "GameOverText"; private const string InfoTextPath = "InfoText"; private const string AllyButtonPath = "Ally Button"; private const string CountdownPath = "CountdownSlider"; /// <summary>캐릭터를 고르기 전에 띄우는 안내문.</summary> private const string SelectPrompt = "Select a character"; private const string ScoreFormat = "Score: {0}"; /// <summary>맞는 순간 화면에 깔리는 색.</summary> private static readonly Color DamageFlashColor = new Color(1f, 0f, 0f, 0.1f); /// <summary>섬광이 걷히는 속도.</summary> private const float DamageFlashFadeSpeed = 5f; /// <summary>이보다 옅어지면 완전히 지운다. Lerp 는 0 에 닿지 않는다.</summary> private const float DamageFlashMinAlpha = 0.01f; private Slider mHealthSlider = null; private Image mDamageImage = null; private Text mGameOverText = null; private Text mInfoText = null; private GameObject mAllyButton = null; private Slider mCountdownSlider = null; /// <summary>피격 섬광이 걷히는 중인가.</summary> private bool mDamageFlashing = false; /// <summary>무기 쿨다운 게이지에 남은 시간(초). 0 이하면 게이지를 숨긴다.</summary> private float mCooldownRemaining = 0f; private bool mSubscribed = false; // ─── 생명주기 ─── protected internal override void OnInit(object userData) { base.OnInit(userData); mHealthSlider = Find<Slider>(HealthSliderPath); mDamageImage = Find<Image>(DamageImagePath); mGameOverText = Find<Text>(GameOverTextPath); mInfoText = Find<Text>(InfoTextPath); mCountdownSlider = Find<Slider>(CountdownPath); Transform allyButton = CachedTransform.Find(AllyButtonPath); mAllyButton = allyButton != null ? allyButton.gameObject : null; if (mAllyButton == null) { Log.Warning("HUDForm: 자식 {0} 을 찾지 못했다.", AllyButtonPath); } } /// <summary>자식을 경로로 찾고 없으면 한 번 알린다. 조용한 null 이 가장 찾기 어렵다.</summary> private T Find<T>(string path) where T : Component { Transform child = CachedTransform.Find(path); if (child == null) { Log.Warning("HUDForm: 자식 {0} 이 없다. 프리팹 구조를 확인할 것.", path); return null; } T component = child.GetComponent<T>(); if (component == null) { Log.Warning("HUDForm: {0} 에 {1} 컴포넌트가 없다.", path, typeof(T).Name); } return component; } protected internal override void OnOpen(object userData) { base.OnOpen(userData); // UI 폼도 풀에서 재사용된다. 이전 판의 점수와 게임오버 문구를 물고 나오지 않도록 // 구독보다 먼저 화면을 초기 상태로 되돌린다. ResetVisuals(); Subscribe(); } protected internal override void OnClose(bool isShutdown, object userData) { Unsubscribe(); base.OnClose(isShutdown, userData); } /// <summary>캐릭터 선택 직전 상태로 되돌린다.</summary> private void ResetVisuals() { if (mInfoText != null) { mInfoText.text = SelectPrompt; } if (mGameOverText != null) { mGameOverText.enabled = false; } if (mHealthSlider != null) { mHealthSlider.value = mHealthSlider.maxValue; } // 아군 소환 아이콘은 8장에서 쓴다. 그때까지는 꺼 둔다. SetAllyButtonVisible(false); ClearDamageFlash(); HideCooldownGauge(); } // ─── 프레임 갱신 ─── // 게임에게 묻는 것은 없다. 이미 받은 이벤트의 연출을 이어 갈 뿐이다. protected internal override void OnUpdate(float elapseSeconds, float realElapseSeconds) { base.OnUpdate(elapseSeconds, realElapseSeconds); UpdateDamageFlash(elapseSeconds); UpdateCooldownGauge(elapseSeconds); } /// <summary>섬광을 조금씩 걷어 낸다.</summary> private void UpdateDamageFlash(float elapseSeconds) { if (!mDamageFlashing || mDamageImage == null) return; mDamageImage.color = Color.Lerp(mDamageImage.color, Color.clear, DamageFlashFadeSpeed * elapseSeconds); if (mDamageImage.color.a > DamageFlashMinAlpha) return; ClearDamageFlash(); } private void BeginDamageFlash() { if (mDamageImage == null) return; mDamageImage.color = DamageFlashColor; mDamageFlashing = true; } private void ClearDamageFlash() { mDamageFlashing = false; if (mDamageImage != null) { mDamageImage.color = Color.clear; } } /// <summary> /// 쿨다운 게이지를 줄인다. 다 줄면 숨긴다 — 슬라이더의 maxValue 를 0 으로 두면 /// 채움 영역이 사라진다. /// </summary> private void UpdateCooldownGauge(float elapseSeconds) { if (mCooldownRemaining <= 0f || mCountdownSlider == null) return; mCooldownRemaining -= elapseSeconds; if (mCooldownRemaining <= 0f) { HideCooldownGauge(); return; } mCountdownSlider.value = mCooldownRemaining; } private void BeginCooldownGauge(float cooldown) { if (mCountdownSlider == null) return; mCooldownRemaining = cooldown; mCountdownSlider.minValue = 0f; mCountdownSlider.maxValue = cooldown; mCountdownSlider.value = cooldown; } private void HideCooldownGauge() { mCooldownRemaining = 0f; if (mCountdownSlider != null) { mCountdownSlider.minValue = 0f; mCountdownSlider.maxValue = 0f; mCountdownSlider.value = 0f; } } // ─── 이벤트 구독 ─── // 같은 (id, handler) 를 두 번 Subscribe 하거나 미등록 핸들러를 Unsubscribe 하면 // 코어가 즉시 예외를 던진다. mSubscribed 로 짝을 보장한다. private void Subscribe() { if (mSubscribed) return; EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) { Log.Error("HUDForm: EventComponent 가 없다. HUD 가 아무것도 갱신하지 못한다."); return; } events.Subscribe(CharacterSelectedEventArgs.EventId, OnCharacterSelected); events.Subscribe(ScoreChangedEventArgs.EventId, OnScoreChanged); events.Subscribe(PlayerHealthChangedEventArgs.EventId, OnPlayerHealthChanged); events.Subscribe(WeaponCooldownStartedEventArgs.EventId, OnWeaponCooldownStarted); events.Subscribe(PlayerDiedEventArgs.EventId, OnPlayerDied); mSubscribed = true; } private void Unsubscribe() { if (!mSubscribed) return; mSubscribed = false; // 종료 순서에 따라 EventComponent 가 먼저 파괴돼 있을 수 있다. EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Unsubscribe(CharacterSelectedEventArgs.EventId, OnCharacterSelected); events.Unsubscribe(ScoreChangedEventArgs.EventId, OnScoreChanged); events.Unsubscribe(PlayerHealthChangedEventArgs.EventId, OnPlayerHealthChanged); events.Unsubscribe(WeaponCooldownStartedEventArgs.EventId, OnWeaponCooldownStarted); events.Unsubscribe(PlayerDiedEventArgs.EventId, OnPlayerDied); } // ─── 핸들러 ─── /// <summary>캐릭터를 고른 순간 안내문이 점수 표시로 바뀐다.</summary> private void OnCharacterSelected(object sender, GameEventArgs e) { SetScore(0); } private void OnScoreChanged(object sender, GameEventArgs e) { ScoreChangedEventArgs ne = e as ScoreChangedEventArgs; if (ne == null) { GameAssert.Unreachable("HUDForm: ScoreChanged 핸들러에 다른 타입이 들어왔다."); return; } SetScore(ne.Score); } private void SetScore(int score) { if (mInfoText == null) return; mInfoText.text = string.Format(ScoreFormat, score); } private void OnPlayerHealthChanged(object sender, GameEventArgs e) { PlayerHealthChangedEventArgs ne = e as PlayerHealthChangedEventArgs; if (ne == null) { GameAssert.Unreachable("HUDForm: PlayerHealthChanged 핸들러에 다른 타입이 들어왔다."); return; } if (mHealthSlider != null) { mHealthSlider.value = Mathf.Clamp01(ne.ToRatio) * mHealthSlider.maxValue; } // 스폰 통보(비율이 그대로인 경우)에는 화면을 번쩍이지 않는다. if (ne.IsDamage) { BeginDamageFlash(); } } private void OnWeaponCooldownStarted(object sender, GameEventArgs e) { WeaponCooldownStartedEventArgs ne = e as WeaponCooldownStartedEventArgs; if (ne == null) { GameAssert.Unreachable("HUDForm: WeaponCooldownStarted 핸들러에 다른 타입이 들어왔다."); return; } BeginCooldownGauge(ne.Cooldown); } private void SetAllyButtonVisible(bool visible) { if (mAllyButton == null) return; if (mAllyButton.activeSelf == visible) return; mAllyButton.SetActive(visible); } private void OnPlayerDied(object sender, GameEventArgs e) { if (mGameOverText == null) return; mGameOverText.enabled = true; } } }

Select a character

PauseMenuForm ← Canvas (Screen Space - Overlay, Sort Order 100) + PauseMenuForm 스크립트 └ PausePanel ← 화면을 덮는 반투명 판. 이것을 켜고 끈다 ├ PausedText ├ ResumeButton ├ QuitButton ├ AudioToggle ← 소리 켜기/끄기 ├ EffectsSlider ← 효과음 볼륨 └ MusicSlider ← 배경음 볼륨

// Assets/GameMain/UI/PauseMenuForm.cs using UnityEngine; using UnityEngine.Audio; using UnityEngine.InputSystem; using UnityEngine.UI; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 일시정지 메뉴. Esc 로 열고 닫으며 볼륨·음소거·종료를 제공한다. /// /// <b>폼 자체는 판이 시작될 때 열려서 계속 떠 있고, 패널만 켜고 끈다.</b> /// 닫혀 있으면 Esc 를 읽을 주체가 없어지기 때문이다. /// /// <b>이 스크립트는 프리팹에 직접 붙어 있어야 한다</b>(UI 폼 규약 — 엔티티와 정반대). /// </summary> public class PauseMenuForm : UIFormLogic { // 프리팹 계층 계약. private const string PanelPath = "PausePanel"; private const string ResumeButtonPath = "PausePanel/ResumeButton"; private const string QuitButtonPath = "PausePanel/QuitButton"; private const string AudioTogglePath = "PausePanel/AudioToggle"; private const string EffectsSliderPath = "PausePanel/EffectsSlider"; private const string MusicSliderPath = "PausePanel/MusicSlider"; // 믹서에 노출된 파라미터 이름. private const string SfxVolumeParam = "sfxVol"; private const string MusicVolumeParam = "musicVol"; [Tooltip("MasterMixer. 볼륨 슬라이더가 이 믹서의 노출 파라미터를 직접 건드린다.")] [SerializeField] private AudioMixer masterMixer = null; [Tooltip("음소거 스냅샷.")] [SerializeField] private AudioMixerSnapshot mutedSnapshot = null; [Tooltip("음소거 해제 스냅샷.")] [SerializeField] private AudioMixerSnapshot unMutedSnapshot = null; private GameObject mPanel = null; private Button mResumeButton = null; private Button mQuitButton = null; private Toggle mAudioToggle = null; private Slider mEffectsSlider = null; private Slider mMusicSlider = null; // ─── 생명주기 ─── protected internal override void OnInit(object userData) { base.OnInit(userData); Transform panel = CachedTransform.Find(PanelPath); mPanel = panel != null ? panel.gameObject : null; if (mPanel == null) { Log.Error("PauseMenuForm: {0} 을 찾지 못했다. 일시정지 화면이 뜨지 않는다.", PanelPath); } mResumeButton = Find<Button>(ResumeButtonPath); mQuitButton = Find<Button>(QuitButtonPath); mAudioToggle = Find<Toggle>(AudioTogglePath); mEffectsSlider = Find<Slider>(EffectsSliderPath); mMusicSlider = Find<Slider>(MusicSliderPath); // 버튼 연결은 프리팹의 onClick 직렬화가 아니라 코드로 건다. // OnInit 은 인스턴스당 1회라 리스너가 중복되지 않는다. if (mResumeButton != null) mResumeButton.onClick.AddListener(Resume); if (mQuitButton != null) mQuitButton.onClick.AddListener(Quit); if (mAudioToggle != null) mAudioToggle.onValueChanged.AddListener(SetSoundOn); if (mEffectsSlider != null) mEffectsSlider.onValueChanged.AddListener(SetEffectsLevel); if (mMusicSlider != null) mMusicSlider.onValueChanged.AddListener(SetMusicLevel); } private T Find<T>(string path) where T : Component { Transform child = CachedTransform.Find(path); if (child == null) { Log.Warning("PauseMenuForm: 자식 {0} 이 없다.", path); return null; } T component = child.GetComponent<T>(); if (component == null) { Log.Warning("PauseMenuForm: {0} 에 {1} 컴포넌트가 없다.", path, typeof(T).Name); } return component; } protected internal override void OnOpen(object userData) { base.OnOpen(userData); // 폼은 판 내내 떠 있지만 패널은 닫힌 상태로 시작한다. SetPanelActive(false); GamePause.SetPaused(false); PullVolumeFromMixer(); } protected internal override void OnClose(bool isShutdown, object userData) { // 정지 상태로 판을 벗어나면 timeScale 이 0 인 채로 남아 다음 판이 통째로 멈춘다. GamePause.Clear(); base.OnClose(isShutdown, userData); } /// <summary> /// 정지 중에도 돌아야 한다. /// (UIFormLogic.OnUpdate 는 timeScale 과 무관하게 매 프레임 불린다.) /// </summary> protected internal override void OnUpdate(float elapseSeconds, float realElapseSeconds) { base.OnUpdate(elapseSeconds, realElapseSeconds); if (!IsCancelPressed()) return; Toggle(); } /// <summary>Esc. 키보드가 없으면 무시한다.</summary> private static bool IsCancelPressed() { Keyboard keyboard = Keyboard.current; return keyboard != null && keyboard.escapeKey.wasPressedThisFrame; } // ─── 정지 토글 ─── public void Toggle() { bool paused = !GamePause.IsPaused; GamePause.SetPaused(paused); SetPanelActive(paused); } public void Resume() { GamePause.SetPaused(false); SetPanelActive(false); } private void SetPanelActive(bool active) { if (mPanel == null) return; if (mPanel.activeSelf == active) return; mPanel.SetActive(active); } // ─── 오디오 ─── /// <summary>믹서의 현재 값을 슬라이더에 반영한다.</summary> private void PullVolumeFromMixer() { if (masterMixer == null) { Log.Warning("PauseMenuForm: MasterMixer 가 지정되지 않았다. 볼륨 조절이 동작하지 않는다."); return; } if (mEffectsSlider != null && masterMixer.GetFloat(SfxVolumeParam, out float sfx)) { mEffectsSlider.SetValueWithoutNotify(sfx); } if (mMusicSlider != null && masterMixer.GetFloat(MusicVolumeParam, out float music)) { mMusicSlider.SetValueWithoutNotify(music); } } public void SetEffectsLevel(float level) { if (masterMixer == null) return; masterMixer.SetFloat(SfxVolumeParam, level); } public void SetMusicLevel(float level) { if (masterMixer == null) return; masterMixer.SetFloat(MusicVolumeParam, level); } /// <summary>음소거는 볼륨 값이 아니라 스냅샷 전환으로 한다.</summary> public void SetSoundOn(bool soundOn) { AudioMixerSnapshot snapshot = soundOn ? unMutedSnapshot : mutedSnapshot; if (snapshot == null) { Log.Warning("PauseMenuForm: 오디오 스냅샷이 지정되지 않았다."); return; } snapshot.TransitionTo(0f); } // ─── 종료 ─── public void Quit() { // 프레임워크를 먼저 내린다(모듈 정리 → 종료). 에디터에서는 재생을 멈춘다. GameEntry.Shutdown(ShutdownType.Quit); } } }

OpenOnce(ui, UITable.HudForm, UITable.DefaultGroup); OpenOnce(ui, UITable.PauseMenuForm, UITable.PopupGroup);

// Assets/GameMain/UI/UIFormBase.cs using UnityEngine; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 이 게임의 UI 폼 공통 베이스. <see cref="EntityLogicBase"/> 의 UI 쪽 짝이다. /// /// <b>폼이 겹치는 순서를 프레임워크의 UI 그룹이 정하게 한다.</b> UIComponent 는 폼을 열고 /// 닫고 앞으로 가져올 때마다 <see cref="OnDepthChanged"/> 로 "몇 번째 깊이의 그룹에서 /// 몇 번째 폼인가" 를 알려 준다. 여기서 그 값을 폼 Canvas 의 sortingOrder 로 옮긴다. /// 그래서 프리팹 Canvas 에 적힌 sortingOrder 는 쓰이지 않는다 — 순서를 바꾸려면 /// GameFramework.prefab 의 UI 그룹 깊이나, 폼을 여는 그룹(<see cref="UITable"/>)을 바꾼다. /// </summary> public abstract class UIFormBase : UIFormLogic { /// <summary>UI 그룹 깊이 1 이 차지하는 sortingOrder 폭. 그룹 하나에 폼이 100개를 넘지 않는 한 그룹끼리 섞이지 않는다.</summary> private const int GroupDepthFactor = 10000; /// <summary>그룹 안에서 폼 하나가 차지하는 sortingOrder 폭. 폼 안에 하위 Canvas 를 둘 여유를 남긴다.</summary> private const int FormDepthFactor = 100; private Canvas mCanvas = null; protected internal override void OnInit(object userData) { base.OnInit(userData); mCanvas = GetComponent<Canvas>(); if (mCanvas == null) { Log.Warning("{0}: 루트에 Canvas 가 없다. UI 그룹 깊이가 화면 순서에 반영되지 않는다.", Name); } } /// <summary> /// 그룹 안의 순서가 바뀔 때마다 불린다. 폼이 열린 직후에도 한 번 온다 /// (코어 UIManager.InternalOpenUIForm 이 OnOpen 다음에 그룹을 Refresh 한다). /// </summary> protected internal override void OnDepthChanged(int uiGroupDepth, int depthInUIGroup) { base.OnDepthChanged(uiGroupDepth, depthInUIGroup); if (mCanvas == null) return; mCanvas.sortingOrder = GroupDepthFactor * uiGroupDepth + FormDepthFactor * depthInUIGroup; } } }

public class HUDForm : UIFormBase

public class PauseMenuForm : UIFormBase