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