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ı veyalibpaddleboat-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: