Game Controller 库   Android Game Development Kit 的一部分。

Game Controller 库(也称为 Pandlecar)可帮助您实现对游戏控制器的有力支持。Game Controller 库以 Jetpack 库的形式分发,适用于使用基于 Gradle 的构建系统(包括 Android Studio)的游戏。该库提供以下内容:

  • 用于检测控制器连接和断开连接情况的回调
  • 控制器设备信息,包括按钮样式和布局
  • 控制器输入数据,针对现代双摇杆控制器的设计进行了标准化处理
  • 支持的控制器上的扩展功能,包括振动、光线、动作轴数据和电池状态
  • 从虚拟和实体鼠标设备读取输入内容的能力
  • 针对特定设备指定自定义控制器映射数据的能力

兼容性要求

Game Controller 库的最低兼容性要求如下所示:

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

集成

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

Game Controller 库的 Jetpack 版本是基于 C++ 运行时共享库构建的静态库。

更新 build.gradle 文件后,您需要将以下代码行添加到游戏的主 CMakeLists.txt 文件中:

find_package(games-controller REQUIRED CONFIG)

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

games-controller::paddleboat_static

如需查看集成了 Game Controller 库的示例,请参阅 games-samples 代码库

后续步骤

请参阅以下指南,了解如何将 Game Controller 库持续集成到您的游戏中: