版本資訊

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

2023.3.0.0 (2023 年 6 月 2 日)

這個版本包含幾項錯誤修正。

GameActivity

修正項目 提升 GameActivityEvent 的穩定性。

Android Memory Advice 程式庫

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

Android Performance Tuner

修正項目 錯誤內容:當程式庫檢測金鑰數量上限大於直方圖數量,程式庫會停止運作。
功能 更新程式庫中的遙測集合功能,以便提供更精細的影格轉譯時間報表。

2023.2.0.0 (2023 年 4 月 27 日)

這個版本包含幾項錯誤修正。

GameActivity

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

Android Memory Advice 程式庫

修正項目 無法正確連結靜態版本的程式庫。
修正項目 程式庫無法正確載入必要的 TensorFlow Lite 資產。

2023.1.0.0 (2023 年 3 月 15 日)

這個主要版本包含建構系統更新,可加快從來源建構程式庫的速度。

GameActivity

變更項目 過往事件時間介面經過調整,現已能克服 32 位元限制。
功能 為使用者提供設定變更項目存取權。
功能 在觸控事件處理作業中,清除大部分 JNI 呼叫並進行最佳化。
修正項目 修正觸控事件的預設 OS 處理作業,例如處理系統按鈕。

GameController

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

Android Frame Pacing 程式庫

功能 新增 Vulkan 框架統計資料。
功能 新增用於清除影格統計資料的新 API。
變更項目 所有記錄皆不會在發布模式下傳送資料,但可在偵錯模式下啟用。

2022.0.0 (2022 年 3 月 15 日)

這個主要版本包含 Memory Advice 程式庫和其他程式庫的數個修正程式。

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 Pacing 和 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 功能而定。
功能 程式庫的靜態和動態連結。
功能 支援採用多種刷新率的裝置。