기술 자료

Unity 엔진

Unity 엔진

입력 관리자

지원이 중단된 Input Manager 창에서 입력 축 및 키를 정의하기 위한 레퍼런스입니다.
읽는 시간 5분최근 업데이트: 9일 전

중요: 입력 관리자는 레거시 기능이며 새 프로젝트에는 권장되지 않습니다. 새 프로젝트의 경우에는 Input System 패키지를 사용해야 합니다.

Input Manager 창에서 입력 축과 해당 작업을 프로젝트에 정의할 수 있습니다. 액세스하려면 Unity 메인 메뉴에서 편집 > 프로젝트 설정으로 이동한 다음 오른쪽 내비게이션에서 입력 관리자를 선택합니다.
입력 관리자는 다음 컨트롤 타입을 사용합니다.
  • 키는 물리 키보드의 모든 키(예: W, Shift 또는 스페이스 바)를 의미합니다.
  • 버튼은 리모콘의 X 버튼과 같이 물리적 컨트롤러(예: 게임패드)의 모든 버튼을 의미합니다.
  • 가상 축(다수: 축)은 버튼이나 키와 같은 컨트롤에 매핑됩니다. 사용자가 컨트롤을 활성화하면 축에 [-1~1] 범위의 값이 수신됩니다. 스크립트에서 이 값을 사용할 수 있습니다.

물리 키

물리 키 옵션을 사용하면 지역별 사용자마다 다를 수 있는 언어별 레이아웃이 아닌 물리 키보드 레이아웃에 키 코드를 매핑할 수 있습니다.
예를 들어, 일부 키보드에서는 첫 번째 문자열이 "QWERTY", 다른 키보드에서는 "AZERTY"라고 표시됩니다. 즉, 이동에 알려진 "WASD" 키를 사용하도록 특정 컨트롤을 스크립팅한 경우 AZERTY 레이아웃 키보드의 화살표 키 배열과 같이 올바른 물리적 배열에 있지 않습니다.
물리 키를 활성화하면 Unity는 일반 ANSI/ISO "Qwerty" 레이아웃을 사용하여 사용자의 실제 레이아웃에 관계없이 키의 물리적 위치를 나타냅니다. 즉, "Q" 키를 지정하면 사용자의 키보드가 해당 포지션에 다른 문자가 있더라도 항상 문자 키의 첫 번째 행에서 가장 왼쪽에 있는 문자로 표시됩니다.
참고: 인게임 텍스트 입력을 위해 키 입력을 읽어서는 안 됩니다. 이는 사용자가 라틴어가 아닌 문자를 입력할 수 없기 때문입니다. 대신 를 사용합니다.

가상 축

생성하는 모든 프로젝트에는 기본적으로 여러 입력 축이 생성됩니다. 이러한 축을 사용하면 프로젝트에서 즉시 키보드, 마우스 및 조이스틱 입력을 사용할 수 있습니다.
이러한 축에 대한 자세한 내용을 보려면 Input Manager 창을 열고 축 이름 옆에 있는 화살표를 클릭하여 해당 속성을 펼칩니다.
각 입력 축에는 다음의 프로퍼티가 있습니다.

프로퍼티

**함수

이름축 이름。 스크립트에서 축에 액세스하는 데 사용할 수 있습니다.
설명 이름, 설명 음의 이름이러한 값은 지원이 중단되어 작동하지 않습니다. 이전에는 시작 시 사용자에게 Rebind Controls 화면에 표시되었지만, 이 화면도 지원이 중단되었습니다.
역 버튼, 양의 버튼축을 각각 음의 방향과 양의 방향으로 밀기 위한 컨트롤입니다. 키보드의 키일 수도 있고 조이스틱 마우스의 버튼일 수도 있습니다.
Alt 음의 버튼, Alt 양의 버튼축을 각각 음의 방향과 양의 방향으로 밀기 위한 대체 컨트롤입니다.
Gravity입력이 없을 때 축이 중립 방향으로 떨어지는 속도(초 단위)입니다.
죽음애플리케이션이 이동을 등록하기 전에 사용자가 아날로그 스틱을 이동해야 하는 거리입니다. 런타임 시 이 범위 내에 있는 모든 아날로그 디바이스의 입력은 null 간주됩니다.
민감도축이 타겟 값을 향해 이동하는 속도(초 단위)입니다. 디지털 디바이스 전용입니다.
Snap활성화하면 반대 방향에 해당하는 버튼을 누르면 축 값이 0으로 초기화됩니다.
Type축을 제어하는 입력 타입입니다. 다음 값 중에서 선택합니다.

- 키 또는 마우스 버튼
- 마우스 이동
- 조이스틱 축
축이 축을 제어하는 연결된 기기의 축입니다.
JoyNum이 축을 제어하는 연결된 조이스틱. 특정 조이스틱 선택하거나 모든 조이스틱에서 입력을 쿼리할 수 있습니다.
축 값은 다음과 같습니다.
  • 조이스틱 및 키보드 입력용 -1과 1 사이 이러한 축의 중립 포지션은 0입니다. 키보드의 버튼과 같은 일부 타입의 컨트롤은 입력 강도에 민감하지 않으므로 -1, 0, 1 이외의 값을 생성할 수 없습니다.
  • 마우스 델타(마우스가 마지막 프레임 동안 이동한 정도)를 마우스 입력에 사용합니다. 사용자가 마우스를 빠르게 움직일 때 마우스 입력 축의 값은 1보다 크거나 -1보다 작을 수 있습니다.

