Libreria Game Controller   Parte di Android Game Development Kit.

La libreria Game Controller, nota anche come Paddleboat, 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 di controllo, inclusi stile e layout dei pulsanti
  • Dati di input del controller, standardizzati in base ai moderni design dei controller con due levette
  • Funzionalità estese sui controller supportati, tra cui vibrazione, luci, dati dell'asse di movimento e stato della batteria
  • Possibilità di leggere l'input da dispositivi mouse virtuali e fisici
  • Possibilità di specificare dati di mappatura del controller personalizzati per determinati dispositivi

Requisiti di compatibilità

La libreria Game Controller ha i seguenti requisiti minimi di compatibilità:

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

Integra

La libreria Game Controller viene distribuita in due formati: come libreria Jetpack per i giochi che utilizzano un sistema di compilazione basato su Gradle (incluso Android Studio) e come file discreti per i giochi che utilizzano sistemi di compilazione personalizzati.

Per un esempio che integra la libreria Game Controller, consulta il repository games-samples.

Libreria Jetpack

La pagina Jetpack Android Games contiene istruzioni di integrazione per aggiungere la dipendenza della libreria Game Controller al file build.gradle del gioco.

La release della libreria Jetpack di Game Controller è una libreria statica creata in base alla libreria condivisa di 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)

Devi 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 dell'archivio .zip dell'Android Game Development Kit include file di intestazione e libreria per la libreria Game Controller. Per utilizzare la libreria Game Controller, devi includere i seguenti file nel tuo progetto:

  • Il file classes.jar contenente le parti di bytecode Dalvik della libreria Game Controller. Questo file si trova in libs/classes.jar
  • Il file di intestazione 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 della build nella directory libs.

Le sottodirectory di configurazione della build nella directory radice libs sono classificate in base a:

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

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

  • ABI ARM a 64 bit
  • Livello API minimo 16
  • Compilato in base alla versione 21 dell'NDK
  • Compilato in base alla versione della libreria condivisa del runtime C++
  • Configurazione della build di release

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

Passaggi successivi

Consulta le seguenti guide per continuare a integrare la libreria Game Controller nel tuo gioco: