版本資訊

本頁面概述了 Android Game Development Kit (AGDK) 程式庫各版本的變更。在第 1.2.4 版之前,該程式庫稱為 Android Games SDK。

2022.0.0 (2022 年 3 月 15 日)

這個主要版本包含記憶體建議程式庫和其他程式庫的數個修正程式。

GameActivity

功能 新增用來在輸入法編輯器和裁剪圖案周圍放置遊戲 UI 的插邊處理功能。
功能 新增金鑰和動作事件篩選器
已修正 修正程式可避免輸入事件損失,並避免消耗所有輸入事件

Android Performance Tuner

已變更 記憶體報告現在顯示為時間序列而非直方圖
功能 允許透過程式輔助設定上傳間隔
已修正 已修正毀損的 API 金鑰錯誤

Android Frame Pacing 程式庫

功能 改善自動模式
功能 新增「uninjectTracer」函式。

Android Memory Advice 程式庫

功能 新增 Memory Advice 程式庫

2021.1.0 (2021 年 7 月 12 日)

我們以前將這款產品稱為 Android Game SDK,現在稱為 Android Game Development Kit。這個主要版本包含數個新的程式庫,並且修正了 Android Frame Paping 和 Android Performance Tuner 程式庫中的小錯誤。

功能 GameActivity 是一種新的元件,用來取代並改善 NDK 的 NativeActivity。
功能 GameTextInput 是一種新的元件,可改善與 Android 螢幕鍵盤的互動。
功能 GameController 是一種新的元件,可讓使用者輕鬆管理外部控制器並與之互動。

1.2.4 (2021 年 4 月 21 日)

這個版本為 Android Performance Tuner 的錯誤修正版本。

Android Performance Tuner

已修正 修正裝置出現 CLOCK_BOOTTIME 不一致時的載入時間和時間長度記錄問題。

1.2.3 (2021 年 3 月 10 日)

這個版本會將 Oboe 新增至 Game SDK。Android Frame Pacing 程式庫和 Android Performance Tuner 沒有任何變更。

Oboe 是開放原始碼的 C++ 程式庫,可在 Android 上提供高效能的音訊。Oboe 提供單一原生 API,適用於 Android 4.1 (API 級別 16) 以上版本。

1.2.2 (2021 年 2 月 12 日)

這個版本改善了 Android Performance Tuner 的載入時間 API 並修正了一些錯誤。Android Frame Pacing 程式庫沒有任何變更。

Android Performance Tuner

功能 載入事件現在必須透過呼叫 TuningFork_startLoadingGroupTuningFork_stopLoadingGroup 進行分組。
已修正 呼叫 TuningFork_flush 會立即上傳資料,而不會排入佇列供稍後上傳。
已修正 由於 JSON 時間格式造成間歇性上傳失敗。
已修正 發布版本的上傳問題。

1.2.1 (2020 年 12 月 16 日)

這個版本為 Android Performance Tuner 的內部功能版本,是 Jetpack 程式庫從 Alpha 測試版升級至 Beta 版的階段。Android Frame Pacing 或 Android Performance Tuner API 沒有任何變更。

請注意,現在連結 Game SDK 程式庫時,必須進行單獨引用,而不是連結至通用的「gamesdk」程式庫。請參閱 Android Frame Pacing:OpenGLAndroid Frame Pacing:Vulkan 以及 Android Performance Tuner 的版本設定。

Android Performance Tuner

功能 玩家在載入過程中加入遊戲背景時,系統會傳送事件以便稍後對放棄載入情況進行分析。

1.2.0 (2020 年 10 月 29 日)

這個版本的主要變更是新增記錄載入時間的機制,同時也修正了一些錯誤。請注意,Game SDK 現已透過 AGDK 程式庫 Jetpack 程式庫提供。

Android Frame Pacing 程式庫

功能 支援自動模式重新整理頻率切換功能。
請注意,如要在 Android 11 中支援多種重新整理頻率,無論是否要使用自動模式,都應呼叫 SwappyGL_setWindowSwappyVk_setWindow
已修正 修正自動模式錯誤。
已修正 修正 Vulkan 錯誤。

Android Performance Tuner

功能 載入時間。
應呼叫新的函式 TuningFork_startRecordingLoadingTimeTuningFork_stopRecordingLoadingTime 以記錄加註的載入時間事件。系統會自動記錄從應用程式啟動到 TuningFork_init 的時間,以及第一個滴答。
已變更 先前設定載入時間註解的方法將會失效。
功能 生命週期事件。
應在呼叫適當的 Java onCreate 等事件後呼叫 TuningFork_reportLifecycleEvent,以便透過 Android Performance Tuner 提供詳細的當機回報功能。
已變更 現在系統會在呼叫 TuningFork_enableMemoryRecording(true) 時記錄更多記憶體指標。
已變更 記憶體模型變更。
現在,每種類型的指標數量上限都是在啟動時指定,而非分配所有可能註解組合的空間。請參閱 tuningfork.h 中的 TuningFork_MetricLimits
已修正 未透過計量付費連線上傳。

1.1.0 (2020 年 6 月 10 日)

這個版本的 AGDK 程式庫提供 Android Performance Tuner 指標回報功能與品質調整程式庫 (又稱為 Tuning Fork)。這個程式庫適用於原生遊戲引擎和 Unity,並具備下列功能:

功能 Android Frame Pacing 程式庫整合,以自動記錄影格時間和其他轉譯指標。
功能 影格時間資訊會記錄在直方圖中,並定期上傳。
功能 包含時間資料與目前遊戲狀態的註解。
功能 裝置特徵、註解和品質設定會與時間資料一起上傳,以便進行跨區段分析。
功能 對表示載入時間等級的註解進行特殊處理。載入期間,系統不會記錄影格滴答資料,但會記錄每個載入週期的時間長度。
功能 能夠記錄自訂時間資訊 (使用 startTraceendTrace)。

1.0.2 (2020 年 3 月 30 日)

這個版本已修正多個錯誤,並進行多個自動模式行為變更。

已修正 已修正針對 swappy 刪除和重新初始化的錯誤。
已變更 根據預設,管道目前為「開啟」狀態。如果自動管道開啟,即使工作負載量偏低,Swappy 仍可決定將其關閉。
已變更 啟用自動模式後,Swappy 將僅在 2 秒期限內 15% 的影格比預期快或慢後才決定切換交換間隔。請注意,Swappy 的交換速度絕不能低於使用者指定的交換間隔。

1.0.1 (2020 年 2 月 19 日)

這個版本主要為錯誤修正版本。

已修正 在 Vulkan 中的 SwappyFallback 程式碼路徑上,清理結束時的資源。
已修正 如果有多個交換鏈,SwappyVk_destroySwapchain 將不再刪除裝置資源。
已修正 Swappy 版本現在可以透過 logcat 進行列印。
已修正 Swappy_destroy 中 API 24 以下級別的當機和死結問題。
功能 支援自訂執行緒管理員 (Swappy_setThreadFunctions)。
功能 支援掛鉤 Vulkan 函式 (SwappyVk_setFunctionProvider)。

1.0.0 (2019 年 12 月 5 日)

這個 AGDK 程式庫的初始版本具有 Android Frame Pacing 程式庫

功能 顯示緩衝區同步處理作業。
功能 自動重新整理頻率模式和管道支援。
功能 影格轉譯統計資料的集合。
功能 在執行階段合理選取行為,視 Swappy 需要的 Android、OpenGL 和 Vulkan 功能而定。
功能 程式庫的靜態和動態連結。
功能 支援採用多種重新整理頻率的裝置。