Game Controller Library   Android Game Development Kit'in bir parçasıdır.

Paddleboat olarak da bilinen Game Controller kitaplığı, oyun kumandaları için güçlü destek uygulamanıza yardımcı olur. Kitaplıkta aşağıdakiler bulunur:

  • Kumanda bağlantılarını ve bağlantı kesilmelerini algılamaya yönelik geri çağırmalar
  • Düğme stili ve düzeni de dahil olmak üzere kontrol cihazı bilgileri
  • Modern çift çubuklu kumanda tasarımlarına göre standartlaştırılmış kumanda giriş verileri
  • Titreşim, ışıklar, hareket ekseni verileri ve pil durumu gibi desteklenen kontrol cihazlarındaki genişletilmiş özellikler
  • Sanal ve fiziksel fare cihazlarından gelen girişleri okuma
  • Belirli cihazlar için özel denetleyici eşleme verilerini belirtme özelliği

Uyumluluk koşulları

Game Controller kitaplığının minimum uyumluluk koşulları şunlardır:

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

Entegre edin

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

Game Controller kitaplığını entegre eden bir örnek için games-samples deposuna bakın.

Jetpack kitaplığı

Jetpack Android Games sayfasında, oyun kumandası kitaplığı bağımlılığını oyununuzun build.gradle dosyasına eklemeyle ilgili entegrasyon talimatları yer alır.

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

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

find_package(games-controller REQUIRED CONFIG)

Ayrıca, oyununuzun ana paylaşılan kitaplığının target_link_libraries komutundaki kitaplıklar listesine aşağıdaki girişi 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 kumandası kitaplığını kullanmak için projenize aşağıdaki dosyalar eklenmelidir:

  • Oyun kumandası kitaplığının Dalvik bayt kodu bölümlerini içeren classes.jar dosyası. Bu dosya libs/classes.jar konumunda bulunuyor
  • paddleboat.h arayüzü üstbilgi dosyası. Bu dosya şu konumda yer alıyor: include/paddleboat/paddleboat.h
  • libpaddleboat.so Paylaşılan kitaplık dosyası veya libpaddleboat-static.a statik kitaplık dosyası. Bu dosyalar, libs dizinindeki derleme yapılandırması alt dizinlerinde bulunur.

Kök libs dizini altındaki derleme yapılandırması alt dizinleri şu şekilde kategorize edilir:

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

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

  • ARM 64 bit ABI
  • Minimum API düzeyi 16
  • NDK sürüm 21 ile oluşturulmuş
  • C++ çalışma zamanının paylaşılan kitaplık sürümüne göre oluşturulmuş
  • Yayınlanan 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 bakın: