本頁面概述了 Android Game Development Kit (AGDK) 程式庫各版本的變更。在第 1.2.4 版之前,該程式庫稱為 Android Games SDK。
2022.0.0 (2022 年 3 月 15 日)
這個主要版本包含記憶體建議程式庫和其他程式庫的數個修正程式。
功能 | 新增用來在輸入法編輯器和裁剪圖案周圍放置遊戲 UI 的插邊處理功能。 |
功能 | 新增金鑰和動作事件篩選器 |
已修正 | 修正程式可避免輸入事件損失,並避免消耗所有輸入事件 |
已變更 | 記憶體報告現在顯示為時間序列,而非直方圖 |
功能 | 允許以程式輔助的方式設定上傳間隔 |
已修正 | 已修正毀損的 API 金鑰錯誤 |
功能 | 改善自動模式 |
功能 | 新增「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 的錯誤修正版本。
已修正 | 修正裝置出現 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 程式庫沒有任何變更。
功能 | 載入事件現在必須透過呼叫 TuningFork_startLoadingGroup 和 TuningFork_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:OpenGL、Android Frame Pacing:Vulkan 以及 Android Performance Tuner 的版本設定。
功能 | 玩家在載入過程中加入遊戲背景時,系統會傳送事件以便稍後對放棄載入情況進行分析。 |
1.2.0 (2020 年 10 月 29 日)
這個版本的主要變更是新增記錄載入時間的機制,同時也修正了一些錯誤。請注意,Game SDK 現已透過 AGDK 程式庫 Jetpack 程式庫提供。
功能 | 支援自動模式刷新率切換功能。 請注意,如要在 Android 11 中支援多種刷新率,無論是否使用自動模式,都應呼叫 SwappyGL_setWindow 或 SwappyVk_setWindow 。 |
已修正 | 修正自動模式錯誤。 |
已修正 | 修正 Vulkan 錯誤。 |
功能 | 載入時間。 應呼叫新的函式 TuningFork_startRecordingLoadingTime 和 TuningFork_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 程式庫整合,以自動記錄影格時間和其他轉譯指標。 |
功能 | 影格時間資訊會記錄在直方圖中,並定期上傳。 |
功能 | 包含時間資料與目前遊戲狀態的註解。 |
功能 | 裝置特徵、註解和品質設定會與時間資料一起上傳,以便進行跨區段分析。 |
功能 | 對表示載入時間等級的註解進行特殊處理。載入期間,系統不會記錄影格滴答資料,但會記錄每個載入週期的時間長度。 |
功能 | 能夠記錄自訂時間資訊 (使用 startTrace 和 endTrace )。 |
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 功能而定。 |
功能 | 程式庫的靜態和動態連結。 |
功能 | 支援採用多種重新整理頻率的裝置。 |