게임 컨트롤러 라이브러리 Android Game Development Kit의 일부
게임 컨트롤러 라이브러리(Paddleboat라고도 함)는 게임 컨트롤러를 위한 강력한 지원을 구현하는 데 도움이 됩니다. 라이브러리는 다음을 제공합니다.
- 컨트롤러 연결 및 연결 해제를 감지하는 콜백
- 버튼 스타일 및 레이아웃을 포함한 컨트롤러 기기 정보
- 최신 듀얼 스틱 컨트롤러 디자인으로 표준화된 컨트롤러 입력 데이터
- 지원되는 컨트롤러의 진동, 조명, 모션 축 데이터, 배터리 상태 등의 확장 기능
- 가상 및 실제 마우스 기기에서의 입력 읽기 기능
- 특정 기기에 대한 맞춤 컨트롤러 매핑 데이터를 지정하는 기능
호환성 요구사항
게임 컨트롤러 라이브러리에는 다음과 같은 최소 호환성 요구사항이 있습니다.
- Android 4.4(API 수준 19) 이상
- Android NDK 버전 21 이상
통합
게임 컨트롤러 라이브러리는 두 가지 형식으로 배포됩니다. 즉, Gradle 기반 빌드 시스템(Android 스튜디오 포함)을 사용하는 게임용 Jetpack 라이브러리와 맞춤 빌드 시스템을 사용하는 게임용 개별 파일 형식으로 배포됩니다.
게임 컨트롤러 라이브러리를 통합하는 샘플은 games-samples 저장소에 연결합니다.
Jetpack 라이브러리
Jetpack Android 게임 페이지에는 게임 컨트롤러 라이브러리 종속 항목을 게임의 build.gradle
파일에 추가하는 방법이 나와 있습니다.
게임 컨트롤러의 Jetpack 라이브러리 출시는 C++ 런타임 공유 라이브러리에 맞춰 빌드된 정적 라이브러리입니다.
build.gradle
파일을 업데이트한 후에는 게임의 기본 CMakeLists.txt
파일에 다음 줄을 추가해야 합니다.
find_package(games-controller REQUIRED CONFIG)
또한 게임 기본 공유 라이브러리의 target_link_libraries
명령어에서 라이브러리 목록에 다음 항목도 추가해야 합니다.
games-controller::paddleboat_static
독립형 파일
Android Game Development Kit의 .zip
아카이브 배포에는 게임 컨트롤러 라이브러리의 헤더와 라이브러리 파일이 포함되어 있습니다. 게임 컨트롤러 라이브러리를 사용하려면 다음 파일이 프로젝트에 포함되어야 합니다.
- 게임 컨트롤러 라이브러리의 Dalvik 바이트 코드 부분이 포함된
classes.jar
파일. 이 파일은libs/classes.jar
에 있습니다. paddleboat.h
인터페이스 헤더 파일. 이 파일은include/paddleboat/paddleboat.h
에 있습니다.libpaddleboat.so
공유 라이브러리 파일 또는libpaddleboat-static.a
정적 라이브러리 파일. 이 파일은libs
디렉터리의 빌드 구성 하위 디렉터리에 있습니다.
루트 libs
디렉터리의 빌드 구성 하위 디렉터리는 다음 카테고리로 분류됩니다.
- ABI 아키텍처
- 최소 Android API 레벨
- Android NDK 버전
- C++ 런타임 라이브러리 버전
- 빌드 구성 출시 또는 디버그
예를 들어 arm64-v8a_API16_NDK21_cpp_shared_Release
하위 디렉터리에는 다음을 위한 라이브러리 파일이 포함됩니다.
- ARM 64비트 ABI
- 최소 API 레벨 16
- NDK 버전 21 기반 빌드
- C++ 런타임의 공유 라이브러리 버전 기반 빌드
- 출시 빌드 구성
libpaddleboat_static.a
파일은 하위 디렉터리에 직접 위치합니다. libpaddleboat.so
파일은 하위 디렉터리 내의 lib/paddleboat/
에 있습니다.
다음 단계
게임 컨트롤러 라이브러리를 게임에 계속 통합하려면 다음 가이드를 참조하세요.