feat: 스켈레톤 코드 작성

Author: ImGdevel

Assets/Domain/Character/Script/Controller/CharacterActionDTOs.cs

@@ -0,0 +1,233 @@
+using System;
+
+namespace ProjectVG.Domain.Character.Service
+{
+	/// <summary>
+	/// 캐릭터 액션 요청을 나타내는 DTO
+	/// </summary>
+	[Serializable]
+	public struct CharacterActionRequest
+	{
+		/// <summary>
+		/// 대상 캐릭터 ID
+		/// </summary>
+		public string CharacterId;
+
+		/// <summary>
+		/// 액션 키 (예: "happy", "wave", "nod")
+		/// </summary>
+		public string ActionKey;
+
+		/// <summary>
+		/// 액션 강도 (0.0 ~ 1.0)
+		/// </summary>
+		public float Intensity;
+
+		/// <summary>
+		/// 액션 지속 시간 (밀리초, null이면 기본값 사용)
+		/// </summary>
+		public int? DurationMs;
+
+		/// <summary>
+		/// 액션 우선순위
+		/// </summary>
+		public CharacterActionPriority Priority;
+
+		/// <summary>
+		/// 액션 취소 정책
+		/// </summary>
+		public CharacterCancelPolicy CancelPolicy;
+
+		public CharacterActionRequest(string characterId, string actionKey, float intensity = 1.0f, int? durationMs = null, CharacterActionPriority priority = CharacterActionPriority.Normal, CharacterCancelPolicy cancelPolicy = CharacterCancelPolicy.Replace)
+		{
+			CharacterId = characterId;
+			ActionKey = actionKey;
+			Intensity = intensity;
+			DurationMs = durationMs;
+			Priority = priority;
+			CancelPolicy = cancelPolicy;
+		}
+	}
+
+	/// <summary>
+	/// 캐릭터 액션 핸들 (액션 실행 추적용)
+	/// </summary>
+	[Serializable]
+	public struct CharacterActionHandle
+	{
+		/// <summary>
+		/// 액션 고유 ID
+		/// </summary>
+		public string ActionId;
+
+		/// <summary>
+		/// 액션 상태
+		/// </summary>
+		public CharacterActionStatus Status;
+
+		public CharacterActionHandle(string actionId, CharacterActionStatus status = CharacterActionStatus.Pending)
+		{
+			ActionId = actionId;
+			Status = status;
+		}
+	}
+
+	/// <summary>
+	/// 캐릭터 액션 상태 정보
+	/// </summary>
+	[Serializable]
+	public struct CharacterActionState
+	{
+		/// <summary>
+		/// 현재 실행 중인 액션 ID
+		/// </summary>
+		public string CurrentActionId;
+
+		/// <summary>
+		/// 현재 실행 중인 액션 키
+		/// </summary>
+		public string CurrentActionKey;
+
+		/// <summary>
+		/// 액션이 재생 중인지 여부
+		/// </summary>
+		public bool IsPlaying;
+
+		/// <summary>
+		/// 음성 게이트가 활성화되어 있는지 여부
+		/// </summary>
+		public bool IsVoiceGated;
+
+		public CharacterActionState(string currentActionId = null, string currentActionKey = null, bool isPlaying = false, bool isVoiceGated = false)
+		{
+			CurrentActionId = currentActionId;
+			CurrentActionKey = currentActionKey;
+			IsPlaying = isPlaying;
+			IsVoiceGated = isVoiceGated;
+		}
+	}
+
+	/// <summary>
+	/// 해석된 캐릭터 액션 정보
+	/// </summary>
+	[Serializable]
+	public struct CharacterResolvedAction
+	{
+		/// <summary>
+		/// 표현식 키
+		/// </summary>
+		public string ExpressionKey;
+
+		/// <summary>
+		/// 모션 키
+		/// </summary>
+		public string MotionKey;
+
+		/// <summary>
+		/// 지속 시간 (밀리초)
+		/// </summary>
+		public int? DurationMs;
+
+		/// <summary>
+		/// 블렌드 인 시간 (초)
+		/// </summary>
+		public float BlendInSec;
+
+		/// <summary>
+		/// 블렌드 아웃 시간 (초)
+		/// </summary>
+		public float BlendOutSec;
+
+		public CharacterResolvedAction(string expressionKey = null, string motionKey = null, int? durationMs = null, float blendInSec = 0.3f, float blendOutSec = 0.3f)
+		{
+			ExpressionKey = expressionKey;
+			MotionKey = motionKey;
+			DurationMs = durationMs;
+			BlendInSec = blendInSec;
+			BlendOutSec = blendOutSec;
+		}
+	}
+
+	/// <summary>
+	/// 캐릭터 액션 우선순위
+	/// </summary>
+	public enum CharacterActionPriority
+	{
+		/// <summary>
+		/// 낮은 우선순위
+		/// </summary>
+		Low = 0,
+
+		/// <summary>
+		/// 일반 우선순위
+		/// </summary>
+		Normal = 1,
+
+		/// <summary>
+		/// 높은 우선순위
+		/// </summary>
+		High = 2,
+
+		/// <summary>
+		/// 최고 우선순위 (음성 등)
+		/// </summary>
+		Critical = 3
+	}
+
+	/// <summary>
+	/// 캐릭터 액션 취소 정책
+	/// </summary>
+	public enum CharacterCancelPolicy
+	{
+		/// <summary>
+		/// 기존 액션을 대체
+		/// </summary>
+		Replace = 0,
+
+		/// <summary>
+		/// 기존 액션이 완료될 때까지 대기
+		/// </summary>
+		Wait = 1,
+
+		/// <summary>
+		/// 기존 액션을 중단하고 즉시 실행
+		/// </summary>
+		Interrupt = 2,
+
+		/// <summary>
+		/// 기존 액션이 우선순위가 낮을 때만 대체
+		/// </summary>
+		ReplaceIfLowerPriority = 3
+	}
+
+	/// <summary>
+	/// 캐릭터 액션 상태
+	/// </summary>
+	public enum CharacterActionStatus
+	{
+		/// <summary>
+		/// 대기 중
+		/// </summary>
+		Pending = 0,
+
+		/// <summary>
+		/// 실행 중
+		/// </summary>
+		Playing = 1,
+
+		/// <summary>
+		/// 완료됨
+		/// </summary>
+		Completed = 2,
+
+		/// <summary>
+		/// 취소됨
+		/// </summary>
+		Cancelled = 3,
+
+		/// <summary>
+		/// 오류 발생
+		/// </summary>
+		Error = 4
+	}
+}

Assets/Domain/Character/Script/Controller/CharacterActionDTOs.cs.meta

@@ -0,0 +1,149 @@
+using UnityEngine;
+using ProjectVG.Domain.Character.Live2D.Model;
+
+namespace ProjectVG.Domain.Character.Service
+{
+	/// <summary>
+	/// 캐릭터 제어를 단일 진입점으로 제공하는 파사드 구현체.
+	/// </summary>
+	public class CharacterFacade : MonoBehaviour, ICharacterFacade
+	{
+		private ICharacterModelManager _modelManager;
+		private ICharacterActionService _actionService;
+		private ICharacterActionResolver _actionResolver;
+
+		/// <summary>
+		/// 파사드를 초기화한다.
+		/// </summary>
+		public void Initialize()
+		{
+			// 의존성 주입을 통해 초기화
+			// TODO: 실제 의존성 주입 컨테이너에서 가져오도록 수정
+			Debug.LogWarning("[CharacterFacade] 의존성 주입이 아직 구현되지 않았습니다.");
+		}
+
+		/// <summary>
+		/// 의존성을 주입한다.
+		/// </summary>
+		/// <param name="modelManager">모델 매니저</param>
+		/// <param name="actionService">액션 서비스</param>
+		/// <param name="actionResolver">액션 해석기</param>
+		public void InjectDependencies(ICharacterModelManager modelManager, ICharacterActionService actionService, ICharacterActionResolver actionResolver)
+		{
+			_modelManager = modelManager;
+			_actionService = actionService;
+			_actionResolver = actionResolver;
+		}
+
+		/// <summary>
+		/// 파사드를 종료한다.
+		/// </summary>
+		public void Shutdown()
+		{
+			if (_modelManager != null) {
+				_modelManager.UnloadAll();
+			}
+		}
+
+		/// <summary>
+		/// 캐릭터를 등록한다.
+		/// </summary>
+		public void RegisterCharacter(string characterId, bool preload = false)
+		{
+			if (_modelManager != null) {
+				_modelManager.LoadModel(characterId, preload);
+			}
+		}
+
+		/// <summary>
+		/// 캐릭터 등록을 해제한다.
+		/// </summary>
+		public void UnregisterCharacter(string characterId)
+		{
+			if (_modelManager != null) {
+				_modelManager.UnloadModel(characterId);
+			}
+		}
+
+		/// <summary>
+		/// 활성 캐릭터를 설정한다.
+		/// </summary>
+		public void SetActiveCharacter(string characterId)
+		{
+			if (_modelManager != null) {
+				_modelManager.ActivateModel(characterId);
+			}
+		}
+
+		/// <summary>
+		/// 활성 캐릭터를 해제한다.
+		/// </summary>
+		public void ClearActiveCharacter()
+		{
+			if (_modelManager != null) {
+				_modelManager.DeactivateModel();
+			}
+		}
+
+		/// <summary>
+		/// 액션을 적용한다.
+		/// </summary>
+		public CharacterActionHandle ApplyAction(CharacterActionRequest request)
+		{
+			// TODO: 액션 서비스 구현 후 연결
+			Debug.LogWarning($"[CharacterFacade] ApplyAction 아직 구현되지 않음: {request.ActionKey}");
+			return new CharacterActionHandle("not_implemented", CharacterActionStatus.Error);
+		}
+
+		/// <summary>
+		/// 액션을 취소한다.
+		/// </summary>
+		public void CancelAction(string actionId)
+		{
+			// TODO: 액션 서비스 구현 후 연결
+			Debug.LogWarning($"[CharacterFacade] CancelAction 아직 구현되지 않음: {actionId}");
+		}
+
+		/// <summary>
+		/// 모든 액션을 취소한다.
+		/// </summary>
+		public void CancelAllActions()
+		{
+			// TODO: 액션 서비스 구현 후 연결
+			Debug.LogWarning("[CharacterFacade] CancelAllActions 아직 구현되지 않음");
+		}
+
+		/// <summary>
+		/// 음성 재생 시작을 알린다.
+		/// </summary>
+		public void OnVoiceStarted()
+		{
+			// TODO: 음성 관련 처리 구현
+		}
+
+		/// <summary>
+		/// 음성 재생 종료를 알린다.
+		/// </summary>
+		public void OnVoiceFinished()
+		{
+			// TODO: 음성 관련 처리 구현
+		}
+
+		/// <summary>
+		/// 활성 캐릭터 ID를 반환한다.
+		/// </summary>
+		public string GetActiveCharacterId()
+		{
+			return _modelManager?.GetActiveModelId();
+		}
+
+		/// <summary>
+		/// 캐릭터 등록 여부를 반환한다.
+		/// </summary>
+		public bool IsRegistered(string characterId)
+		{
+			return _modelManager?.IsLoaded(characterId) ?? false;
+		}
+	}
+}
+