InputSystem - osy9611/ProjectPT GitHub Wiki

Unity의 InputSystem을 사용하고 적용했던 사례를 간단히 정리하고 Unreal의 InputSystem에 대해서 분석하고 정리한 내용

해당 입력 시스템을 공부하면서 이전 프로젝트에서 적용했던 Unity Input System의 설계가 떠올라서 추가적인 정리를 하려고한다.

• Unity에도 새로운 New Input System이 도입되면서 UE의 Input Mapping Context와 같이 입력 스키마를 작성해서 이용하는 방식을 사용했다.

• 이전 프로젝트에 적용했던 Input System을 매니저로 관리를 진행했다.

• AddEvent

  • Input 스키마 이벤트에 대한 콜백 함수 등록

    

• Remove Event

  • 특정 입력 이벤트에서 콜백 함수 제거

    

해당 프로젝트에서는 기존 언리얼 입력 방식이 아닌 UE 5 버전의 Enhance Input을 적용했다. 고로 이전의 언리얼 입력 방식은 간단하게 정리를 하고 UE5 버전의 EnhaceInput위주로 정리를 하려고 한다.

• 기존 언리얼 입력 시스템은 프로젝트 세팅에서 키를 등록하고 Bind해서 사용했다.

  

• 언리얼 5 버전으로 넘어오면서 Enhanced Input 시스템이 정식으로 도입되면서 프로젝트 세팅이 아닌 Input Mapping Context을 생성해서 입력 매핑을 하게되었다.

• Input Action

  • 특정 키나 조작을 통해 발생하는 액션을 정의한다.
  • bool, float, Vector2D, Vector3D 등을 지원함

• Input Mapping Contexts

  • 특정 컨텍스트에서 입력 액션을 바인딩하는 역할을 한다.
  • Input Modifilers
    • 입력 값을 변환하는 역할을 한다.
    • ex) 특정 축의 순서를 변경하거나 입력 값을 반대로 만들 수 있음
  • Input Triggers
    • 입력 액션의 특정 조건을 설정하는 역할을 한다.
    • ex) 짧게 누르면 약공격, 길게 누르면 강공격과 같은 기능을 설정할 수 있음
  • 예시

    

Unity의 InputSystem과 비슷하게 작업을 진행했다. 추후 라이라 코드를 분석해 부족한 부분을 추가했다.

• InputConfig

  • GameplayTag를 이용해 각 IA 관리를 진행

• PTInputComponent

  • BindNativeActions

    • C++코드에서 작성한 함수를 BindAction으로 등록하도록 구현

    • 주요 코드

      template <class UserClass, typename FuncType>
      void UPTInputComponent::BindNativeAction(const UPTInputConfig* InputConfig, const FGameplayTag& InputTag, ETriggerEvent TriggerEvent, UserClass* Object, FuncType Func, bool bLogIfNotFound)
      {
      	check(InputConfig);
      
      	if (const UInputAction* IA = InputConfig->FindNativeInputActionForTag(InputTag, bLogIfNotFound))
      		BindAction(IA, TriggerEvent, Object, Func);
      }

  • BindAbilityActions

    • GAS 이벤트를 BindAction으로 등록 하도록 구현

    • 초기에는 해당 부분도 BindNativeActions과 통합해서 사용했지만 추후 라이라 분석을 통해서 다음과 같이 분리를 진행했다.

    • 주요 코드

      template <class UserClass, typename PressedFuncType, typename ReleasedFuncType>
      void UPTInputComponent::BindAbilityActions(const UPTInputConfig* InputConfig, UserClass* Object, PressedFuncType PressedFunc, ReleasedFuncType ReleasedFunc, TArray<uint32>& BindHandles)
      {
      	check(InputConfig);
      
      	//AbilityAction에 대해서는 그냥 모든 InputAction에 다 바인딩 시킨다
      	for (const FPTInputAction& Action : InputConfig->AbilityInputActions)
      	{
      		if (Action.InputAction && Action.InputTag.IsValid())
      		{
      			if (PressedFunc)
      				BindHandles.Add(BindAction(Action.InputAction, ETriggerEvent::Triggered, Object, PressedFunc, Action.InputTag).GetHandle());
      
      			if (ReleasedFunc)
      				BindHandles.Add(BindAction(Action.InputAction, ETriggerEvent::Completed, Object, ReleasedFunc, Action.InputTag).GetHandle());
      		}
      	}
      }

• GAS Input 처리

  처음 GAS를 처리할때 각 입력 이벤트를 각각 처리해서 Bind를 진행했다. 라이라 분석 후 AbilitySystemComponent에 핸들을 등록해서 사용하는 방식을 사용했다.

  • InputPress 또는 InputReleased 이벤트가 들어오면 필요한 핸들에 등록

    • 주요 코드

      oid UPTAbilitySystemComponent::AbilityInputTagPressed(const FGameplayTag& InputTag)
      {
      	if (InputTag.IsValid())
      	{
      		for (const FGameplayAbilitySpec& AbilitySpec : ActivatableAbilities.Items)
      		{
      			if (AbilitySpec.Ability && (AbilitySpec.DynamicAbilityTags.HasTagExact(InputTag)))
      			{
      
      				InputPressedSpecHandles.AddUnique(AbilitySpec.Handle);
      				InputHeldSpecHandles.AddUnique(AbilitySpec.Handle);
      			}
      		}
      	}
      }

  • 핸들에 등록된 이벤트를 검색해 등록된 핸들이 있다면 GAS를 실행

    • 주요 코드

      for (const FGameplayAbilitySpecHandle& Handle : InputHeldSpecHandles)
      {
      	if (const FGameplayAbilitySpec* AbilitySpec = FindAbilitySpecFromHandle(Handle))
      	{
      		if (AbilitySpec->Ability && !AbilitySpec->IsActive())
      		{
      			const UPTGameplayAbility* AbilityCDO = CastChecked<UPTGameplayAbility>(AbilitySpec->Ability);
      
      			if (AbilityCDO->ActivationPolicy == EPTAbilityActivationPolicy::WhileInputActive)
      				ExecuteHandles.AddUnique(AbilitySpec->Handle);
      		}
      	}
      }