游戏控制器库   Android 游戏开发工具包的一部分 (Android 游戏开发工具包).

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

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

兼容性要求

游戏控制器库的最低兼容性要求包括：

  • Android 4.4 (API 级别 19) 或更高版本
  • Android NDK 版本 21 或更高版本

集成

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

如需集成游戏控制器库的示例，请参阅 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/。

后续步骤

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