本頁面概述了 Android Game Development Kit (AGDK) 程式庫各版本的變更。在第 1.2.4 版之前,該程式庫稱為 Android Games SDK。
2023.3.0.0 (2023 年 6 月 2 日)
這個版本包含幾項錯誤修正。
修正項目 | 修正 GameActivityEvent 的穩定性問題。 |
功能 | 更新驅動程式庫的機器學習模型,較新款手機可因此取得更理想結果。 |
修正項目 | 錯誤內容:當程式庫檢測金鑰數量上限大於直方圖數量,程式庫會停止運作。 |
功能 | 更新程式庫中的遙測集合功能,以便提供更精細的影格轉譯時間報表。 |
2023.2.0.0 (2023 年 4 月 27 日)
這個版本包含幾項錯誤修正。
修正項目 | historicalEventTimes 記憶體較早釋放問題。 |
修正項目 | 32 位元系統 historicalEventTimesNanos 的溢位問題。 |
修正項目 | 無法正確連結靜態版本的程式庫。 |
修正項目 | 程式庫無法正確載入必要的 TensorFlow Lite 資產。 |
2023.1.0.0 (2023 年 3 月 15 日)
這個主要版本包含建構系統更新,可加快從來源建構程式庫的速度。
變更項目 | 過往事件時間介面經過調整,現已能克服 32 位元限制。 |
功能 | 為使用者提供設定變更項目存取權。 |
功能 | 在觸控事件處理作業中,清除大部分 JNI 呼叫並進行最佳化。 |
修正項目 | 修正觸控事件的預設 OS 處理作業,例如處理系統按鈕。 |
功能 | 新增可偵測硬體鍵盤連線狀態的功能。 |
功能 | 新增從主要裝置 (例如手機) 和控制器回報動作資料 (加速計/陀螺儀) 的功能。 |
變更項目 | 變更控制器定義資料庫的 API 和格式,藉此減少記憶體用量,並支援其他功能。 |
功能 | 新增 Vulkan 框架統計資料。 |
功能 | 新增用於清除影格統計資料的新 API。 |
變更項目 | 所有記錄皆不會在發布模式下傳送資料,但可在偵錯模式下啟用。 |
2022.0.0 (2022 年 3 月 15 日)
這個主要版本包含 Memory Advice 程式庫和其他程式庫的數個修正程式。
功能 | 新增可在輸入法編輯器和凹口周圍放置遊戲 UI 的插邊處理功能。 |
功能 | 新增金鑰和動作事件篩選器 |
修正項目 | 調整程式以避免輸入事件損失,並防止消耗所有輸入事件 |
變更項目 | 記憶體報告現在顯示為時間序列,而非直方圖 |
功能 | 允許以程式輔助的方式設定上傳間隔 |
修正項目 | 修正毀損的 API 金鑰錯誤 |
功能 | 改善自動模式 |
功能 | 新增「uninjectTracer」函式。 |
Android Memory Advice 程式庫
功能 | 新增 Memory Advice 程式庫 |
2021.1.0 (2021 年 7 月 12 日)
這款產品先前稱為 Android Game SDK,現在改稱為 Android Game Development Kit。這個主要版本包含數個新的程式庫,並修正了 Android Frame Pacing 和 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 功能而定。 |
功能 | 程式庫的靜態和動態連結。 |
功能 | 支援採用多種刷新率的裝置。 |