游戏控制器库   Android 游戏开发套件的一部分.

游戏控制器库（也称为 Paddleboat）可帮助您实现对游戏控制器的强大支持。该库提供以下功能

  • 用于检测控制器连接和断开连接的回调
  • 控制器设备信息，包括按钮样式和布局
  • 控制器输入数据，围绕现代双摇杆控制器设计标准化
  • 支持控制器上的扩展功能，包括振动、灯光、运动轴数据和电池状态
  • 能够从虚拟和物理鼠标设备读取输入
  • 能够为特定设备指定自定义控制器映射数据

兼容性要求

游戏控制器库具有以下最低兼容性要求

  • Android 4.4（API 级别 19）或更高版本
  • Android NDK 版本 21 或更高版本

集成

游戏控制器库以两种格式分发：作为 Jetpack 库，用于使用基于 Gradle 的构建系统的游戏（包括 Android Studio），以及作为离散文件，用于使用自定义构建系统的游戏。

有关集成游戏控制器库的示例，请参阅 games-samples 存储库.

Jetpack 库

Jetpack Android Games 页面提供了集成说明，以便将游戏控制器库依赖项添加到游戏的 build.gradle 文件中。

Jetpack 库版本的游戏控制器是一个静态库，它针对 C++ 运行时共享库构建。

更新 build.gradle 文件后，需要在游戏的 main CMakeLists.txt 文件中添加以下行

find_package(games-controller REQUIRED CONFIG)

您还需要在游戏的主要共享库的 target_link_libraries 命令中的库列表中添加以下条目

games-controller::paddleboat_static

离散文件

Android 游戏开发套件的 .zip 存档发行版包括游戏控制器库的标头和库文件。要使用游戏控制器库，必须在您的项目中包含以下文件

  • 包含游戏控制器库的 Dalvik 字节码部分的 classes.jar 文件。此文件位于 libs/classes.jar
  • 接口标头文件 paddleboat.h。此文件位于 include/paddleboat/paddleboat.h
  • 共享库文件 libpaddleboat.so 或静态库文件 libpaddleboat-static.a。这些文件位于 libs 目录下的构建配置子目录中。

根 libs 目录下的构建配置子目录按以下分类

  • ABI 架构
  • 最低 Android API 级别
  • Android NDK 版本
  • C++ 运行时库版本
  • 发布或调试构建配置

例如，arm64-v8a_API16_NDK21_cpp_shared_Release 子目录包含针对以下内容构建的库文件

  • ARM 64 位 ABI
  • 最低 API 级别 16
  • 针对 NDK 版本 21 构建
  • 针对 C++ 运行时的共享库版本构建
  • 发布构建配置

文件 libpaddleboat_static.a 位于子目录中。文件 libpaddleboat.so 位于子目录内的 lib/paddleboat/ 中。

后续步骤

请参阅以下指南，以继续将游戏控制器库集成到您的游戏中