요즘 퇴근 후 유니티 강의를 듣고 있다. 일단 2D 게임 튜토리얼을 모은 강의들을 듣고 있는데,

가장 최근 만들고 있는 건 똥피하기 게임이다.

현재 좌우 방향키 전환 시 플레이어가 움직이는 스크립트를 만들었는데 강의에서는 별다른 설명없이 Unity API를 쓰더라. (대충 "transform은 캐릭터를 움직이는 거에요." 정도로)

사실 Unity 입문자 강의이며 프로그래밍 경험이 없는 사람들도 이해할 수 있도록 배려하는 강의기 때문에 C# API, Unity의 시스템, 구성요소를 줄줄 설명하고 있을 수 없는건 십분 이해한다.

그래서 내가 써본 Unity API들을 따로 알아보고 정리해두려고 포스팅을 해본다.

스크립트 원문

위 스크린샷의 개구리 캐릭터가 돌아다니게 만드는 스크립트다.

Start와 Update로 이루어져 있는게 p5.js의 구조와 거의 같다.

결국 유니티도 인터랙티브 코딩의 일종인 것이다.

using System;
using UnityEngine;

public class Player : MonoBehaviour
{
private Animator animator;
[SerializeField] private float moveSpeed = 5.0f;

// Start is called once before the first execution of Update after the MonoBehaviour is created
void Start()
{
animator = GetComponent<Animator>();
}

// Update is called once per frame
void Update()
{
if (Input.GetKey(KeyCode.LeftArrow))
{
// 왼쪽 방향키 눌렀을 때
Vector3 currScale = transform.localScale;
transform.localScale = new Vector3(-Mathf.Abs(currScale.x), currScale.y, currScale.z);
transform.position += Vector3.left * moveSpeed * Time.deltaTime;
animator.SetBool("isRunning", true);
}
else if (Input.GetKey(KeyCode.RightArrow))
{
// 오른쪽 방향키 눌렀을 때
Vector3 currScale = transform.localScale;
transform.localScale = new Vector3(Mathf.Abs(currScale.x), currScale.y, currScale.z);
transform.position += Vector3.right * moveSpeed * Time.deltaTime;
animator.SetBool("isRunning", true);
}
else
{
animator.SetBool("isRunning", false);
}
}
}

Vector3

정의:

자료형은 struct. (C#의 자료형 중 하나인데, 클래스와 유사한 구조를 가지고 있는데 참조 타입이 아니라 값 타입이다.)

3차원 벡터/좌표를 표현하는 타입.x, y, z필드를 보유한다. 그냥 쉽게 말해 3차원 좌표값을 정의한다.

활용 예시:

// 생성
var v = new Vector3(1f, 2f, 3f); // (x=1, y=2, z=3)

// 필드
float x = v.x; float y = v.y; float z = v.z;

// 상수(단위 방향/자주 쓰는 값)
Vector3.zero // (0,0,0)
Vector3.one // (1,1,1)
Vector3.right // (1,0,0)
Vector3.left // (-1,0,0)
Vector3.up // (0,1,0)
Vector3.down // (0,-1,0)
Vector3.forward // (0,0,1)
Vector3.back // (0,0,-1)

// 활용예시
transform.position += Vector3.left * speed * Time.deltaTime;

주요 메서드:

normalized,magnitude,Lerp(a,b,t),Dot,Cross

... 같은 것들이 있다고는 하는데 사실 잘 안 써봐서 모르겠다. 아직 활용해보지 않은걸 열심히 정리하는건 시간낭비라는 주의라 생략하겠다.

Animator

정의:

애니메이션 상태머신(Animator Controller)을 재생/전이시키는컴포넌트.

애니메이션용 useState라고 보면 된다. 위 코드에선 isRunning을 만들어서 이를 불린 값으로 관리한다.

파라미터 제어:

SetBool,SetFloat,SetInteger,SetTrigger로 상태 전환 트리거.

Input

정의:

구식 입력 API (구식인 이유는 신식이 나왔기 때문이다. 지금 강의는 구식을 쓰고 있으니 구식 정리하겠다.)

웹과의 비교:

웹:

알다시피 DOM 이벤트(keydown, keyup, input/change)를 리스너로 수신하며 이를 콜백함수에서 리액션을 처리한다.

OS단에서 입력을 브라우저의 메시지큐로 이벤트를 넣어줘야 그에 대한 리액션으로 뭔가 생기는 것이다. (이벤트 드리븐) 즉, 브라우저는 기본적으로 외부에서 이벤트를 push해줄때까진 아무 일도 하지 않는다.

유니티:

유니티는 위 Input이란 모듈이 계속 프레임단위로 입력을 폴링해서 수신한다고 한다.

매 프레임마다 폴링한다니 성능 괜찮은거 맞나? 라고 생각했는데 사실 큰 문제는 안 된다고 한다.

매 프레임 별로 입력장치의 로그가 경량화되어 입력되면, 유니티 엔진이 매 프레임마다 읽는 방식이라고 한다. 병목 걱정은 안 해도 된다는 듯.. (뭔가 유니티가 더 적극적으로 이벤트를 처리하는 모델인거 같다. 프레임별로 입력을 적극적으로 뒤지네..)

입력 범위:

키보드

Input.GetKey(KeyCode.A): 누르는 동안true

Input.GetKeyDown(KeyCode.A): 누른 그 프레임만 true

Input.GetKeyUp(KeyCode.A): 뗀 그 프레임만 true

마우스

Input.GetMouseButton(0/1/2) / GetMouseButtonDown / GetMouseButtonUp

Input.mousePosition: 화면 좌표(px)

Input.GetAxis("Mouse X"),"Mouse Y"

축/스틱

Input.GetAxis("Horizontal"),"Vertical": -1~1,스무딩 적용

Input.GetAxisRaw(...): 스무딩 없이 즉각 -1/0/1

이 이름들은Project Settings → Input Manager에서 맵핑 가능

터치

Input.touchCount,Input.GetTouch(i)(Touch.phase,position, …)

기타

Input.anyKey,anyKeyDown

Input.imeCompositionMode,compositionString(IME 조합)

GetComponent()

[정의]

같은 GameObject에 붙은 컴포넌트 조회.

즉 쉽게 말하면, 인스펙터 창에 붙은 컴포넌트들 다 불러와서 속성 제어할 수 있게 해준다.

사실 엄밀히 말하면 인스펙터 창에 있는 것들도 GameObject에 붙어있는 것들 보여주는 거지만..

위 예시에선 animator = GetComponent();로 썼다.

transform

[정의]

모든 GameObject가 가지는Transform 컴포넌트(위치/회전/스케일)

[Transform이 다루는 3요소]

position(Vector3):월드 좌표

rotation(Quaternion)/eulerAngles(Vector3):월드 회전

localScale(Vector3):부모 기준 스케일

로컬 기준값도 있음:localPosition, localRotation→ 부모를 원점/기준으로 본 위치와 회전

[월드 vs 로컬] (가장 중요한 개념)

월드 기준: 씬 전체 좌표계.

ex: transform.position,transform.rotation

로컬 기준:부모를 (0,0,0)·(0,0,0)·(1,1,1)로 보는 좌표계.

ex: localPosition, localRotation, localScale

부모의 이동/회전에 따라 자식의월드 값이 함께 변하지만, 자식의 로컬 값은 부모 기준으로 유지된다.

[비유]

월드 기준인 transform.position은 웹의 css에서 position: fixed랑 비슷하다고 보면 된다.뷰포트를 월드로 본다면.

물론 유니티는 월드가 정확히 뷰포트랑 1:1이진 않는다.

로컬 기준은 그야말로 position: absolute랑 유사하다.

[SerializeField]

[정의]

private 필드라도 인스펙터에 노출시켜서 편집 가능하게 만드는 속성 (Attribute).

[위 예시]

[SerializeField] private float moveSpeed = 5.0f;

[효용]

디자이너나 기획자가 값 조절 가능 => 협업 편하다.

public으로 열지 말고 가능하면 SerializeField + private 권장한다고 한다. 이유는 나중에 자세히 알아보도록 하겠다.

SerializedField가 없었다면.gif

물론 앉아있는게 딸깍거리고 있는게 개발자다.

정리 소감?:

어우 힘들다.. 역시 블로그 글 쓰는 건 힘들다. 또한 장시간 글쓰면서 에디터 버그도 발견했다.

(하 그냥 검증된 에디터 쓸걸.. 괜히 무료 Notion-like 찾는다고 고생만 하고 제대로 쓰려니 버그만 많네.

여기 버그 픽스하면서 라이브러리 기여해볼까..)

하여튼 유니티를 곁핡기로 정리해봤는데, 확실히 웹 API를 어느정도 아니까 비교하면서 이해하기 좋은거 같다.

웹으로 인터랙티브 코딩한 경험이 유니티 프로그래밍에 도움을 주는걸 보면 개발은 역시 상호보완적이다.