Oyun Kumandası Kitaplığı Android Game Development Kit'in bir parçasıdır.

Paddlebot olarak da bilinen Game Controller kitaplığı, oyun kumandaları için güçlü destek uygulamanıza yardımcı olur. Kitaplık şunları sağlar:

  • Kumanda bağlantılarını ve bağlantı kesmelerini algılamak için geri çağırmalar
  • Düğme stili ve düzeni dahil kumanda cihazı bilgileri
  • Modern çift çubuklu denetleyici tasarımlarına göre standartlaştırılmış denetleyici giriş verileri
  • Desteklenen denetleyicilerde titreşim, ışıklar, hareket ekseni verileri ve pil durumu gibi genişletilmiş özellikler
  • Girişleri sanal ve fiziksel fare cihazlarından okuyabilme
  • Belirli cihazlar için özel denetleyici eşleme verileri belirtebilme

Uyumluluk gereksinimleri

Oyun Denetleyicisi kitaplığının minimum uyumluluk gereksinimleri şunlardır:

  • Android 4.4 (API düzeyi 19) veya sonraki sürümler
  • Android NDK 21 veya sonraki sürümler

İntegral alın

Oyun Denetleyici kitaplığı iki biçimde dağıtılır: Gradle tabanlı derleme sistemi (Android Studio dahil) kullanan oyunlar için Jetpack kitaplığı olarak ve özel derleme sistemleri kullanan oyunlar için ayrı dosyalar olarak.

Oyun Denetleyicisi kitaplığını entegre eden bir örnek için oyun-örnekleri deposuna bakın.

Jetpack kitaplığı

Jetpack Android Games sayfasında Oyun Kumandası kitaplığı bağımlılığını oyununuzun build.gradle dosyasına eklemek için gereken entegrasyon talimatları bulunmaktadır.

Game Controller'ın Jetpack kitaplığı sürümü, C++ çalışma zamanı paylaşılan kitaplığına dayalı statik bir kitaplıktır.

build.gradle dosyanızı güncelledikten sonra aşağıdaki satırı oyununuzun ana CMakeLists.txt dosyasına eklemeniz gerekecek:

find_package(games-controller REQUIRED CONFIG)

Ayrıca, oyununuzun ana paylaşılan kitaplığındaki target_link_libraries komutundaki kitaplık listesine aşağıdaki girişi eklemeniz gerekir:

games-controller::paddleboat_static

Ayrık dosyalar

Android Oyun Geliştirme Kiti'nin .zip arşiv dağıtımı, Oyun Kumandası kitaplığı için başlık ve kitaplık dosyalarını içerir. Oyun Kumandası kitaplığını kullanmak için projenize aşağıdaki dosyaların eklenmesi gerekir:

  • Game Controller kitaplığının Dalvik bayt kodu bölümlerini içeren classes.jar dosyası. Bu dosya şu konumda: libs/classes.jar
  • paddleboat.h arayüzü başlık dosyası. Bu dosya şu konumda: include/paddleboat/paddleboat.h
  • libpaddleboat.so paylaşılan kitaplık dosyası veya libpaddleboat-static.a statik kitaplık dosyası. Bu dosyalar, libs dizininin altındaki derleme yapılandırması alt dizinlerinde bulunur.

Kök libs dizininin altındaki derleme yapılandırması alt dizinleri şu kategorilere ayrılır:

  • ABI mimarisi
  • Minimum Android API düzeyi
  • Android NDK sürümü
  • C++ çalışma zamanı kitaplığı sürümü
  • Derleme yapılandırması serbest veya hata ayıklama

Örneğin, arm64-v8a_API16_NDK21_cpp_shared_Release alt dizininde aşağıdaki kitaplık dosyaları bulunur:

  • ARM 64 bit ABI
  • Minimum API düzeyi 16
  • NDK sürüm 21'e göre geliştirildi
  • C++ çalışma zamanının paylaşılan kitaplık sürümüne göre geliştirildi
  • Sürüm derleme yapılandırması

libpaddleboat_static.a dosyası doğrudan alt dizinde bulunur. libpaddleboat.so dosyası, alt dizindeki lib/paddleboat/ dizininde bulunur.

Sonraki adımlar

Oyun Kumandası kitaplığını oyununuza entegre etmeye devam etmek için aşağıdaki rehberlere bakın: