La bibliothèque Game Controller Composante d'Android Game Development Kit.

La bibliothèque Game Controller, également appelée Paddleboat, vous aide à implémenter une prise en charge solide des manettes de jeu. La bibliothèque fournit les éléments suivants :

  • Des rappels pour détecter les connexions et déconnexions de la manette
  • Des informations concernant la manette, y compris le style et la disposition des boutons
  • Des données d'entrée de la manette, standardisées autour des conceptions de manettes modernes à double joystick
  • Des fonctionnalités étendues sur les manettes compatibles, y compris les vibrations, l'éclairage, les données d'axe de mouvement et l'état de la batterie
  • La possibilité de lire les données d'entrée de souris virtuelles et physiques
  • La possibilité de spécifier des données de mappage de manette personnalisées pour des appareils spécifiques

Configuration requise

La configuration requise pour la bibliothèque Game Controller est la suivante :

  • Android 4.1 (niveau d'API 16) ou version ultérieure
  • Android NDK version 17 ou ultérieure

Intégrer

La bibliothèque Game Controller est distribuée dans deux formats : en tant que bibliothèque Jetpack pour les jeux utilisant un système de compilation basé sur Gradle (y compris Android Studio) et sous forme de fichiers distincts pour les jeux utilisant des systèmes de compilation personnalisés.

Pour obtenir un exemple intégrant la bibliothèque Game Controller, consultez le dépôt "games-samples".

Bibliothèque Jetpack

La page Jeux Android de Jetpack contient des instructions d'intégration permettant d'ajouter la dépendance de la bibliothèque Game Controller au fichier build.gradle de votre jeu.

La version de bibliothèque Jetpack de Game Controller est une bibliothèque statique conçue pour la bibliothèque d'exécution partagée C++.

Après avoir mis à jour votre fichier build.gradle, vous devez ajouter la ligne suivante au fichier CMakeLists.txt principal de votre jeu :

find_package(games-controller REQUIRED CONFIG)

Vous devez également ajouter l'entrée suivante à la liste des bibliothèques dans la commande target_link_libraries de la bibliothèque partagée principale de votre jeu :

games-controller::paddleboat_static

Fichiers distincts

La distribution d'Android Game Development Kit sous forme de fichier .zip inclut des fichiers d'en-tête et de bibliothèque pour la bibliothèque Game Controller. Pour que vous puissiez utiliser la bibliothèque Game Controller, les fichiers suivants doivent être inclus dans votre projet :

  • Le fichier classes.jar contenant les portions de bytecode Dalvik de la bibliothèque Game Controller. Ce fichier se trouve à l'emplacement libs/classes.jar.
  • Le fichier d'en-tête de l'interface paddleboat.h. Ce fichier se trouve à l'emplacement include/paddleboat/paddleboat.h.
  • Soit le fichier de bibliothèque partagée libpaddleboat.so, soit le fichier de bibliothèque statique libpaddleboat-static.a. Ces fichiers se trouvent dans les sous-répertoires de configuration de compilation du répertoire libs.

Les sous-répertoires de configuration de compilation du répertoire racine libs sont classés par :

  • Architecture ABI
  • Niveau d'API Android minimal
  • Version d'Android NDK
  • Version de la bibliothèque d'exécution C++
  • Configuration de compilation de version ou de débogage

Par exemple, le sous-répertoire arm64-v8a_API16_NDK21_cpp_shared_Release contient des fichiers de bibliothèque pour les éléments suivants :

  • ABI ARM 64 bits
  • Niveau d'API minimal 16
  • Compilation avec la version de NDK 21
  • Compilation avec la version de bibliothèque partagée de l'environnement d'exécution C++
  • Configuration de compilation de version

Le fichier libpaddleboat_static.a se trouve directement dans le sous-répertoire. Le fichier libpaddleboat.so se trouve dans le sous-répertoire lib/paddleboat/.

Étapes suivantes

Consultez les guides suivants pour continuer à intégrer la bibliothèque Game Controller à votre jeu :