Android 遊戲

Android 遊戲程式庫會仿照 Android 應用程式 SDK 提供二進位檔下載。您可以使用 androidx 程式庫，不必手動下載 Android 遊戲 SDK 並將其整合至版本中。

如要進一步瞭解 Android 遊戲 SDK，請參閱 SDK 說明文件和 SDK 版本資訊。

這個資料表會列出 androidx.games 群組中的所有成果。

構件	穩定版	候選版	Beta 版	Alpha 版
games-activity	1.2.1	-	-	-
games-controller	1.1.0	-	-	-
遊戲畫面速度	1.9.1	-	-	-
games-memory-advice	-	-	1.0.0-beta01	-
Games-text-input	1.1.1	-	-	-
games-performance-tuner	1.6.0	-	-	-

本程式庫上次更新日期：2022 年 7 月 13 日

要求

games-memory-advice

如要使用 MemoryAdvice API，您必須使用下列任一 NDK 版本建構應用程式：

r20.*
r21.*
r23.*

宣告依附元件

如要新增遊戲依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

針對您需要的模組或應用程式的 build.gradle 檔案，為所需的構件新增依附元件；games-activity 程式庫整合了相同版本的 game-text-input 程式庫，因此 GameActivity 應用程式無法再次納入 game-text-input 依附元件：

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:1.9.1"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:1.6.0"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:1.2.1"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:1.1.0"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:1.1.1"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:1.9.1")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:1.6.0")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:1.2.1")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:1.1.0")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:1.1.1")
}
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

新增 Gradle 屬性

您可能需要新增屬性到位於應用程式 (或模組) build.gradle 檔案所在的目錄中 gradle.properties 檔案。如果 gradle.properties 檔案不存在，請建立這個檔案。

如果您使用 Android Studio 4.0，請確認 gradle.properties 包含以下：

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

如果您使用 Android Studio 4.1 以上版本，請確認 gradle.properties 包含以下：

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

使用 CMake 新增套件

如要提供匯入的遊戲遊戲套件，請將以下內容新增至主應用程式的 CMakeLists.txt 檔案：

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

因此您可以在遊戲程式碼中加入 Android Game SDK 的標題檔案：

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

在主要應用程式的 CMakeLists.txt 檔案中，找到主要共用資料庫的 target_link_libraries。將參考資料新增至 Android Game SDK 靜態程式庫，將其加入共用資料庫中：

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時，請告訴我們。建立新的問題之前，請先查看這個程式庫中的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

Games-Memory-Advice 1.0.0 版本

1.0.0-beta01 版本

2022 年 3 月 9 日

已釋出androidx.games:games-memory-advice:1.0.0-beta01。1.0.0-beta01 版本包含這些修訂版本。

自 1.0.0-alpha01 起沒有變更。

1.0.0-alpha01 版本

2022 年 2 月 23 日

已釋出androidx.games:games-memory-advice:1.0.0-alpha01。1.0.0-alpha01 版本包含以下修訂項目。

新功能

這個 C 程式庫可讓使用者針對執行遊戲的裝置，查詢記憶體記憶體狀態的變化並接收回呼。

API 異動

這是記憶體建議資料庫的初始版本。如需完整 API 的相關標題，請參閱 Include/Memory_advice/Memory_advice.h 的標題。

外部貢獻

這個程式庫取決於 tensorflow，您可以前往 https://github.com/tensorflow/tensorflow 取得授權和授權依附元件。

Games-Activity 1.2 版本

1.2.1 版本

2022 年 7 月 13 日

發布 androidx.games:games-activity:1.2.1。1.2.1 版本包含以下修訂項目。

修正錯誤

修正先前版本缺少 .aar 檔案的問題。

1.2.0 版本

2022 年 6 月 15 日

發布 androidx.games:games-activity:1.2.0。1.2.0 版本包含這些修訂版本。

自 1.1.0 版以來的重要異動

允許 GameActivity 衍生類別處理原生資料庫的載入程序。
請一律在 GameActivity.onCreate 內載入原生資料庫。
如果系統找不到其他程式庫，備用方式是載入名稱內具有「main」的程式庫。

Games-Activity 1.1 版本

1.1.0 版本

2022 年 2 月 23 日

androidx.games:games-activity:1.1.0 和 androidx.games:games-controller:1.1.0 發布。1.1.0 版本包含以下修訂項目。

自 1.0.0 版以來的重要異動

Games Activity:

WindowInsets 監聽及查詢問題回報和 IME 回應
新增金鑰和動作事件篩選器
修正問題:
- 新增缺少與 NativeActivity 相容的訊息
- 修正 onNativeWindowSized 中的簽章
- 修正輸入事件損失

1.1.0-rc01 版本

2022 年 2 月 9 日

已釋出「androidx.games:games-activity:1.1.0-rc01」和「androidx.games:games-controller:1.1.0-rc01」。1.1.0-rc01 版本包含以下修訂項目。

1.1.0-beta03 版本

2022 年 1 月 26 日

已釋出androidx.games:games-activity:1.1.0-beta03。1.1.0-beta03 版本包含這些修訂版本。

修正錯誤

onNativeWindowResized的固定簽名
繼續處理onSurfaceChanged中的原生視窗

1.1.0-beta02 版本

2021 年 12 月 15 日

已釋出androidx.games:games-activity:1.1.0-beta02。1.1.0-beta02 版本包含以下修訂項目。

修正錯誤

修正事件篩選器設定中的競爭狀況。

1.1.0-beta01 版本

2021 年 11 月 17 日

已釋出androidx.games:games-activity:1.1.0-beta01。1.1.0-beta01 版本包含這些修訂版本。

新功能

新增支援功能，可查詢回溯期內及監聽插入變更。如此一來，遊戲就能回應 IME 彈出式視窗，並處理刊登序列和相機切割畫面。

API 異動

void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

修正錯誤

請避免使用所有重要事件：音量、相機等事件現在都已透過系統。

1.1.0-alpha01 版本

2021 年 9 月 29 日

已釋出androidx.games:games-activity:1.1.0-alpha01。1.1.0-alpha01 版本包含以下修訂項目。

API 異動

已將 onContentRectChanged 回呼新增至GameActivityCallbacks

修正錯誤

加入 android_native_app_glue.h 的訊息遺失：
- APP_CMD_CONTENT_RECT_CHANGED
- APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 1.6

1.6.0 版本

2022 年 6 月 15 日

發布 androidx.games:games-performance-tuner:1.6.0。1.6.0 版本含有這些修訂版本。

自 1.5.0 版本之後的重要異動

修正在嘗試取得記憶體遙測時，getpid 會回傳 0 的問題。
當無載入群組在活動時，會阻止系統執行 StopLoadingGroup。

Games Performance Tuner 1.5.0

1.5.0 版本

2022 年 2 月 9 日

發布 androidx.games:games-performance-tuner:1.5.0。1.5.0 版隨附這些修訂版本。

1.4.0 版之後的重要異動

以程式輔助方式變更上傳之間的間隔時間，而不是在初始設定中採用硬式編碼。
- 已新增函式：TuningFork_setAggregationStrategyInterval
修正 API<=23 上 API 金鑰損毀的記憶體問題

1.5.0-rc01 版本

2022 年 1 月 26 日

已釋出androidx.games:games-performance-tuner:1.5.0-rc01。1.5.0-rc01 版包含這些修訂版本。

修正錯誤

修正 API 金鑰中 API 金鑰損毀的記憶體<=23

1.5.0-beta02 版本

2021 年 12 月 15 日

已釋出androidx.games:games-performance-tuner:1.5.0-beta02。1.5.0-beta02 版本包含這些修訂版本。

API 異動

移除 TuningFork_Settings 的 ABI 中斷設定變更。

1.5.0-beta01 版本

2021 年 9 月 29 日

已釋出androidx.games:games-performance-tuner:1.5.0-beta01。1.5.0-beta01 版本包含這些修訂版本。

新功能

Alpha 版沒有任何變更。該版本包含：
- 以程式輔助的方式變更上傳的間隔時間，而不是在初始設定中採用硬式編碼的方式。

API 異動

Alpha 版沒有任何變更。該版本包含：
- 新功能: TuningFork_setAggregationStrategyInterval
- TuningFork_Settings: aggregation_strategy_intervalms_or_count中的新欄位

1.5.0-alpha01 版本

2021 年 8 月 18 日

已釋出androidx.games:games-performance-tuner:1.5.0-alpha01。1.5.0-alpha01 版本包含這些修訂版本。

新功能

您現在可以透過程式輔助 (而非設定檔案) 設定 APT 上傳作業的間隔時間。

API 異動

已新增函式：TuningFork_setAggregationStrategyInterval
已將欄位新增至 TuningFork_Settings struct：aggregation_strategy_intervalms_or_count

Games-Activity 1.0.0 版本

1.0.0 版本

2021 年 8 月 4 日

已釋出 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。1.0.0 版本包含以下修訂項目。

1.0.0 的主要功能

這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。

1.0.0-rc01 版本

2021 年 7 月 12 日

已釋出androidx.games:games-activity:1.0.0-rc01。1.0.0-rc01 版本包含這些修訂版本。

修正錯誤

GameActivityCallbacks::onSaveInstanceState 的修正返回類型

1.0.0-beta01 版本

2021 年 6 月 30 日

已釋出androidx.games:games-activity:1.0.0-beta01。1.0.0-beta01 版本包含這些修訂版本。

API 異動

將 GameActivityInputInfo 重新命名為 GameActivityPointerAxes。
onNativeWindowResized 回呼現可提供視窗的寬度和高度。
已移除 onContentRectChanged 回呼。
onLowMemory已重新命名為onTrimMemory。
已移除GameActivity_setWindowFormat。
改善 GameActivityMotionEvents 和 GameActivityMotionEvent 指標的擁有權模型。
改善 onSaveInstanceState 回呼的使用者狀態擁有權模型。

1.0.0-alpha01 版本

2021 年 6 月 16 日

已釋出androidx.games:games-activity:1.0.0-alpha01。

新功能

Games-Activity 是將 NativeActivity 取代為 Android 與 C/C++ 遊戲的推薦方法。

Games-Controller 1.1.0 版本

1.1.0 版本

2022 年 2 月 23 日

androidx.games:games-activity:1.1.0 和 androidx.games:games-controller:1.1.0 發布。1.1.0 版本包含以下修訂項目。

自 1.0.0 版以來的重要異動

Games Activity:

WindowInsets 監聽及查詢問題回報和 IME 回應
新增金鑰和動作事件篩選器
修正問題:
- 新增缺少與 NativeActivity 相容的訊息
- 修正 onNativeWindowSized 中的簽章
- 修正輸入事件損失

1.1.0-rc01 版本

2022 年 2 月 9 日

發布 androidx.games:games-controller:1.1.0-rc01。1.1.0-rc01 版本包含以下修訂項目。

1.1.0-beta01 版本

2022 年 1 月 26 日

androidx.games:games-controller:1.1.0-beta01 自 1.1.0-alpha01起沒有變更。1.1.0-beta01 版本包含這些修訂版本。

1.1.0-alpha01 版本

2021 年 12 月 15 日

發布 androidx.games:games-controller:1.1.0-alpha01。1.1.0-alpha01 版本包含以下修訂項目。

新功能

現在在 Android S 以上版本執行時，可在支援的控制器上提供電池狀態、雙馬達震動、燈光控制和動態軸回報功能。

API 異動

新增 Paddleboat_setMotionDataCallback 函式，用於註冊控制器動態資料回呼
已新增 Paddleboat_setControllerLight 函式，可用於變更控制器燈設定。
將 Paddleboat_Controller_Battery 結構新增至 Paddleboat_Controller_Data
新結構：
- Paddleboat_Controller_Battery
- Paddleboat_Motion_Data
新列舉項目：
- Paddleboat_BatteryStatus
- Paddleboat_LightType
- Paddleboat_Motion_Type
新增控制器旗標：
- PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
- PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
- PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
- PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
- PADDLEBOAT_CONTROLLER_FLAG_BATTERY

修正錯誤

新增 PS4 控制器的替代裝置 ID 資料庫項目
新增 PS5 控制器的 API >=31 資料庫項目

Games-Controller 1.0.0 版本

1.0.0 版本

2021 年 8 月 4 日

已釋出 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。1.0.0 版本包含以下修訂項目。

1.0.0 的主要功能

這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。

1.0.0-rc02 版本

2021 年 7 月 21 日

發布 androidx.games:games-controller:1.0.0-rc02。1.0.0-rc02 版包含以下修訂項目。

修正錯誤

修正了封裝錯誤，導致 Prefab 匯入作業在空白、未使用的架構/版本排列時失敗。

1.0.0-rc01 版本

2021 年 7 月 12 日

已釋出androidx.games:games-controller:1.0.0-rc01。1.0.0-rc01 版本包含這些修訂版本。

修正錯誤

修正最新 GameActivity 不相容的問題

1.0.0-beta01 版本

2021 年 6 月 30 日

已釋出androidx.games:games-controller:1.0.0-beta01。1.0.0-beta01 版本包含這些修訂版本。

API 異動

會傳回成功或失敗布林值的函式將會傳回 Paddleboat_Error_Code 列舉。
Paddleboat_onPause已重新命名為Paddleboat_onStop。
Paddleboat_onResume已重新命名為Paddleboat_onStart。
Paddleboat_processGameActivityEvent 拆分為兩個函式：Paddleboat_processGameActivityKeyInputEvent 和 Paddleboat_processGameActivityMotionInputEvent
移除需要為 Android S SDK 預覽需要建構的擴充控制器功能
已新增 Paddleboat_getBackButtonConsumed 函式
控制器和滑鼠狀態回呼現在會使用選用參數，指向使用者定義的資料
已將控制器名稱字串移出裝置資訊結構，現可透過 Paddleboat_getControllerName 函式存取

修正錯誤

修正原本未將控制器回報為控制器，但之後透過 onInputDeviceChanged 訊息的控制器無法正確偵測為控制器連線的問題。

1.0.0-alpha01 版本

2021 年 6 月 16 日

已釋出androidx.games:games-controller:1.0.0-alpha01。

新功能

Games-Controller 是提供 C API 的新程式庫，用於偵測遊戲控制器裝置、讀取控制器輸入內容，以及與控制器進行互動。

Games-Text-Input 1.1 版本

1.1.1 版本

2022 年 7 月 13 日

發布 androidx.games:games-text-input:1.1.1。1.1.1 版本包含以下修訂項目。

修正錯誤

修正先前版本缺少 .aar 檔案的問題。

1.1.0 版本

2022 年 2 月 9 日

發布 androidx.games:games-text-input:1.1.0。1.1.0 版本包含以下修訂項目。

自 1.0.0 版起的重要變更 - 為 GameTextInput 新增 WindowInsets 監聽和查詢功能 - 新增缺少的 gamecommon.h 標題

1.1.0-rc01 版本

2022 年 1 月 26 日

已釋出androidx.games:games-text-input:1.1.0-rc01。1.1.0-rc01 版本包含以下修訂項目。

1.1.0-beta01 版本

2021 年 12 月 15 日

已釋出androidx.games:games-text-input:1.1.0-beta01。1.1.0-beta01 版本包含這些修訂版本。

修正錯誤

修正刊登序列與 IME 插槽
新增遺漏的 Gamecommon.h 標題

1.1.0-alpha01 版本

2021年10月13日

已釋出androidx.games:games-text-input:1.1.0-alpha01。1.1.0-alpha01 版本包含以下修訂項目。

API 異動

將 IME 插入功能新增至 GameTextInput

Games-Text-Input 1.0 版本

1.0.0 版本

2021 年 8 月 4 日

已釋出 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。1.0.0 版本包含以下修訂項目。

1.0.0 的主要功能

這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。

1.0.0-rc01 版本

2021 年 7 月 12 日

androidx.games:games-text-input:1.0.0-rc01 發布，內容無變更。1.0.0-rc01 版本包含以下修訂項目。

1.0.0-beta01 版本

2021 年 6 月 30 日

已釋出androidx.games:games-text-input:1.0.0-beta01。1.0.0-beta01 版本包含這些修訂版本。

API 異動

改善 GameTextInputState 物件的擁有權模型。
與 NDK 保持一致的類型。

1.0.0-alpha01 版本

2021 年 6 月 16 日

已釋出androidx.games:games-text-input:1.0.0-alpha01。

新功能

Games-Text-Input 是一款新程式庫，可協助遊戲開發人員在 C/C++ 中使用 Android 螢幕鍵盤輸入功能。

Games Frame Pacing 1.10

1.10.1 版本

2022 年 6 月 15 日

發布 androidx.games:games-frame-pacing:1.10.1。1.10.1 版本包含這些修訂版本。

修正錯誤

修正 swappy 無法使用 ndk <23 和 >17 建構的問題。
曝露 API，以便擷取螢幕支援的重新整理頻率。

1.10.0 版本

2022 年 2 月 23 日

已釋出androidx.games:games-frame-pacing:1.10.0。1.10.0 版含有這些修訂版本。

自 1.9.0 版以來的重要異動

忽略輪詢器篩選器輸入內容，然後設定更平穩的配置，避免模擬器凍結
新增 *_uninjectTracer 函式。

1.10.0-rc01 版本

2022 年 2 月 9 日

已釋出androidx.games:games-frame-pacing:1.10.0-rc01。1.10.0-rc01 版包含這些修訂版本。

1.10.0-beta01 版本

2022 年 1 月 26 日

已釋出androidx.games:games-frame-pacing:1.10.0-beta01。1.10.0-beta01 版本包含這些修訂版本。

1.10.0-alpha01 版本

2021 年 12 月 15 日

已釋出androidx.games:games-frame-pacing:1.10.0-alpha01。1.10.0-alpha01 版本包含這些修訂版本。

新功能

新增 SwappyGL_uninjectTracer 函式。

API 異動

使用SwappyGL_uninjectTracer(const SwappyTracer *t)API移除先前使用SwappyGL_injectTracer新增的回呼。

遊戲畫面速度 1.9

1.9.1 版本

2021年10月13日

已釋出androidx.games:games-frame-pacing:1.9.1。1.9.1 版包含這些修訂版本。

修正錯誤

已修正 b/199487756

1.9.0 版本

2021 年 7 月 12 日

已釋出androidx.games:games-frame-pacing:1.9.0。1.9.0 版包含這些修訂版本。

1.7.0 版之後的重要異動

已配合內部版本管理架構更新。

遊戲畫面速度 1.7.0

1.7.0 版本

2021 年 6 月 30 日

已釋出androidx.games:games-frame-pacing:1.7.0。1.7.0 版本包含以下修訂項目。

1.7.0-rc01 版本

2021 年 6 月 2 日

已釋出androidx.games:games-frame-pacing:1.7.0-rc01。1.7.0-rc01 版本包含以下修訂項目。

1.7.0-beta02 版本

2021 年 2 月 24 日

已釋出androidx.games:games-frame-pacing:1.7.0-beta02。

1.7.0-beta01 版本

2020 年 12 月 16 日

已釋出androidx.games:games-frame-pacing:1.7.0-beta01。

Games Performance Tuner 1.4.3 版本

1.4.3 版本

2021 年 7 月 12 日

已釋出androidx.games:games-performance-tuner:1.4.3。1.4.3 版本包含以下修訂項目。

自 1.1.0 版以來的重要異動

已配合內部版本管理架構更新。

Games Performance Tuner 1.1.0

1.1.0 版本

2021 年 6 月 30 日

已釋出androidx.games:games-performance-tuner:1.1.0。1.1.0 版本包含以下修訂項目。

1.1.0-rc01 版本

2021 年 6 月 2 日

已釋出androidx.games:games-performance-tuner:1.1.0-rc01。1.1.0-rc01 版本包含以下修訂項目。

1.1.0-beta03 版本

2021 年 4 月 21 日

已釋出androidx.games:games-performance-tuner:1.1.0-beta03。

1.1.0-beta02 版本

2021 年 2 月 24 日

已釋出androidx.games:games-performance-tuner:1.1.0-beta02。

1.1.0-beta01 版本

2020 年 12 月 16 日

已釋出androidx.games:games-performance-tuner:1.1.0-beta01。

1.1.0-alpha01 版本

已釋出 androidx.games:games-performance-tuner:1.1.0-alpha01。

1.0.0 版本

1.0.0-alpha02 版本

2020 年 8 月 12 日

Android Gaming 程式庫已重新命名為 Android 遊戲程式庫。

androidx.gaming -> androidx.games

1.0.0-alpha01 版本

2020年6月10日

已釋出androidx.games:1.0.0-alpha01。