遊戲控制器程式庫   由 Android Game Development Kit 提供

遊戲控制器程式庫 (又稱為 Paddleboat) 可協助您針對遊戲控制器提供完善的支援。遊戲控制器程式庫以 Jetpack 程式庫的形式發布，適用於使用 Gradle 型建構系統 (包括 Android Studio) 的遊戲。程式庫提供以下功能：

  • 用於偵測控制器連線和中斷連線的回呼
  • 控制器裝置資訊，包括按鈕樣式和版面配置
  • 控管器輸入資料，根據現代化的雙貼圖控制器設計進行標準化
  • 支援控制器上的額外功能，包括震動、光線、動作軸資料和電池狀態
  • 能夠讀取虛擬和實體滑鼠裝置的輸入資料
  • 能夠指定特定裝置的自訂控制器對應資料

相容性需求

遊戲控制器程式庫的最低相容性需求如下：

  • Android 4.4 (API 級別 19) 以上版本
  • Android NDK (21 以上版本)

整合

Jetpack Android Games 頁面提供整合操作說明，將遊戲控制器程式庫依附元件新增至遊戲的 build.gradle 檔案。

遊戲控制器的 Jetpack 程式庫版本是根據 C++ 執行階段共用資料庫建構的靜態程式庫。

更新 build.gradle 檔案後，您必須在遊戲的主要 CMakeLists.txt 檔案中加入以下這行文字：

find_package(games-controller REQUIRED CONFIG)

您也需要將下列條目加入遊戲主要共用資料庫的 target_link_libraries 指令中的程式庫清單：

games-controller::paddleboat_static

如需整合遊戲控制器程式庫的範例，請參閱遊戲範例存放區。

後續步驟

請參閱下列指南，繼續將遊戲控制器程式庫整合至遊戲中：