Android 遊戲
這個資料表會列出 androidx.games
群組中的所有成果。
構件 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
games-activity | 1.2.1 | - | - | - |
games-controller | 1.1.0 | - | - | - |
遊戲畫面速度 | 1.9.1 | - | - | - |
games-memory-advice | - | - | 1.0.0-beta01 | - |
Games-text-input | 1.1.1 | - | - | - |
games-performance-tuner | 1.6.0 | - | - | - |
要求
games-memory-advice
如要使用 MemoryAdvice API,您必須使用下列任一 NDK 版本建構應用程式:
- r20.*
- r21.*
- r23.*
宣告依附元件
如要新增遊戲依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
針對您需要的模組或應用程式的 build.gradle
檔案,為所需的構件新增依附元件;games-activity
程式庫整合了相同版本的 game-text-input
程式庫,因此 GameActivity
應用程式無法再次納入 game-text-input
依附元件:
Groovy
android { ... // To use the Android Frame Pacing or Android Performance Tuner libraries, enable // native dependencies to be imported. Libraries will be made available to your CMake build // as packages named "games-frame-pacing" and "games-performance-tuner". buildFeatures { prefab true } } dependencies { // To use the Android Frame Pacing library implementation "androidx.games:games-frame-pacing:1.9.1" // To use the Android Performance Tuner implementation "androidx.games:games-performance-tuner:1.6.0" // To use the Games Activity library implementation "androidx.games:games-activity:1.2.1" // To use the Games Controller Library implementation "androidx.games:games-controller:1.1.0" // To use the Games Text Input Library // Do not include this if games-activity has been included implementation "androidx.games:games-text-input:1.1.1" }
Kotlin
android { ... // To use the Android Frame Pacing or Android Performance Tuner libraries, enable // native dependencies to be imported. Libraries will be made available to your CMake build // as packages named "games-frame-pacing" and "games-performance-tuner". buildFeatures { prefab = true } } dependencies { // To use the Android Frame Pacing library implementation("androidx.games:games-frame-pacing:1.9.1") // To use the Android Performance Tuner implementation("androidx.games:games-performance-tuner:1.6.0") // To use the Games Activity library implementation("androidx.games:games-activity:1.2.1") // To use the Games Controller Library implementation("androidx.games:games-controller:1.1.0") // To use the Games Text Input Library // Do not include this if games-activity has been included implementation("androidx.games:games-text-input:1.1.1") } }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
新增 Gradle 屬性
您可能需要新增屬性到位於應用程式 (或模組) build.gradle
檔案所在的目錄中 gradle.properties
檔案。如果 gradle.properties
檔案不存在,請建立這個檔案。
如果您使用 Android Studio 4.0,請確認 gradle.properties
包含以下:
# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true
如果您使用 Android Studio 4.1 以上版本,請確認 gradle.properties
包含以下:
# Tell Android Studio we are using AndroidX
android.useAndroidX=true
使用 CMake 新增套件
如要提供匯入的遊戲遊戲套件,請將以下內容新增至主應用程式的 CMakeLists.txt
檔案:
# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)
因此您可以在遊戲程式碼中加入 Android Game SDK 的標題檔案:
#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"
在主要應用程式的 CMakeLists.txt
檔案中,找到主要共用資料庫的 target_link_libraries
。將參考資料新增至 Android Game SDK 靜態程式庫,將其加入共用資料庫中:
target_link_libraries(...
games-frame-pacing::swappy_static
games-performance-tuner::tuningfork_static
...)
意見回饋
您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 文件。
Games-Memory-Advice 1.0.0 版本
1.0.0-beta01 版本
2022 年 3 月 9 日
已釋出androidx.games:games-memory-advice:1.0.0-beta01
。1.0.0-beta01 版本包含這些修訂版本。
- 自 1.0.0-alpha01 起沒有變更。
1.0.0-alpha01 版本
2022 年 2 月 23 日
已釋出androidx.games:games-memory-advice:1.0.0-alpha01
。1.0.0-alpha01 版本包含以下修訂項目。
新功能
- 這個 C 程式庫可讓使用者針對執行遊戲的裝置,查詢記憶體記憶體狀態的變化並接收回呼。
API 異動
- 這是記憶體建議資料庫的初始版本。如需完整 API 的相關標題,請參閱 Include/Memory_advice/Memory_advice.h 的標題。
外部貢獻
- 這個程式庫取決於 tensorflow,您可以前往 https://github.com/tensorflow/tensorflow 取得授權和授權依附元件。
Games-Activity 1.2 版本
1.2.1 版本
2022 年 7 月 13 日
發布 androidx.games:games-activity:1.2.1
。1.2.1 版本包含以下修訂項目。
修正錯誤
- 修正先前版本缺少 .aar 檔案的問題。
1.2.0 版本
2022 年 6 月 15 日
發布 androidx.games:games-activity:1.2.0
。1.2.0 版本包含這些修訂版本。
自 1.1.0 版以來的重要異動
- 允許 GameActivity 衍生類別處理原生資料庫的載入程序。
- 請一律在 GameActivity.onCreate 內載入原生資料庫。
- 如果系統找不到其他程式庫,備用方式是載入名稱內具有「main」的程式庫。
Games-Activity 1.1 版本
1.1.0 版本
2022 年 2 月 23 日
androidx.games:games-activity:1.1.0
和 androidx.games:games-controller:1.1.0
發布。1.1.0 版本包含以下修訂項目。
自 1.0.0 版以來的重要異動
Games Activity:
- WindowInsets 監聽及查詢問題回報和 IME 回應
- 新增金鑰和動作事件篩選器
- 修正問題:
- 新增缺少與 NativeActivity 相容的訊息
- 修正 onNativeWindowSized 中的簽章
- 修正輸入事件損失
1.1.0-rc01 版本
2022 年 2 月 9 日
已釋出「androidx.games:games-activity:1.1.0-rc01
」和「androidx.games:games-controller:1.1.0-rc01
」。1.1.0-rc01 版本包含以下修訂項目。
1.1.0-beta03 版本
2022 年 1 月 26 日
已釋出androidx.games:games-activity:1.1.0-beta03
。1.1.0-beta03 版本包含這些修訂版本。
修正錯誤
onNativeWindowResized
的固定簽名- 繼續處理
onSurfaceChanged
中的原生視窗
1.1.0-beta02 版本
2021 年 12 月 15 日
已釋出androidx.games:games-activity:1.1.0-beta02
。1.1.0-beta02 版本包含以下修訂項目。
修正錯誤
- 修正事件篩選器設定中的競爭狀況。
1.1.0-beta01 版本
2021 年 11 月 17 日
已釋出androidx.games:games-activity:1.1.0-beta01
。1.1.0-beta01 版本包含這些修訂版本。
新功能
- 新增支援功能,可查詢回溯期內及監聽插入變更。如此一來,遊戲就能回應 IME 彈出式視窗,並處理刊登序列和相機切割畫面。
API 異動
void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);
修正錯誤
- 請避免使用所有重要事件:音量、相機等事件現在都已透過系統。
1.1.0-alpha01 版本
2021 年 9 月 29 日
已釋出androidx.games:games-activity:1.1.0-alpha01
。1.1.0-alpha01 版本包含以下修訂項目。
API 異動
- 已將
onContentRectChanged
回呼新增至GameActivityCallbacks
修正錯誤
- 加入 android_native_app_glue.h 的訊息遺失:
APP_CMD_CONTENT_RECT_CHANGED
APP_CMD_WINDOW_REDRAW_NEEDED
Games Performance Tuner 1.6
1.6.0 版本
2022 年 6 月 15 日
發布 androidx.games:games-performance-tuner:1.6.0
。1.6.0 版本含有這些修訂版本。
自 1.5.0 版本之後的重要異動
- 修正在嘗試取得記憶體遙測時,getpid 會回傳 0 的問題。
- 當無載入群組在活動時,會阻止系統執行 StopLoadingGroup。
Games Performance Tuner 1.5.0
1.5.0 版本
2022 年 2 月 9 日
發布 androidx.games:games-performance-tuner:1.5.0
。1.5.0 版隨附這些修訂版本。
1.4.0 版之後的重要異動
- 以程式輔助方式變更上傳之間的間隔時間,而不是在初始設定中採用硬式編碼。
- 已新增函式:
TuningFork_setAggregationStrategyInterval
- 已新增函式:
- 修正
API<=23
上 API 金鑰損毀的記憶體問題
1.5.0-rc01 版本
2022 年 1 月 26 日
已釋出androidx.games:games-performance-tuner:1.5.0-rc01
。1.5.0-rc01 版包含這些修訂版本。
修正錯誤
- 修正 API 金鑰中 API 金鑰損毀的記憶體<=23
1.5.0-beta02 版本
2021 年 12 月 15 日
已釋出androidx.games:games-performance-tuner:1.5.0-beta02
。1.5.0-beta02 版本包含這些修訂版本。
API 異動
- 移除
TuningFork_Settings
的 ABI 中斷設定變更。
1.5.0-beta01 版本
2021 年 9 月 29 日
已釋出androidx.games:games-performance-tuner:1.5.0-beta01
。1.5.0-beta01 版本包含這些修訂版本。
新功能
- Alpha 版沒有任何變更。該版本包含:
- 以程式輔助的方式變更上傳的間隔時間,而不是在初始設定中採用硬式編碼的方式。
API 異動
- Alpha 版沒有任何變更。該版本包含:
- 新功能:
TuningFork_setAggregationStrategyInterval
TuningFork_Settings: aggregation_strategy_intervalms_or_count
中的新欄位
- 新功能:
1.5.0-alpha01 版本
2021 年 8 月 18 日
已釋出androidx.games:games-performance-tuner:1.5.0-alpha01
。1.5.0-alpha01 版本包含這些修訂版本。
新功能
- 您現在可以透過程式輔助 (而非設定檔案) 設定 APT 上傳作業的間隔時間。
API 異動
- 已新增函式:
TuningFork_setAggregationStrategyInterval
- 已將欄位新增至 TuningFork_Settings struct:
aggregation_strategy_intervalms_or_count
Games-Activity 1.0.0 版本
1.0.0 版本
2021 年 8 月 4 日
已釋出 androidx.games:games-activity:1.0.0
、androidx.games:games-controller:1.0.0
和 androidx.games:games-text-input:1.0.0
。1.0.0 版本包含以下修訂項目。
1.0.0 的主要功能
這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。
1.0.0-rc01 版本
2021 年 7 月 12 日
已釋出androidx.games:games-activity:1.0.0-rc01
。1.0.0-rc01 版本包含這些修訂版本。
修正錯誤
GameActivityCallbacks::onSaveInstanceState
的修正返回類型
1.0.0-beta01 版本
2021 年 6 月 30 日
已釋出androidx.games:games-activity:1.0.0-beta01
。1.0.0-beta01 版本包含這些修訂版本。
API 異動
- 將
GameActivityInputInfo
重新命名為GameActivityPointerAxes
。 onNativeWindowResized
回呼現可提供視窗的寬度和高度。- 已移除
onContentRectChanged
回呼。 onLowMemory
已重新命名為onTrimMemory
。- 已移除
GameActivity_setWindowFormat
。 - 改善
GameActivityMotionEvents
和GameActivityMotionEvent
指標的擁有權模型。 - 改善
onSaveInstanceState
回呼的使用者狀態擁有權模型。
1.0.0-alpha01 版本
2021 年 6 月 16 日
已釋出androidx.games:games-activity:1.0.0-alpha01
。
新功能
- Games-Activity 是將 NativeActivity 取代為 Android 與 C/C++ 遊戲的推薦方法。
Games-Controller 1.1.0 版本
1.1.0 版本
2022 年 2 月 23 日
androidx.games:games-activity:1.1.0
和 androidx.games:games-controller:1.1.0
發布。1.1.0 版本包含以下修訂項目。
自 1.0.0 版以來的重要異動
Games Activity:
- WindowInsets 監聽及查詢問題回報和 IME 回應
- 新增金鑰和動作事件篩選器
- 修正問題:
- 新增缺少與 NativeActivity 相容的訊息
- 修正 onNativeWindowSized 中的簽章
- 修正輸入事件損失
1.1.0-rc01 版本
2022 年 2 月 9 日
發布 androidx.games:games-controller:1.1.0-rc01
。1.1.0-rc01 版本包含以下修訂項目。
1.1.0-beta01 版本
2022 年 1 月 26 日
androidx.games:games-controller:1.1.0-beta01
自 1.1.0-alpha01
起沒有變更。1.1.0-beta01 版本包含這些修訂版本。
1.1.0-alpha01 版本
2021 年 12 月 15 日
發布 androidx.games:games-controller:1.1.0-alpha01
。1.1.0-alpha01 版本包含以下修訂項目。
新功能
現在在 Android S 以上版本執行時,可在支援的控制器上提供電池狀態、雙馬達震動、燈光控制和動態軸回報功能。
API 異動
- 新增
Paddleboat_setMotionDataCallback
函式,用於註冊控制器動態資料回呼 - 已新增
Paddleboat_setControllerLight
函式,可用於變更控制器燈設定。 - 將
Paddleboat_Controller_Battery
結構新增至Paddleboat_Controller_Data
- 新結構:
Paddleboat_Controller_Battery
Paddleboat_Motion_Data
- 新列舉項目:
Paddleboat_BatteryStatus
Paddleboat_LightType
Paddleboat_Motion_Type
- 新增控制器旗標:
PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
PADDLEBOAT_CONTROLLER_FLAG_BATTERY
修正錯誤
- 新增 PS4 控制器的替代裝置 ID 資料庫項目
- 新增 PS5 控制器的 API >=31 資料庫項目
Games-Controller 1.0.0 版本
1.0.0 版本
2021 年 8 月 4 日
已釋出 androidx.games:games-activity:1.0.0
、androidx.games:games-controller:1.0.0
和 androidx.games:games-text-input:1.0.0
。1.0.0 版本包含以下修訂項目。
1.0.0 的主要功能
這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。
1.0.0-rc02 版本
2021 年 7 月 21 日
發布 androidx.games:games-controller:1.0.0-rc02
。1.0.0-rc02 版包含以下修訂項目。
修正錯誤
- 修正了封裝錯誤,導致 Prefab 匯入作業在空白、未使用的架構/版本排列時失敗。
1.0.0-rc01 版本
2021 年 7 月 12 日
已釋出androidx.games:games-controller:1.0.0-rc01
。1.0.0-rc01 版本包含這些修訂版本。
修正錯誤
- 修正最新
GameActivity
不相容的問題
1.0.0-beta01 版本
2021 年 6 月 30 日
已釋出androidx.games:games-controller:1.0.0-beta01
。1.0.0-beta01 版本包含這些修訂版本。
API 異動
- 會傳回成功或失敗布林值的函式將會傳回
Paddleboat_Error_Code
列舉。 Paddleboat_onPause
已重新命名為Paddleboat_onStop
。Paddleboat_onResume
已重新命名為Paddleboat_onStart
。- Paddleboat_processGameActivityEvent 拆分為兩個函式:
Paddleboat_processGameActivityKeyInputEvent
和Paddleboat_processGameActivityMotionInputEvent
- 移除需要為 Android S SDK 預覽需要建構的擴充控制器功能
- 已新增
Paddleboat_getBackButtonConsumed
函式 - 控制器和滑鼠狀態回呼現在會使用選用參數,指向使用者定義的資料
- 已將控制器名稱字串移出裝置資訊結構,現可透過
Paddleboat_getControllerName
函式存取
修正錯誤
- 修正原本未將控制器回報為控制器,但之後透過 onInputDeviceChanged 訊息的控制器無法正確偵測為控制器連線的問題。
1.0.0-alpha01 版本
2021 年 6 月 16 日
已釋出androidx.games:games-controller:1.0.0-alpha01
。
新功能
- Games-Controller 是提供 C API 的新程式庫,用於偵測遊戲控制器裝置、讀取控制器輸入內容,以及與控制器進行互動。
Games-Text-Input 1.1 版本
1.1.1 版本
2022 年 7 月 13 日
發布 androidx.games:games-text-input:1.1.1
。1.1.1 版本包含以下修訂項目。
修正錯誤
- 修正先前版本缺少 .aar 檔案的問題。
1.1.0 版本
2022 年 2 月 9 日
發布 androidx.games:games-text-input:1.1.0
。1.1.0 版本包含以下修訂項目。
自 1.0.0 版起的重要變更
- 為 GameTextInput 新增 WindowInsets 監聽和查詢功能
- 新增缺少的 gamecommon.h
標題
1.1.0-rc01 版本
2022 年 1 月 26 日
已釋出androidx.games:games-text-input:1.1.0-rc01
。1.1.0-rc01 版本包含以下修訂項目。
1.1.0-beta01 版本
2021 年 12 月 15 日
已釋出androidx.games:games-text-input:1.1.0-beta01
。1.1.0-beta01 版本包含這些修訂版本。
修正錯誤
- 修正刊登序列與 IME 插槽
- 新增遺漏的 Gamecommon.h 標題
1.1.0-alpha01 版本
2021年10月13日
已釋出androidx.games:games-text-input:1.1.0-alpha01
。1.1.0-alpha01 版本包含以下修訂項目。
API 異動
- 將 IME 插入功能新增至 GameTextInput
Games-Text-Input 1.0 版本
1.0.0 版本
2021 年 8 月 4 日
已釋出 androidx.games:games-activity:1.0.0
、androidx.games:games-controller:1.0.0
和 androidx.games:games-text-input:1.0.0
。1.0.0 版本包含以下修訂項目。
1.0.0 的主要功能
這是「Game-Activity」、「Game-Controller」和「Game-Text-Input」的穩定的初始版本。詳情請參閱 AGDK 首頁。
1.0.0-rc01 版本
2021 年 7 月 12 日
androidx.games:games-text-input:1.0.0-rc01
發布,內容無變更。1.0.0-rc01 版本包含以下修訂項目。
1.0.0-beta01 版本
2021 年 6 月 30 日
已釋出androidx.games:games-text-input:1.0.0-beta01
。1.0.0-beta01 版本包含這些修訂版本。
API 異動
- 改善 GameTextInputState 物件的擁有權模型。
- 與 NDK 保持一致的類型。
1.0.0-alpha01 版本
2021 年 6 月 16 日
已釋出androidx.games:games-text-input:1.0.0-alpha01
。
新功能
- Games-Text-Input 是一款新程式庫,可協助遊戲開發人員在 C/C++ 中使用 Android 螢幕鍵盤輸入功能。
Games Frame Pacing 1.10
1.10.1 版本
2022 年 6 月 15 日
發布 androidx.games:games-frame-pacing:1.10.1
。1.10.1 版本包含這些修訂版本。
修正錯誤
- 修正 swappy 無法使用 ndk <23 和 >17 建構的問題。
- 曝露 API,以便擷取螢幕支援的重新整理頻率。
1.10.0 版本
2022 年 2 月 23 日
已釋出androidx.games:games-frame-pacing:1.10.0
。1.10.0 版含有這些修訂版本。
自 1.9.0 版以來的重要異動
- 忽略輪詢器篩選器輸入內容,然後設定更平穩的配置,避免模擬器凍結
- 新增 *_uninjectTracer 函式。
1.10.0-rc01 版本
2022 年 2 月 9 日
已釋出androidx.games:games-frame-pacing:1.10.0-rc01
。1.10.0-rc01 版包含這些修訂版本。
1.10.0-beta01 版本
2022 年 1 月 26 日
已釋出androidx.games:games-frame-pacing:1.10.0-beta01
。1.10.0-beta01 版本包含這些修訂版本。
1.10.0-alpha01 版本
2021 年 12 月 15 日
已釋出androidx.games:games-frame-pacing:1.10.0-alpha01
。1.10.0-alpha01 版本包含這些修訂版本。
新功能
- 新增
SwappyGL_uninjectTracer
函式。
API 異動
- 使用
SwappyGL_uninjectTracer(const SwappyTracer *t)
API移除先前使用SwappyGL_injectTracer
新增的回呼。
遊戲畫面速度 1.9
1.9.1 版本
2021年10月13日
已釋出androidx.games:games-frame-pacing:1.9.1
。1.9.1 版包含這些修訂版本。
修正錯誤
- 已修正 b/199487756
1.9.0 版本
2021 年 7 月 12 日
已釋出androidx.games:games-frame-pacing:1.9.0
。1.9.0 版包含這些修訂版本。
1.7.0 版之後的重要異動
- 已配合內部版本管理架構更新。
遊戲畫面速度 1.7.0
1.7.0 版本
2021 年 6 月 30 日
已釋出androidx.games:games-frame-pacing:1.7.0
。1.7.0 版本包含以下修訂項目。
1.7.0-rc01 版本
2021 年 6 月 2 日
已釋出androidx.games:games-frame-pacing:1.7.0-rc01
。1.7.0-rc01 版本包含以下修訂項目。
1.7.0-beta02 版本
2021 年 2 月 24 日
已釋出androidx.games:games-frame-pacing:1.7.0-beta02
。
1.7.0-beta01 版本
2020 年 12 月 16 日
已釋出androidx.games:games-frame-pacing:1.7.0-beta01
。
Games Performance Tuner 1.4.3 版本
1.4.3 版本
2021 年 7 月 12 日
已釋出androidx.games:games-performance-tuner:1.4.3
。1.4.3 版本包含以下修訂項目。
自 1.1.0 版以來的重要異動
- 已配合內部版本管理架構更新。
Games Performance Tuner 1.1.0
1.1.0 版本
2021 年 6 月 30 日
已釋出androidx.games:games-performance-tuner:1.1.0
。1.1.0 版本包含以下修訂項目。
1.1.0-rc01 版本
2021 年 6 月 2 日
已釋出androidx.games:games-performance-tuner:1.1.0-rc01
。1.1.0-rc01 版本包含以下修訂項目。
1.1.0-beta03 版本
2021 年 4 月 21 日
已釋出androidx.games:games-performance-tuner:1.1.0-beta03
。
1.1.0-beta02 版本
2021 年 2 月 24 日
已釋出androidx.games:games-performance-tuner:1.1.0-beta02
。
1.1.0-beta01 版本
2020 年 12 月 16 日
已釋出androidx.games:games-performance-tuner:1.1.0-beta01
。
1.1.0-alpha01 版本
已釋出 androidx.games:games-performance-tuner:1.1.0-alpha01。
1.0.0 版本
1.0.0-alpha02 版本
2020 年 8 月 12 日
Android Gaming 程式庫已重新命名為 Android 遊戲程式庫。
androidx.gaming -> androidx.games
1.0.0-alpha01 版本
2020年6月10日
已釋出androidx.games:1.0.0-alpha01。