게임 컨트롤러 라이브러리 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/에 있습니다.

다음 단계

게임 컨트롤러 라이브러리를 게임에 계속 통합하려면 다음 가이드를 참조하세요.