リリースノート

このページでは、Android Game Development Kit(AGDK)ライブラリの各リリースにおける変更点の概要を示します。AGDK は、v1.2.4 リリースまでは Android Games SDK という名前でした。

2023.3.0.0(2023 年 6 月 2 日)

このリリースには、いくつかのバグ修正が含まれています。

ゲーム アクティビティ

修正 GameActivityEvents の安定性を修正しました。

Android Memory Advice Library

機能 ライブラリを強化する機械学習モデルを更新しました。これにより、新しいスマートフォンでの結果を改善できます。

Android Performance Tuner

修正 最大インストルメンテーション キーがヒストグラムの数を超えるとライブラリがクラッシュするバグを修正しました。
機能 ライブラリのテレメトリー収集機能が更新され、フレーム レンダリング時間をより細かくレポートできるようになりました。

2023.2.0.0(2023 年 4 月 27 日)

このリリースには、いくつかのバグ修正が含まれています。

ゲーム アクティビティ

修正 historyEventTimes によるメモリの早期解放を修正しました。
修正 32 ビットシステムで HistoryEventTimesNanos のオーバーフローが発生する問題を修正しました。

Android Memory Advice Library

修正 ライブラリの静的バージョンを正しくリンクできないバグを修正しました。
修正 ライブラリが必要な TensorFlow Lite アセットを正しく読み込めないバグを修正しました。

2023.1.0.0(2023 年 3 月 15 日)

このメジャー リリースでは、ソースからライブラリをより迅速にビルドできるようにビルドシステムが更新されました。

ゲーム アクティビティ

変更 32 ビットの制限を克服するために、過去のイベント時間のインターフェースが変更されました。
機能 構成の変更に対するユーザー アクセス権を付与しました。
機能 タッチイベント処理におけるほとんどの JNI 呼び出しを最適化しました。
修正 システムボタンの処理など、タッチイベントのデフォルトの OS 処理を修正しました。

GameController

機能 ハードウェア キーボードの接続ステータスを検出する機能が追加されました。
機能 メインデバイス(スマートフォンなど)とコントローラからモーション データ(加速度計/ジャイロスコープ)を報告する機能が追加されました。
変更 メモリ フットプリントを削減し、追加機能をサポートするため、コントローラ定義データベースの API と形式を変更しました。

Android Frame Pacing ライブラリ

機能 Vulkan フレーム統計情報が追加されました。
機能 フレーム統計情報を消去するための新しい API が追加されました。
変更 リリースモードではログはすべてサイレント モードであり、デバッグモードで有効にできます。

2022.0.0(2022 年 3 月 15 日)

このメジャー リリースには、メモリ アドバイス ライブラリと、他のライブラリの修正がいくつか含まれています。

ゲーム アクティビティ

機能 IME とカットアウトの周囲にゲーム UI を配置するためのインセットの処理を追加しました。
機能 キーとモーション イベントのフィルタを追加
修正 入力イベントの損失を回避し、すべての入力イベントを消費しないように修正しました。

Android Performance Tuner

変更済み メモリ レポートはヒストグラムではなく時系列で作成
機能 アップロード間隔のプログラムによる設定を許可する
修正 API キーの破損のバグを修正

Android Frame Pacing ライブラリ

機能 自動モードの改善
機能 「uninjectTracer」関数を追加する

Android Memory Advice ライブラリ

機能 Memory Advice Library の追加

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 日)

今回のリリースでは Game SDK に Oboe が追加されました。Android Frame Pacing ライブラリと Android Performance Tuner に変更はありません。

Oboe は Android で使用する高性能オーディオ用のオープンソースの C++ ライブラリです。Oboe は、Android 4.1(API レベル 16)以降で動作する単一のネイティブ API を提供します。

1.2.2(2021 年 2 月 12 日)

このリリースでは、Android Performance Tuner の loading times API が改善され、いくつかのバグの修正が行われています。Android Frame Pacing Library に変更はありません。

Android Performance Tuner

機能 読み込みイベントでは、TuningFork_startLoadingGroupTuningFork_stopLoadingGroup の呼び出しでのグループ化が必要になりました。
修正 TuningFork_flush を呼び出すと、後でアップロードするためにデータをキューに追加するのではなく、すぐにデータがアップロードされていました。
修正 時間の JSON 形式が原因で、アップロードの失敗が断続的に発生していました。
修正 リリースビルドのアップロードで問題が発生していました。

1.2.1(2020 年 12 月 16 日)

このリリースは、Android Performance Tuner の内部機能リリースであり、Jetpack ライブラリはアルファ版からベータ版に昇格しました。Android Frame Pacing API または Android Performance Tuner API に変更はありません。

Game SDK ライブラリをリンクする際には、通常の「gamesdk」ライブラリにリンクするのではなく、個別に参照する必要があります。Android Frame Pacing: OpenGLAndroid Frame Pacing: VulkanAndroid Performance Tuner のビルド設定をご覧ください。

Android Performance Tuner

機能 プレーヤーが読み込み中のゲームをバックグラウンドに移動した場合、後で読み込みの中止を分析するためのイベントが送信されます。

1.2.0(2020 年 10 月 29 日)

このバージョンの主な変更点は、読み込み時間を記録するメカニズムの追加です。バグの修正もいくつか行いました。Jetpack の AGDK ライブラリを介して Game SDK を使用できるようになりました。

Android Frame Pacing ライブラリ

機能 自動モード リフレッシュ レートの切り替えのサポート。
Android 11 で複数のリフレッシュ レートをサポートする場合は、自動モードを使用しているかどうかにかかわらず、SwappyGL_setWindow または SwappyVk_setWindow を呼び出す必要があります。
修正 自動モードのバグを修正しました。
修正 Vulkan のバグを修正しました。

Android Performance Tuner

機能 読み込み時間。
アノテーション付き読み込み時間イベントを記録するには、新しい関数 TuningFork_startRecordingLoadingTimeTuningFork_stopRecordingLoadingTime を呼び出す必要があります。アプリの起動から TuningFork_init までの時間と最初のティックが自動的に記録されます。
変更 読み込み時間のアノテーションを設定するための従来のメソッドは機能しなくなります。
機能 ライフサイクル イベント
適切な Java onCreate などが呼び出されたときに TuningFork_reportLifecycleEvent を呼び出す必要があります。これにより、Android Performance Tuner 内で詳細なクラッシュ レポートを作成できるようになります。
変更 TuningFork_enableMemoryRecording(true) が呼び出されたときに、より多くのメモリ指標を記録するようにしました。
変更 メモリモデルの変更。
アノテーションの考えられる組み合わせすべてにスペースを割り当てるのではなく、各タイプの指標の最大数を起動時に指定するようにしました。tuningfork.hTuningFork_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 に出力されるようになりました。
修正 API レベル 24 以下の Swappy_destroy で発生するクラッシュとデッドロックを修正しました。
機能 カスタム スレッド マネージャーをサポートします(Swappy_setThreadFunctions)。
機能 Vulkan 関数のフック処理をサポートします(SwappyVk_setFunctionProvider)。

1.0.0(2019 年 12 月 5 日)

この初回バージョンの AGDK ライブラリには、Android Frame Pacing ライブラリが含まれています。

機能 バッファ同期を表示します。
機能 自動リフレッシュ レート モードとパイプライン処理をサポートします。
機能 フレーム レンダリングの統計情報を収集します。
機能 Swappy が必要とする Android、OpenGL、Vulkan の機能の有無に応じて、実行時に動作を適切に選択します。
機能 ライブラリの静的リンクと動的リンク。
機能 複数のリフレッシュ レートに対応するデバイスをサポートします。