게임 컨트롤러 지원
개요¶
Hive SDK v4 Unity Windows 24.1.0부터 Hive SDK가 구현하는 UI상에서 사용자는 게임 컨트톨러로 마우스 커서를 이동시키고 버튼을 클릭할 수 있습니다. 예를 들어, Hive SDK가 노출하는 웹뷰 영역에서 사용자는 게임 컨트롤러로 마우스 커서를 이동시켜 웹뷰 영역 내에 있는 버튼을 클릭할 수 있습니다.
지원 범위¶
Hive SDK에서 지원하는 게임 컨트롤러는 다음과 같습니다. * 마이크로소프트 엑스박스 컨트롤러 * 소니 플레이스테이션 듀얼센스, 듀얼쇼크 컨트롤러 * 닌텐도 스위치 프로 컨트롤러
Hive SDK가 지원하는 게임 컨트롤러 개수는 최대 1대입니다.
키 조작 방법¶
- 마우스 커서 이동: 아날로그 조이스틱(좌)
- 마우스 종,횡 휠스크롤: 아날로그 조이스틱(우)
- 마우스 좌측 버튼 클릭: A 버튼(듀얼센스, 듀얼프로의 경우 X버튼)
- 마우스 우측 버튼 클릭: 지원하지 않음
유의 사항¶
Hive SDK로 개발할 때 게임 컨트롤러 기능 사용 시 다음 사항을 유의해야 합니다.
게임 컨트롤러 작동 범위¶
게임 컨트롤러는 Hive SDK로 구현한 UI에서만 지원합니다. 예를 들어, 로그인 화면과 뉴스와 프로모션 배너 등 게임에서 Hive SDK가 띄우는 웹뷰 UI 등입니다. 외부 브라우저창과 같이 Hive SDK가 구현하지 않은 UI에서는 지원하지 않습니다. 게임내에서 게임 컨트롤러를 사용한 마우스 커서 이동은 개발사가 직접 구현해야 합니다.
스팀 연동¶
스팀 연동 시 "Steam Input 사용함"으로 설정한 경우, Hive SDK가 제공하는 게임 컨트롤러 기능을 사용할 수 없습니다. 단, 스팀에서 제공하는 레이아웃 변경 메뉴를 통하여 Hive SDK가 제공하는 게임 컨트롤러 기능과 유사한 환경을 제공할 수 있습니다. 보다 자세한 내용은 스팀웍스 공식 문서에 있는 Steam Input 페이지를 참고하세요.
기존 방식으로 컨트롤러 입력 처리¶
앱이 Hive SDK 메서드를 호출 후 응답을 받기 전 시점까지 게임 컨트롤러(스팀 덱 자체 컨트롤러 포함) 입력이 발생하면, 앱 자체적으로 게임 컨트롤러 입력을 처리하면 안 됩니다. Hive SDK가 구현하는 UI상에서 발생하는 게임 컨트롤러 입력은 Hive SDK가 처리하기 때문입니다.
Windows 화상 키보드¶
Windows 화상 키보드에서 Hive SDK가 제공하는 게임 컨트롤러 지원 기능을 사용 시, 윈도우 화상 키보드 "옵션" 에서 다음과 같이 설정해야 게임 컨트롤러 기능을 사용할 수 있습니다.
- "스캔해서 입력" 체크
- "조이스틱, 게임 패드 또는 기타 게임 장치 사용"만 체크
알려진 문제점¶
반복적으로 게임 컨트롤러 재연결을 빠르게 시도하는 경우 컨트롤러가 비정상적으로 동작하는 경우가 있습니다. 예를 들어 스위치 프로 컨트롤러의 경우 짧은 시간 내에 해제, 연결을 반복하게 되면 사용자가 조작하지 않더라도 마우스 커서가 특정 방향으로 이동하는 현상이 발생할 수도 있습니다. 이는 스위치 프로 컨트롤러 이슈로, 문제 발생 시 유선 연결 단자 좌측에 위치한 동기화 버튼을 눌러 해결할 수 있습니다.