기술 자료

Unity 엔진

Unity 엔진

웹의 입력(Input in Web)

Unity Web이 지원하는 다양한 입력 유형입니다.
읽는 시간 5분최근 업데이트: 9일 전

Unity Web은 게임패드, 조이스틱, 터치스크린, 키보드 및 움직임 센서를 비롯한 다양한 유형의 입력을 지원합니다.

게임패드 및 조이스틱 지원

웹은 게임패드용 다음의 입력을 지원합니다.
웹은 HTML5 게임패드 API를 지원하는 브라우저용 조이스틱도 지원합니다.
일부 브라우저는 애플리케이션이 포커스에 있는 동안 사용자가 기기와 상호 작용한 후에만 입력 기기에 대한 액세스를 허용합니다. 이 타입의 보안 조치는 사용자가 브라우저 핑거프린팅 목적으로 연결된 디바이스를 사용하지 못하도록 방지합니다. 따라서 Input.GetJoystickNames()를 호출하여 연결된 디바이스를 확인하기 전에 애플리케이션에서 사용자에게 게임패드/조이스틱의 버튼을 누르도록 지시해야 합니다.

컨트롤러 매핑

이전 Input System의 웹 게임 컨트롤러 매핑은 버튼 매핑 레이아웃이 다음과 같이 배치된 W3 사양에 부합합니다.

Buttons

설명

buttons[0]오른쪽 클러스터의 하단 버튼 = 크로스(X)
buttons[1]오른쪽 클러스터의 오른쪽 버튼 = 원
buttons[2]오른쪽 클러스터의 왼쪽 버튼 = 사각형
buttons[3]오른쪽 클러스터의 상단 버튼 = 삼각형
참고
웹은 W3 사양을 따르므로 다른 플랫폼과 일치하지 않을 수 있으며, Windows Web과 같은 여러 플랫폼을 동시에 타게팅하는 경우 다른 접근 방식이 필요합니다. 자세한 내용은 리매핑에 대한 W3 기술 자료를 참고하십시오.

터치 지원

Unity Web은 터치가 지원되는 브라우저 및 기기에서 Input.touches 및 기타 관련 API를 구현합니다. 기본적으로 모바일 디바이스는 사용자가 UI 입력 필드에 텍스트를 입력할 수 있도록 터치 화면에 소프트 키보드를 표시합니다. 이 동작을 비활성화하려면 WebGLInput.mobileKeyboardSupport 프로퍼티를 사용합니다.

키보드 입력 및 포커스 처리

기본적으로 Unity Web은 웹 페이지에 포커스가 있는지 여부와 관계없이 모든 키보드 입력을 처리합니다. 이를 통해 사용자는 웹 캔버스를 클릭 수 필요 없이 키보드 기반 애플리케이션을 사용할 수 있습니다.
다음 참고 사항은 아래에 설명된 대로 특정 키보드 입력에 적용됩니다.

키보드 입력 동작

설명

HTML 요소(예: 텍스트 필드)키보드 입력을 수신할 웹 페이지에 텍스트 필드와 같은 HTML 요소를 도입하면 오류가 발생할 수 있습니다. Unity 입력 이벤트를 수신하기 전에 해당 이벤트를 사용합니다.
HTML 요소가 키보드 입력을 수신하도록 하려면
WebGLInput.captureAllKeyboardInput
를
false
로 설정합니다. 이렇게 하면 웹 캔버스에 포커스가 있는 경우에만 애플리케이션이 입력을 수신합니다.
Esc 키Safari와 같은 일부 브라우저는 웹 환경에서 Esc 키가 보호되므로 전체 화면 모드로 전환하기 위해 Esc 키를 사용하는 기능을 차단합니다. Google Chrome과 같은 다른 브라우저는 예측할 수 없게 동작할 수 있습니다. 브라우저가 전체 화면 모드일 때 사용자는 전체 화면 모드를 종료하기 위해 Esc 키만 사용할 수 있습니다. 브라우저 유형에 따라 Esc 키를 클릭해도 브라우저에서 애플리케이션으로 이벤트를 전달하도록 트리거하는 것은 아닙니다.
HideMobileInput
TextMeshPro(TMP라고도 함) 입력 필드의
HideMobileInput
옵션은 웹 플랫폼에 영향을 미치지 않습니다. 브라우저에서 가상 키보드를 트리거하기 위해 텍스트 입력 필드가 필요하므로 이 옵션은 영향을 미치지 않습니다. 웹 플랫폼은 텍스트 입력 필드를 인스턴스화하여 Unity 플레이어 텍스트 입력을 기대할 때 가상 키보드를 트리거합니다. 텍스트 입력 필드는 다른 플랫폼과 마찬가지로 가상 키보드 위에 나타납니다. 가상 키보드는 모바일 텍스트 입력 필드에 의존하므로 웹 플랫폼에서 숨겨져 표시할 수 없습니다.

모바일 센서 지원

터치가 지원되는 브라우저 및 모바일 디바이스의 경우 Unity Web은 다음 센서를 지원합니다.
중요
브라우저는 안전한 컨텍스트에서만 센서 입력을 허용합니다. 즉 HTTPS를 통해 페이지를 제공해야 합니다. 개발 중에 사용할 수 있는
http://localhost
만 예외입니다.

커서 잠금 지원

Unity 웹 플랫폼은 HTML5 API
Element.requestPointerLock
를 사용하는 커서 잠금을 지원합니다. 커서를 사용하여 마우스 커서를 게임 창의 중앙에 고정합니다. 커서를 잠그면 Unity 숨겨진 상태로 표시되고 마우스를 움직일 때 움직이지 않습니다. 이는 일반적으로 마우스 커서를 사용하여 플레이어 각도의 방향을 제어하는 1인칭 게임에 특히 유용합니다.
참고
커서 잠금에 대한 브라우저 지원이 달라지기 때문에 Element: requestPointerLock() 메서드에 대한 Mozilla 문서를 참조하십시오.

커서 잠금 활성화

커서를 잠그려면
Cursor.lockState
프로퍼티를 사용합니다. 예를 들어 사용자가 마우스 왼쪽 버튼을 클릭하면 다음 코드는 커서를 잠긴 상태로 전환합니다.
void Update(){ if (Input.GetMouseButtonDown(0)) { Cursor.lockState = CursorLockMode.Locked; }}
커서 잠금은 사용자 상호작용에 의해 활성화되어야 합니다. 자세한 내용은 전체 화면 모드 및 커서 잠금에 대한 추가 고려 사항을 참조하십시오.

커서 잠금 비활성화

커서를 잠금 해제하려면 Esc 키를 누릅니다.

스티커 커서 잠금

stickyCursorLock
프로퍼티는 브라우저 동작에 관계없이 커서 잠금 모드를 유지하는 데 유용하기 때문에 일반적으로 1인칭 게임에서 사용됩니다.
브라우저가 Unity 캔버스에서 커서 잠금을 해제하는 경우(일반적으로 Esc 키를 사용하는 경우)에도
Cursor.lockState
상태가 지속되도록 하려면
stickyCursorLock
을 사용합니다. 이 경우 커서가 다음 번에 캔버스에 포커스가 맞을 때 다시 잠겨집니다.
따라서
WebGLInput._stickyCursorLock
를
true
로 설정하면 Unity 캔버스 HTML 요소가 커서를 잠금 해제하더라도
Cursor.lockState
는
CursorLockMode.Locked
상태로 유지됩니다.
WebGLInput._stickyCursorLock
를
false
로 설정하면 다음이 발생합니다.
  • Cursor.lockState
    는 브라우저의 커서 잠금 상태와 동기화 상태로 유지됩니다.
  • 사용자가 Esc 키를 눌러 캔버스 커서 잠금을 취소하면
    Cursor.lockState
    가
    CursorLockMode.None
    로 변경됩니다.
참고
웹에서
stickyCursorLock
는 기본적으로
true
로 설정됩니다.

전체 화면 모드

게임에서 전체 화면 모드를 사용하여 다음을 수행할 수 있습니다.
  • 게임에 화면 전체를 사용합니다.
  • 주소 표시줄과 탭과 같은 브라우저 사용자 인터페이스(UI) 요소를 숨깁니다.
  • 제목 표시줄과 툴바 같은 Unity 플레이어 UI 요소를 숨깁니다.
Unity 웹 플랫폼은 HTML5 API,
Element.requestFullscreen
를 사용하는 전체 화면 모드를 지원합니다.
참고
전체 화면 모드에 대한 브라우저 지원이 달라지므로 Element: requestFullscreen() 메서드에 대한 Mozilla 문서를 참조하십시오.

웹에서 전체 화면 모드 활성화

전체 화면 모드를 활성화하려면
Screen.fullScreen
프로퍼티를 사용합니다. 예를 들어 사용자가 F 키를 누르면 다음 코드는 게임을 전체 화면 모드로 전환합니다.
void Update(){ if (Input.GetKeyDown(KeyCode.F)) { Screen.fullScreen = true; }}
참고
Screen.fullScreen
속성은 기본적으로
false
로 설정됩니다.
전체 화면 모드는 사용자 상호 작용으로 활성화되어야 합니다. 자세한 내용은 전체 화면 모드 및 커서 잠금에 대한 추가 고려 사항을 참조하십시오.

전체 화면 모드 종료

전체 화면 모드를 종료하려면 Esc 키를 다시 누르거나 마우스 포인터를 화면 상단으로 가져가면 주소 표시줄과 탭에 액세스할 수 있습니다.

전체 화면 모드 및 커서 잠금에 대한 추가 고려 사항

보안상의 DUE 브라우저에서는 마우스 클릭 수 키 누름과 같은 사용자가 시작한 이벤트 후에만 커서를 잠그고 전체 화면 모드를 활성화할 수 있습니다.
Unity 별도의 이벤트와 렌더링 루프를 지원하지 않기 때문에 브라우저가 Unity 스크립팅 발생한 이벤트에 대한 직접적인 응답으로 전면 화면 또는 커서 잠금 요청을 더 이상 인식하지 못할 때까지 이벤트 처리를 지연합니다.
따라서 Unity 커서 잠금이나 전체 화면 요청을 트리거한 이벤트 대신 다음 사용자가 시작한 이벤트에 대한 요청을 트리거합니다.
더 나은 결과를 얻을 수 있는 커서 잠금 또는 전체 화면 모드를 활성화하려면 마우스/키다운 이벤트를 사용하여 마우스/키업 이벤트 대신 응답을 트리거하십시오. 이렇게 하면 사용자가 초기에 시작한 이벤트가 아닌 경우 해당 마우스/키업 이벤트가 디퍼드 요청을 트리거할 수 있습니다.
Unity의 UI.Button 컴포넌트를 사용하여
OnPointerDown
메서드를 오버라이드하는
Button
의 하위 클래스를 생성하여 원하는 동작을 구현할 수도 있습니다.
참고
일부 브라우저는 전체 화면 모드로 전환하거나 커서를 잠그기 전에 알림 메시지를 표시하거나 사용자에게 권한을 부여하라는 메시지를 표시할 수 있습니다.

추가 리소스