입력 지원
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 주제에서는 PC용 Google Play 게임즈에서 사용자 입력을 처리하기 위한 설계 고려사항과 권장사항을 다룹니다.
PC용 Google Play 게임즈는 터치스크린이 아닌 마우스와 키보드를 통해 플레이어의 입력을 받습니다. 마우스 및 키보드 환경을 설계할 때는 데스크톱 또는 노트북 PC 사용자를 위한 최상의 사용자 환경을 빌드하는 데 초점을 맞춥니다. 시작하려면 Chromebook에 관한 Android 앱 입력 호환성에 관한 가이드를 참고하세요.
플레이어 상호작용 설계 및 빌드 시에는 다음 권장사항을 따르는 것이 좋습니다.
- 모든 타겟을 마우스로 클릭 가능
- 스크롤 가능한 모든 영역에서 마우스 휠로 스크롤 가능
- 마우스를 가져가면 클릭 가능한 영역을 강조표시하고 최선의 판단을 통해 사용자에게 부담스럽지 않은 수준에서 UI 탐색 개선
- 사용자가 컨트롤을 빠르게 불러올 수 있는 핫키 제공
- 터치 기반 컨트롤(예: 손가락 조이스틱 또는 화면 버튼)을 마우스 기반 컨트롤 및 핫키로 대체
- 멀티 터치 동작이 필요한 모바일 게임 액션의 경우 키보드 또는 마우스 컨트롤로 동일 액션 지원(예를 들어 두 손가락 모으기 대신 마우스의 스크롤 휠 사용 가능)
추가 세부정보와 권장사항은 마우스 및 키보드에 Chrome OS Android 앱 최적화에 관한 가이드를 참고하세요.
현지화 고려사항
해외 사용자를 대상으로 하는 게임을 설계할 때는 게임에서 지원하는 각 언어로 설정된 키보드 레이아웃으로 게임을 테스트하는 것이 중요합니다. 그렇지 않으면 플레이어가 게임 내 채팅과 같은 기능을 사용하지 못할 수 있습니다. 시스템 설정에서 입력 언어를 변경하면 변경사항이 PC용 Google Play 게임즈에 자동으로 적용됩니다. 모바일에서는 가상 키보드에서 텍스트를 수신한다는 사실로 인해 엔진의 많은 문제가 숨겨질 수 있습니다. PC에서 발생하는 일반적인 문제는 다음과 같습니다.
- '대체 그래픽' (AltGr) 키 코드의 잘못된 처리 많은 언어에서 이는 악센트와 같은 발음 구별 기호나 지역 통화 글리프와 같은 특수 언어별 기호를 입력하는 데 사용됩니다.
- '입력 방법 확장 프로그램' (IME) 입력이 잘못 처리됩니다. 이 방법은 사용자가 여러 키 입력을 단일 문자로 결합할 수 있도록 하여 라틴어 이외의 알파벳을 지원하는 데 일반적으로 사용됩니다.
GameTextInput
와 EditText
은 이미 국제 키보드 레이아웃과 입력 방법을 알고 있습니다.
아래 목록에는 여러 게임에서 공통적으로 사용하는 작업과 개발자가 PC용 Google Play 게임즈에서 사용하는 일반적인 구현 방식이 나와 있습니다.
- Enter 키를 사용하여 메시지를 보내거나 텍스트 입력란으로 텍스트를 제출합니다.
- 메뉴 및 대화상자는 Esc 키를 사용하여 취소할 수 있어야 합니다.
- Enter 키를 사용하여 스토리 요소와 대화상자를 이동합니다.
- 스크롤 휠을 사용하여 텍스트를 수직으로 스크롤합니다.
- 특히 모바일 빌드에서 두 손가락 모으기를 사용하는 경우 스크롤 휠을 사용하여 확대하거나 축소합니다.
- W, A, S, D를 사용하여 보통 클릭 및 드래그 동작을 사용하는 지도를 탐색합니다.
이러한 동작이 일반적으로 사용되는 경우에도 플레이어가 발견할 수 있도록 입력 SDK를 사용하여 플레이어에게 명시적으로 제공해야 합니다.
호환성 모드
PC용 Google Play 게임즈는 기본적으로 게임을 '입력 호환성 모드'로 전환합니다. 즉, 마우스 왼쪽 버튼을 누르면 게임에 터치 이벤트가 주어집니다. 자세한 내용은 마우스 입력 가이드를 참고하세요.
튜토리얼 및 사용자 교육
경우에 따라 사용자는 마우스와 키보드 컨트롤을 확인할 뿐 아니라 게임 컨트롤에 관해 알려주는 게임 내 튜토리얼을 이용할 수 있습니다. 올바른 마우스 및 키보드 컨트롤과 함께 게임 내 튜토리얼과 교육 기능을 포함하고, PC 버전 게임의 경우 터치 기반 컨트롤과 관련된 가이드는 삭제하는 것이 좋습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Input support\n\nThis topic covers design considerations and best practices for handling user\ninput in Google Play Games on PC.\n\nGoogle Play Games on PC relies on a mouse and keyboard for player input rather\nthan a touchscreen. When designing your mouse and keyboard experience, focus on\nbuilding the best user experience for desktop or laptop PC users. To get\nstarted, see our guide on\n[Android app input compatibility for Chromebooks](/topic/arc/input-compatibility).\n\nBest practices\n--------------\n\nWe recommend the following best practices for designing and building player\ninteractions.\n\n- All targets should be clickable with a mouse.\n- All scrollable surfaces scroll on mouse wheel events.\n- Highlight clickable surfaces when hovered, and use your best judgment to improve UI discovery without overwhelming the user.\n- Provide hotkeys for users to quickly bring up controls.\n- Replace touch-based controls (for example, thumb joysticks or on-screen buttons) with mouse-based controls and hotkeys.\n- For actions in your mobile game that require multi-touch gestures, ensure the same actions are supported with a keyboard or mouse control (for example, using the scroll wheel of the mouse to replace a two-finger pinch).\n\nFor additional details and best practices, see our guide on\n[optimizing your ChromeOS Android app for mouse and keyboard](/topic/arc/optimizing#keyboard).\n\n### Internationalization considerations\n\nWhen designing a game for an international audience, it is important that you\ntest your game with your keyboard layout set to each language supported by your\ngame. Failure to do so may block players from using features such as in-game\nchat. You can change your input locale\n[in your system settings](https://support.microsoft.com/en-us/windows/manage-the-input-and-display-language-settings-in-windows-12a10cb4-8626-9b77-0ccb-5013e0c7c7a2)\nand the changes will apply automatically to Google Play Games on PC. On\nmobile, many issues in your engine may be hidden by the fact that you're\nreceiving text from a virtual keyboard. Common issues on PC include:\n\n- Incorrect handling of \"alternative graphic\" (AltGr) keycodes. In many locales this is used to type diacritical marks such as accents or special locale-specific symbols such as regional currency glyphs.\n- Incorrect handling of [\"input method extension\" (IME)](/reference/android/view/inputmethod/InputMethodManager) inputs. This method is commonly used to support non-Latin alphabets by allowing users to combine several keystrokes into a single character.\n\n[`GameTextInput`](/games/agdk/add-support-for-text-input) and\n[`EditText`](/reference/android/widget/EditText) are already aware of\ninternational keyboard layouts and input methods.\n\n### Recommended input mappings\n\nThe following list includes actions many games have in common, and the typical\nimplementation developers use on Google Play Games on PC:\n\n- Use the enter key to send messages or submit text in text entry fields.\n- Menus and dialogs should be cancellable with the escape key.\n- Use the enter key to progress through story elements and dialog boxes.\n- Use the scroll wheel to scroll text vertically.\n- Use the scroll wheel to zoom in or out, especially if you use a two-finger pinch in your mobile build.\n- Use W, A, S, and D navigate around a map that you'd normally use a click and drag motion on.\n\nEven though these actions are common, you should still explicitly present them\nto the player with the [Input SDK](/games/playgames/input-sdk) to make sure they're\nproperly discoverable.\n\nCompatibility mode\n------------------\n\nGoogle Play Games on PC places your game into \"input compatibility mode\" by\ndefault. This means that when you press the left mouse button, your game is\ngiven a touch event. See the [mouse input](/games/playgames/input-mouse) guide for more\ninformation.\n\nTutorials and user education\n----------------------------\n\nIn some cases, users can benefit from in-game tutorials that teach them the\ncontrols to the game, in addition to being able to view the mouse and keyboard\ncontrols. We recommend including in-game tutorials and educational features with\nthe correct controls for mouse and keyboard, and removing tutorials relevant to\ntouch-based controls for the PC version of your game."]]