게임 컨트롤러 지원
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
플레이어가 게임 컨트롤러를 사용할 수 있도록 하여 게임의 사용자 환경을 개선할 수 있습니다. Android 프레임워크는 게임 컨트롤러의 사용자 입력을 감지하고 처리하는 API를 제공합니다.
이 가이드에서는 다양한 Android API 수준 (API 수준 9 이상)에서 게임 컨트롤러와 일관되게 게임을 실행하는 방법과 앱에서 여러 컨트롤러를 동시에 지원하여 플레이어의 게임 환경을 개선하는 방법을 보여줍니다.
참고: 게임을 개발하거나 C++ 앱을 작성하는 경우 Android Game Development Kit (AGDK)에 포함된 게임 컨트롤러 라이브러리를 대신 사용하세요.
과정
-
컨트롤러 작업 처리
- 방향 패드 (D패드) 버튼, 게임패드 버튼, 조이스틱 등 게임 컨트롤러의 일반적인 입력 요소에서 사용자 입력을 처리하는 방법을 알아보세요.
-
다양한 Android 버전에서 컨트롤러 지원
- 서로 다른 버전의 Android를 실행하는 기기에서 게임 컨트롤러를 동일하게 작동하는 방법을 알아보세요.
-
여러 게임 컨트롤러 지원
- 동시에 연결된 여러 개의 게임 컨트롤러를 감지하고 사용하는 방법을 알아보세요.
-
추가 게임 컨트롤러 기능
-
추가 컨트롤러 기능을 사용하는 방법을 알아보세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(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-26(UTC)"],[],[],null,["# Support game controllers\n\nYou can enhance the user experience in your game by letting\nplayers use game controllers. The Android framework\nprovides APIs for detecting and processing user input from game\ncontrollers.\n\n\nThis guide shows how to make your game work consistently with game\ncontrollers across different Android API levels (API level 9 and up) and\nhow to enhance the gaming experience for players by supporting multiple\ncontrollers simultaneously in your app.\n\n**Note:**\nIf you are developing games or writing a C++ app, use the\n[Game Controller Library](/games/sdk/game-controller)\nthat is part of the\n[Android Game Development Kit (AGDK)](/games/agdk) instead.\n\nLessons\n-------\n\n\n**[Handle controller actions](/develop/ui/views/touch-and-input/game-controllers/controller-input)**\n:\n Learn how to handle user input from common input elements on game\n controllers, including directional pad (D-pad) buttons, gamepad buttons,\n and joysticks.\n\n\n**[Support controllers across Android versions](/develop/ui/views/touch-and-input/game-controllers/compatibility)**\n:\n Learn how to make game controllers behave the same across devices\n running different versions of Android.\n\n\n**[Support multiple game controllers](/develop/ui/views/touch-and-input/game-controllers/multiple-controllers)**\n:\n Learn how to detect and use multiple game controllers that are\n simultaneously connected.\n\n\n**[Additional game controller features](/develop/ui/views/touch-and-input/game-controllers/controller-features)**\n:\n Learn how to use additional controller features."]]