본문 바로가기

Common UI - #0 개요 및 설정

@exqt2026. 11. 3. 08:16

Common UI란?


일반 UMG에서 확장 플러그인으로 아래와 같은 기능들을 제공한다.

  • 키보드 / 마우스 / 게임패드 / 콘솔 입력을 한번에 처리
  • 여러 메뉴가 겹쳐 있을 때 입력 라우팅 관리
  • 뒤로가기 / 닫기 / 포커스 복원 
  • Button, Text 스타일 통일
  • 플랫폼별 버튼 아이콘 표시버튼, 탭, 액션바 같은 게임 UI 컴포넌트 재사용

크로스 플랫폼이 메인이 된 게임 시장에 필수적인 플러그인이다.

 

주요 컴포넌트

Activatable Widget Stack 예시

 

Common Activatable Widget

  • 활성화 / 비활성화될 수 있는 화면 단위 위젯
  • 예시) 열었다 닫을 수 있는 팝업창, 메인 메뉴/세이브 슬롯 페이지 단위 위젯

Common Activatable Widget Stack

  • Common Activatable Widget 이 배치되는 위젯 컨테이너
  • Stack 내에서 하나의 Widget만이 활성화 되어 표시 됨
  • Widget을 Push하거나 Pop하면 Fade Transition을 통해 전환 됨 

Common Button / Text

  • 기존 Button/Text를 확장한 위젯
  • 주 역할은 버튼과 텍스트에 CSS의 스타일처럼 별도의 스타일 에셋을 지정할 수 있는 기능이 추가 됨
  • Common Button에선 Selected라는 새로운 상태가 추가됨
    • Focus와는 다름에 유의
    • Button이 눌린 상태를 표현할 수 있음 
    • Toggleable을 활성화 할 경우 지속적으로 눌림 상태가 유지 됨

 

Common Action Widget / Action Bar

Arc Raiders의 메인 메뉴 UI

  • 현재 화면에서 조작 가능한 기능의 버튼들을 하단에 나열해 놓은 UI를 Action Bar 라고 한다.
  • Common Action Widget은 입력 장치 별로 버튼 이미지를 나타내는 위젯 (입력 장치가 바뀌면 실시간으로 바뀜)

설정에 필요한 에셋

 



InputActionDataTable:

- CommonInputActionDataBase를 Row Type으로 하는 DataTable

- Select (UI 선택) / Back (뒤로가기) 등 UI 에서 할 수 있는 Action들을 정의한다.

 

InputData: 

- GenericInputData 를 상속

- InputActionDataTable에서 Select / Back 에 해당하는 Input Action을 정의하는 용도

 

ControllerData:

- CommonInputBaseControllerData 를 상속

- 입력 디바이스 별 키 마다 Brush(Image) 매핑

- 지원할 컨트롤러 종류 만큼 생성
- 단일 키 입력은 Input Brush Data Map에 설정해야 한다. (Input Brush Key Sets은 좌+우 등 여러개의 입력을 나타낼 때 용도)

프로젝트 설정

 

Game Viewport Client Class를 Common UI Viewport로 변경
Common Input 설정

  • InputData를 직접 만든 것으로 변경
  • Windows의 Default Gamepad Name을 Generic(특정 컨트롤러에 한정되지 않음) 으로 설정, 이후 Controller Data에 만든 에셋들 지정
  • Gamepad Name 드롭다운은 **타겟 플랫폼에 따라 자동으로 생성**되기 때문에 PC에서는 Generic만 보이는 것이 정상

 

Input Action Icons Asset

https://kenney.nl/assets/input-prompts

CC0 라이센스로 무료로 사용할 수 있는 아이콘이다. 

 

exqt
@exqt :: exqt

gamedev

안녕하세요.

목차