Raccolta di controller di gioco Parte del Android Game Development Kit.

La libreria Game Controller, nota anche come Paddle boat, ti aiuta a implementare un supporto solido per i controller di gioco. La libreria fornisce quanto segue:

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

Requisiti di compatibilità

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

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

Integra

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

Per un esempio che integra la libreria del controller di gioco, visita la pagina Repository di esempi di giochi.

Libreria Jetpack

La pagina Jetpack Android Games ha le istruzioni di integrazione per aggiungere la dipendenza della libreria del controller di gioco al tuo build.gradle del gioco.

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

Dopo aver aggiornato il file build.gradle, dovrai aggiungere quanto segue al file CMakeLists.txt principale del tuo gioco:

find_package(games-controller REQUIRED CONFIG)

Dovrai anche aggiungere la seguente voce all'elenco delle librerie nel comando target_link_libraries della schermata principale del gioco libreria:

games-controller::paddleboat_static

File discreti

La distribuzione nell'archivio di .zip del Game Development Kit di Android include di intestazione e libreria per la raccolta del controller di gioco. I file che seguono devono essere inclusi nel progetto per utilizzare la libreria del controller di gioco:

  • Il file classes.jar contenente le parti bytecode Dalvik del nella raccolta di controller di gioco. Questo file si trova all'indirizzo libs/classes.jar
  • Il file di intestazione dell'interfaccia paddleboat.h. Questo file si trova in include/paddleboat/paddleboat.h
  • Il file della raccolta condivisa libpaddleboat.so o libpaddleboat-static.a file di libreria statica. Questi file sono stati trovati nelle sottodirectory della configurazione di compilazione nella directory libs.

Le sottodirectory della configurazione di compilazione nella directory principale libs sono classificato per:

  • Architettura ABI
  • Livello API Android minimo
  • Versione Android NDK
  • Versione 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 raccolta per:

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

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

Passaggi successivi

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