입력 Input - 유니티3D ( Unity3D )

문서의 이전 판을 선택했습니다! 저장하면 이 자료로 새 판을 만듭니다.

======입력 Input======

======데스크톱 Desktop======
유니티는 키보드, 조이스틱과 게임패드 입력을 지원함.

:!: 키보드, 조이스틱, 게임패드 입력은 유니티의 데스크탑 버전에서만 작동.

가상 축과 버튼은 [[unity:class-inputmanager|입력 매니져 Input Manager]] (**Edit->Project Settings->Input**)에서 만들수 있고 사용자는 키보드 입력을 화면 설정 대화창 screen configuration dialogue 에서 설정할 수 있다.

사용자는 조이스틱, 게임패드, 키보드 그리고 마우스를 설정하고 그것들 모두를 하나의  간단한 스크립팅 인터페이스를 통해 접근할 수 있다.

스크립트에서 모든 가상 축은 그들의 이름을 통해 접근하게 된다.

모든 프로젝트는 생성되었을 때 아래의 기본 입력 축 input axe 을 가진다:

* //수평 Horizontal// and //수직 Vertical//은 w, a, s, d와 화살표 키로 연결 map 되어 있다.
  * //발사 Fire1//, // 발사 Fire2//, // 발사 Fire3// 는 각각 Ctrl, Option (Alt), Command으로 연결되어 있다.
  * //마우스 Mouse X// 와 //마우스 Mouse Y// 는 마우스 이동의 델타 delta 와 연결되어 있다.
  * //윈도우 셰이크 Window Shake X// 와//윈도우 셰이크 Window Shake Y// 는 윈도우 이동과 연결되어 있다.

====새로운 입력 축 추가하기 Adding new Input Axes====

새로운 입력 축을 추가하고 싶으면 **Edit->Project Settings->Input** 메뉴로 간다. 여기서 각 축의 설정도 바꿀수 있다.

사용자는 각각의 축을 조이스틱, 마우스, 또는 키보드 키들의 두개의 버튼들에 연결.

입력의 더 나은 모양과 느낌을 위해서 위의 설정을 이용하라. 이들은 모두 에디터에 풍선도움말 tooltips 로도 볼 수 있다.

====스크립트에서 입력 축 이용하기 Using Input Axes from Scripts====
사용자는 이런 스크립트를 통해 현재 상태를 아래와 같이 물을 query 수 있다:

<file csharp>value = Input.GetAxis ("Horizontal"); </file>

축은 -1부터 1까지의 값을 가진다. 중립 위치는 0이다.
이것은 조이스틱과 키보드 입력의 경우이다.

그러나 마우스 델타 Mouse Delta 와 윈도우 셰이크 델타 Window Shake Delta 는 마지막 프레임동안 얼마나 마우스나 윈도우가 움직였는가 이다. 즉 이것은 사용자가 마우스를 빨리 움직이면 그것이 1보다 크거나 -1보다 작을 수도 있다는 말이다.

같은 이름으로 여러 개의 축을 만드는 것은 가능. 입력 축 input axis 을 얻을 때는 가장 큰 절대값을 가진  축이 불려온다. 이것은 하나의 축 이름에 하나 이상의 입력 장치를 할당하는 것을 가능하게 . 예를 들어, 키보드 입력을 위한 축 하나를 만들고 같은 이름으로 조이스틱 입력을 위한 축을 만듭니다. 만약 사용자가 조이스틱을 이용하면 입력은 조이스틱에서 올 것이고 그렇지 않으면 입력은 키보드에서 오게 될 것이다. 이 방식을 통하여 사용자는 스크립트를 작성할 때 입력이 어디서 올 지 신경쓸 필요가 없게 된다.

====버튼 이름 Button Names====

하나의 키를 어떤 축과 연결시키기 위해서는 키의 이름을 ''인스펙터 Inspector''에 //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"
  * 마우스 버튼: "mouse 0", "mouse 1", "mouse 2", ...
  * 조이스틱 버튼 (모든 조이스틱에서): "joystick button 0", "joystick button 1", "joystick button 2",  ...
  * 조이스틱 버튼(특정 조이스틱에서): "joystick button 0", "joystick button 1", "joystick 1 button 0", ...
  * 특수 키: "backspace", "tab", "return", "escape", "space", "delete", "enter", "insert", "home", "end", "page up", "page down"
  * 기능 키: "f1", "f2", "f3", ...

키들을 식별하기 위한 이름은 스크립팅 인터페이스에서나 인스펙터에서나 같다.

<file csharp>value = Input.GetKey ("a"); </file>

======모바일 입력 Mobile Input======
유니티 iOS/안드로이드는 [[ScriptRef:Input.html|Input]]과 [[ScriptRef:iPhoneInput.html|iOS Input]] 스크립트 인터페이스를 통해 아이폰, 아이패드, 그리고 안드로이드 입력 시스템에 접근할 수 있게 해준다.

[[ScriptRef:Input.html|Input]]은 멀티터치 스크린, 가속도계 accelerator 그리고 기기의 화면방향 device orientation 에 접근하게 해준다.
[[ScriptRef:iPhoneInput.html|iOS Input]] 는 지리적 위치 정보에 접근하게 해준다.

모바일 장치에서 키보드로의 접근은 [[unity:MobileKeyboard#iOS|iOS keyboard]]를 통해 제공된다.

=====멀티터치 스크린 Multi-Touch Screen=====

아이폰과 아이팟 터치 장치는 다섯 손가락의 동시 터치를 감지할 수 있다. 사용자는 [[ScriptRef:Input-touches.html|Input.touches]] 속성 배열 property array 을 통해 마지막 프레임 동안 화면을 만진 각 손가락에 대한 상태를 가져올 수 있다.

안드로이드 장치들은 한번에 얼마나 많은 손가락 터치를 감지할 지에 대한 일관된 제한 기준이 없다. 조금 오래된 장치에서는 두 손가락 터치, 조금 더 최신 장치에서는 다섯 손가락까지 이것은 장치마다 다 틀립니다.

다음은 유저가 화면을 탭 할때마다 광선 ray 을 뿌리는 예제 스크립트이다:
<file csharp>
var particle : GameObject;
function Update () {
    for (var touch : Touch in Input.touches) {
        if (touch.phase == TouchPhase.Began) {
            //현재 터치 좌표에서 광선을 만듭니다.
            var ray = Camera.main.ScreenPointToRay (touch.position);
            if (Physics.Raycast (ray)) {
                //히트시 파티클을 생성.
                Instantiate (particle, transform.position, transform.rotation);
            }
        }
    }
}
</file>

====마우스 시뮬레이션 Mouse Simulation====
본래의 터치 지원 이외에도 유니티 iOS/안드로이드는 마우스 시뮬레이션을 제공. 사용자는 표준 [[ScriptRef:Input.html|Input]] 클래스에서 마우스 기능을 사용할 수 있다.

=====장치 방향 Device Orientation=====
유니티 iOS/안드로이드는 사용자가 3차원 공간에서 기기의 실제 물리적 방향의 분리된 정보를 얻는 것을 가능하게 . 사용자가 어떻게 장치를 들고 있는가에 따라 게임의 행동 behaviors 이 반응하게 만들고 싶다면 방향 변화의 감지는 유용히 쓰일 수 있다.

=====가속도계 Accelerometer=====
모바일 장치가 움직이면서 내장된 가속도계 accelerometer 는 3D 공간에서 일차적인 세 개의 축에 대한 선형 가속 변화 llinear acceleration changes 를 보고. 각 축 방향으로의 가속은 G-force 값으로 하드웨어에 의해 직접 보고 되어진다. 값 1.0은 주어진 축에서 +1g의 양을 나타내며 -1.0은 -1g를 나타냅니다. 만약 사용자가  장치를 정면으로 보고 똑바로 세워서 잡고 있으면 (홈버튼이 바닥에 위치) X축은 오른쪽으로 양수값이며 Y축은 위쪽으로 양수이며 Z축은 사용자 쪽으로 양수값을 가진다.

가속도계 값은 [[ScriptRef:Input-acceleration.html|Input.acceleration]] 속성에서 얻을 수 있다.

아래는 가속도계를 이용해서 객체를 움직이는 예제 스크립트이다:
<file csharp>
var speed = 10.0;
function Update () {
    var dir : Vector3 = Vector3.zero;

// 장치가 지면과 평행하게 놓여있다고 가정
    // 홈 버튼이 오른손 쪽에 위치해 있다

// 장치 가속도 축을 게임 좌표에 재적용:
    //  1) 장치의 XY 평면이 XZ평면에 적용된다
    //  2) Y축을 따라 90도 회전 되었다.
    dir.x = -Input.acceleration.y;
    dir.z = Input.acceleration.x;

// 가속 벡터를 단위 구 unit sphere 에 고정.
    if (dir.sqrMagnitude > 1)
        dir.Normalize();

//이것을 프레임당 10미터 대신 초당 10미터로 이동하게 만듭니다.
    dir *= Time.deltaTime;

//객체를 이동.
    transform.Translate (dir * speed);
}
</file>

====로우-패스 필터 Low-Pass Filter====
가속도계를 읽는 것은 불규칙한 곳들과 노이즈가 많다. 로우-패스 필터 Low-pass filter 를 신호 signal 에 적용시키는 것은 사용자가 그것을 완화시키고 고주파 노이즈를 제거하게 해준다.

아래의 스크립트는 사용자가 어떻게 로우-패스 필터를 가속도계 읽기에 적용시키는지 보여준다:
<file csharp>
var AccelerometerUpdateInterval : float = 1.0 / 60.0;
var LowPassKernelWidthInSeconds : float = 1.0;

private var LowPassFilterFactor : float = AccelerometerUpdateInterval / LowPassKernelWidthInSeconds; // tweakable
private var lowPassValue : Vector3 = Vector3.zero;
function Start () {
    lowPassValue = Input.acceleration;
}

function LowPassFilterAccelerometer() : Vector3 {
    lowPassValue = Mathf.Lerp(lowPassValue, Input.acceleration, LowPassFilterFactor);
    return lowPassValue;
}
</file>

''LowPassKernelWidthInSeconds'' 의 값이 클수록 필터된 값이 현재 입력 샘플 input sample 에 모이는 것이 느려지게 될 것이다 (반대의 경우도 마찬가지). 사용자는 ''avgSamples()'' 대신 ''LowPassFilter()'' 함수를 사용할 수 있다.

====가속도계를 읽을 때 가장 정밀한 값을 원한다면 어떻게 해야 하나요?====

[[ScriptRef:Input-acceleration.html|Input.acceleration]] 변수를 읽는 것은 하드웨어를 샘플링하는 것과 같은 것이 아니다. 간단히 말하면 유니티는 하드웨어를 60Hz의 빈도로 샘플을 모으며 그 결과를 해당 변수에 저장. 현실적으로는 이것은 조금 더 복잡. 만약 CPU에 부담이 굉장히 많은 상황이 되면 가속도계의 샘플링은 일정한 시간 간격으로 일어나지 않는다. 그 결과 시스템은 한 프레임에선 2개의 샘플을 보고하기도 하고 다음 프레임에선 1개의 샘플을 보고하기도 .

프레임에서 가속도계가 그 프레임에서 실행한 모든 측정 정보에 접근할 수 있다. 아래의 코드는 마지막 프레임안에서 수집된 모든 가속도계 이벤트의 간단한 평균을 보여줄 것이다:

<file csharp>
var period : float = 0.0;
var acc : Vector3 = Vector3.zero;
for (var evnt : iPhoneAccelerationEvent  in iPhoneInput.accelerationEvents) {
    acc += evnt.acceleration * evnt.deltaTime;
    period += evnt.deltaTime;
}
if (period > 0)
    acc *= 1.0/period;
return acc;
</file>

=====추가 읽기 Further Reading=====

유니티 모바일 입력 API는 원래 애플의 API에 기반을 둡니다. 유니티의 입력 API를 더 잘 이해하기 위해서는 원래 API를 배우면 도움이 될 것이다. 아래에서 애플 입력 API문서를 찾을 수 있다:
*[[file:///Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.AppleiPhone2_0.iPhoneLibrary.docset/Contents/Resources/Documents/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/EventHandling/chapter_8_section_1.html|Programming Guide: Event Handling (애플 아이폰 SDK 문서)]]
*[[file:///Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.AppleiPhone2_0.iPhoneLibrary.docset/Contents/Resources/Documents/documentation/UIKit/Reference/UITouch_Class/Reference/Reference.html|UITouch Class Reference (애플 iOS SDK 문서)]]

_주의:_ 위 링크들은 사용자의 로컬 설치된 아이폰 SDK 참조 문서 iPhone SDK Reference Documentation 를 참조하고 본래 ObjectiveC 코드를 포함하고 있을 것이다. 유니티를 모바일 장치에서 사용하기 위해 꼭 위의 문서들을 이해할 필요는 없으나 도움이 되는 분들이 있을 것이다!

======iOS!======
[[#iPhoneInput]]

=====장치의 지리적 위치 Device geographical location=====
장치의 지리적 위치는 [[ScriptRef:iPhoneInput-lastLocation.html|iPhoneInput.lastLocation]] 속성을 통해 얻을 수 있다. 사용자는 이 속성을 호출하기 전에 [[ScriptRef:iPhoneSettings.StartLocationServiceUpdates.html|iPhoneSettings.StartLocationServiceUpdates()]]를 이용해서 위치 서비스 업데이트를 시작하고 [[ScriptRef:iPhoneSettings-locationServiceStatus.html|iPhoneSettings.locationServiceStatus]]를 통해 서비스 상태를 확인해야 할 것이다. 자세한 사항은 [[ScriptRef:iPhoneSettings.StartLocationServiceUpdates.html|scripting reference]]를 보라.

{{tag>유니티 unity}}
   * 출처: [[http://unitykoreawiki.com/index.php?n=KrMain.Input|유니티코리아위키]] (CC BY-NC-SA 2.0)

편집 요약

참고: 이 문서를 편집하면 내용은 다음 라이선스에 따라 배포하는 데 동의하는 것으로 간주합니다: CC Attribution-Noncommercial-Share Alike 4.0 International

연결문서