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

遊戲控制器程式庫 (又稱為 Paddleboat) 可協助您針對遊戲控制器提供完善的支援。程式庫提供以下功能：

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

相容性需求

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

  • Android 4.1 (API 級別 16) 或以上版本
  • Android NDK (17 或以上版本)

整合

遊戲控制器程式庫採用兩種格式發布：作為使用以 Gradle 為基礎的建構系統 (包括 Android Studio) 的遊戲的 Jetpack 程式庫，以及作為使用自訂建構系統的遊戲的離散檔案。

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

Jetpack 程式庫

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

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

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

find_package(games-controller REQUIRED CONFIG)

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

games-controller::paddleboat_static

離散檔案

Android Game Development Kit 的 .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/ 中。

後續步驟

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