콘텐츠로 이동

게임 컨트롤러 지원

개요

Hive SDK에서 제공하는 UI에서는 일반 마우스가 아닌 '게임 컨트톨러'로 마우스 커서를 이동시키고 버튼을 클릭할 수 있습니다. 예를 들어, Hive SDK가 노출하는 웹뷰 영역에서 사용자는 게임 컨트롤러로 마우스 커서를 이동시켜 웹뷰 영역 내에 있는 버튼을 클릭할 수 있습니다.

Note

Hive SDK의 '게임 컨트톨러' 지원은 Hive SDK v4 Unity Windows 24.1.0부터 제공합니다.

지원 게임 컨트롤러

Hive SDK에서 지원하는 게임 컨트롤러 종류는 아래와 같으며, SDK 당 사용할 수 있는 컨트롤러 개수는 최대 1개 입니다.

  • 마이크로소프트 엑스박스 컨트롤러
  • 소니 플레이스테이션 듀얼센스, 듀얼쇼크 컨트롤러
  • 닌텐도 스위치 프로 컨트롤러

컨트롤러 키 맵핑

Hive SDK v4 Unity Windows 25.0.0부터는 게임 컨트롤러 사용 시, 일부 Hive UI에서 컨트롤러 키 맵핑 을 지원합니다.

Warning

컨트롤러 키 맵핑을 지원하는 UI에서는 키 조작 방법이 기존 UI에서의 키 조작 방법과 다름을 유의하세요.


키 조작 방법

입력 장치 기존 UI 키 조작 방법 컨트롤러 키 맵핑 지원 UI 키 조작 방법
좌측 아날로그 조이스틱 마우스 커서 이동 포커스 이동
우측 아날로그 조이스틱 마우스 종, 횡 휠 스크롤 마우스 종, 횡 휠 스크롤
A 버튼 마우스 좌측 버튼 클릭 확인 (듀얼센스, 듀얼쇼크의 경우 X 버튼)
B 버튼 지원하지 않음 취소 (듀얼센스, 듀얼쇼크의 경우 O 버튼)
D패드 지원하지 않음 포커스 이동


컨트롤러 키 맵핑 지원 UI 목록

컨트롤러 키 맵핑 기능을 지원하는 Hive UI 목록은 아래와 같습니다:

지원 UI
1 앱 업데이트
2 접속 제한
3 서버 점검
4 로그인 대기
5 IdP 목록
6 프로모션
7 구글 결제 계정 확인
8 결제 확인
9 결제 오류
10 스팀덱 로그인
Warning

웹뷰 화면 에서는 컨트롤러 키 맵핑 기능을 사용할 수 없습니다.


유의 사항

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가 제공하는 게임 컨트롤러 지원 기능을 사용 시, 윈도우 화상 키보드 "옵션" 에서 다음과 같이 설정해야 게임 컨트롤러 기능을 사용할 수 있습니다.

  1. 스캔해서 입력 체크
  2. 조이스틱, 게임 패드 또는 기타 게임 장치 사용 만 체크

컨트롤러 키 맵핑 기능 제한

컨트롤러 키 맵핑 기능이 적용된 UI는 Rog Ally > 게임패드 모드 에서만 정상적으로 동작합니다.


알려진 문제점

반복적으로 게임 컨트롤러 재연결을 빠르게 시도하는 경우 컨트롤러가 비정상적으로 동작하는 경우가 있습니다. 예를 들어, 스위치 프로 컨트롤러의 경우 짧은 시간 내에 해제, 연결을 반복하게 되면 사용자가 조작하지 않더라도 마우스 커서가 특정 방향으로 이동하는 현상이 발생할 수도 있습니다. 이는 스위치 프로 컨트롤러 이슈로, 문제 발생 시 유선 연결 단자 좌측에 위치한 동기화 버튼을 눌러 해결할 수 있습니다.