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 inlibs/classes.jar
- Il file delle intestazioni dell'interfaccia
paddleboat.h
. Questo file si trova ininclude/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 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:
- Utilizzare la raccolta del controller di gioco
- Aggiungi il supporto del mouse
- Aggiungere mappature personalizzate dei dispositivi del controller