08. 아군 소환과 사운드

// Assets/GameMain/Game/AllyTable.cs using UnityEngine; namespace ToyBoxNightmare { /// <summary> /// 아군(양) 튜닝값. /// </summary> public static class AllyTable { /// <summary>Addressables 주소.</summary> public const string Asset = "Sheep"; /// <summary>엔티티 그룹. GameFramework.prefab 의 mEntityGroups 와 이름이 같아야 한다.</summary> public const string Group = "Ally"; /// <summary>소환 비용(점수).</summary> public const int Cost = 30; /// <summary>소환 후 유지 시간(초).</summary> public const float Duration = 10f; /// <summary>소환 위치.</summary> public static readonly Vector3 SpawnPosition = new Vector3(29.93f, 0f, 4.61f); /// <summary>EntityData 의 TypeId. 아직 타입 테이블이 없어 프로젝트 전체가 1 이다.</summary> public const int EntityTypeId = 1; } }

// Assets/GameMain/Entity/EntityData/AllyData.cs using GameFramework; using UnityEngine; namespace ToyBoxNightmare { /// <summary> /// 아군 스폰 데이터. /// /// 아군은 소환 시점에 목적지를 <b>한 번만</b> 받고 그리로 걸어간다. /// 그래서 목적지가 런타임 상태가 아니라 스폰 인자다. /// </summary> public class AllyData : EntityData { /// <summary>소환 직후 걸어갈 목적지. 소환 시점의 플레이어 위치를 넣는다.</summary> public Vector3 MoveDestination { get; private set; } public static AllyData Create(int entityId, int typeId, Vector3 position, Vector3 moveDestination) { var data = ReferencePool.Acquire<AllyData>(); data.Fill(entityId, typeId); data.Position = position; data.MoveDestination = moveDestination; return data; } public override void Clear() { base.Clear(); MoveDestination = Vector3.zero; } } }

// Assets/GameMain/Entity/EntityLogic/Ally.cs using UnityEngine; using UnityEngine.AI; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 아군(양). 소환되면 목적지로 한 번 걸어갈 뿐 아무것도 하지 않는다 — /// <b>미끼다.</b> 적이 아군을 쫓게 만드는 것은 아군 자신이 아니라 /// 적이 <see cref="EntityFinder.FindAlly"/> 로 아군을 찾아 그 좌표를 쫓기 때문이다. /// </summary> public class Ally : EntityLogicBase { private NavMeshAgent mAgent = null; private AllyData mAllyData = null; /// <summary>적이 쫓을 좌표. 회수된 뒤에는 의미가 없으므로 호출부가 Available 을 먼저 볼 것.</summary> public Vector3 LurePosition => CachedTransform.position; protected internal override void OnInit(object userData) { base.OnInit(userData); mAgent = GetComponent<NavMeshAgent>(); if (mAgent == null) { Log.Warning("Ally: NavMeshAgent 가 없다. 소환 위치에 그대로 서 있게 된다."); } } protected internal override void OnShow(object userData) { base.OnShow(userData); mAllyData = userData as AllyData; if (mAllyData == null) { Log.Error("Ally: AllyData 가 아니다. 회수한다."); SafeHide(); return; } PlaceOnNavMesh(mAllyData.Position); MoveTo(mAllyData.MoveDestination); } protected internal override void OnHide(bool isShutdown, object userData) { StopAgent(); mAllyData = null; base.OnHide(isShutdown, userData); } /// <summary> /// 스폰 좌표로 옮기고 NavMesh 폴리곤 위로 스냅한다. /// (Enemy 와 같은 절차다 — 에이전트가 켜진 채 transform 을 옮기면 Unity 가 경고를 낸다.) /// </summary> private void PlaceOnNavMesh(Vector3 position) { if (mAgent == null) { CachedTransform.position = position; return; } mAgent.enabled = false; CachedTransform.position = position; mAgent.enabled = true; mAgent.Warp(position); if (mAgent.isOnNavMesh) { mAgent.isStopped = false; } } /// <summary>목적지를 한 번만 준다. 이후 재조준하지 않는다.</summary> private void MoveTo(Vector3 destination) { if (mAgent == null || !mAgent.enabled || !mAgent.isOnNavMesh) return; mAgent.SetDestination(destination); } /// <summary>회수 전에 반드시 멈춘다. 켜진 채로 풀에 들어가면 다음 소환에서 옛 경로를 이어 간다.</summary> private void StopAgent() { if (mAgent == null || !mAgent.enabled) return; if (mAgent.isOnNavMesh) { mAgent.isStopped = true; mAgent.ResetPath(); } mAgent.enabled = false; } } }

// Assets/GameMain/Game/AllyAvailabilityChangedEventArgs.cs using GameFramework; using GameFramework.Event; namespace ToyBoxNightmare { /// <summary> /// 아군을 소환할 수 있는지가 바뀌었을 때 발행된다. HUD 의 아군 아이콘이 구독한다. /// /// 매 점수 획득마다 쏘지 않고 <b>가부가 실제로 뒤집힐 때만</b> 발행한다 — /// 적 하나 잡을 때마다 같은 값을 반복 통보하면 HUD 가 매번 헛일을 한다. /// </summary> public class AllyAvailabilityChangedEventArgs : GameEventArgs { public static readonly int EventId = typeof(AllyAvailabilityChangedEventArgs).GetHashCode(); public override int Id => EventId; /// <summary>지금 소환할 수 있는가.</summary> public bool CanSummon { get; private set; } public static AllyAvailabilityChangedEventArgs Create(bool canSummon) { var args = ReferencePool.Acquire<AllyAvailabilityChangedEventArgs>(); args.CanSummon = canSummon; return args; } public override void Clear() { CanSummon = false; } } }

// Assets/GameMain/Game/AllySquad.cs using UnityEngine; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 아군 소환 경제. 점수를 소환 포인트로 쌓고, 한 마리를 정해진 시간만 유지한다. /// /// <see cref="SurvivalGame"/> 이 소유하는 순수 객체다. /// 판 단위 상태라 게임 객체가 들고 있는 편이 수명이 맞는다. /// /// <b>미끼 역할은 여기서 하지 않는다.</b> 적은 <see cref="EntityFinder.FindAlly"/> 로 떠 있는 /// 아군 엔티티를 직접 찾아 그 좌표(<see cref="Ally.LurePosition"/>)를 쫓는다. /// </summary> public class AllySquad { /// <summary>"소환된 아군 없음" 을 뜻하는 엔티티 Id. EntitySerialId 는 1부터 발급한다.</summary> private const int NoAllyId = 0; private int mPoints = 0; private int mAllyEntityId = NoAllyId; private Ally mAlly = null; private float mRemainingSeconds = 0f; /// <summary> /// 로드가 끝나기 전에 회수 요청이 들어왔는지. ShowEntity 는 비동기라 /// 소환 직후 판이 끝나면 아군이 <b>다음 판에</b> 나타날 수 있다. /// </summary> private bool mUnsummonRequested = false; /// <summary>마지막으로 통보한 가부. 값이 뒤집힐 때만 이벤트를 쏜다.</summary> private bool mNotifiedCanSummon = false; /// <summary>지금 소환할 수 있는가.</summary> public bool CanSummon => mPoints >= AllyTable.Cost && !HasAlly; /// <summary>소환된(또는 소환 중인) 아군이 있는가.</summary> public bool HasAlly => mAllyEntityId != NoAllyId; // ─── 판 생명주기 ─── /// <summary>새 판 시작. 포인트와 아군 상태를 전부 지운다.</summary> public void Reset() { mPoints = 0; mAllyEntityId = NoAllyId; mAlly = null; mRemainingSeconds = 0f; mUnsummonRequested = false; // 판이 바뀌면 HUD 아이콘도 반드시 꺼져야 하므로 강제로 통보한다. mNotifiedCanSummon = true; NotifyAvailability(); } /// <summary>점수를 얻을 때마다 같은 양이 소환 포인트로 쌓인다.</summary> public void AddPoints(int amount) { if (amount <= 0) return; mPoints += amount; NotifyAvailability(); } // ─── 소환 / 회수 ─── /// <summary> /// 소환을 시도한다. 성공하면 true. /// destination 은 아군이 걸어갈 목적지이며, 소환 시점의 플레이어 위치를 넣는다. /// </summary> public bool TrySummon(Vector3 destination) { if (!CanSummon) return false; EntityComponent entityComponent = GameEntry.GetComponent<EntityComponent>(); if (entityComponent == null) { Log.Error("AllySquad: EntityComponent 가 없다. 아군을 소환할 수 없다."); return false; } int id = EntitySerialId.Next(); // 아군이 실제로 뜨기 전에 상태를 먼저 세운다. ShowEntity 가 비동기라 // 여기서 세우지 않으면 로드가 끝나기 전에 한 번 더 소환될 수 있다. mAllyEntityId = id; mAlly = null; mRemainingSeconds = AllyTable.Duration; mUnsummonRequested = false; entityComponent.ShowEntity( id, typeof(Ally), AllyTable.Asset, AllyTable.Group, AllyData.Create(id, AllyTable.EntityTypeId, AllyTable.SpawnPosition, destination)); NotifyAvailability(); return true; } /// <summary> /// <see cref="SurvivalGame.OnShowEntitySuccess"/> 가 아군 엔티티를 넘겨준다. /// 로드 중에 회수 요청이 들어왔다면 여기서 즉시 되돌린다. /// </summary> public void CacheAlly(Entity entity) { if (entity == null) return; Ally ally = entity.Logic as Ally; if (ally == null) { GameAssert.Unreachable("AllySquad: Ally 로직이 아닌 엔티티가 넘어왔다."); return; } // 이 판의 소환이 아니다(이전 판의 잔여 로드). 바로 돌려보낸다. if (entity.Id != mAllyEntityId || mUnsummonRequested) { ally.SafeHide(); return; } mAlly = ally; } /// <summary> /// 아군을 거둔다. <b>포인트도 함께 몰수된다.</b> /// 한 번 부르면 다시 30점을 모아야 한다. /// </summary> public void Unsummon() { if (!HasAlly) return; if (mAlly != null && mAlly.Available) { mAlly.SafeHide(); } else { // 아직 로드 중이다. 도착하는 순간 CacheAlly 가 되돌린다. mUnsummonRequested = true; } mPoints = 0; mAllyEntityId = NoAllyId; mAlly = null; mRemainingSeconds = 0f; NotifyAvailability(); } // ─── 갱신 ─── public void OnUpdate(float elapseSeconds) { if (!HasAlly) return; // 판 정리 등으로 아군이 밖에서 회수됐을 수 있다. 그 경우 타이머를 기다리지 않고 정리한다. if (mAlly != null && !mAlly.Available) { Unsummon(); return; } mRemainingSeconds -= elapseSeconds; if (mRemainingSeconds > 0f) return; Unsummon(); } // ─── HUD 통보 ─── private void NotifyAvailability() { bool canSummon = CanSummon; if (canSummon == mNotifiedCanSummon) return; mNotifiedCanSummon = canSummon; EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Fire(this, AllyAvailabilityChangedEventArgs.Create(canSummon)); } } }

/// <summary>아군 소환 경제. 판 단위 상태라 게임 객체가 소유한다.</summary> private readonly AllySquad mAllySquad = new AllySquad();

/// <summary> /// 아군 소환 입력. 숫자 1. /// 무기 전환(Tab)·발사(좌클릭)와 겹치지 않는다. /// </summary> private void ReadAllySummonInput() { if (GamePause.IsPaused) return; // 키보드가 없을 수 있다(패드만 연결된 경우 등). Keyboard keyboard = Keyboard.current; if (keyboard == null || !keyboard.digit1Key.wasPressedThisFrame) return; Player player = Player; if (player == null) return; // 소환 시점의 플레이어 위치를 목적지로 준다. 아군은 그리로 한 번 걸어갈 뿐이다. mAllySquad.TrySummon(player.CachedTransform.position); }

mGameTime += elapseSeconds; ReadAllySummonInput(); mAllySquad.OnUpdate(elapseSeconds); mSpawner.OnUpdate(elapseSeconds);

Score += delta; // 점수는 곧 소환 포인트다. mAllySquad.AddPoints(delta);

if (ne.EntityLogicType == typeof(Ally)) { mAllySquad.CacheAlly(ne.Entity); return; }

/// <summary>지금 떠 있는 아군. 소환하지 않았거나 아직 로드 중이면 null 이다.</summary> public static Ally FindAlly() { return Find<Ally>(AllyTable.Group); }

mAgent.SetDestination(GetDestination(playerPosition, playerPosition));

// 추적 목적지는 발밑(트랜스폼 원점)이다. 공격 판정만 콜라이더 중심을 쓴다. Vector3 playerPosition = player.CachedTransform.position; mAgent.SetDestination(GetDestination(playerPosition, ResolveChasePosition(playerPosition)));

/// <summary> /// 지금 쫓을 좌표. 아군이 소환돼 있으면 아군이고, 아니면 플레이어다. /// /// 0.5초마다 <b>폴링</b>한다. 이벤트로 바꾸지 않는다 — /// 소환 직후 적이 한 박자 늦게 방향을 트는 그 지연이 손맛이다. /// </summary> private static Vector3 ResolveChasePosition(Vector3 playerPosition) { // 아군이 실제로 화면에 서 있을 때만 아군을 쫓는다. 소환 직후 로드가 끝나기 전에는 // 플레이어를 그대로 쫓는다. Ally ally = EntityFinder.FindAlly(); if (ally == null) return playerPosition; return ally.LurePosition; }

events.Subscribe(AllyAvailabilityChangedEventArgs.EventId, OnAllyAvailabilityChanged);

events.Unsubscribe(AllyAvailabilityChangedEventArgs.EventId, OnAllyAvailabilityChanged);

/// <summary>소환 가부가 뒤집힐 때만 온다. 매 점수마다 오지 않는다.</summary> private void OnAllyAvailabilityChanged(object sender, GameEventArgs e) { AllyAvailabilityChangedEventArgs ne = e as AllyAvailabilityChangedEventArgs; if (ne == null) { GameAssert.Unreachable("HUDForm: AllyAvailabilityChanged 핸들러에 다른 타입이 들어왔다."); return; } SetAllyButtonVisible(ne.CanSummon); }

soundComponent.PlaySound("PlayerHurt", "Soundeffects", worldPosition); // ↑ Addressables 주소 ↑ 사운드 그룹 ↑ 어디서 나는 소리인가

// Assets/GameMain/Game/SoundTable.cs namespace ToyBoxNightmare { /// <summary> /// 사운드 그룹 이름과 Addressables 주소를 모아 둔다. /// /// <b>그룹 이름은 AudioMixer 의 그룹 이름과 정확히 같아야 한다.</b> /// SoundComponent 가 <c>Master/{그룹이름}</c> 으로 믹서 그룹을 찾고, /// 못 찾으면 조용히 Master 로 떨어진다 — 그러면 볼륨 슬라이더가 안 먹는다. /// MasterMixer 의 그룹은 Master / Music / Soundeffects 다. /// </summary> public static class SoundTable { // ─── 사운드 그룹 ─── /// <summary>배경음악. 동시에 한 곡만 나오면 되므로 에이전트 1개.</summary> public const string MusicGroup = "Music"; /// <summary>효과음. 피격·사망이 겹치므로 에이전트를 여러 개 둔다.</summary> public const string SfxGroup = "Soundeffects"; // ─── Addressables 주소 ─── public const string BackgroundMusic = "BackgroundMusic"; // 무기·상태 이상. 주소가 엔티티 프리팹의 주소(LightningHit, StinkHit …)와 겹치지 않게 Sound 를 붙였다 — // Addressables 주소는 에셋 종류와 무관하게 하나의 이름공간이다. public const string LightningFire = "LightningFireSound"; public const string LightningHit = "LightningHitSound"; public const string FrostConeLoop = "FrostConeLoopSound"; public const string StinkFire = "StinkFireSound"; public const string StinkHit = "StinkHitSound"; public const string SlimeHit = "SlimeHitSound"; public const string EnemyFreeze = "EnemyFreezeSound"; public const string EnemySlimeLoop = "EnemySlimeLoopSound"; public const string PlayerHurt = "PlayerHurt"; public const string PlayerDeath = "PlayerDeath"; // 적 종별 클립. 클립이 있는 종은 셋뿐이라(ZomBunny / ZomBear / Hellephant) // 나머지 둘은 체급이 비슷한 쪽을 빌려 쓴다. 전용 클립이 생기면 여기만 고치면 된다. private const string ZomBunnyHurt = "ZomBunnyHurt"; private const string ZomBunnyDeath = "ZomBunnyDeath"; private const string ZomBearHurt = "ZomBearHurt"; private const string ZomBearDeath = "ZomBearDeath"; private const string HellephantHurt = "HellephantHurt"; private const string HellephantDeath = "HellephantDeath"; /// <summary>적 종의 Addressables 주소로 피격음 주소를 얻는다. 모르는 종이면 null.</summary> public static string GetEnemyHurtSound(string enemyAssetName) { switch (enemyAssetName) { case "Zombunny": return ZomBunnyHurt; case "ZombieDuck": return ZomBunnyHurt; // 대역 — 전용 클립 없음 case "ZomBear": return ZomBearHurt; case "Clown": return ZomBearHurt; // 대역 — 전용 클립 없음 case "Hellephant": return HellephantHurt; default: return null; } } /// <summary>적 종의 Addressables 주소로 사망음 주소를 얻는다. 모르는 종이면 null.</summary> public static string GetEnemyDeathSound(string enemyAssetName) { switch (enemyAssetName) { case "Zombunny": return ZomBunnyDeath; case "ZombieDuck": return ZomBunnyDeath; // 대역 case "ZomBear": return ZomBearDeath; case "Clown": return ZomBearDeath; // 대역 case "Hellephant": return HellephantDeath; default: return null; } } } }

