版本資訊

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

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