Oyun Denetleyici Kitaplığı Android Oyun Geliştirme Kiti'nin bir parçasıdır.

Paddlebot olarak da bilinen Oyun Denetleyici 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 de dahil olmak üzere kumanda cihazı bilgileri
  • Modern çift çubuklu denetleyici tasarımlarına uygun şekilde standartlaştırılmış denetleyici giriş verileri
  • Desteklenen kumandalarda titreşim, ışıklar, hareket ekseni verileri ve pil durumu gibi genişletilmiş özellikler
  • Sanal ve fiziksel fare cihazlarından gelen girişleri okuma özelliği
  • Belirli cihazlar için özel kumanda eşleme verileri belirtebilme

Uyumluluk gereksinimleri

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

  • Android 4.1 (API düzeyi 16) veya sonraki sürümler
  • Android NDK 17 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ığı ve özel derleme sistemleri kullanan oyunlar için ayrı dosyalar olarak.

Oyun Denetleyicisi kitaplığını entegre eden bir örnek için games-samples deposuna göz atın.

Jetpack kitaplığı

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

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)

Aşağıdaki girişi, oyununuzun paylaşılan ana kitaplığının target_link_libraries komutundaki kitaplık listesine de eklemeniz gerekir:

games-controller::paddleboat_static

Ayrık dosyalar

Android Game Development Kit'in .zip arşiv dağıtımı, Game Controller kitaplığı için başlık ve kitaplık dosyalarını içerir. Oyun Denetleyicisi kitaplığını kullanmak için projenize aşağıdaki dosyaların eklenmesi gerekir:

  • Oyun Denetleyici 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 dizini 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ü
  • Sürüm veya hata ayıklama derleme yapılandırması

Ö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 oluşturuldu
  • Sürüm derleme yapılandırması

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

Sonraki adımlar

Oyun Kumandası kitaplığını oyununuza entegre etmeye devam etmek için aşağıdaki kılavuzlara göz atın: