Raccolta del controller di gioco Componente del Kit di sviluppo dei giochi Android.

La libreria dei controller di gioco, nota anche come pedalò, consente di implementare un solido supporto per i controller di gioco. La libreria offre quanto segue:

  • Callback per il rilevamento di connessioni e disconnessioni del controller
  • Informazioni sul dispositivo controller, inclusi stile e layout dei pulsanti
  • Dati di input del controller, standardizzati secondo i moderni design di controller dual-stick
  • Funzionalità estese sui controller supportati, tra cui vibrazione, spie, dati degli assi di movimento e stato della batteria
  • Possibilità di leggere l'input da mouse virtuali e fisici
  • Possibilità di specificare dati di mappatura personalizzati del controller per determinati dispositivi

Requisiti di compatibilità

La raccolta del controller di gioco ha requisiti minimi di compatibilità di:

  • Android 4.1 (livello API 16) o versioni successive
  • Android NDK 17 o versioni successive

Integrazione

La libreria del controller di gioco è distribuita in due formati: come libreria Jetpack per i giochi che utilizzano un sistema di build basato su Gradle (compreso Android Studio) e come file discreti per i giochi che utilizzano sistemi di build personalizzati.

Per un esempio che integra la libreria del controller di gioco, consulta il repository game-samples.

Raccolta Jetpack

La pagina Giochi Android Jetpack contiene istruzioni per l'integrazione per aggiungere la dipendenza della libreria del controller di gioco al file build.gradle del tuo gioco.

La versione della libreria Jetpack del controller di gioco è una libreria statica basata sulla libreria condivisa del runtime C++.

Dopo aver aggiornato il file build.gradle, dovrai aggiungere la seguente riga al file CMakeLists.txt principale del gioco:

find_package(games-controller REQUIRED CONFIG)

Dovrai inoltre aggiungere la seguente voce all'elenco delle librerie nel comando target_link_libraries della libreria condivisa principale del tuo gioco:

games-controller::paddleboat_static

File discreti

La distribuzione in archivio .zip dell'Android Game Development Kit include i file di intestazione e libreria per la libreria del controller di gioco. Per utilizzare la libreria del controller di gioco, devi includere i seguenti file nel tuo progetto:

  • Il file classes.jar contenente le parti di bytecode Dalvik della libreria del controller di gioco. Questo file si trova nella cartella libs/classes.jar
  • Il file delle intestazioni dell'interfaccia paddleboat.h. Questo file si trova nella posizione include/paddleboat/paddleboat.h
  • Il file della libreria condivisa libpaddleboat.so o il file della libreria statica libpaddleboat-static.a. Questi file si trovano nelle sottodirectory di configurazione di compilazione nella directory libs.

Le sottodirectory di configurazione di compilazione nella directory principale libs sono classificate in base a:

  • Architettura ABI
  • Livello API Android minimo
  • Versione NDK per Android
  • Versione della libreria di runtime C++
  • Rilascia o esegui il debug della configurazione della build

Ad esempio, la sottodirectory arm64-v8a_API16_NDK21_cpp_shared_Release contiene file di libreria per:

  • ABI ARM a 64 bit
  • Livello API minimo 16
  • Basato sulla versione 21 di NDK
  • Basato sulla versione della libreria condivisa del runtime C++
  • Rilascia configurazione build

Il file libpaddleboat_static.a si trova direttamente nella sottodirectory. Il file libpaddleboat.so si trova in lib/paddleboat/ nella sottodirectory.

Passaggi successivi

Consulta le seguenti guide per continuare a integrare la raccolta del controller di gioco nel tuo gioco: