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

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

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

兼容性要求

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

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

集成

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

有关集成游戏控制器库的示例，请参阅 games-samples 代码库。

Jetpack 库

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

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

更新 build.gradle 文件后，您需要将以下行添加到游戏的 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/ 中。

后续步骤

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