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 cartellalibs/classes.jar
- Il file delle intestazioni dell'interfaccia
paddleboat.h
. Questo file si trova nella posizioneinclude/paddleboat/paddleboat.h
- Il file della libreria condivisa
libpaddleboat.so
o il file della libreria staticalibpaddleboat-static.a
. Questi file si trovano nelle sottodirectory di configurazione di compilazione nella directorylibs
.
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:
- Utilizzare la raccolta del controller di gioco
- Aggiungi il supporto per il mouse
- Aggiungere mappature dei dispositivi controller personalizzate