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

Paddlebot olarak da bilinen Oyun Kumandası kitaplığı, uygulamanızın geliştirilmiştir. Kitaplıkta şunlar bulunur:

  • Kumanda bağlantılarını ve bağlantı kesmelerini algılamak için geri çağırma işlevleri
  • Düğme stili ve düzeni de dahil olmak üzere kumanda cihaz bilgileri
  • Modern çift çubuklu kumandaya göre standartlaştırılmış kumanda giriş verileri tasarımlar
  • Desteklenen kumandalarda titreşim, ışıklar, hareket ekseni verileri ve pil durumu
  • Sanal ve fiziksel fare cihazlarından gelen girişleri okuma özelliği
  • Belirli cihazlar için özel kumanda eşleme verileri belirleme olanağı

Uyumluluk gereksinimleri

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

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

İntegral alın

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

Oyun Kumandası kitaplığıyla entegre olan bir örnek için bkz. oyun örnekleri deposu'na gidin.

Jetpack kitaplığı

Jetpack Android Games sayfasında şunlar yer alır: oyun Kumandası kitaplığı bağımlılığını eklemek için uygulama entegrasyon talimatlarını oyunun build.gradle dosyası.

Game Controller'ın Jetpack kitaplık sürümü, kitaplığını temel alır.

build.gradle dosyanızı güncelledikten sonra şunları eklemeniz gerekir: satırını oyununuzun ana CMakeLists.txt dosyasına ekleyin:

find_package(games-controller REQUIRED CONFIG)

Kitaplık listesine aşağıdaki girişi de eklemeniz gerekir Oyununuzun ana paylaşılan klasörünün target_link_libraries komutunda kitaplık:

games-controller::paddleboat_static

Ayrık dosyalar

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

  • classes.jar Oyun Kumandası kitaplığı. Bu dosya, libs/classes.jar konumunda bulunuyor.
  • paddleboat.h arayüzü başlık dosyası. Bu dosyanın konumu: include/paddleboat/paddleboat.h.
  • libpaddleboat.so paylaşılan kitaplık dosyası veya libpaddleboat-static.a statik kitaplık dosyası. Bu dosyalar bulundu libs dizini altındaki derleme yapılandırması alt dizinlerinde bulabilirsiniz.

Kök libs dizininin altındaki derleme yapılandırması alt dizinleri şunlardır: kategorize etme ölçütü:

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

Örneğin, arm64-v8a_API16_NDK21_cpp_shared_Release alt dizini şunun için kitaplık dosyaları içerir:

  • ARM 64 bit ABI
  • Minimum API düzeyi 16
  • NDK 21 sürümüne 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ını

libpaddleboat_static.a dosyası doğrudan alt dizinde bulunur. İlgili içeriği oluşturmak için kullanılan libpaddleboat.so dosyası, alt dizindeki lib/paddleboat/ adresinde bulunuyor.

Sonraki adımlar

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