가상 축 추가, 제거 및 복사

가상 축을 추가하려면 크기 필드에 있는 숫자를 늘립니다. 그러면 리스트 하단에 새 축이 생성됩니다. 새 축은 리스트에 이전 축의 프로퍼티를 복사합니다.
가상 축을 제거하려면 다음 중 하나를 수행합니다.
  • 크기 필드에서 숫자를 줄입니다. 그러면 리스트의 마지막 축이 제거됩니다.
  • 축을 마우스 오른쪽 버튼으로 클릭하고 Array Element Delete를 선택합니다.
    참고: 이 작업을 실행 취소할 수 없습니다.
가상 축을 복사하려면 마우스 오른쪽 버튼을 클릭하고 Duplicate Array Element를 선택합니다.

가상 축을 컨트롤에 매핑

키 또는 버튼을 축에 매핑하려면 입력 관리자의 Positive Button 또는 Negative Button 프로퍼티에 해당 이름을 입력합니다.
키 이름은 다음 명명 규칙을 따릅니다.

키 패밀리

명명 규칙

문자 키
a
,
b
,
c
...
숫자 키
1
,
2
,
3
...
화살표 키
up
,
down
,
left
,
right
숫자 키
[1]
,
[2]
,
[3]
,
[+]
,
[equals]
...
수정 키
right shift
,
left shift
,
right ctrl
,
left ctrl
,
right alt
,
left alt
,
right cmd
,
left cmd
특수 키
backspace
,
tab
,
return
,
escape
,
space
,
delete
,
enter
,
insert
,
home
,
end
,
page up
,
page down
함수 키
f1
,
f2
,
f3
...
마우스 버튼의 이름은
mouse 0, mouse 1, mouse 2,
등입니다.
조이스틱 버튼은 다음 명명 규칙을 따릅니다.

버튼 원점

명명 규칙

모든 조이스틱 특정 버튼
joystick button 0
,
joystick button 1
,
joystick button 2
...
특정 조이스틱 특정 버튼
joystick 1 button 0
,
joystick 1 button 1
,
joystick 2 button 0
...
Input.GetKey
및 위에서 지정된 명명 규칙을 사용하여 특정 키 또는 버튼에 대한 입력을 쿼리할 수도 있습니다. 예제는 아래와 같습니다.
Input.GetKey("a");
키에 액세스하는 또 다른 방법은
KeyCode
열거를 사용하는 것입니다.

스크립트에서 가상 축 사용

스크립트에서 가상 축에 액세스하려면 축 이름을 사용할 수 있습니다.
예를 들어 수평 축의 현재 값을 쿼리하여 변수에 저장하려면 다음과 같이
Input.GetAxis
를 사용할 수 있습니다.
float horizontalInput = Input.GetAxis ("Horizontal");
움직임이 아닌 이벤트를 설명하는 축(예: 게임에서 무기 발사)의 경우 대신
Input.GetButtonDown
를 사용합니다.
두 개 이상의 축의 이름이 동일하면 쿼리는 절대값이 가장 큰 축을 반환합니다. 이렇게 하면 축 이름에 두 개 이상의 입력 디바이스를 할당할 수 있습니다.
예를 들어 Horizontal이라는 두 개의 축을 만들고 하나는 키보드 입력에 할당하고 다른 하나는 조이스틱 입력에 할당할 수 있습니다. 사용자가 조이스틱 사용하는 경우, 입력은 조이스틱 가져오고 키보드 입력은 null. 그렇지 않으면 키보드에서 입력되고 조이스틱 입력은 null. 이를 통해 여러 컨트롤러의 입력을 다루는 단일 스크립트를 작성할 수 있습니다.
예제
수평 및 수직 축과
transform.Translate
메서드의 입력을 사용하여 XZ 공간(앞, 뒤, 왼쪽 또는 오른쪽)에서 게임 오브젝트를 이동할 수 있습니다. 이동하려는 게임 오브젝트에 연결된 스크립트의
update()
메서드에 다음 코드를 추가합니다.
float moveSpeed = 10;//Define the speed at which the object moves.float horizontalInput = Input.GetAxis("Horizontal");//Get the value of the Horizontal input axis.float verticalInput = Input.GetAxis("Vertical");//Get the value of the Vertical input axis.transform.Translate(new Vector3(horizontalInput, verticalInput, 0) * moveSpeed * Time.deltaTime);//Move the object to XYZ coordinates defined as horizontalInput, 0, and verticalInput respectively.
Time.deltaTime
는 마지막 프레임 이후 경과한 시간을 나타냅니다.
moveSpeed
변수를
Time.deltaTime
로 곱하면 게임 오브젝트가 프레임마다 일정한 속도로 움직입니다.