// Assets/GameMain/Utility/GameSound.cs using GameFramework.Sound; using UnityEngine; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 게임이 소리를 내는 유일한 창구. 전부 <see cref="SoundComponent"/> 로 간다. /// /// <b>프리팹에 AudioSource 를 박아 두고 직접 <c>Play()</c> 하지 않는다.</b> 그렇게 낸 소리는 /// 프레임워크의 사운드 그룹을 거치지 않아서 볼륨 설정·동시 재생 수 제한이 /// 하나도 먹지 않는다. 클립은 Addressables 에 등록하고 주소(<see cref="SoundTable"/>)로 재생한다. /// </summary> public static class GameSound { /// <summary>재생 중인 소리가 없음을 뜻하는 일련번호. 프레임워크는 1부터 발급한다.</summary> public const int NoSound = 0; /// <summary>반복음의 우선순위. 에이전트가 모자랄 때 한 번 울리고 끝나는 효과음보다 늦게 밀려난다.</summary> private const int LoopPriority = 1; /// <summary> /// 배경음악을 틀어 준 <see cref="SoundComponent"/>. 음악은 판이 바뀌어도 끊지 않으므로, /// "이 프레임워크 인스턴스에서 이미 틀었는가" 만 기억하면 된다. /// </summary> private static SoundComponent sMusicOwner = null; /// <summary> /// 한 번 울리고 끝나는 효과음. /// /// 주소가 비어 있거나 사운드 시스템이 없으면 조용히 넘어간다 — /// 소리가 안 나는 것이 게임을 멈출 이유는 되지 않는다. /// </summary> public static void PlaySfx(string assetName, Vector3 worldPosition) { if (string.IsNullOrEmpty(assetName)) return; SoundComponent sound = GameEntry.GetComponent<SoundComponent>(); if (sound == null) return; sound.PlaySound(assetName, SoundTable.SfxGroup, worldPosition); } /// <summary> /// 멈출 때까지 반복하는 효과음(냉기 분사, 슬라임 지속음). 돌려준 일련번호를 /// <see cref="Stop"/> 에 넘겨 끈다. 재생하지 못했으면 <see cref="NoSound"/>. /// </summary> public static int PlayLoop(string assetName, Vector3 worldPosition, float volume) { if (string.IsNullOrEmpty(assetName)) return NoSound; SoundComponent sound = GameEntry.GetComponent<SoundComponent>(); if (sound == null) return NoSound; // PlaySoundParams 는 참조 풀 객체다. 넘기고 나면 프레임워크가 반납한다. PlaySoundParams playSoundParams = PlaySoundParams.Create(); playSoundParams.Loop = true; playSoundParams.VolumeInSoundGroup = volume; return sound.PlaySound(assetName, SoundTable.SfxGroup, LoopPriority, playSoundParams, worldPosition); } /// <summary> /// <see cref="PlayLoop"/> 로 낸 소리를 끈다. 아직 로드 중이어도 된다 — /// 프레임워크가 로드가 끝나는 순간 재생하지 않고 버린다. /// </summary> public static void Stop(int serialId) { if (serialId == NoSound) return; SoundComponent sound = GameEntry.GetComponent<SoundComponent>(); if (sound == null) return; // 이미 끝난 소리면 false 가 돌아올 뿐이다. sound.StopSound(serialId); } /// <summary> /// 배경음악을 튼다. 이미 틀었으면 아무것도 하지 않는다 — /// 판을 다시 시작할 때마다 불려도 음악이 처음으로 돌아가지 않는다. /// </summary> public static void PlayMusic() { SoundComponent sound = GameEntry.GetComponent<SoundComponent>(); if (sound == null) return; // 프레임워크가 다시 만들어지면(에디터에서 재생을 다시 누르는 경우 등) 예전 컴포넌트는 // 파괴된 뒤라 지금 것과 같지 않다. 그때는 다시 튼다. if (sMusicOwner == sound) return; sMusicOwner = sound; PlaySoundParams playSoundParams = PlaySoundParams.Create(); playSoundParams.Loop = true; sound.PlaySound(SoundTable.BackgroundMusic, SoundTable.MusicGroup, playSoundParams); } } }

WeaponUtil.SpawnEffect(typeof(HitEffect), WeaponTable.LightningHitAsset, hit.point, Quaternion.identity, WeaponTable.LightningHitLifetime); GameSound.PlaySfx(SoundTable.LightningHit, hit.point);

private void PlayBolt(Vector3 endPoint) { GameSound.PlaySfx(SoundTable.LightningFire, MuzzleOrigin); if (mBolt != null) { mBolt.Play(endPoint); } }

/// <summary> /// 발사음의 Addressables 주소. 없으면 null. 소리는 프리팹에 박아 두지 않고 /// <see cref="GameSound"/> 로 낸다. /// </summary> protected virtual string LaunchSound => null;

protected void PlayEffects() { PlayParticles(); GameSound.PlaySfx(LaunchSound, CachedTransform.position); }

protected override string LaunchSound => SoundTable.StinkFire;

GameSound.PlaySfx(SoundTable.StinkHit, impactPoint);

