Android 遊戲

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

需求條件

games-memory-advice

如要使用 MemoryAdvice API，您必須使用 NDK r23.* 以上版本建構應用程式。

宣告依附元件

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

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

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:2.1.2"

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

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

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

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

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:2.1.2")

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

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

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

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

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

新增 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 2.1 版

2.1.0-beta01 版

2023 年 11 月 29 日

發布 androidx.games:games-memory-advice:2.1.0-beta01。2.1.0-beta01 版包含此連結所列的修訂項目。

2.1.0-alpha01 版本

2023 年 11 月 15 日

發布 androidx.games:games-memory-advice:2.1.0-alpha01。2.1.0-alpha01 版本包含這些修訂版本。

新功能

• 更新程式庫的記憶體模型，以便提供更準確的預測結果。

API 變更

• 新增了 getAvailableMemory() API，可傳回可安全分配的記憶體量預估值 (以位元組為單位)。

2.1.0-alpha01 版本

2023 年 7 月 26 日

發布 androidx.games:games-memory-advice:2.1.0-alpha01。2.1.0-alpha01 版本包含這些修訂版本。

API 變更

• 新增 GetAvailableMemory 函式

修正錯誤

• 更新記憶體建議模型
• 修正共用 memory_advice 建構目標

Games-Memory-Advice 2.0 版

2.0.1 版

2023 年 9 月 20 日

發布 androidx.games:games-memory-advice:2.0.1。2.0.1 版包含此連結所列的修訂項目。

修正錯誤

• 修正狀態監控器執行緒發生當機的問題，因為執行緒未附加至 JVM。

2.0.0 版

2023 年 9 月 6 日

發布 androidx.games:games-memory-advice:2.0.0。2.0.0 版包含此連結所列的修訂項目。

2.0.0 的主要功能

• 這個版本已訓練並發布新的機器學習模型。
• 實作可預測可用記憶體量的 API。

2.0.0-rc01 版

2023 年 7 月 26 日

發布 androidx.games:games-memory-advice:2.0.0-rc01。2.0.0-rc01 版包含以下修訂項目。

新功能

• 加入新模型，以便更準確地預測剩餘記憶體。

修正錯誤

• 修正記憶體建議無法搭配共用 STL 使用的情形。

2.0.0-beta04 版

2023 年 5 月 24 日

發布 androidx.games:games-memory-advice:2.0.0-beta04。2.0.0-beta04 版包含以下修訂項目。

新功能

• 更新驅動程式庫的機器學習模型，較新款手機可因此取得更理想結果

2.0.0-beta03 版

2023 年 4 月 5 日

發布 androidx.games:games-memory-advice:2.0.0-beta03。2.0.0-beta03 版包含以下修訂項目。

修正錯誤

• 修正程式庫無法正確載入必要的 TensorFlow Lite 資產的錯誤

2.0.0-beta02 版

2023 年 3 月 22 日

發布 androidx.games:games-memory-advice:2.0.0-beta02。2.0.0-beta02 版包含以下修訂項目。

修正錯誤

• 修正無法正確連結靜態版本程式庫的錯誤

2.0.0-beta01 版

2023 年 2 月 22 日

發布 androidx.games:games-memory-advice:2.0.0-beta01。2.0.0-beta01 版包含此連結所列的修訂項目。

新功能

• 沒有更新內容

2.0.0-alpha01 版

2023 年 2 月 8 日

發布 androidx.games:games-memory-advice:2.0.0-alpha01。2.0.0-alpha01 版本包含這些修訂版本。

API 變更

• 重構建構檔案，更新主要版本。

修正錯誤

• 程式庫資產設定錯誤時不會停止運作，而是顯示錯誤訊息。

Games-Memory-Advice 1.0.0 版本

1.0.0-beta03 版

2022 年 11 月 9 日

發布了 androidx.games:games-memory-advice:1.0.0-beta03。1.0.0-beta03 版包含此連結所列的修訂項目。

新功能

• 沒有更新內容

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-Text-Input 3.0 版

3.0.4 版

2024 年 8 月 7 日

發布 androidx.games:games-text-input:3.0.4。3.0.4 版包含這些修訂項目。

修正錯誤

• 修正了刪除功能的功能，無論是否選取文字皆可使用。

Games-Activity 4.0 版

4.2.0-alpha01 版

2025 年 3 月 26 日

發布 androidx.games:games-activity:4.2.0-alpha01 和 androidx.games:games-text-input:4.2.0-alpha01。4.2.0-alpha01 版包含這些修訂版本。

新功能

• 升級至 Gradle 8.8.1 (1ed0153)
• 升級至 Java 17 (1ed0153)

修正錯誤

• 修正 GameActivity 中的錯誤，在該錯誤中，getLocaleScript、getLocaleCountry 和 getLocaleVariant 會回報語言代碼，而不是要求的值 (1198bb0)
• 修正 GameActivity 中的錯誤，該錯誤會導致我們誤報軟體鍵盤開啟/關閉事件。(a63ecca)
• 修正 GameTextInput 中多位元表情符號處理的錯誤 (9d54c68)

4.0.0 版

2025 年 2 月 12 日

發布 androidx.games:games-activity:4.0.0 和 androidx.games:games-text-input:4.0.0。4.0.0 版包含這些修訂項目。

4.0.0 的主要功能

• AAR 檔案現在包含預先建構的靜態資料庫。應用程式程式碼現在應透過預設項目使用這些程式庫，並只加入標頭 (例如 #include "GameActivity.h")，而非加入實作 (例如 #include "GameActivity.cpp")。
• 此外，Android 語言代碼資訊現在也適用於使用 GameActivity 的原生程式碼。

修正錯誤

• 已修正 GameTextInput 中的多項錯誤。程式庫現在更穩定，可搭配許多熱門的軟體和硬體鍵盤使用。

4.0.0-rc01 版

2025 年 1 月 29 日

發布 androidx.games:games-activity:4.0.0-rc01 和 androidx.games:games-text-input:4.0.0-rc01。4.0.0-rc01 版包含這些修訂項目。

4.0.0-beta01 版

2025 年 1 月 15 日

發布 androidx.games:games-activity:4.0.0-beta01 和 androidx.games:games-text-input:4.0.0-beta01。4.0.0-beta01 版包含這些修訂項目。

修正錯誤

• 為新加入的語言代碼相關功能提供更完善的說明文件。
• 為所有列舉類型新增備援類型。

4.0.0-alpha01 版

2024 年 10 月 16 日

發布 androidx.games:games-activity:4.0.0-alpha01 和 androidx.games:games-text-input:4.0.0-alpha01。4.0.0-alpha01 版包含這些修訂版本。

新功能

• GameTextInput 現在支援 Left/Right 鍵。

API 變更

• 已移除 GameTextInput 的過時 Java 介面。
• GameActivity 和 GameTextInput 的預設資料塊現在包含所有來源檔案。我們不再建議使用 #include <GameActivity.cpp>。請改為連結至適當的靜態或動態程式庫，例如 CMake 中的 game-activity::game-activity_static。這些程式庫會透過 AAR 檔案提供。

修正錯誤

• 我們已在 GameTextInput 中進行多項修正。輸入和移除功能已修正。
• 改善與大多數熱門軟體鍵盤的相容性。
• 修正硬體鍵盤的特殊字元處理問題。
• 修正 GameActivity 中罕見的空值指標存取問題。

Games-Activity 3.0 版

3.0.5 版

2024 年 8 月 7 日

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

修正錯誤

• GameActivity 的新版本，與 GameTextInput 的 3.0.4 版本相符 (已修正輸入內容中的文字刪除功能)。

3.0.4 版

2024 年 7 月 10 日

發布 androidx.games:games-activity:3.0.4。3.0.4 版包含這些修訂項目。

修正錯誤

• 修正空指標的處理方式。
• 修正 onConfiguration() 回呼中部分狀態缺少狀態更新的問題。

3.0.3 版

2024 年 4 月 17 日

發布 androidx.games:games-activity:3.0.3 和 androidx.games:games-text-input:3.0.3。3.0.3 版包含這些修訂項目。

修正錯誤

• 修正部分軟體鍵盤的相容性問題。

3.0.2 版

2024 年 4 月 3 日

發布 androidx.games:games-activity:3.0.2 和 androidx.games:games-text-input:3.0.2。3.0.2 版包含這些修訂項目。

修正錯誤

• 我們對 GamesTextInput 進行了幾項修正，目的是改善軟體和硬體鍵盤支援功能。此外，我們也修正了導致 GameTextInput 無法在沒有 GameActivity 的情況下使用的問題。

3.0.1 版本

March 20, 2024

發布 androidx.games:games-activity:3.0.1 和 androidx.games:games-text-input:3.0.1。3.0.1 版包含這些修訂項目。

修正錯誤

• 修正輸入和顯示特殊字元的相關問題。

3.0.0 版本

2024 年 3 月 6 日

發布 androidx.games:games-activity:3.0.0 和 androidx.games:games-text-input:3.0.0。3.0.0 版包含這些修訂版本。

3.0.0 的主要功能

• GameTextInput 已重新設計，可在遊戲中使用。
• 兩個程式庫中的部分介面已根據 2.0.0 版進行變更。

修正錯誤

• 修正舊版 NDK 的相容性問題
• 修正 Windows 建構問題

3.0.0-rc01 版本

2024 年 2 月 21 日

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

修正錯誤

• 修正鍵盤事件未正確由迴圈器處理時的當機問題。

3.0.0-beta01 版本

2023 年 11 月 29 日

發布 androidx.games:games-activity:3.0.0-beta01 和 androidx.games:games-text-input:3.0.0-beta01。查看 3.0.0-beta01 版的修訂項目。

3.0.0-alpha01 版本

2023 年 11 月 15 日

發布 androidx.games:games-activity:3.0.0-alpha01 和 androidx.games:games-text-input:3.0.0-alpha01。查看 3.0.0-alpha01 版的修訂版本。

API 變更

• GameActivityMotionEvent 和 GameActivityCallbacks 結構已變更大小。
• onEditorAction 將其傳回類型從布林值變更為 void。
• setImeEditorInfo 現在預期列舉參數，而非整數。
• GameActivityEvents 的內部函式會移至 GameActivityEvents_internal.h。
• GameTextInput 的輸入類型也是列舉，而不是整數。

Games-Activity 2.1 版

2.1.0-alpha02 版

2023 年 9 月 6 日

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

修正錯誤

• 改善 32 位元裝置的相容性。

2.1.0-alpha01 版本

2023 年 7 月 26 日

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

新功能

• 提供覆寫 SurfaceView 例項建立作業的功能
• 新增 SDK 版本回報

API 變更

• 請使用 int64_t 取代 long，以避免在 32 位元系統上超出範圍 historicalEventTimes
• 新增 GameActivity_restartInput 方法
• 新增原生回呼來處理軟體鍵盤的顯示變更

修正錯誤

• 最佳化觸控事件處理作業
• 正確銷毀 GameActivityMotionEven
• 修正 GameActivityMotionEvent_getHistoricalAxisValue 索引計算
• 修正動作篩選器的位元遮罩

Games-Activity 2.0 版

2.0.2 版

2023 年 5 月 24 日

發布 androidx.games:games-activity:2.0.2。2.0.2 版包含此連結所列的修訂項目。

修正錯誤

• 修正 GameActivityEvents 中的穩定性問題 (b/278017467)

2.0.1 版

2023 年 4 月 5 日

發布 androidx.games:games-activity:2.0.1。2.0.1 版包含此連結所列的修訂項目。

修正錯誤

• 修正 historicalEventTimes 記憶體較早釋放的問題。
• 修正 32 位元系統 historicalEventTimesNanos 溢位問題

2.0.0 版

2023 年 3 月 8 日

發布 androidx.games:games-activity:2.0.0。2.0.0 版包含此連結所列的修訂項目。

2.0.0 的主要功能

• 過往事件時間介面經過調整，現已能克服 32 位元限制。
• 為使用者提供設定變更項目存取權，例如螢幕方向。
• 在 contentRect 結構中提供最新資訊。
• 提供更簡單的方式自訂預設 SurfaceView。
• 修正觸控事件的預設 OS 處理作業，例如處理系統按鈕。
• 在觸控事件處理作業中，清除大部分 JNI 呼叫並進行最佳化。這項作業原本會影響效能。

2.0.0-rc01 版

2023 年 2 月 22 日

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

2.0.0-beta01 版

2023 年 2 月 8 日

發布 androidx.games:games-activity:2.0.0-beta01。2.0.0-beta01 版包含此連結所列的修訂項目。

修正錯誤

• 修正系統按鈕處理問題。(2a103e)

2.0.0-alpha01 版

2023 年 1 月 11 日

androidx.games:games-activity:2.0.0-alpha01 發布，內容無變更。2.0.0-alpha01 版本包含這些修訂項目。

Games-Activity 1.2 版本

1.2.2 版本

2022 年 12 月 7 日

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

修正錯誤

• 現在可以在執行階段設定動作事件數量上限。

1.2.2-alpha01 版本

2022 年 11 月 9 日

發布了 androidx.games:games-activity:1.2.2-alpha01。1.2.2-alpha01 版包含這些修訂項目。

API 變更

• API 現在也包含 GAMEACTIVITY_PACKED_VERSION 形式的版本資訊。(I287e6)
• 新增了 onContentRectChanged 回呼。當視窗 (其中應放入內容) 中的矩形已變更時，便會呼叫此回呼。(I81396)

修正錯誤

• 修正事件緩衝區溢位。inputBuffer->keyEvents 和 motionEvents 現已都是動態分配緩衝區。(Ic00f6)
• 如果記憶體不足，則會正常失敗。新增在緩衝區大小調整時的 realloc() 錯誤處理作業。

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 2.0

2.0.0 版

2024 年 8 月 7 日

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

2.0.0 的主要功能

• 自 2.0.0-beta01 以來沒有重大變更，我們只是將這個版本標示為穩定版。

2.0.0-beta01 版

2024 年 1 月 10 日

發布 androidx.games:games-performance-tuner:2.0.0-beta01，該版本與上一個 Alpha 版沒有差別。2.0.0-beta01 版包含此連結所列的修訂項目。

2.0.0-alpha07 版

2023 年 11 月 29 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha07。查看 2.0.0-alpha07 版的修訂項目。

修正錯誤

• 修正記憶體遙測回報有時會回報錯誤值的問題

2.0.0-alpha06 版

2023 年 11 月 1 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha06。2.0.0-alpha06 版包含此連結所列的修訂項目。

2.0.0-alpha05 版

2023 年 8 月 23 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha05。2.0.0-alpha05 版包含此連結所列的修訂項目。

新功能

• 已將 Protobuf 程式庫遷移至 Protobuf lite。

修正錯誤

• 修正懸掛指標的問題。

2.0.0-alpha04 版

2023 年 4 月 19 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha04。查看 2.0.0-alpha04 版的修訂項目。

新功能

• 更新程式庫中的遙測集合功能，以便提供更精細的影格轉譯時間報表。

修正錯誤

• 修正當檢測金鑰數量上限大於直方圖數量時，程式庫會停止運作的問題。

2.0.0-alpha03 版

2023 年 2 月 22 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha03。2.0.0-alpha03 版包含以下修訂項目。

修正錯誤

• Games-Performance-Tuner 已移至新的發布程序。行為應不會有任何變化。

2.0.0-alpha02 版

2023 年 2 月 8 日

發布 androidx.games:games-performance-tuner:2.0.0-alpha02。2.0.0-alpha02 版包含以下修訂項目。

API 變更

• 新增 TuningFork_predictQualityLevels API，這有助於預測要使用的正確品質等級/擬真度參數。

Games Performance Tuner 1.6

1.6.1-alpha01 版

2022 年 11 月 9 日

發布了 androidx.games:games-performance-tuner:1.6.1-alpha01。1.6.1-alpha01 版包含這些修訂項目。

新功能

• 沒有更新內容

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 2.2 版

2.2.0-alpha01 版

2025 年 3 月 26 日

發布 androidx.games:games-controller:2.2.0-alpha01、androidx.games:games-memory-advice:2.2.0-alpha01 和 androidx.games:games-performance-tuner:2.2.0-alpha01。2.2.0-alpha01 版包含這些修訂版本。

新功能

• 升級至 Gradle 8.8.1 (1ed0153)
• 升級至 Java 17 (1ed0153)
• 將 targetSdk 變更為 35 (eddf605)

Games-Controller 2.0 版

2.0.2 版

2024 年 6 月 12 日

發布 androidx.games:games-controller:2.0.2。2.0.2 版包含這些修訂項目。

修正錯誤

• 修正問題：對於在 Paddleboat_init 之前已連線的控制器，控制器連線回呼不會觸發。
• 修正問題：在 Paddleboat_processGameActivityMotionInputEvent 中，如果未手動啟用壓力軸，遊戲控制器的觸控板就不會記錄觸控板的按壓動作。
• 修正遊戲控制器觸控板事件未標示為由 Paddleboat_processGameActivityMotionInputEvent 消耗的問題。

2.0.1 版

2023 年 9 月 20 日

已釋出 `androidx.games:games-controller:2.0.1 2.0.1 版包含此連結所列的修訂項目。

遊戲控制器錯誤修正：

• 修正 onInputDeviceChanged 處理常式中罕見的 NullReferenceException 狀況。
• 修正問題，避免某些 USB 鍵盤誤登記為遊戲控制器。

2.0.0 版

2023 年 3 月 8 日

發布 androidx.games:games-controller:2.0.0。2.0.0 版包含此連結所列的修訂項目。

2.0.0 的主要功能

• 新增可偵測硬體鍵盤連線狀態的功能。
• 新增從主要裝置 (例如手機) 和控制器回報動作資料 (加速計/陀螺儀) 的功能。
• 變更控制器定義資料庫的 API 和格式，藉此減少記憶體用量，並支援其他功能。

2.0.0-alpha01 版

2023 年 1 月 11 日

發布 androidx.games:games-controller:2.0.0-alpha01。2.0.0-alpha01 版本包含這些修訂項目。

新功能

• 硬體鍵盤偵測
• 推出整合式感應器動作資料回報功能 (也就是從手機本身接收陀螺儀和加速計資料)
• 新增最佳化控制器對應資料格式

API 變更

• 針對硬體鍵盤新增 API 呼叫：Paddleboat_getPhysicalKeyboardStatus 和 Paddleboat_setPhysicalKeyboardStatusCallback
• 針對整合式感應器動作資料回報功能新增 API 呼叫：Paddleboat_getIntegratedMotionSensorFlags 和 Paddleboat_setMotionDataCallbackWithIntegratedFlags
• 針對修訂的控制器對應資料格式新增 API 呼叫：Paddleboat_addControllerRemapDataFromFd、Paddleboat_addControllerRemapDataFromFileBuffer
• 淘汰舊版對應 API 呼叫：Paddleboat_addControllerRemapData 和 Paddleboat_getControllerRemapTableData

修正錯誤

• 修正 GameActivity 1.2.2 以上版本中動作事件的相容性問題

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 2.1

2.1.0-alpha01 版本

2023 年 7 月 26 日

發布 androidx.games:games-text-input:2.1.0-alpha01。2.1.0-alpha01 版本包含這些修訂版本。

新功能

• 新增多行和單行模式支援

API 變更

• 新增 isSoftwareKeyboardVisible 函式
• 為 GameActivity_setImeEditorInfo 新增位元組定義
• 新增 onEditorAction 回呼

修正錯誤

• 修正硬體和軟體鍵盤不同步的問題
• 在隱藏螢幕鍵盤時清除焦點

Games-Text-Input 2.0

2.0.0 版

2023 年 3 月 8 日

發布 androidx.games:games-text-input:2.0.0。2.0.0 版包含此連結所列的修訂項目。

自 1.1.1 版以來的重要變更

• 主要版本更新是因為建構系統有所變更，但程式庫/API 本身並未更新。

Games-Text-Input 1.1 版本

1.1.2-alpha01 版

2022 年 11 月 9 日

發布了 androidx.games:games-text-input:1.1.2-alpha01。1.1.2-alpha01 版包含這些修訂項目。

新功能

• 沒有更新內容

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 2.3 版

2.3.0-alpha01 版本

2025 年 3 月 26 日

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

新功能

• 升級至 Gradle 8.8.1 (1ed0153)
• 升級至 Java 17 (1ed0153)
• 將 targetSdk 變更為 35 (eddf605)

修正錯誤

• 修正多項錯誤 (修正項目清單)

Games Frame Pacing 2.1 版

2.1.2 版

2024 年 7 月 24 日

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

修正錯誤

• Swappy 現在會使用 API 33 中的 AChoreographer_postVsyncCallback，更準確地計算呈現時間。這項修正可解決 120 Hz 裝置的影格遺漏問題。

2.1.1 版

2024 年 7 月 10 日

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

修正錯誤

• 請從 Swappy 中正確取消註冊顯示器監聽器，以免發生當機情形。
• 修正使用已毀損的互斥鎖時，在 ChoreographerFilter::onSettingsChanged 中發生的當機問題。

2.1.0 版

2023 年 11 月 15 日

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

2.1.0-rc01 版

2023 年 9 月 20 日

發布 androidx.games:games-frame-pacing:2.1.0-rc01。2.1.0-rc01 版包含以下修訂項目。

2.1.0-beta01 版

2023 年 5 月 24 日

發布 androidx.games:games-frame-pacing:2.1.0-beta01。2.1.0-beta01 版包含此連結所列的修訂項目。

修正錯誤

• 在 NDKChoreographer 初始化失敗時逾時 (ef466d)
• 使用 SwappyGL_getSupportedRefreshPeriodsNS 時，明確從系統查詢更新率 (c85235)

2.1.0-alpha01 版本

2023 年 4 月 5 日

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

新功能

• 新的 API，可重設影格間距狀態。
• 新的 API，可在停用 Swappy 的幀率影響效果的同時，仍觀察 CPU 和 GPU 的時間。

API 變更

• SwappyGL_resetFramePacing/SwappyVk_resetFramePacing 現在可用於重設內部影格間隔狀態。幀率調整現在只會考量從呼叫重設 API 的時間點開始的資料。
• SwappyGL_enableFramePacing/SwappyVk_enableFramePacing 現在可用於啟用/停用 Swappy 的幀率調整。停用後，
• SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait 可用於控制在停用影格間隔時，是否會對最後影格的 GPU 工作進行阻斷等待。

修正錯誤

• 使用 Swappy GL API 時，GPU 繫結案例的效能會有所改善。

Games Frame Pacing 2.0 版

2.0.0 版

2023 年 3 月 8 日

發布 androidx.games:games-frame-pacing:2.0.0。2.0.0 版包含此連結所列的修訂項目。

自 1.10.1 版以來的重要異動

• 建構系統經歷重大變更，因此每個 SDK/NDK 版本只會產生一個程式庫，而非多個。
• 新增 Vulkan 框架統計資料。
• 新增用於清除影格統計資料的新 API。
• 所有記錄皆不會在發布模式下傳送資料，但可在偵錯模式下啟用。

2.0.0-rc01 版

2023 年 2 月 22 日

發布 androidx.games:games-frame-pacing:2.0.0-rc01。2.0.0-rc01 版包含以下修訂項目。

新功能

• 記錄功能現在已隱藏在編譯標記後方。根據預設，程式庫的發布版本不會記錄任何資料，而程式庫的偵錯版本會啟用所有記錄功能。

2.0.0-beta01 版

2023 年 2 月 8 日

發布 androidx.games:games-frame-pacing:2.0.0-beta01。2.0.0-beta01 版包含此連結所列的修訂項目。

新功能

• 推出新的 API 以清除影格統計資料。

API 變更

• 新增 SwappyGL_clearStats 和 SwappyGL_clearStats API。

2.0.0-alpha01 版

2023 年 1 月 11 日

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

新功能

• 新增 Vulkan 影格統計資料

API 變更

• 因建構檔案重構而增加主要版本
• 新增 3 個 API：SwappyVk_enableStats、SwappyVk_recordFrameStart 和 SwappyVk_getStats

修正錯誤

• 僅針對自動交換模式套用門檻 (Ic0786)

Games Frame Pacing 1.10

1.10.2-alpha01 版

2022 年 11 月 9 日

發布了 androidx.games:games-frame-pacing:1.10.2-alpha01。1.10.2-alpha01 版本包含這些修訂項目。

新功能

• 沒有更新內容

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

2.0.0-rc01 版

2024 年 7 月 24 日

發布 androidx.games:games-performance-tuner:2.0.0-rc01。2.0.0-rc01 版包含這些修訂項目。

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。