기록

Flutter SDK 설치

먼저 Flutter를 설치하는 방법은 크게 두 가지가 있다.

첫 번째는 공식 홈페이지에 들어가서 직접 파일을 다운로드하여 압축을 풀고 환경변수 설정을 하는 것이다.

두 번째로는 Visual Studio Code를 활용해서 여기서 Flutter를 설치하는 방법이 있다.

해당 내용은 플러터 공식 홈페이지에서도 확인 가능하다.

첫 번째 방법

먼저 공식 홈페이지에서 SDK 압축 파일을 다운로드한 다음 적절한 경로에 옮겨두고 압축을 푼다.

이 경로에는 특수 문자나 공백을 포함해선 안되며 또한 권한이 필요한 폴더 내에 위치해서도 안된다.

저장한 위치의 경로를 복사해 둔 다음 이 경로 사용자 변수 또는 시스템 변수의 PATH에 등록한다.

두 번째 방법

VSCode를 열고 확장 프로그램 마켓을 열고 flutter를 검색해서 가장 상단에 있는 걸 설치한다.

프로젝트 생성

플러터 SDK의 설치가 끝났다면 VSCode를 열고 팔레트를 열어서(Ctrl + Shift + P) 새로운 플러터 프로젝트를 생성한다.

New Project를 선택하면 > 프로젝트 템플릿 > 프로젝트 생성 경로 > 프로젝트 이름

프로젝트 템플릿

프로젝트 템플릿은 Application, Empty, Skeleton이 있다.

Application은 기본적인 UI 구성 요소가 만들어져 있어 처음에 Flutter의 계층 구조나 State 개념을 파악하는데 괜찮을 듯하다.

Empty는 뜻 그대로 기본 main 함수와 MaterailApp()만 작성되어 있는 실행가능한 최소 상태이다.

Skeleton은 기본 페이지 구성과 라우팅 구조를 갖춘 템플릿으로 어느 정도 숙련도가 있다면 빠른 작업 진행에 유용할 것 같다.

생성 경로

해당 경로에 '프로젝트 이름' 폴더가 생성되고 IDE에서 해당 폴더를 연다. 이름은 경로 설정 후 입력가능하며 기본 이름값이 주어진다.

프로젝트 이름

프로젝트 폴더 이름뿐만 아니라 앱의 이름인 pubspec.yml 파일의 name 필드의 값도 해당 이름으로 설정된다. 

추가 패키지 설치

Flutter 프로젝트의 생성이 끝났다면 먼저 IDE에서 터미널을 열고, flutter doctor 명령어를 실행시켜 문제가 없는지 확인한다.

해당 명령어의 실행이 끝나면 체크 항목과 문제 사항을 볼 수 있는데 여기서 문제가 되는 부분들을 하나씩 해결해 주도록 한다.

이미 한 번 작업을 마친 상태였기 때문에 현재는 문제가 발생하지 않지만 일반적으로 색칠한 부분에서 문제가 발생할 것이다.

Android Studio - 안드로이드 스튜디오가 없다면 요구되는 버전을 확인 후 설치한다.

Android toolchain - 안드로이드 스튜디오의 SDK 매니저에서 Android toolchain을 찾아서 설치한다.

Visual Studio - VS를 버전에 맞게 설치하고 추가 설치 항목에서 develop Windows apps를 설치한다.

문제가 모두 해결되었는지 다시 flutter doctor를 실행해서 확인한다.

여기까지 완료되었다면 기본적인 준비가 완료되었다.

다시 팔레트를 열어서 Flutter: Launch Emulator를 클릭해서 가상 머신을 실행시킨 후 터미널에서 flutter run을 실행시켜 앱을 띄워본다.

IDE의 이 버튼을 눌러도 실행을 시킬 수 있다.

애뮬레이터를 추가하려면 안드로이드 스튜디오의 디바이스 매니저에서 추가하면 된다.

Player

Input System을 활용해서 간단한 플레이어를 만들어 본다.

구현할 기능은 Move, Sprint

디바이스는 키보드, Invoke C Sharp Events로 작업한다.

Move

Input Action에서 WASD의 입력을 받아서 플레이어 이동으로 처리한다.

Input Action에서 WASD키를 조합하여 Move 액션을 만든다.

스크립트에서 PlayerInput의 onActionTriggered 이벤트에 OnActionTriggered 함수를 리스너로 등록하고, OnActionTriggered 함수 안에서 각 액션에 대한 처리를 한다.

private PlayerInput playerInput;
private Vector2 moveInput;

private void Awake()
{
	...
    playerInput = GetComponent<PlayerInput>();
    playerInput.onActionTriggered += OnActionTriggered;
    ...
}

...


private void OnActionTriggered(InputAction.CallbackContext context)
{
    if (context.action.name == "Move" && context.performed)
    {
        OnMove(context);
    }
}

...

public void OnMove(InputAction.CallbackContext context)
{
    moveInput = context.ReadValue<Vector2>();
}

WASD 키 입력에 따라서 moveInput의 값이 수시로 업데이트되고 플레이어의 움직임을 관리하는 함수에서 moveInput 값을 사용해서 처리한다.

확실한 입력이 있을 때 만 처리하기 위해서 performed 인 경우를 체크한다.

Sprint

달리기를 위한 기능으로 눌린 상태에서 더 빠르게 움직이도록 한다.

Left Shift 키와 바인딩하여 누르고 있을 때 달리고 떼면 다시 걷도록 한다. 이 입력을 위해서 Press And Release로 키 입력을 받는다.

private void OnActionTriggered(InputAction.CallbackContext context)
{
	...
    
    if (context.action.name == "Sprint" && context.performed)
    {
        OnSprint(context);
    }

    ...
}

public void OnSprint(InputAction.CallbackContext context)
{
    isSprint = context.ReadValue<float>() == 1;
    currentSpeed = isSprint ? moveSpeed * 2f : moveSpeed;
    Debug.Log("On Sprint");
}

눌림 상태는 float 값으로 들어오며 눌리면 1 떼면 0으로 콜백이 들어온다.

이 값을 달리는 상태를 변경하는 플래그로 사용해서 처리한다.

간단하게 조작 로직을 구현해서 본다.

PlayerInput

Input System은 Input Actions와 PlayerInput으로 구성된다. Input Actions는 입력과 행동의 연결을 정의하는 구조이고, PlayerInput은 그 정의를 바탕으로 실제 입력을 감지하고 동작을 실행하는 컴포넌트다.

동작의 주체가 되는 Player 게임 오브젝트에 PlayerInput 컴포넌트를 추가하고, Actions 필드에 사용할 Input Actions 에셋을 지정하면 PlayerInput을 사용할 준비가 완료된다.

Default Scheme

어떤 입력 장치(키보드마우스, 게임패드 등)에 대한 입력을 처리할지 지정할 수 있는 설정이다. 

기본값인 Any는 어떤 장치에서든 입력을 받을 수 있다. 특정 장치를 지정하더라도 Auto-Switch가 활성화되어 있다면, 다른 장치의 입력이 감지되었을 때 자동으로 해당 장치로 전환되어 입력을 처리한다. 반대로 Auto-Switch가 비활성화되어 있다면, 처음 감지된 장치만 계속 사용하게 된다. 

예를 들어 Default Scheme을 Any로 설정하면 먼저 사용된 키보드마우스로 Control Scheme이 잡힌다.

이 상태에서 게임패드를 연결하여 조작을 하면 Auto-Switch 덕분에 자동으로 게임패드로 입력이 감지되어 처리된다.

Default Map

Default Map은 Input Action Maps 중에서 기본으로 사용할 Map을 지정하는 설정이다.

Input Action은 상황에 따라 다른 Map으로 전환할 수 있다.

예를 들어 캐릭터 조작 시에는 Player 맵을 사용하고, 메뉴를 열었을 때는 UI 맵으로 전환하여 입력을 UI 조작에만 반응하도록 만들 수 있다. 이러한 방식은 게임패드나 조이스틱처럼 여러 입력이 혼합되는 환경에서 특히 유용하다.

UI Input Module

UI와의 상호작용은 EventSystem에 연결된 Input System UI Input Module 컴포넌트를 통해 처리된다.

기본 Unity UI 시스템은 단일 입력만 처리하도록 설계되어 있지만 멀티플레이 게임(로컬)에서는 각 플레이어가 자신의 UI를 조작해야 하는 경우가 생기기 때문에 각 플레이어에게 UI 입력용 시스템도 별도로 연결해주어야 한다.

PlayerInput 컴포넌트가 사용하는 Input Action Asset은 UI Input Module에도 동일하게 적용되어, 동일한 동작과 디바이스 설정으로 UI와 게임 조작을 일관되게 제어할 수 있다.

멀티플레이 환경에서는 MultiplayerEventSystem 컴포넌트를 사용하여 화면에 여러 UI 인스턴스를 동시에 표시하고 각 UI를 서로 다른 플레이어가 독립적으로 제어할 수 있게 만들 수 있다.

Camera

Camera 필드는 멀티 플레이어 상황에서, 플레이어 관리에 사용되는 PlayerInputManager 컴포넌트의 Split-Screen 기능이 활성화된 경우에 의미를 갖는다.

이 기능이 켜지면 각 플레이어는 자신만의 카메라를 통해 분할된 화면을 보게 되며, 이때 PlayerInput의 Camera 필드에 각 플레이어의 카메라를 연결해주어야 한다.

이렇게 설정하면, UI의 입력 처리도 해당 카메라를 기준으로 이루어지므로 플레이어마다 올바른 UI 포커스 및 이벤트 처리가 가능해진다.

Behavior

이벤트가 발생했을 때 어떤 방식으로 처리할지 결정하는 옵션이다.

Send Messages

Send Message는 Unity의 고전적인 메시지 전달 방식으로, SendMessage("함수명", 파라미터) 형태로 특정 메서드를 실행한다.

PlayerInput 컴포넌트는 Input Action이 발생했을 때, 해당 액션 이름을 기반으로 구성된 함수명을 자동으로 호출한다. 이 메서드는 GameObject에 연결된 MonoBehaviour 스크립트 내에 정확한 이름으로 존재해야 하며, 그렇지 않으면 호출되지 않고 무시된다.

예를 들어 Jump라는 액션이 정의되어 있다면, PlayerInput은 OnJump()라는 함수명을 찾아 호출한다.

이처럼 Input Action에서 정의된 Action 이름 앞에 On을 붙인 함수명이 호출 대상이 되며 위 이미지에서 텍스트로 사용가능한 함수명이 표시된다. 이 함수명 텍스트는 Input Actions 에셋에서 Action의 이름을 추가하거나 편집하고 Asset을 저장하면 자동으로 수정되어 보인다.

SendMessage 방식의 장점은 간단하고 빠르게 연결 가능하기 때문에 코드 구조가 가볍지만 메서드명이 정확히 일치해야 작동한다는 점과 동적 호출 방식이기 때문에 컴파일 타임에서 오류 체크가 불가능하며 함수의 파라미터가 InputValue만 전달되기 때문에 복합적인 처리나 Context 정보 전달, 다중 파라미터 기반 로직등의 처리가 어렵다.

public void OnMove(InputValue value)
{
	moveInput = value.Get<Vector2>();
}

Broadcast Message

Broadcast Message 방식도 Unity의 고전적인 메시지 전달 방식으로 Send Message와 동일한 형식을 따르지만, 차이점은 현재 GameObject 뿐만 아니라 모든 자식 오브젝트들에게도 메시지를 전파한다는 점이다.

예를 들어 계층 구조 내 여러 컴포넌트가 동일한 함수명을 가지고 있다면, 모두 호출되기 때문에 예상치 못한 중복 동작이 발생할 수 있다. 또한 자식 오브젝트가 많거나 계층이 깊을 경우, 성능 저하의 원인이 될 수 있어 주의가 필요하다.

Invoke Unity Events

이벤트 기반 정적 연결방식으로, 함수명을 신경 쓸 필요 없이 에디터에서 간편하게 메서드를 지정할 수 있다.

Input Actions에서 정의한 Action들은 PlayerInput 컴포넌트 내에서 자동으로 이벤트로 생성되며, 인스펙터 창에서 해당 이벤트에 호출할 메서드를 직접 할당할 수 있다. 이러한 이벤트 - 리스너 구조는 코드 간의 결합도를 낮추고, 동작을 시각적으로 구성할 수 있어 직관적이고 유지보수도 용이하다.

Invoke C Sharp Events

Invoke C# Events는 코드 기반으로 입력을 처리하는 방식으로, PlayerInput이 제공하는 onActionTriggered 이벤트에 리스너를 등록하여 모든 입력 액션을 하나의 이벤트에서 감지할 수 있다.

void OnEnable()
{
    playerInput.onActionTriggered += OnActionTriggered;
}

void OnDisable()
{
    playerInput.onActionTriggered -= OnActionTriggered;
}

void OnActionTriggered(InputAction.CallbackContext context)
{
    if (context.action.name == "Jump")
    {
        Debug.Log("Jump triggered");
    }
}

action.name을 기준으로 원하는 액션을 구분해서 처리할 수 있으며, Unity Events 방식은 인스펙터에서 함수명을 문자열로 참조하기 때문에 함수명이 바뀌면 참조가 끊길 수 있는 반면 Invoke C# Events는 코드에서 직접 리스너를 등록하기 때문에 함수명을 변경하더라도 안전하게 리팩토링이 가능하며, 유지보수에 강점을 가진다.

정리

각 Behavior 방식은 특징이 다르기 때문에 상황에 따라 적절히 선택해서 사용하는 것이 중요하며 다음과 같이 요약할 수 있다.

- Send Message : 간단한 구현이 필요할 때 유용

- Broadcast Message : 하위 오브젝트까지 포함하여 입력 처리를 해야 하는 특수한 경우에 사용

- Invoke Unity Events : 비프로그래머나 디자이너가 에디터에서 직관적으로 연결할 때 적합

- Invoke C Sharp Events : 복잡한 입력 로직을 처리할 때 사용

Input System

2019 버전을 발표할 시점인 19년도에 새로운 Input System을 업데이트하면서 기존까지 입력 처리를 담당했던 Input Manager에 대해서 앞으로 추가 업데이트 사항은 없다고 언급을 했었다. 그 후 아직까지도 호환성은 유지한 채 사용할 수 있도록 제공하고 있지만 공식 문서에서도 legacy로 표현하며 Input System을 권장하고 있다. 

Input System을 권장하는 이유는 새로운 입력 처리 방식의 장점과 Input Manager의 오래된 기술로 인한 한계에 있다.

Input System 장점

- 다양한 입력 장치를 지원하며 사용자 정의가 가능하다. 이를 통해서 다양한 플랫폼에서 일관된 입력을 처리할 수 있다. 

- 비동기 입력 처리를 지원하기 때문에 입력 이벤트를 더 효율적으로 관리할 수 있어 게임 성능의 향상을 모색할 수 있다.

- Input System의 API는 더 직관적이어서 사용하기 쉬워 코드의 가독성을 높인다.

Input Manager 한계

- 다양한 입력 장치를 동시에 처리하는 등의 현대의 게임 개발에서 요구되는 사항을 충족하기  어렵다.

- 기본적인 입력 처리만 가능하기 때문에 복잡한 입력에 대한 요구 사항을 처리하기 부적합하다.

Unity 6 버전을 기준으로 진행한다.

Project Settings

기본 선택은 both로 되어있는데 Input System만 을 사용하기 위해서 Project Settings > Player > Active Input Handling에서 Input System Package를 선택한다. 

어느 버전부터인지 모르겠지만 이전에 사용했던 버전에서는 Input System을 선택 시 패키지 설치가 필요했는데 현재 버전에서는 패키지가 기본적으로 설치되어 있고 InputSystem_Actions 파일이 기본 생성되어 있다.

Input Actions

Input Actions Asset 파일을 열면 입력에 대한 처리를 맵핑과 세부 설정을 할 수 있는 Input Actions Editor 창이 열린다.

Action Maps

입력을 그룹으로 묶어 관리할 수 있는 단위이다. 기본적으로 Player, UI 맵이 제공된다.

각 Action Map은 관련된 여러 입력 동작인 Action들의 설정 묶음으로 하나의 Input Actions Asset에서 활성화되는 Map은 하나만 처리되므로 플레이어의 상태에 따라 Map을 전환하여 상황에 맞는 입력만 처리하도록 구성할 수 있어 게임 내 다양한 상태에 따라 입력 처리를 명확하게 구분하고 유지 보수 및 확장도 간편하다.

Actions

사용자 입력에 반응하여 수행될 동작을 정의하는 요소이다.

이동, 점프, 공격 등과 같이 플레이어의 입력 행동 단위이다. 각 Action은 하나 이상의 입력 Binding과 연결되고 키보드, 마우스, 게임 패드 등 다양한 장치의 입력을 조합하여 정의할 수 있다.

Action은 하나의 입력 동작에 대한 정의이며 Binding은 Action을 어떤 입력 장치에 매핑할지 설정한다.

각각 Properties에서 세부적인 옵션 설정을 할 수 있다.

Action Properties

각 Action의 동작 방식과 입력값의 처리 형태를 세부적으로 설정할 수 있는 항목이다.

입력의 종류, 처리 방식, 반환 값의 형태 등을 정의하여 다양한 입력 상황에 대응할 수 있도록 옵션이 제공된다.

각 옵션의 기본 설정은 Project Settings > Input System > Settings의 값을 따르며 개별 값을 조정하려면 Default 플래그를 끄고 직접 수정하거나 Settings Asset을 생성하여 값을 커스텀한다.

Action Type

입력 시스템의 동작 방식을 정의하는 요소로 각 타입마다 입력 이벤트를 처리하는 방식에 따라 다르게 동작한다.

Value, Button, Pass Through 세 가지 방식이 있다.

Value

지속적인 입력 값을 반환한다. 입력이 활성화된 동안 현재 상태 값을 계속해서 업데이트한다. 주로 조이스틱의 위치나 슬러이더처럼 지속적으로 변화하는 값을 처리할 때 유용하다.

Button

버튼의 누름 상태를 감지한다. 점프, 공격, 상호작용처럼 단일 이벤트 트리거에 적합하다.

PassThrough

입력을 필터링 없이 그대로 전달한다. 가공되지 않고 호출 대상에 직접 전달되며 주로 복잡한 입력 로직, 멀티 컨트롤 입력, UI 입력 등에 활용한다.

Control Type

Action Type에 따라 달라지는데 Value인 경우 다양한 값 형식으로 가공해서 받을 수 있다.

PlayerInput의 Behavior 방식에 따라 다르지만 Stick, Dpad, Touch, Pose, Eyes와 같은 타입들은 내부적으로 해당 클래스 타입(StickControl, DpadControl 등)으로 처리되며, Callback 방식에서 해당 클래스를 직접 참조하여 세부 데이터를 추출할 수 있다.

Interactions

 Action의 세 가지 이벤트 상태(started, performed, canceled)에 도달하기 위한 조건을 세부적으로 정의하는 항목이다.

Action 상태

- started : 입력의 시작점

- performed : 입력이 성공적으로 완료된 시점

- canceled : 입력이 도중에 중단 또는 실패한 경우

Hold

일정 시간 동안 누르고 있을 때만 유효한 입력으로 인식한다.

Press Point : 입력 강도를 판정하는 것으로 어느 정도 눌렸을 때 Press로 보는지 판단하는 기준으로 트리거나 스틱 같이 값 변경이 미세한 경우에서 중요하게 판단된다.

Hold Time : Press Point를 넘은 후 이 시간만큼 입력이 유지됐을 때 performed 상태가 되고 그전에 입력이 중단되면 canceled 상태가 된다.

Multi Tap

일정 시간 안에 특정 횟수만큼의 입력이 발생했을 때 작동한다.

Tap Count : 몇 번을 입력해야 performed 되는지

Max Tap Spacing : 탭과 탭 사이 최대 허용 시간

Max Tap Duration : 각 탭이 유지될 수 있는 최대 시간

Press Point : 유효한 입력으로 판단할 최소 세기

입력 사이 간격이 Max Tap Spacing을 넘거나, 각 탭 유지 시간이 Max Tap Duration을 넘기면 canceled

Press

버튼을 누르거나 뗄 때 발생하는 단순 입력을 세밀하게 제어할 때 사용한다. 

단순 버튼의 입력에 대한 처리라면 Action Type의 Button으로 설정하면 되고 세부 제어가 필요한 경우 Press Interaction을 사용한다.

Trigger Behavior : Press Only, Release Only, Press and Release 세 가지 상태가 있으며 각 상태는 버튼을 눌리는 순간, 떼는 순간, 누를 때 started 뗄 때 performed로 처리한다.

Slow Tap

버튼을 누른 뒤 일정 시간 후에 뗄 때 performed 상태가 된다.

Min Tap Duration : 탭이 performed 되기 위한 최소 시간

Hold와 비슷하지만 hold는 시간 조건이 됐을 때 performed, slow tap은 시간을 채우고 뗄 때 performed 되는 차이가 있다. 하지만 겹치는 동작이 발생할 수 있기 때문에 동일한 Action에서 Hold와 Slow Tap 두 인터랙션을 동시에 사용할 때는 조건을 명확하게 하여 구분할 필요가 있다.

Tap

버튼을 빠르게 누르고 떼는 동작을 인식한다.

Max Tap Duration : 입력이 Press Point 이상으로 감지된 이후에 started 상태가 되고 Max Tap Duration 안에 입력을 뗄 때 performed 된다.

Processors

입력값을 처리하여 최종적으로 Action에 전달되는 값을 조정하는 기능이다.

컨트롤러의 조이스틱, 마우스, 트리거 등 다양한 입력 장치에서 입력된 원시 값을 자동으로 보정, 변환, 필터링할 수 있다.

Axis Deadzone, Stick Deadzone

Axis Deadzone은 축 단위(float)의 선형적인 입력값에 대해 deadzone을 적용한다.

입력값이 min 보다 작으면 0, max 보다 크면 1, 그 사이의 값은 0 ~ 1 사이로 정규화된 값

주로 게임패드의 트리거와 같이 선형적인 입력에서 의도치 않은 작은 입력을 무시하거나 거의 끝까지 입력된 경우 1로 보정한다.

Stick Deadzone은 2D Vector 입력에 대해서 방사형 범위의 deadzone을 적용한다.

입력된 벡터의 길이(magnitude)가 min 보다 작으면 0, max 보다 크면 1, 그 사이값은 정규화하여 보정한다.

게임패드의 아날로그 스틱 입력에서 중앙 근처의 미세한 입력을 무시하고 가장자리에 가까우면 1, 범위 내의 값은 정규화하여 보정한다.

Clamp

입력값이 특정 범위를 벗어나지 않도록 제한해 주는 기능이다. 즉, 최소와 최댓값을 지정하고 그 범위를 벗어나는 값은 경곗값으로 보정한다.

Min : 입력값의 최솟값

Max : 입력값의 최댓값

Invert, Invert Vector2, Invert Vector3

입력값의 부호를 반전시킨다. 

단일 수치(float) 뿐 아니라 Vector2, Vector3 타입의 입력에도 사용 가능하며, 각 축별로 플래그로 개별 설정할 수 있다.

Normalize, Normalize Vector2, Normalize Vector3

입력값을 -1 ~ 1 사이로 정규화한다.

벡터의 크기는 무시하고 방향성만 필요한 경우에 사용한다.

Scale, Scale Vector2, Scale Vector3

입력 값에 곱셈 계수 Factor를 적용한다.

마우스 민감도 등 감도 조정에 사용할 수 있다.

Binding Properties

Binding

단일 입력 바인딩

Path

이 Binding이 참조하는 입력 장치와 입력 경로를 지정하며 기본 입력 연결 포인트로, 해당 Action이 어떤 입력에서 데이터를 받을지 결정한다.

Show Drived Bdings : 입력 장치마다 자동으로 파생되는 바인딩 목록을 확인할 수 있다.

Use in control scheme

특정 Control Scheme에 이 Binding을 포함할지 여부를 정한다.

예를 들어서 Keyboard&Mouse, Gamepad, Touch 등으로 나누어진 스킴에서 이 바인딩이 어떤 스킴에서 사용되는지 지정한다.

Composite

복합 입력 바인딩

여러 입력 값을 조합해서 하나의 논리적 입력으로 만들 때 사용한다.

대표적으로 WASD 나 방향키 조합으로 Vector2 이동을 구현하는 것이 있다.

Composite Type

어떤 형태의 입력 조합인지 지정한다.

1D Axis 

두 개의 입력을 받아서 -1 ~ 1 사이의 float 값으로 반환한다.

Negative 입력 -1, Positive 입력 +1 두 입력이 동시에 있다면 Which Side Wins에 따라 결과가 달라진다.

Neither : 두 입력이 상쇄되어 0

Positive : Positive 입력 우선, +1 반환

Negative : Negative 입력 우선, -1 반환

2D Vector

네 개의 입력을 받아 Vector2(x, y) 값으로 결합하여 반환

Up : +y

Down : -y

Left : -x

Right : +x

Analog : 아날로그 입력 값을 그대로 사용

Digital Normalized : 디지털 입력의 정규화 값

Digital : 입력이 있는 방향에 대해 -1/0/1의 벡터 구성

3D Vector

여섯 개의 입력을 받아 Vector3(x, y, z) 값으로 결합

2D Vector에서 

Forward : +z

Backward : -z

추가

모드는 동일하다.

Button With One/Two Modifiers

하나 또는 두 개의 Modifier 키와 Button의 조합이다.

Modifier의 입력이 있으며 Button이 눌려야 Action이 발생한다.

일반적으로 shift, ctrl, alt 등의 키를 modifier 키지만 일반키를 Modifier로 사용할 수 있다.

Override Modifiers Need To Be Pressed First : Modifier 키가 먼저 눌려야 Action이 발동되는지 결정하는 옵션

활성화 시 Modifier 키들이 먼저 입력된 상태에서 Button이 입력되어야 동작 비활성화 시 순서 상관없이 모두 눌려지면 동작

One/Two Modifiers

하나 또는 두 개의 Modifier 키의 조합이다.

Binding이 있지만 이 키의 입력은 상관없이 Modifier의 입력만으로 판단한다.

Button의 입력이 중요한 Button With ~ Modifier와 달리 Modifier의 입력만으로 동작의 조건이 충족된다.

Binding은 Modifier 입력을 기반으로 추가 입력을 받을 수 있는 여지를 만들어 주는 역할을 한다.

PlayerInput Component

빌트인 컴포넌트인 PlayerInput을 플레이어 오브젝트에 추가해서 키입력을 바로 받을 수 있다.

Actions에 등록된 InputSystem_Actions를 열어볼 수 있는데 일반적으로 사용되는 키로 바인딩되어 있는 걸 확인할 수 있다.

이 파일을 수정해서 바인딩 키나 값을 변경하여 처리할 수 있다.

플레이어 조작 스크립트에서 이 입력을 가져다 쓰는 방법은 다음과 같다.

private void Awake()
{
    rb = GetComponent<Rigidbody>();
}

private void FixedUpdate()
{
    if (currentInput != Vector2.zero)
    {
        // 방향 설정
        body.forward = new Vector3(currentInput.x, 0, currentInput.y).normalized;

        // 속도 계산
        float currentSpeed = walkSpeed;
        Vector3 moveVelocity = new Vector3(currentInput.x, 0, currentInput.y) * currentSpeed;

        // 물리 이동
        rb.linearVelocity = moveVelocity;

        // 애니메이션
        animator.SetFloat("Move", currentInput.magnitude);
    }
    else
    {
        // 정지 상태
        animator.SetFloat("Move", 0);
        rb.linearVelocity = Vector3.zero;
    }
}

public void OnMove(InputValue value)
{
	moveInput = value.Get<Vector2>();
}

업데이트 안에서 이동키 입력으로 변경되는 moveInput 값을 갱신해서 플레이어를 움직인다.

Action Properties 설정을 통해서 필요에 맞춰 수정해서 쓸 수 있다.

쉬프트를 누르면 달리고, 떼면 걷도록 상태를 변경하는 기능을 추가해본다. 

기본 Action은 눌렀을 때만 처리하고 있는데 이 부분을 PressAndRelease로 변경한다. 

그리고 Initial State Check를 활성화 해준다.

private void FixedUpdate()
{
    currentInput = Vector2.SmoothDamp(
        currentInput,
        moveInput * (isSprint ? 1f : 0.5f),
        ref smoothVelocity,
        smoothTime
    );

    if (currentInput != Vector2.zero)
    {
        // 방향 설정
        body.forward = new Vector3(currentInput.x, 0, currentInput.y).normalized;

        // 속도 계산
        float currentSpeed = isSprint ? sprintSpeed : walkSpeed;
        Vector3 moveVelocity = new Vector3(currentInput.x, 0, currentInput.y) * currentSpeed;

        // 물리 이동
        rb.linearVelocity = moveVelocity;

        // 애니메이션
        animator.SetFloat("Move", currentInput.magnitude);
    }
    else
    {
        // 정지 상태
        animator.SetFloat("Move", 0);
        rb.linearVelocity = Vector3.zero;
    }
}

private void PlayerAnimation(float moveAmount)
{
    animator.SetFloat("Move", moveAmount);
}

public void OnMove(InputValue value)
{
    moveInput = value.Get<Vector2>();
}

public void OnSprint(InputValue value)
{
    isSprint = value.isPressed;
}

InputManager의 GetAxis처럼 입력이 서서히 -1 0 1 사이에서 움직이는 선택 없이 GetAxisRaw처럼 고정된 숫자로 값이 반환되는데 이 부분이 InputSystem에서 설정으로 제어 가능한 부분이 아닌 것으로 현재 판단되어서 일단 damp를 사용해서 임의로 값을 증가, 증감시켜 범위 내 변하는 값으로 움직임을 처리한다.

이 값이 필요한 이유는 애니메이션을 블렌딩으로 처리하기 때문에 자연스러운 애니메이션을 표현하기 위해서 시작-도착 값까지의 변화하는 값이 필요하다.

유니티의 물리엔진의 기본 기능들의 샘플 구현

중력

유니티는 물리적인 오브젝트에는 중력과 힘 등의 물리 작용들이 적용된다.

물리적인 오브젝트란 Rigidbody 컴포넌트가 붙어있는 것으로 이 컴포넌트에서 중력의 적용 여부나 질량, 마찰력 등의 설정을 제어할 수 있다.

유니티의 중력은 Physics.gravity로 접근하여 값을 가져오고 변경할 수 있다.

이 중력은 Vector3 값으로 기본값은 현실과 동일하게 y 축으로 -9.81으로 되어있다.

이 값을 변경하면 중력을 다양한 방식으로 적용할 수 있다.

Rigidbody 컴포넌트의 drag 값은 항력을 제어한다. 하지만 이는 선형적인 값으로 현실적인 물리와는 차이가 있다.

angular drag는 회전 항력으로 회전력에 적용되는 저항력이다.

힘

물리적인 상태의 오브젝트에는 힘을 가해서 움직이거나 회전 또는 범위 내 오브젝트에 거리 비례 힘을 가하는 물리 기능들을 사용할 수 있다.

AddForce

물체에 특정 방향으로 특정 크기만큼의 힘을 가한다.

AddTorque

물체에 회전력을 준다.

AddExplosionForce

AddExplosionForce는 이 함수만 호출한다고 주변에 영향을 주는 것이 아니라 특정한 객체를 기준으로 영향을 줄 주변 객체를 직접 탐색하면서 AddExpolsionForce를 적용시킨다.

public void ApplyExplosion(float force, float radius)
{
    Collider[] colliders = Physics.OverlapSphere(transform.position, radius);
    foreach (Collider col in colliders)
    {
        Rigidbody rb = col.GetComponent<Rigidbody>();
        if (rb != null)
        {
            rb.AddExplosionForce(force, transform.position, radius);
        }
    }
}

샘플 프로젝트 Github 저장소

https://github.com/Bakcoding/unity-physics-sample.gi

디렉터리 구조나 파일의 위치, 이동, 삭제 등을 좀 편하게 하기 위해서 FTP를 연결해 로컬에서 관리할 수 있도록 한다.

FTP 툴은 FileZilla를 사용한다.

FileZilla

FileZilla를 실행하고 필요한 정보를 채운다.

호스트는 서버의 ip 주소, 사용자명과 비밀번호는 서버를 만들 때 입력했던 정보를 쓰면 된다.

포트는 FTP의 경우 기본적으로 21번 포트를 사용한다.

모든 정보를 입력하고 연결을 하면 디렉터리를 직관적으로 확인할 수 있다.

이제 GUI로 계층 구조를 직관적으로 확인할 수 있다.

FTP 사용을 하게 되면 파일을 관리하기 위해서는 읽기 뿐만 아니라 쓰기 권한도 필요하다. 서버에서 생성했던 파일은 소유자와 그룹 모두 서버에서만 사용할 수 있는 상태인데 일단 test.php를 로컬에서 변경할 것 이기 때문에 이 파일의 권한 중 그룹을 변경하고 쓰기 권한도 추가해 본다.

일단 파일들이 계속 추가될 것을 대비해서 폴더를 세분화해 둔다.

dev 경로를 생성해서 release 루트와 구분되도록 한다.

$sudo mkdir /home/username/html/dev

해당 경로로 test.php 이동

$sudo mv /home/username/html/test.php /home/username/html/dev/

test.php 권한 수정

// 읽기/쓰기 권한 부여
sudo chmod 664 /home/username/html/dev/test.php
// 소유자 , 그룹 수정
sudo chown apache:username /home/username/html/dev/test.php

php의 수정된 내용은 기존에 페이지가 열릴 때마다 테이블에 인서트 되던 것을 버튼 입력으로 처리 후 결괏값을 페이지에 반영하도록 수정했다.

<?php
// MySQL Connection
$servername = "localhost";
$username = "name";
$password = "password";
$dbname = "testdb";

//conn
$conn = new mysqli($servername, $username, $password, $dbname);

//conn check
if ($conn->connect_error){
	die("Connection failed: " . $conn->connect_error);
}
echo "Connected successfully";

// data insert test (폼에서 제출 버튼 클릭 시 실행)
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $sql = "INSERT INTO users (username, email) VALUES ('testuser', 'test@example.com')";
    if ($conn->query($sql) === TRUE) {
        echo "New record created successfully<br>";

        // 테이블 데이터 출력
        echo "<h3>Users Table:</h3>";
        $result = $conn->query("SELECT * FROM users");
        if ($result->num_rows > 0) {
            echo "<table border='1'><tr><th>ID</th><th>Username</th><th>Email</th></tr>";
            while($row = $result->fetch_assoc()) {
                echo "<tr><td>" . $row["id"]. "</td><td>" . $row["username"]. "</td><td>" . $row["email"]. "</td></tr>";
            }
            echo "</table>";
        } else {
            echo "0 results";
        }
    } else {
        echo "Error: " . $sql . "<br>" . $conn->error;
    }
}

$conn->close();
?>

<!-- 폼 추가 -->
<form method="POST" action="">
    <button type="submit">Submit</button>
</form>

로컬에서 수정한 test.php를 ftp를 사용해서 파일을 덮어쓰기 해본다.

이전에는 권한이 없어서 해당 동작이 실패했지만 권한 수정 후 문제없이 동작이 실행되었고 서버에서 vim으로 파일을 열어 변경된 내용을 확인해 보면 잘 바뀐 것을 확인할 수 있다.

이제 수정된 test.php 페이지를 열어본다.

 submit 클릭 시

FTP 연결까지 이상 없이 완료되었다.

리눅스 서버에서 db를 사용하기에는 불편함이 많아서 로컬에서 클라이언트 툴을 연결해서 사용하기로 한다.

툴은 평소에 자주 쓰던 HeidiSQL을 쓰기로 한다.

NHN에서 서버의 보안 그룹 관련된 내용을 보면 my_sql은 기본적으로 허용하지 않기 때문에 직접 서버의 콘솔 페이지에서 보안그룹에 들어가서 포트와 접근 ip에 대한 설정을 해주어야 한다.

대시보드 > 자세히 보기 > 프로젝트 명 선택

보안 그룹 관리에서 추가하여 상태를 변경해 준다.

수신 / 사용자 정의 TCP / 3306 (MY-SQL) / IPv4 / 내 로컬 주소 (CIDR)

CIDR은 IP 주소 범위를 지정하는 방법인데 0.0.0.0/0은 모든 IP 주소를 허용하는데 내 로컬 주소만 허용하기로 한다.

https://ipinfo.io/ 에서 확인하여 내 IP를 특정하여 입력해 준다.

이렇게 하면 콘솔에서 보안은 해결되었고 이제 서버의 mysql에 로그인해서 로컬에서 사용할 계정을 따로 추가하도록 한다.

CREATE USER 'user_id'@'user_ip' IDENTIFIED BY 'user_password';

계정은 접속할 수 있는 IP를 지정(내 로컬 ip)하여 생성한다.

그리고 이 계정에 권한을 준다.

GRANT ALL PRIVILEGES ON testdb.* TO 'user_id'@'user_ip';
FLUSH PRIVILEGES

위에서 만든 계정에 database_name 데이터베이스에 대한 모든 권한(.*)을 준다.

이제 이렇게 만든 계정으로 HeidiSQL에 로그인하면 

서버의 db를 GUI로 확인할 수 있어 편한 게 관리할 수 있게 되었다.

먼저 vim이란 텍스트 편집기이며 파일을 편집할 때 사용하는 만큼 다양한 명령어들에 대해서 알고 있어야 유의미한 활용이 가능하다.

vim은 모드마다 수행할 수 있는 동작들이 구분되며 vim을 사용해서 파일을 열게 되면 일반 모드로 시작하게 된다.

일반 모드

텍스트를 수정할 수 없으며 커서 이동, 삭제, 복사, 붙여 넣기 등의 명령을 실행할 수 있다.

커서 위치를 기준으로 동작하는 명령어들이 있는데 커서 위치는 방향키로 이동할 수 있다.

x : 커서 위치의 문자 하나 삭제

dd : 현재 줄 삭제

d$ : 커서부터 현재 행의 끝까지 삭제

d0 : 커서부터 현재 행의 시작까지 삭제

d{motion} : {motion}이 가리키는 텍스트를 삭제 ({motion}은 이동 명령어)

ex) dw는 단어 삭제

yy : 현재 줄 복사

y {motion} : {motion}이 가리키는 텍스트 복사

ex) yw는 한 단어 복사

p : 복사한 텍스트를 커서 뒤에 붙여 넣기

P : 복사한 텍스트를 커서 앞에 붙여 넣기

u : 마지막 변경 취소 (undo)

Ctrl + r : 마지막 취소 작업 복구 (redo)

입력 모드

텍스트를 수정할 수 있는 상태로 진입한다. esc로 일반모드 전환할 수 있다.

i : 커서 앞에 텍스트 입력 시작

I : 현재 행의 맨 앞에서 입력 시작

a : 커서 뒤에서 텍스트 입력 시작

A : 현재 행의 맨 끝에서 입력 시작

o : 다음 줄에 새 행을 추가하고 입력 모드로 전환

O : 현재 줄 위에 새 행을 추가하고 입력 모드로 전환

h : 왼쪽으로 한 칸 이동

j : 아래로 한 줄 이동

k : 위로한 줄 이동

l : 오른쪽으로 한 칸 이동

w : 단어 단위로 앞으로 한 칸 이동

b : 단어 단위로 뒤로 한 칸 이동

0 : 현재 행의 시작으로 이동

$ : 현재 행의 끝으로 이동

gg : 파일의 첫 번째 줄로 이동

G : 파일의 마지막 줄로 이동

/검색어 : 파일 내에서 '검색어'를 검색, 다음 단어로 이동은 n

? 검색어 : 파일 내에서 '검색어'를 역방향으로 검색, 이전으로 이동은 N

ZZ : 저장하고 종료

명령모드

vim의 명령어를 입력할 수 있는 모드로 : 를 입력해 진입할 수 있다.

:{숫자} : 지정한 줄로 이동 (:10은 10번 줄로 이동)

:w :현재 파일 저장

:w filename : 다른 이름으로 파일 저장

:q : vim 종료, 저장되지 않은 변경 사항이 있으면 경고가 뜬다.

:q! : 저장하지 않고 종료

:wq : 저장하고 종료

:set number : 줄 번호 표시

:set nonumber : 줄 번호 숨기기

:set ignorecase : 대소문자 구분 없이 검색

:set noignorecase : 대소문자 구분하여 검색

:set autoindent : 자동 들여 쓰기 활성화 (현재 줄의 들여 쓰기를 자동으로 이전 줄의 들여쓰기와 맞춰주는 기능)

:set smartindent : 스마트 들여쓰기 활성화 (코드 구조에 따라 들여쓰기를 조정하는 기능)

:set paste : 붙여 넣기 모드 활성화 (들여쓰기가 깨지지 않도록)

:set nopaste : 붙여넣기 모드 비활성화

:help : vim 도움말 열기

:split or :sp : 수평 분할

:vsplit or :vsp : 수직 분할

이 외 이동명령

Ctrl + f : 한 페이지 아래로 이동

Ctrl + b : 한 페이지 위로 이동

Ctrl + d : 파일에서 절반 정도 아래로 이동

Ctrl + u : 파일에서 절반 정도 위로 이동

Ctrl + w, s : 창을 수평으로 나누고 커서 이동

Ctrl + w, v : 창을 수직으로 나누고 커서 이동

Ctrl + w, q : 분할된 창 닫기

자주 사용되는 명령어를 생각날 때마다 정리하기로 한다.

ls

ls

list의 약자로 디렉터리 내의 파일과 폴더 목록을 나열하는 데 사용된다.

기본 사용법인 ls는 현재 디렉터리의 파일과 폴더 목록을 나열한다.

다른 디렉터리의 목록을 보려면

ls /path/to/directory

ls 뒤에 확인하고자 하는 경로를 입력한다.

옵션

ls -l

파일의 권한, 소유자, 크기, 수정 시간 등 상세 정보와 함께 목록을 표시한다.

ls -a

숨겨진 파일(점으로 시작하는 파일)도 포함하여 모든 파일을 나열한다.

ls -lh

파일 크기를 사람이 읽기 쉬운 형식으로 표시한다.

ls -R

하위 디렉터리까지 재귀적으로 목록을 나열한다.

ls -lt

수정 시간을 기준으로 파일을 정렬 (최근 수정된 파일 우선)

ls -lS

파일 크기를 기준으로 정렬 (큰 파일이 우선)

ls -lr

역순으로 정렬

ls -d */

디렉터리 자체만 표시 (디렉터리 내의 파일 목록은 표시되지 않음)

ls -1

한 줄에 하나의 파일만 표시

기본적으로 여러 열로 표시되지만, -1 옵션을 사용하면 한 줄에 하나씩 표시

man ls

이 외의 옵션들에 대한 매뉴얼을 확인할 수 있다.