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

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

  • Callback per rilevare le connessioni e le disconnessioni del controller
  • Informazioni sul dispositivo controller, tra cui stile e layout dei pulsanti
  • Dati di input del controller, standardizzati intorno al design moderno dei 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 dispositivi mouse virtuali e fisici
  • Possibilità di specificare dati personalizzati per la mappatura dei controller per determinati dispositivi

Requisiti di compatibilità

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

  • Android 4.4 (livello API 19) o versioni successive
  • Android NDK 21 o versioni successive

Integrare

La libreria del controller di gioco viene distribuita in due formati: come libreria Jetpack per i giochi che utilizzano un sistema di build basato su Gradle (incluso 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 dei giochi-samples.

Libreria 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 release della libreria Jetpack del controller di gioco è una libreria statica basata sulla libreria condivisa di runtime C++.

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

find_package(games-controller REQUIRED CONFIG)

Dovrai anche aggiungere la voce seguente 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 della libreria del controller di gioco. Per poter utilizzare la libreria del controller di gioco, devi includere i seguenti file nel progetto:

  • Il file classes.jar contenente le parti di bytecode Dalvik della libreria del controller di gioco. Questo file si trova in libs/classes.jar
  • Il file delle intestazioni dell'interfaccia paddleboat.h. Questo file si trova in 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 categorizzate in base a:

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

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

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

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: