Android Games

Android Games ライブラリは、Android Game SDK をミラーリングしており、バイナリ ダウンロードとして入手できます。Android Game SDK を手動でダウンロードしてビルドに統合する代わりに、androidx ライブラリを使用できます。

Android Game SDK について詳しくは、SDK ドキュメントSDK リリースノートをご覧ください。

androidx.games グループ内のすべてのアーティファクトのリストを以下に示します。

アーティファクト 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
games-activity 3.0.1 - - -
games-controller 2.0.1 - - -
games-frame-pacing 2.1.0 - - -
games-memory-advice 2.0.1 - 2.1.0-beta01 -
games-text-input 3.0.1 - - -
games-performance-tuner - - 2.0.0-beta01 -
このライブラリの最終更新日: 2024 年 3 月 20 日

要件

games-memory-advice

MemoryAdvice API では、次のいずれかの NDK バージョンを使用してアプリケーションをビルドする必要があります。

  • r20.*
  • r21.*
  • r23.*

依存関係の宣言

game への依存関係を追加するには、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:2.1.0"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:3.0.1"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:2.0.1"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:3.0.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:2.1.0")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:3.0.1")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.1")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:3.0.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 でパッケージを追加する

インポートした Game SDK パッケージを利用できるようにするには、メインアプリの 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 バージョン 2.1

バージョン 2.1.0-beta01

2023 年 11 月 29 日

androidx.games:games-memory-advice:2.1.0-beta01 がリリースされました。バージョン 2.1.0-beta01 に含まれる commit については、こちらをご覧ください

バージョン 2.1.0-alpha01

2023 年 11 月 15 日

androidx.games:games-memory-advice:2.1.0-alpha01 がリリースされました。バージョン 2.1.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • 予測を改善するため、ライブラリのメモリモデルを更新しました。

API の変更

  • 安全に割り当て可能なメモリ量の推定値(バイト単位)を返す新しい API getAvailableMemory() を追加しました。

バージョン 2.1.0-alpha01

2023 年 7 月 26 日

androidx.games:games-memory-advice:2.1.0-alpha01 がリリースされました。バージョン 2.1.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • GetAvailableMemory 関数を追加

バグの修正

  • Memory Advice モデルの更新
  • 共有 memory_advice ビルド ターゲットを修正

Games-Memory-Advice バージョン 2.0

バージョン 2.0.1

2023 年 9 月 20 日

androidx.games:games-memory-advice:2.0.1 がリリースされました。バージョン 2.0.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • スレッドが JVM にアタッチされていないため、状態監視スレッドで発生するクラッシュを修正しました。

バージョン 2.0.0

2023 年 9 月 6 日

androidx.games:games-memory-advice:2.0.0 がリリースされました。バージョン 2.0.0 に含まれる commit については、こちらをご覧ください

2.0.0 の主な機能

  • このバージョンで新しい ML モデルがトレーニングされ、リリースされました。
  • メモリの空き容量を予測する API が実装されています。

バージョン 2.0.0-rc01

2023 年 7 月 26 日

androidx.games:games-memory-advice:2.0.0-rc01 がリリースされました。バージョン 2.0.0-rc01 に含まれる commit については、こちらをご覧ください

新機能

  • メモリの残量をより正確に予測するための新しいモデルを追加しました。

バグの修正

  • 共有 STL で Memory Advice が機能しない問題を修正しました。

バージョン 2.0.0-beta04

2023 年 5 月 24 日

androidx.games:games-memory-advice:2.0.0-beta04 がリリースされました。バージョン 2.0.0-beta04 に含まれる commit については、こちらをご覧ください

新機能

  • ライブラリで使用されている機械学習モデルを更新し、新しいスマートフォンでより良い結果が得られるようにしました

バージョン 2.0.0-beta03

2023 年 4 月 5 日

androidx.games:games-memory-advice:2.0.0-beta03 がリリースされました。バージョン 2.0.0-beta03 に含まれる commit については、こちらをご覧ください

バグの修正

  • ライブラリが必要な tensorflow Lite アセットを正しく読み込めないバグを修正しました。

バージョン 2.0.0-beta02

2023 年 3 月 22 日

androidx.games:games-memory-advice:2.0.0-beta02 がリリースされました。バージョン 2.0.0-beta02 に含まれる commit については、こちらをご覧ください

バグの修正

  • 静的バージョンのライブラリを適切にリンクできないバグを修正しました。

バージョン 2.0.0-beta01

2023 年 2 月 22 日

androidx.games:games-memory-advice:2.0.0-beta01 がリリースされました。バージョン 2.0.0-beta01 に含まれる commit については、こちらをご覧ください

新機能

  • 新しい変更はありません

バージョン 2.0.0-alpha01

2023 年 2 月 8 日

androidx.games:games-memory-advice:2.0.0-alpha01 がリリースされました。バージョン 2.0.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • ビルドファイルのリファクタリングにより、メジャー バージョンを更新しました。

バグの修正

  • ライブラリ アセットが正しく設定されていないときにクラッシュせず、エラーを表示するようになりました。

Games-Memory-Advice バージョン 1.0.0

バージョン 1.0.0-beta03

2022 年 11 月 9 日

androidx.games:games-memory-advice:1.0.0-beta03 がリリースされました。バージョン 1.0.0-beta03 に含まれる commit については、こちらをご覧ください

新機能

  • 新しい変更はありません

バージョン 1.0.0-beta01

2022 年 3 月 9 日

androidx.games:games-memory-advice:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

  • 1.0.0-alpha01 からの変更はありません。

バージョン 1.0.0-alpha01

2022 年 2 月 23 日

androidx.games:games-memory-advice:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • この C ライブラリは、ゲームを実行しているデバイスのメモリ状態の変化について、コールバックのクエリと受信を行うための設備を提供します。

API の変更

  • これはメモリ アドバイス ライブラリの初回リリースです。完全な API については、include/memory_advice/memory_advice.h のヘッダーをご覧ください。

外部からの協力

  • このライブラリは tensorflow に依存しています。tensorflow のライセンスと推移的依存関係について詳しくは、https://github.com/tensorflow/tensorflow をご覧ください。

Games-Activity バージョン 3.0

バージョン 3.0.1

2024 年 3 月 20 日

androidx.games:games-activity:3.0.1androidx.games:games-text-input:3.0.1 がリリースされました。バージョン 3.0.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 特殊文字が入力されて表示される問題を修正しました。

バージョン 3.0.0

2024 年 3 月 6 日

androidx.games:games-activity:3.0.0androidx.games:games-text-input:3.0.0 がリリースされました。バージョン 3.0.0 に含まれる commit については、こちらをご覧ください。

3.0.0 の主な機能

  • GameTextInput をゲームで使用できるように修正しました。
  • 両方のライブラリの一部のインターフェースが、バージョン 2.0.0 に関して変更されました。

バグの修正

  • 古い NDK との互換性の問題を修正しました
  • Windows のビルドに関する問題を修正しました

バージョン 3.0.0-rc01

2024 年 2 月 21 日

androidx.games:games-activity:3.0.0-rc01androidx.games:games-text-input:3.0.0-rc01 がリリースされました。バージョン 3.0.0-rc01 に含まれる commit については、こちらをご覧ください

バグの修正

  • キーボード イベントが Looper で適切に処理されないフリーズを修正しました。

バージョン 3.0.0-beta01

2023 年 11 月 29 日

androidx.games:games-activity:3.0.0-beta01androidx.games:games-text-input:3.0.0-beta01 がリリースされました。バージョン 3.0.0-beta01 に含まれる commit については、こちらをご覧ください

バージョン 3.0.0-alpha01

2023 年 11 月 15 日

androidx.games:games-activity:3.0.0-alpha01androidx.games:games-text-input:3.0.0-alpha01 がリリースされました。バージョン 3.0.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • GameActivityMotionEvent 構造と GameActivityCallbacks 構造のサイズが変更されました。
  • onEditorAction は、戻り値の型をブール値から void に変更します。
  • setImeEditorInfo で整数ではなく、列挙型パラメータが想定されるようになりました。
  • GameActivityEvents の内部関数は GameActivityEvents_internal.h に移動されました。
  • GameTextInput の入力型も整数ではなく列挙型です。

Games-Activity バージョン 2.1

バージョン 2.1.0-alpha02

2023 年 9 月 6 日

androidx.games:games-activity:2.1.0-alpha02androidx.games:games-text-input:2.1.0-alpha02 がリリースされました。バージョン 2.1.0-alpha02 に含まれる commit については、こちらをご覧ください

バグの修正

  • 32 ビットデバイスの互換性が改善されました。

バージョン 2.1.0-alpha01

2023 年 7 月 26 日

androidx.games:games-activity:2.1.0-alpha01 がリリースされました。バージョン 2.1.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • SurfaceView インスタンスの作成をオーバーライドする機能を提供する
  • SDK バージョンのレポートを追加する

API の変更

  • 32 ビットシステムでのオーバーランを回避するため、historicalEventTimeslong ではなく int64_t を使用する
  • GameActivity_restartInput メソッドを追加
  • ソフトウェア キーボードの公開設定の変更を処理するネイティブ コールバックを追加する

バグの修正

  • タッチイベント処理を最適化する
  • GameActivityMotionEven の正しい破棄
  • GameActivityMotionEvent_getHistoricalAxisValue インデックスの計算を修正
  • モーション フィルタのビットマスクを修正

Games-Activity バージョン 2.0

バージョン 2.0.2

2023 年 5 月 24 日

androidx.games:games-activity:2.0.2 がリリースされました。バージョン 2.0.2 に含まれる commit については、こちらをご覧ください

バグの修正

  • GameActivityEvents の安定性を修正しました。(b/278017467

バージョン 2.0.1

2023 年 4 月 5 日

androidx.games:games-activity:2.0.1 がリリースされました。バージョン 2.0.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • historicalEventTimes でのメモリの早期解放を修正しました。
  • 32 ビットシステムでの historicalEventTimesNanos のオーバーフローの問題を修正しました

バージョン 2.0.0

2023 年 3 月 8 日

androidx.games:games-activity:2.0.0 がリリースされました。バージョン 2.0.0 に含まれる commit については、こちらをご覧ください

2.0.0 の主な機能

  • 32 ビットの制限を克服するため、過去のイベント時間のインターフェースを変更しました。
  • 画面の向きなど、構成の変更に対するユーザー アクセス権を付与しました。
  • contentRect 構造で最新の情報を提供しました。
  • デフォルトの SurfaceView を簡単にカスタマイズできるようにしました。
  • システムボタンの処理など、OS のデフォルトのタッチイベント処理を修正しました。
  • タッチイベント処理におけるほとんどの JNI 呼び出しを最適化。これはパフォーマンスに影響を及ぼしていました。

バージョン 2.0.0-rc01

2023 年 2 月 22 日

androidx.games:games-activity:2.0.0-rc01 がリリースされました。バージョン 2.0.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 2.0.0-beta01

2023 年 2 月 8 日

androidx.games:games-activity:2.0.0-beta01 がリリースされました。バージョン 2.0.0-beta01 に含まれる commit については、こちらをご覧ください

バグの修正

  • システムボタンの処理を修正しました。(2a103e

バージョン 2.0.0-alpha01

2023 年 1 月 11 日

androidx.games:games-activity:2.0.0-alpha01 がリリースされました。変更はありません。バージョン 2.0.0-alpha01 に含まれる commit については、こちらをご覧ください

Games-Activity バージョン 1.2

バージョン 1.2.2

2022 年 12 月 7 日

androidx.games:games-activity:1.2.2 がリリースされました。バージョン 1.2.2 に含まれる commit については、こちらをご覧ください

バグの修正

  • 実行時にモーション イベントの最大数を設定できるようになりました。

バージョン 1.2.2-alpha01

2022 年 11 月 9 日

androidx.games:games-activity:1.2.2-alpha01 がリリースされました。バージョン 1.2.2-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • API にバージョン情報も GAMEACTIVITY_PACKED_VERSION の形式で含まれるようになりました。(I287e6
  • コンテンツを配置するウィンドウの矩形が変形したときに呼び出される onContentRectChanged コールバックを追加しました。(I81396

バグの修正

  • イベントのバッファ オーバーフローを修正しました。inputBuffer -> keyEventsmotionEvents の両方が動的に割り当てられるバッファになりました。(Ic00f6
  • メモリ不足の場合、エラーとして適切に処理します。バッファのサイズ変更中の realloc() エラーの処理を追加しました。

バージョン 1.2.1

2022 年 7 月 13 日

androidx.games:games-activity:1.2.1 がリリースされました。バージョン 1.2.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • 以前のリリースで .aar ファイルが見つからない問題を修正しました。

バージョン 1.2.0

2022 年 6 月 15 日

androidx.games:games-activity:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください

1.1.0 以降の重要な変更

  • GameActivity の派生クラスにネイティブ ライブラリの読み込みの処理を許可しました。
  • 常に GameActivity.onCreate でネイティブ ライブラリを読み込むようにしました。
  • ライブラリが見つからない場合は、代替として「main」という名前のライブラリを読み込むようにしました。

Games-Activity バージョン 1.1

バージョン 1.1.0

2022 年 2 月 23 日

androidx.games:games-activity:1.1.0androidx.games:games-controller:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください

1.0.0 以降の重要な変更

Games Activity:

  • ノッチと IME のレスポンスをリッスンしてクエリする WindowInsets
  • キーとモーション イベントのフィルタを追加
  • バグの修正:
    • NativeActivity との互換性を維持するために欠落しているメッセージを追加
    • onNativeWindowResized の署名を修正
    • 入力イベントの損失を修正

バージョン 1.1.0-rc01

2022 年 2 月 9 日

androidx.games:games-activity:1.1.0-rc01androidx.games:games-controller:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.1.0-beta03

2022 年 1 月 26 日

androidx.games:games-activity:1.1.0-beta03 がリリースされました。バージョン 1.1.0-beta03 に含まれる commit については、こちらをご覧ください

バグの修正

  • onNativeWindowResized のシグネチャを修正
  • onSurfaceChanged のネイティブ ウィンドウへのハンドルを維持

バージョン 1.1.0-beta02

2021 年 12 月 15 日

androidx.games:games-activity:1.1.0-beta02 がリリースされました。バージョン 1.1.0-beta02 に含まれる commit については、こちらをご覧ください

バグの修正

  • イベント フィルタの設定での競合状態を修正しました。

バージョン 1.1.0-beta01

2021 年 11 月 17 日

androidx.games:games-activity:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください

新機能

  • ウィンドウ インセットのクエリとインセット変更のリッスンに対するサポートを追加しました。これにより、ゲームは 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 に含まれる commit については、こちらをご覧ください

API の変更

  • onContentRectChanged コールバックを GameActivityCallbacks に追加しました

バグの修正

  • 欠落していたメッセージを android_native_app_glue.h に追加しました。
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

バージョン 2.0.0-beta01

2024 年 1 月 10 日

androidx.games:games-performance-tuner:2.0.0-beta01 がリリースされました。前回のアルファ版リリースからの変更はありません。バージョン 2.0.0-beta01 に含まれる commit については、こちらをご覧ください

バージョン 2.0.0-alpha07

2023 年 11 月 29 日

androidx.games:games-performance-tuner:2.0.0-alpha07 がリリースされました。バージョン 2.0.0-alpha07 に含まれる commit については、こちらをご覧ください

バグの修正

  • メモリ テレメトリー レポートが誤った値を報告することがある問題を修正

バージョン 2.0.0-alpha06

2023 年 11 月 1 日

androidx.games:games-performance-tuner:2.0.0-alpha06 がリリースされました。バージョン 2.0.0-alpha06 に含まれる commit については、こちらをご覧ください

バージョン 2.0.0-alpha05

2023 年 8 月 23 日

androidx.games:games-performance-tuner:2.0.0-alpha05 がリリースされました。バージョン 2.0.0-alpha05 に含まれる commit については、こちらをご覧ください

新機能

  • Protobuf ライブラリを Protobuf lite に移行しました。

バグの修正

  • ダングリング ポインタの問題を修正しました。

バージョン 2.0.0-alpha04

2023 年 4 月 19 日

androidx.games:games-performance-tuner:2.0.0-alpha04 がリリースされました。バージョン 2.0.0-alpha04 に含まれる commit については、こちらをご覧ください

新機能

  • ライブラリのテレメトリー収集機能を更新し、フレーム レンダリング時間をより詳細にレポートできるようになりました。

バグの修正

  • 最大インストルメンテーション キーがヒストグラムの数を超えるとライブラリがクラッシュするバグを修正しました。

バージョン 2.0.0-alpha03

2023 年 2 月 22 日

androidx.games:games-performance-tuner:2.0.0-alpha03 がリリースされました。バージョン 2.0.0-alpha03 に含まれる commit については、こちらをご覧ください

バグの修正

  • Games-Performance-Tuner が新しいリリース プロセスに移行されました。動作に変更はありません。

バージョン 2.0.0-alpha02

2023 年 2 月 8 日

androidx.games:games-performance-tuner:2.0.0-alpha02 がリリースされました。バージョン 2.0.0-alpha02 に含まれる commit については、こちらをご覧ください

API の変更

  • TuningFork_predictQualityLevels API を追加しました。これは使用すべき適切な品質レベル / 忠実度パラメータの予測に役立ちます。

Games Performance Tuner 1.6

バージョン 1.6.1-alpha01

2022 年 11 月 9 日

androidx.games:games-performance-tuner:1.6.1-alpha01 がリリースされました。バージョン 1.6.1-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • 新しい変更はありません

バージョン 1.6.0

2022 年 6 月 15 日

androidx.games:games-performance-tuner:1.6.0 がリリースされました。バージョン 1.6.0 に含まれる commit については、こちらをご覧ください

1.5.0 以降の重要な変更

  • メモリ テレメトリーを取得しようとするときに 0 を返す getpid を修正しました。
  • StopLoadingGroup が有効な読み込みグループなしで実行されないようにしました。

Games Performance Tuner 1.5.0

バージョン 1.5.0

2022 年 2 月 9 日

androidx.games:games-performance-tuner:1.5.0 がリリースされました。バージョン 1.5.0 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください

バグの修正

  • API 23 以前の API キーのメモリ破損を修正

バージョン 1.5.0-beta02

2021 年 12 月 15 日

androidx.games:games-performance-tuner:1.5.0-beta02 がリリースされました。バージョン 1.5.0-beta02 に含まれる commit については、こちらをご覧ください

API の変更

  • TuningFork_Settings から ABI の互換性を破る変更を削除しました。

バージョン 1.5.0-beta01

2021 年 9 月 29 日

androidx.games:games-performance-tuner:1.5.0-beta01 がリリースされました。バージョン 1.5.0-beta01 に含まれる commit については、こちらをご覧ください

新機能

  • アルファ版リリースからの変更はありません。当該リリースでの変更は次のとおりでした。
    • アップロードの間隔を、初期設定でハードコードするのではなくプログラムで変更するようにしました。

API の変更

  • アルファ版リリースからの変更はありません。当該リリースでの変更は次のとおりでした。
    • 新しい関数: 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 に含まれる commit については、こちらをご覧ください

新機能

  • 設定ファイルを使用せず、APT アップロードの間隔をプログラムで設定できるようになりました。

API の変更

  • 関数を追加しました: TuningFork_setAggregationStrategyInterval
  • TuningFork_Settings 構造体にフィールドを追加しました: aggregation_strategy_intervalms_or_count

Games-Activity バージョン 1.0.0

バージョン 1.0.0

2021 年 8 月 4 日

androidx.games:games-activity:1.0.0androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください

1.0.0 の主な機能

これは、Games-Activity、Games-Controller、Games-Text-Input の安定版の初回のリリースです。詳しくは、AGDK のホームページをご覧ください。

バージョン 1.0.0-rc01

2021 年 7 月 12 日

androidx.games:games-activity:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください

バグの修正

  • GameActivityCallbacks::onSaveInstanceState の戻り値の型を修正しました

バージョン 1.0.0-beta01

2021 年 6 月 30 日

androidx.games:games-activity:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

API の変更

  • GameActivityInputInfoGameActivityPointerAxes に名前変更します。
  • 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 は、C/C++ ゲームを Android と統合するためのおすすめの方法として NativeActivity の代わりに導入された新しいライブラリです。

Games-Controller バージョン 2.0

バージョン 2.0.1

2023 年 9 月 20 日

「androidx.games: Games-controller: 2.0.1」がリリースされました。バージョン 2.0.1 に含まれる commit については、こちらをご覧ください

ゲーム コントローラのバグの修正:

  • onInputDeviceChanged ハンドラでのまれな NullReferenceException 条件を修正しました。
  • 特定の USB キーボードがゲーム コントローラとして不適切に登録されないよう修正しました。

バージョン 2.0.0

2023 年 3 月 8 日

androidx.games:games-controller:2.0.0 がリリースされました。バージョン 2.0.0 に含まれる commit については、こちらをご覧ください

2.0.0 の主な機能

  • ハードウェア キーボードの接続ステータスを検出する機能を追加しました。
  • メインデバイス(ハンドセット)とコントローラから動作データ(加速度計/ジャイロスコープ)を報告する機能を追加しました。
  • メモリ使用量を削減し、追加機能をサポートするため、コントローラ定義データベースの API と形式を変更しました。

バージョン 2.0.0-alpha01

2023 年 1 月 11 日

androidx.games:games-controller:2.0.0-alpha01 がリリースされました。バージョン 2.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • ハードウェア キーボードの検出
  • 統合されたセンサー モーション データレポートのサポート(例: スマートフォン自体からジャイロスコープと加速度計のデータを受信)
  • 最適化された新しいコントローラ マッピング データ形式

API の変更

  • ハードウェア キーボード用の新しい API 呼び出し: Paddleboat_getPhysicalKeyboardStatus および Paddleboat_setPhysicalKeyboardStatusCallback
  • 統合されたセンサー モーション データレポート用の新しい API 呼び出し: Paddleboat_getIntegratedMotionSensorFlags および Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • 改訂されたコントローラ マッピング データ形式用の新しい API 呼び出し: Paddleboat_addControllerRemapDataFromFdPaddleboat_addControllerRemapDataFromFileBuffer
  • 古いマッピング API 呼び出しを非推奨化: Paddleboat_addControllerRemapData および Paddleboat_getControllerRemapTableData

バグの修正

  • GameActivity 1.2.2 以降のモーション イベントに関する互換性の問題を修正しました。

Games-Controller バージョン 1.1.0

バージョン 1.1.0

2022 年 2 月 23 日

androidx.games:games-activity:1.1.0androidx.games:games-controller:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください

1.0.0 以降の重要な変更

Games Activity:

  • ノッチと IME のレスポンスをリッスンしてクエリする WindowInsets
  • キーとモーション イベントのフィルタを追加
  • バグの修正:
    • NativeActivity との互換性を維持するために欠落しているメッセージを追加
    • onNativeWindowResized の署名を修正
    • 入力イベントの損失を修正

バージョン 1.1.0-rc01

2022 年 2 月 9 日

androidx.games:games-controller:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-beta01

2022 年 1 月 26 日

androidx.games:games-controller:1.1.0-beta01 がリリースされました。1.1.0-alpha01 からの変更はありません。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-alpha01

2021 年 12 月 15 日

androidx.games:games-controller:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

Android S 以降で実行されている場合の、サポートされているコントローラのバッテリーの状態、デュアルモーターのバイブレーション、ライト操作、モーション軸のレポートのサポートを追加しました。

API の変更

  • コントローラのモーション データ コールバックを登録するための Paddleboat_setMotionDataCallback 関数を追加しました
  • コントローラのライト設定を変更するための Paddleboat_setControllerLight 関数を追加しました
  • Paddleboat_Controller_DataPaddleboat_Controller_Battery 構造体を追加しました
  • 新しい構造体:
    • 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 コントローラの代替 deviceId データベース項目を追加しました
  • PS5 コントローラの API >=31 データベース項目を追加しました

Games-Controller バージョン 1.0.0

バージョン 1.0.0

2021 年 8 月 4 日

androidx.games:games-activity:1.0.0androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください

1.0.0 の主な機能

これは、Games-Activity、Games-Controller、Games-Text-Input の安定版の初回のリリースです。詳しくは、AGDK のホームページをご覧ください。

バージョン 1.0.0-rc02

2021 年 7 月 21 日

androidx.games:games-controller:1.0.0-rc02 がリリースされました。バージョン 1.0.0-rc02 に含まれる commit については、こちらをご覧ください

バグの修正

  • 空の未使用のアーキテクチャ / バージョンの組み合わせで Prefab のインポートが失敗する原因となっていたパッケージング エラーを修正しました。

バージョン 1.0.0-rc01

2021 年 7 月 12 日

androidx.games:games-controller:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください

バグの修正

  • 最新の GameActivity との非互換性に関する問題を修正しました

バージョン 1.0.0-beta01

2021 年 6 月 30 日

androidx.games:games-controller:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

API の変更

  • 成功または失敗をブール値で返していた関数が Paddleboat_Error_Code 列挙型を返すようになりました
  • Paddleboat_onPause の名前を Paddleboat_onStop に変更しました
  • Paddleboat_onResume の名前を Paddleboat_onStart に変更しました
  • Paddleboat_processGameActivityEvent を 2 つの関数 Paddleboat_processGameActivityKeyInputEventPaddleboat_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 を提供する新しいライブラリです。

ゲーム - テキスト入力 2.1

バージョン 2.1.0-alpha01

2023 年 7 月 26 日

androidx.games:games-text-input:2.1.0-alpha01 がリリースされました。バージョン 2.1.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • 複数行モードと単一行モードのサポートを追加する

API の変更

  • isSoftwareKeyboardVisible 関数を追加
  • GameActivity_setImeEditorInfo のビットフィールド定義を追加する
  • onEditorAction コールバックを追加

バグの修正

  • ハードウェア キーボードとソフトウェア キーボードが同期しない問題を修正
  • ソフト キーボードが非表示のときにフォーカスをクリアする

ゲーム - テキスト入力 2.0

バージョン 2.0.0

2023 年 3 月 8 日

androidx.games:games-text-input:2.0.0 がリリースされました。バージョン 2.0.0 に含まれる commit については、こちらをご覧ください

1.1.1 以降の重要な変更

  • ビルドシステムの変更によるメジャー バージョン アップデート。ライブラリや API 自体のアップデートはありません。

Games-Text-Input バージョン 1.1

バージョン 1.1.2-alpha01

2022 年 11 月 9 日

androidx.games:games-text-input:1.1.2-alpha01 がリリースされました。バージョン 1.1.2-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • 新しい変更はありません

バージョン 1.1.1

2022 年 7 月 13 日

androidx.games:games-text-input:1.1.1 がリリースされました。バージョン 1.1.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • 以前のリリースで .aar ファイルが見つからない問題を修正しました。

バージョン 1.1.0

2022 年 2 月 9 日

androidx.games:games-text-input:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください

1.0.0 以降の重要な変更 - WindowInsets のリッスンとクエリの機能を GameTextInput に追加 - 欠落していた gamecommon.h ヘッダーを追加

バージョン 1.1.0-rc01

2022 年 1 月 26 日

androidx.games:games-text-input:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-beta01

2021 年 12 月 15 日

androidx.games:games-text-input:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください

バグの修正

  • ウォーターフォールと IME インセットを修正しました
  • 不足している gamecommon.h ヘッダーを追加しました

バージョン 1.1.0-alpha01

2021 年 10 月 13 日

androidx.games:games-text-input:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • IME インセット機能を GameTextInput に追加しました

Games-Text-Input バージョン 1.0

バージョン 1.0.0

2021 年 8 月 4 日

androidx.games:games-activity:1.0.0androidx.games:games-controller:1.0.0androidx.games:games-text-input:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください

1.0.0 の主な機能

これは、Games-Activity、Games-Controller、Games-Text-Input の安定版の初回のリリースです。詳しくは、AGDK のホームページをご覧ください。

バージョン 1.0.0-rc01

2021 年 7 月 12 日

androidx.games:games-text-input:1.0.0-rc01 がリリースされました。変更はありません。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.0.0-beta01

2021 年 6 月 30 日

androidx.games:games-text-input:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

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 バージョン 2.1

バージョン 2.1.0

2023 年 11 月 15 日

androidx.games:games-frame-pacing:2.1.0 がリリースされました。バージョン 2.1.0 に含まれる commit については、こちらをご覧ください

バージョン 2.1.0-rc01

2023 年 9 月 20 日

androidx.games:games-frame-pacing:2.1.0-rc01 がリリースされました。バージョン 2.1.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 2.1.0-beta01

2023 年 5 月 24 日

androidx.games:games-frame-pacing:2.1.0-beta01 がリリースされました。バージョン 2.1.0-beta01 に含まれる commit については、こちらをご覧ください

バグの修正

  • NDKChoreographer の初期化が失敗した場合のタイムアウト(ef466d
  • システムから明示的に SwappyGL_getSupportedRefreshPeriodsNS クエリの更新頻度を使用する場合(c85235

バージョン 2.1.0-alpha01

2023 年 4 月 5 日

androidx.games:games-frame-pacing:2.1.0-alpha01 がリリースされました。バージョン 2.1.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • フレーム ペーシング状態をリセットする新しい API。
  • CPU 時間と GPU 時間を監視しながら、Swappy のフレーム ペーシングの影響を無効にする新しい API を追加しました。

API の変更

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing を使用して内部フレーム ペーシング状態をリセットできるようになりました。フレーム ペーシングで、リセット API が呼び出された時点からのデータのみが考慮されるようになりました。
  • SwappyGL_enableFramePacing/SwappyVk_enableFramePacing を使用して、Swappy のフレーム ペーシングを有効または無効にできるようになりました。無効にすると、
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait を使用すると、フレーム ペーシングが無効になっている場合に、最後のフレームの GPU 処理のブロッキング待機が発生するかどうかを制御できます。

バグの修正

  • Swappy GL API を使用する場合、GPU でバインドされたケースのパフォーマンスが改善されました。

Games Frame Pacing バージョン 2.0

バージョン 2.0.0

2023 年 3 月 8 日

androidx.games:games-frame-pacing:2.0.0 がリリースされました。バージョン 2.0.0 に含まれる commit については、こちらをご覧ください

1.10.1 以降の重要な変更

  • ビルドシステムに大きな変更が行われ、SDK/NDK バージョンごとに複数のライブラリが生成されず、1 つのライブラリのみが生成されました。
  • Vulkan フレーム統計情報を追加しました。
  • フレーム統計情報をクリアするための新しい API が追加されました。
  • リリースモードではログはすべてサイレントになりますが、デバッグモードで有効にできます。

バージョン 2.0.0-rc01

2023 年 2 月 22 日

androidx.games:games-frame-pacing:2.0.0-rc01 がリリースされました。バージョン 2.0.0-rc01 に含まれる commit については、こちらをご覧ください

新機能

  • ロギングはコンパイル フラグによって非表示になりました。デフォルトでは、ライブラリのリリースビルドではロギングは行われず、ライブラリのデバッグ リリースではすべてのロギングがオンになっています。

バージョン 2.0.0-beta01

2023 年 2 月 8 日

androidx.games:games-frame-pacing:2.0.0-beta01 がリリースされました。バージョン 2.0.0-beta01 に含まれる commit については、こちらをご覧ください

新機能

  • フレーム統計情報をクリアする新しい API を導入しました。

API の変更

  • SwappyGL_clearStats API と SwappyGL_clearStats API を追加しました。

バージョン 2.0.0-alpha01

2023 年 1 月 11 日

androidx.games:games-frame-pacing:2.0.0-alpha01 がリリースされました。バージョン 2.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • Vulkan フレーム統計情報を追加しました。

API の変更

  • ビルドファイルのリファクタリングにより、メジャー バージョンを更新
  • 3 つの新しい API を追加: SwappyVk_enableStatsSwappyVk_recordFrameStartSwappyVk_getStats

バグの修正

  • 自動スワップモードの場合にのみ、しきい値を適用します。(Ic0786

Games Frame Pacing 1.10

バージョン 1.10.2-alpha01

2022 年 11 月 9 日

androidx.games:games-frame-pacing:1.10.2-alpha01 がリリースされました。バージョン 1.10.2-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • 新しい変更はありません

バージョン 1.10.1

2022 年 6 月 15 日

androidx.games:games-frame-pacing:1.10.1 がリリースされました。バージョン 1.10.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • 17 より大きく 23 より小さい ndk で swappy がビルドされない問題を修正しました。
  • ディスプレイでサポートされているリフレッシュ レートを取得するための API を公開しました。

バージョン 1.10.0

2022 年 2 月 23 日

androidx.games:games-frame-pacing:1.10.0 がリリースされました。バージョン 1.10.0 に含まれる commit については、こちらをご覧ください

1.9.0 以降の重要な変更

  • Choreographer のフィルタ入力の汚染を無視し、エミュレータのフリーズを防止するために滑らかさを改善
  • *_uninjectTracer 関数を追加。

バージョン 1.10.0-rc01

2022 年 2 月 9 日

androidx.games:games-frame-pacing:1.10.0-rc01 がリリースされました。バージョン 1.10.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.10.0-beta01

2022 年 1 月 26 日

androidx.games:games-frame-pacing:1.10.0-beta01 がリリースされました。バージョン 1.10.0-beta01 に含まれる commit については、こちらをご覧ください

バージョン 1.10.0-alpha01

2021 年 12 月 15 日

androidx.games:games-frame-pacing:1.10.0-alpha01 がリリースされました。バージョン 1.10.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • SwappyGL_uninjectTracer 関数を追加しました。

API の変更

  • SwappyGL_uninjectTracer(const SwappyTracer *t) API を使用することで、以前は SwappyGL_injectTracer を使用して追加されていたコールバックを削除しました。

Games Frame Pacing 1.9

バージョン 1.9.1

2021 年 10 月 13 日

androidx.games:games-frame-pacing:1.9.1 がリリースされました。バージョン 1.9.1 に含まれる commit については、こちらをご覧ください

バグの修正

バージョン 1.9.0

2021 年 7 月 12 日

androidx.games:games-frame-pacing:1.9.0 がリリースされました。バージョン 1.9.0 に含まれる commit については、こちらをご覧ください

1.7.0 以降の重要な変更

  • 内部のバージョニング スキームに合わせて更新しました。

Games Frame Pacing 1.7.0

バージョン 1.7.0

2021 年 6 月 30 日

androidx.games:games-frame-pacing:1.7.0 がリリースされました。バージョン 1.7.0 に含まれる commit については、こちらをご覧ください

バージョン 1.7.0-rc01

2021 年 6 月 2 日

androidx.games:games-frame-pacing:1.7.0-rc01 がリリースされました。バージョン 1.7.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 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 に含まれる commit については、こちらをご覧ください

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 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-rc01

2021 年 6 月 2 日

androidx.games:games-performance-tuner:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 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 Games ライブラリに変更されました。

androidx.gaming -> androidx.games

バージョン 1.0.0-alpha01

2020 年 6 月 10 日

androidx.games:1.0.0-alpha01 がリリースされました。