GameSound.PlaySfx(SoundTable.SlimeHit, CachedTransform.position);

/// <summary>분사음의 볼륨.</summary> private const float ConeSoundVolume = 0.85f; /// <summary>재생 중인 분사음. 없으면 <see cref="GameSound.NoSound"/>.</summary> private int mConeSoundId = GameSound.NoSound;

private void SetConeActive(bool active) { if (mFrostCone != null && mFrostCone.activeSelf != active) { mFrostCone.SetActive(active); } SetConeSoundActive(active); } /// <summary> /// 콘이 켜져 있는 동안 분사음을 반복한다. /// 켜고 끄는 호출이 매 프레임 올 수 있으므로 상태가 바뀔 때만 프레임워크에 요청한다. /// </summary> private void SetConeSoundActive(bool active) { bool isPlaying = mConeSoundId != GameSound.NoSound; if (isPlaying == active) return; if (!active) { GameSound.Stop(mConeSoundId); mConeSoundId = GameSound.NoSound; return; } mConeSoundId = GameSound.PlayLoop(SoundTable.FrostConeLoop, CachedTransform.position, ConeSoundVolume); }

/// <summary>빙결 VFX 토글. 프리팹에 FreezeFx 자식이 없으면 조용히 무시된다.</summary> internal void SetFreezeFxActive(bool active) { // 소리는 연출이 꺼져 있다가 켜지는 순간에만 한 번 낸다. bool turnsOn = active && mFreezeFx != null && !mFreezeFx.activeSelf; SetFxActive(mFreezeFx, active); if (turnsOn) { GameSound.PlaySfx(SoundTable.EnemyFreeze, CachedTransform.position); } } /// <summary>재생 중인 슬라임 지속음. 없으면 <see cref="GameSound.NoSound"/>.</summary> private int mSlimeLoopSoundId = GameSound.NoSound; /// <summary>슬라임 VFX 토글. 프리팹에 SlimeFx 자식이 없으면 조용히 무시된다.</summary> internal void SetSlimeFxActive(bool active) { SetFxActive(mSlimeFx, active); // 슬라임이 붙어 있는 동안 지속음을 낸다. 떼어질 때(만료·사망·회수) 반드시 끈다 — // 이 함수는 ClearAll 을 통해 그 모든 경로에서 false 로 불린다. if (!active) { GameSound.Stop(mSlimeLoopSoundId); mSlimeLoopSoundId = GameSound.NoSound; return; } if (mSlimeLoopSoundId != GameSound.NoSound) return; mSlimeLoopSoundId = GameSound.PlayLoop(SoundTable.EnemySlimeLoop, CachedTransform.position, 1f); }

Log.Info("ProcedureMain: Enter"); // 배경음악은 SoundComponent 로 튼다. 이미 나오고 있으면 그대로 둔다. GameSound.PlayMusic();

/// <summary>피격음. 사망 여부와 무관하게 매 피격 울린다.</summary> protected override void OnDamaged(Entity attacker, int damageHitPoints) { base.OnDamaged(attacker, damageHitPoints); GameSound.PlaySfx(SoundTable.PlayerHurt, CenterPosition); }

mDying = true; mDeathTimer = 0f; GameSound.PlaySfx(SoundTable.PlayerDeath, CenterPosition);

protected override void OnDamaged(Entity attacker, int damageHitPoints) { if (mHitParticles != null) { mHitParticles.Play(); } GameSound.PlaySfx(SoundTable.GetEnemyHurtSound(AssetName), CachedTransform.position); } /// <summary> /// 사운드 주소를 고르는 데 쓰는 종 이름. Addressables 주소와 같다("Zombunny" 등). /// </summary> private string AssetName => Entity != null ? Entity.EntityAssetName : string.Empty;

mDeathTimer = 0f; GameSound.PlaySfx(SoundTable.GetEnemyDeathSound(AssetName), CachedTransform.position);