입력 SDK는 플레이어가 PC용 Google Play 게임즈에서 플레이하려는 모든 게임의 마우스 및 키보드 바인딩을 보고 변경할 수 있는 통합 인터페이스를 제공합니다. 게임플레이 중에 언제든지 플레이어는 다음 스크린샷과 같이 PC용 Google Play 게임즈 오버레이를 호출할 수 있습니다.
Android 모바일 게임이 플레이어 입력을 위한 터치스크린을 중심으로 설계되었기 때문에 PC용 Google Play 게임즈에서 키보드를 사용하는 게임에는 이 SDK가 필수입니다.
PC용으로 개발하는 경우 게임은 마우스와 키보드를 지원해야 합니다. PC용 Google Play 게임즈에서만 이 SDK를 사용 설정해야 합니다.
입력 SDK는 다양한 플랫폼에서 플레이어의 만족도와 참여도를 높이는 데 중요한 요소입니다. 마우스 및 키보드로 제공되는 환경은 터치스크린과 다릅니다. 게임을 입력 SDK와 통합하면 플레이어가 PC용 Google Play 게임즈에서 기본 컨트롤을 재매핑할 수 있습니다.
더 몰입도 높은 환경을 제공하려면 메뉴, 기본 게임, 미니 게임용 다양한 스킴 컨트롤을 설정하거나 사용자의 맞춤 컨트롤 매핑과 일치하도록 UI를 업데이트하여 PC용 Google Play 게임즈에서 제공하는 재매핑 기능을 더 잘 활용할 수 있습니다. 개별 키 또는 키 그룹의 재매핑을 사용 중지 또는 사용 설정하거나 게임에서 재매핑할 수 있는 키를 결정할 수 있습니다.
재매핑 기능을 사용하면 Android는 사용자가 텍스트 필드에 텍스트를 입력하는 것을 감지하고 재매핑을 사용 중지하므로 게임에서 이러한 시나리오의 재매핑을 수동으로 사용 중지하지 않아도 됩니다.
자세한 내용은 게임에 최상의 PC 환경을 빌드하는 데 도움이 되는 입력 SDK의 권장사항 및 제한사항을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Input SDK\n\n| **Note:** Games that are played with only the left-mouse button are not required to integrate the Input SDK. These games are supported using with the [compatibility mode](/games/playgames/input#compatibility-mode). This document applies to all other games that need more than the left-mouse button.\n\nThe Input SDK provides a unified interface that allows players to\nview and change the mouse and keyboard bindings for any game they wish to play\non Google Play Games on PC. At any point during gameplay, a player can summon\nthe Google Play Games on PC overlay as seen in this screenshot:\n\nThis SDK is **required** for games that use keyboard on Google Play Games on PC\nbecause Android mobile games are designed around a touchscreen for player input.\nWhen developing for PCs, games need to support a mouse and keyboard instead. You\nshould only enable this SDK on Google Play Games on PC.\n| **Note:** For information about the other Google Play Games on PC requirements, see [Get started with Google Play Games on PC](/games/playgames/start).\n\nThe Input SDK is an important element for keeping players happy and\nengaged with your game on different platforms. The experience afforded by\na mouse and keyboard is different from touchscreens. When you integrate your game\nwith the Input SDK you will enable players to remap the default controls\nin Google Play Games on PC.\n\nFor a more immersive experience, you can take more advantage of the remapping\nfeature offered by Google Play Games on PC by setting different scheme controls\nfor your menus, main game and minigames, or by updating your UI to match your\nuser's custom control maps. You can disable or enable remapping for individual\nkeys or groups of keys, or decide what keys are allowed to be remapped in your\ngame.\n\nWhen using the remapping feature, Android will detect when the user is typing text\ninto a text field and disable remapping, so your game doesn't have to\nmanually disable remapping for these scenarios.\n\nFor more information, see [best practices](/games/playgames/input-sdk-start#input-sdk-best-practices)\nand [restrictions](/games/playgames/input-sdk-start#remapping-restrictions) of the Input SDK to help build the best PC experience possible for your game.\n\nIntegration guide\n-----------------\n\nFor information about integrating the Input SDK, see\n[Get started with the Input SDK](/games/playgames/input-sdk-start).\n\nSample games\n------------\n\nFor examples of how to integrate with the Input SDK, see\n[AGDK Tunnel](https://github.com/android/games-samples/tree/main/agdk/agdktunnel)\nfor Kotlin or Java games and\n[Trivial Kart](https://github.com/android/games-samples/tree/main/trivialkart/trivialkart-unity)\nfor Unity games.\n\nDownload the Input SDK\n----------------------\n\nBefore you download the Input SDK, read the following Google Input SDK terms of service and data collection requirements.\n\n### Google APIs Terms of Service\n\nThe [Google APIs Terms of Service](https://developers.google.com/terms) governs\nyour use of the Google Input SDK.\n\n### Data collection\n\nThe Google Input SDK may collect performance and stability data to\nimprove our product, including the following data:\n\n- Number of calls to the Input SDK methods.\n- Number of non-successful calls to Input SDK methods.\n- InputMap aggregated information like:\n - Number of defined actions and groups.\n - Number of defined single-key, multi-key and mouse actions.\n - Number of defined mouse actions.\n - Number of remappable actions and groups.\n - Number of remapping-reserved keys.\n - InputMap remapping option (enabled/disabled).\n- Game's package name.\n- Game's version number.\n- Game's version name.\n- Input SDK version.\n- Client variants such as Google Play Games on PC or other clients.\n\nThe Input SDK is\n[available on the Google Maven Repository](https://maven.google.com/web/index.html#com.google.android.libraries.play.games:inputmapping).\nSee the [Getting Started Guide](/games/playgames/input-sdk-start#adding-the-sdk) for instructions\non how to your Java or Kotlin project.\n\nDownload the Input SDK for Unity from the\n[Play Unity Plugins repository](https://developers.google.com/unity/packages#input_sdk)."]]
