Android Games

Library game Android mencerminkan Android Game SDK yang tersedia sebagai download biner. Anda dapat menggunakan library androidx daripada mendownload dan mengintegrasikan Android Game SDK secara manual ke dalam build Anda.

Untuk mengetahui informasi selengkapnya tentang Android Game SDK, lihat dokumentasi SDK dan catatan rilis SDK.

Tabel ini mencantumkan semua artefak di grup androidx.games.

Artefak Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
games-activity 2.0.2 3.0.0-rc01 - -
games-controller 2.0.1 - - -
games-frame-pacing 2.1.0 - - -
games-memory-advice 2.0.1 - 2.1.0-beta01 -
games-text-input 2.0.0 3.0.0-rc01 - -
games-performance-tuner - - 2.0.0-beta01 -
Library ini terakhir diperbarui pada: 21 Februari 2024

Persyaratan

games-memory-advice

MemoryAdvice API mengharuskan aplikasi Anda dibuild dengan salah satu versi NDK berikut:

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

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada game, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda; library games-activity telah mengintegrasikan versi library game-text-input yang sama, sehingga aplikasi GameActivity tidak dapat menyertakan dependensi game-text-input lagi:

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:2.0.2"

    // 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:2.0.0"
}

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:2.0.2")

    // 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:2.0.0")
}
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Menambahkan properti Gradle

Anda mungkin perlu menambahkan properti ke file gradle.properties yang berada di direktori yang sama dengan file build.gradle aplikasi (atau modul). Jika file gradle.properties tidak ada, buat file ini.

Jika Anda menggunakan Android Studio 4.0, pastikan gradle.properties berisi baris berikut:

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Jika Anda menggunakan Android Studio 4.1 atau yang lebih baru, pastikan gradle.properties berisi baris berikut:

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Menambahkan paket dengan CMake

Agar paket SDK Game yang diimpor tersedia, tambahkan berikut ini ke file CMakeLists.txt aplikasi utama:

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

Ini akan memudahkan Anda untuk menyertakan file header dari Android Game SDK dalam kode game:

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

Di file CMakeLists.txt aplikasi utama, cari target_link_libraries untuk library utama yang digunakan bersama. Tambahkan referensi ke library statis Android Game SDK untuk menyertakannya dalam library bersama:

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Games-Memory-Advice versi 2.1

Versi 2.1.0-beta01

29 November 2023

androidx.games:games-memory-advice:2.1.0-beta01 dirilis. Versi 2.1.0-beta01 berisi commit ini.

Versi 2.1.0-alpha01

15 November 2023

androidx.games:games-memory-advice:2.1.0-alpha01 dirilis. Versi 2.1.0-alpha01 berisi commit ini.

Fitur Baru

  • Memperbarui model memori library untuk prediksi yang lebih baik.

Perubahan API

  • Menambahkan API baru getAvailableMemory() yang menampilkan perkiraan jumlah memori yang dapat dialokasikan dengan aman, dalam byte.

Versi 2.1.0-alpha01

26 Juli 2023

androidx.games:games-memory-advice:2.1.0-alpha01 dirilis. Versi 2.1.0-alpha01 berisi commit ini.

Perubahan API

  • Tambahkan fungsi GetAvailableMemory

Perbaikan Bug

  • Mengupdate model Memory Advice
  • Perbaiki target build memory_advice bersama

Games-Memory-Advice versi 2.0

Versi 2.0.1

20 September 2023

androidx.games:games-memory-advice:2.0.1 dirilis. Versi 2.0.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki error yang terjadi di thread watcher status karena thread tidak terpasang ke JVM.

Versi 2.0.0

6 September 2023

androidx.games:games-memory-advice:2.0.0 dirilis. Versi 2.0.0 berisi commit ini.

Fitur utama 2.0.0

  • Model ML baru telah dilatih dan dirilis dalam versi ini.
  • API untuk memprediksi jumlah memori bebas diterapkan.

Versi 2.0.0-rc01

26 Juli 2023

androidx.games:games-memory-advice:2.0.0-rc01 dirilis. Versi 2.0.0-rc01 berisi commit ini.

Fitur Baru

  • Menyertakan model baru untuk memprediksi sisa memori dengan lebih baik.

Perbaikan Bug

  • Saran Memori yang tidak berfungsi dengan STL bersama telah diperbaiki.

Versi 2.0.0-beta04

24 Mei 2023

androidx.games:games-memory-advice:2.0.0-beta04 dirilis. Versi 2.0.0-beta04 berisi commit ini.

Fitur Baru

  • Memperbarui model machine learning yang mendukung library sehingga memungkinkan hasil yang lebih baik untuk ponsel yang lebih baru

Versi 2.0.0-beta03

5 April 2023

androidx.games:games-memory-advice:2.0.0-beta03 dirilis. Versi 2.0.0-beta03 berisi commit ini.

Perbaikan Bug

  • Memperbaiki bug saat library tidak dapat memuat aset tensorflow lite yang diperlukan dengan benar

Versi 2.0.0-beta02

22 Maret 2023

androidx.games:games-memory-advice:2.0.0-beta02 dirilis. Versi 2.0.0-beta02 berisi commit ini.

Perbaikan Bug

  • Memperbaiki bug yang mencegah library versi statis ditautkan dengan benar

Versi 2.0.0-beta01

22 Februari 2023

androidx.games:games-memory-advice:2.0.0-beta01 dirilis. Versi 2.0.0-beta01 berisi commit ini.

Fitur Baru

  • Tidak ada perubahan baru

Versi 2.0.0-alpha01

8 Februari 2023

androidx.games:games-memory-advice:2.0.0-alpha01 dirilis. Versi 2.0.0-alpha01 berisi commit ini.

Perubahan API

  • Peningkatan versi utama karena pemfaktoran ulang file build.

Perbaikan Bug

  • Konfigurasi aset library yang salah kini menampilkan error, bukan tidak bekerja.

Games-Memory-Advice versi 1.0.0

Versi 1.0.0-beta03

9 November 2022

androidx.games:games-memory-advice:1.0.0-beta03 dirilis. Versi 1.0.0-beta03 berisi commit berikut ini.

Fitur Baru

  • Tidak ada perubahan baru

Versi 1.0.0-beta01

9 Maret 2022

androidx.games:games-memory-advice:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

  • Tidak ada perubahan sejak versi 1.0.0-alpha01.

Versi 1.0.0-alpha01

23 Februari 2022

androidx.games:games-memory-advice:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Library C ini memberikan fasilitas untuk membuat kueri dan menerima callback untuk perubahan status memori perangkat yang menjalankan game.

Perubahan API

  • Ini adalah rilis awal dari library memory advice. Lihat header di include/memory_advice/memory_advice.h untuk API lengkapnya.

Kontribusi Eksternal

Games-Activity Versi 3.0

Versi 3.0.0-rc01

21 Februari 2024

androidx.games:games-activity:3.0.0-rc01 dan androidx.games:games-text-input:3.0.0-rc01 dirilis. Versi 3.0.0-rc01 berisi commit ini.

Perbaikan Bug

  • Memperbaiki pembekuan saat peristiwa keyboard tidak ditangani dengan benar oleh looper.

Versi 3.0.0-beta01

29 November 2023

androidx.games:games-activity:3.0.0-beta01 dan androidx.games:games-text-input:3.0.0-beta01 dirilis. Versi 3.0.0-beta01 berisi commit ini.

Versi 3.0.0-alpha01

15 November 2023

androidx.games:games-activity:3.0.0-alpha01 dan androidx.games:games-text-input:3.0.0-alpha01 dirilis. Versi 3.0.0-alpha01 berisi commit ini.

Perubahan API

  • Struktur GameActivityMotionEvent dan GameActivityCallbacks mengubah ukurannya.
  • onEditorAction mengubah jenis nilai yang ditampilkan dari boolean menjadi void.
  • setImeEditorInfo kini mengharapkan parameter enum, bukan bilangan bulat.
  • fungsi internal GameActivityEvents dipindahkan ke GameActivityEvents_internal.h.
  • Jenis input GameTextInput juga berupa enumerasi, bukan bilangan bulat.

Games-Activity Versi 2.1

Versi 2.1.0-alpha02

6 September 2023

androidx.games:games-activity:2.1.0-alpha02 dan androidx.games:games-text-input:2.1.0-alpha02 dirilis. Versi 2.1.0-alpha02 berisi commit ini.

Perbaikan Bug

  • Kompatibilitas perangkat 32 bit telah ditingkatkan.

Versi 2.1.0-alpha01

26 Juli 2023

androidx.games:games-activity:2.1.0-alpha01 dirilis. Versi 2.1.0-alpha01 berisi commit ini.

Fitur Baru

  • Memberikan kemampuan untuk mengganti pembuatan instance SurfaceView
  • Menambahkan pelaporan versi SDK

Perubahan API

  • Gunakan int64_t, bukan long untuk historicalEventTimes agar tidak berlebihan pada sistem 32bit
  • Menambahkan metode GameActivity_restartInput
  • Menambahkan callback native untuk menangani perubahan visibilitas keyboard software

Perbaikan Bug

  • Mengoptimalkan penanganan peristiwa sentuh
  • Memperbaiki penghancuran GameActivityMotionEven
  • Perbaiki penghitungan indeks GameActivityMotionEvent_getHistoricalAxisValue
  • Memperbaiki bitmask untuk filter gerakan

Games-Activity Versi 2.0

Versi 2.0.2

24 Mei 2023

androidx.games:games-activity:2.0.2 dirilis. Versi 2.0.2 berisi commit ini.

Perbaikan Bug

  • Perbaikan stabilitas di GameActivityEvents (b/278017467)

Versi 2.0.1

5 April 2023

androidx.games:games-activity:2.0.1 dirilis. Versi 2.0.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki pengosongan memori awal dengan historicalEventTimes.
  • Memperbaiki masalah terkait historicalEventTimesNanos yang melebihi sistem 32bit

Versi 2.0.0

8 Maret 2023

androidx.games:games-activity:2.0.0 dirilis. Versi 2.0.0 berisi commit ini.

Fitur utama 2.0.0

  • Mengubah antarmuka untuk waktu peristiwa historis untuk mengatasi batas 32 bit.
  • Memberi pengguna akses ke perubahan konfigurasi, seperti orientasi.
  • Memberikan informasi terbaru dalam struktur contentRect.
  • Memberikan cara yang lebih mudah untuk menyesuaikan SurfaceView default.
  • Memperbaiki penanganan peristiwa sentuh default oleh OS, seperti menangani tombol sistem.
  • Mengoptimalkan sebagian besar panggilan JNI dalam penanganan peristiwa sentuh; hal ini digunakan untuk memengaruhi performa.

Versi 2.0.0-rc01

22 Februari 2023

androidx.games:games-activity:2.0.0-rc01 dirilis. Versi 2.0.0-rc01 berisi commit ini.

Versi 2.0.0-beta01

8 Februari 2023

androidx.games:games-activity:2.0.0-beta01 dirilis. Versi 2.0.0-beta01 berisi commit ini.

Perbaikan Bug

  • Memperbaiki penanganan tombol sistem. (2a103e)

Versi 2.0.0-alpha01

11 Januari 2023

androidx.games:games-activity:2.0.0-alpha01 dirilis tanpa perubahan. Versi 2.0.0-alpha01 berisi commit ini.

Games-Activity Versi 1.2

Versi 1.2.2

7 Desember 2022

androidx.games:games-activity:1.2.2 dirilis. Versi 1.2.2 berisi commit ini.

Perbaikan Bug

  • Jumlah maksimum peristiwa gerakan kini dapat disetel saat runtime.

Versi 1.2.2-alpha01

9 November 2022

androidx.games:games-activity:1.2.2-alpha01 dirilis. Versi 1.2.2-alpha01 berisi commit ini.

Perubahan API

  • API kini juga berisi informasi versi dalam bentuk GAMEACTIVITY_PACKED_VERSION. (I287e6)
  • Menambahkan callback onContentRectChanged yang dipanggil saat persegi di jendela tempat konten harus ditempatkan telah berubah. (I81396)

Perbaikan Bug

  • Memperbaiki overflow buffering peristiwa. Baik inputBuffer->keyEvents maupun motionEvents kini merupakan buffering yang dialokasikan secara dinamis. (Ic00f6)
  • Gagal dengan baik jika kehabisan memori. Menambahkan penanganan error realloc() selama pengubahan ukuran buffering.

Versi 1.2.1

13 Juli 2022

androidx.games:games-activity:1.2.1 dirilis. Versi 1.2.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki masalah pada file .aar yang tidak ada dalam rilis sebelumnya.

Versi 1.2.0

15 Juni 2022

androidx.games:games-activity:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Perubahan penting sejak 1.1.0

  • Mengizinkan class turunan GameActivity menangani pemuatan library native.
  • Selalu memuat library native di GameActivity.onCreate.
  • Penggantian ke library pemuatan dengan nama "main" jika library lain tidak ditemukan.

Games-Activity Versi 1.1

Versi 1.1.0

23 Februari 2022

androidx.games:games-activity:1.1.0 dan androidx.games:games-controller:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan penting sejak versi 1.0.0

Aktivitas Game:

  • WindowInsets memproses dan membuat kueri untuk notch dan respons IME
  • Menambahkan filter peristiwa tombol dan gerakan
  • Perbaikan bug:
    • Menambahkan pesan yang hilang untuk kompatibilitas dengan NativeActivity
    • Memperbaiki tanda tangan onNativeWindowResized
    • Memperbaiki kerugian peristiwa input

Versi 1.1.0-rc01

9 Februari 2022

androidx.games:games-activity:1.1.0-rc01 dan androidx.games:games-controller:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit ini.

Versi 1.1.0-beta03

26 Januari 2022

androidx.games:games-activity:1.1.0-beta03 dirilis. Versi 1.1.0-beta03 berisi commit ini.

Perbaikan Bug

  • Memperbaiki tanda tangan onNativeWindowResized
  • Mempertahankan handle ke jendela native di onSurfaceChanged

Versi 1.1.0-beta02

15 Desember 2021

androidx.games:games-activity:1.1.0-beta02 dirilis. Versi 1.1.0-beta02 berisi commit ini.

Perbaikan Bug

  • Memperbaiki kondisi race dalam setelan filter peristiwa.

Versi 1.1.0-beta01

17 November 2021

androidx.games:games-activity:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit ini.

Fitur Baru

  • Menambahkan dukungan untuk mengkueri inset jendela dan memproses perubahan inset. Dukungan ini memungkinkan game merespons pop-up IME dan mengatasi inset potongan kamera dan waterfall.

Perubahan API

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

Perbaikan Bug

  • Mengindari pemakaian semua peristiwa tombol: volume, kamera, dll. kini diteruskan ke sistem.

Versi 1.1.0-alpha01

29 September 2021

androidx.games:games-activity:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perubahan API

  • Callback onContentRectChanged ditambahkan ke GameActivityCallbacks

Perbaikan Bug

  • Pesan yang hilang ditambahkan ke android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

Versi 2.0.0-beta01

10 Januari 2024

androidx.games:games-performance-tuner:2.0.0-beta01 dirilis tanpa perubahan dari rilis alfa terakhir. Versi 2.0.0-beta01 berisi commit ini.

Versi 2.0.0-alpha07

29 November 2023

androidx.games:games-performance-tuner:2.0.0-alpha07 dirilis. Versi 2.0.0-alpha07 berisi commit ini.

Perbaikan Bug

  • Memperbaiki pelaporan telemetri memori yang terkadang melaporkan nilai yang salah

Versi 2.0.0-alpha06

1 November 2023

androidx.games:games-performance-tuner:2.0.0-alpha06 dirilis. Versi 2.0.0-alpha06 berisi commit ini.

Versi 2.0.0-alpha05

23 Agustus 2023

androidx.games:games-performance-tuner:2.0.0-alpha05 dirilis. Versi 2.0.0-alpha05 berisi commit ini.

Fitur Baru

  • Memigrasikan library Protobuf ke Protobuf lite.

Perbaikan Bug

  • Memperbaiki masalah terkait pointer yang terputus.

Versi 2.0.0-alpha04

19 April 2023

androidx.games:games-performance-tuner:2.0.0-alpha04 dirilis. Versi 2.0.0-alpha04 berisi commit ini.

Fitur Baru

  • Memperbarui fitur pengumpulan telemetri di library, sehingga memungkinkan pelaporan waktu rendering frame yang lebih terperinci.

Perbaikan Bug

  • Memperbaiki bug saat library mengalami error jika kunci instrumentasi maksimum lebih dari jumlah histogram.

Versi 2.0.0-alpha03

22 Februari 2023

androidx.games:games-performance-tuner:2.0.0-alpha03 dirilis. Versi 2.0.0-alpha03 berisi commit ini.

Perbaikan Bug

  • Games-Performance-Tuner telah dipindahkan ke proses rilis baru. Seharusnya tidak ada perubahan perilaku.

Versi 2.0.0-alpha02

8 Februari 2023

androidx.games:games-performance-tuner:2.0.0-alpha02 dirilis. Versi 2.0.0-alpha02 berisi commit ini.

Perubahan API

  • TuningFork_predictQualityLevels API ditambahkan; yang akan membantu memprediksi tingkat kualitas/parameter fidelitas yang benar untuk digunakan.

Games Performance Tuner 1.6

Versi 1.6.1-alpha01

9 November 2022

androidx.games:games-performance-tuner:1.6.1-alpha01 dirilis. Versi 1.6.1-alpha01 berisi commit ini.

Fitur Baru

  • Tidak ada perubahan baru

Versi 1.6.0

15 Juni 2022

androidx.games:games-performance-tuner:1.6.0 dirilis. Versi 1.6.0 berisi commit ini.

Perubahan penting sejak versi 1.5.0

  • Memperbaiki getpid yang menampilkan 0 saat mencoba mendapatkan telemetri memori.
  • Menghentikan StopLoadingGroup agar tidak dieksekusi tanpa grup pemuatan aktif.

Games Performance Tuner 1.5.0

Versi 1.5.0

9 Februari 2022

androidx.games:games-performance-tuner:1.5.0 dirilis. Versi 1.5.0 berisi commit ini.

Perubahan penting sejak versi 1.4.0

  • Perubahan interval antar-upload secara terprogram, bukan hard code di setelan awal.
    • Menambahkan fungsi: TuningFork_setAggregationStrategyInterval
  • Perbaikan kerusakan memori pada kunci API di API<=23

Versi 1.5.0-rc01

26 Januari 2022

androidx.games:games-performance-tuner:1.5.0-rc01 dirilis. Versi 1.5.0-rc01 berisi commit ini.

Perbaikan Bug

  • Perbaikan kerusakan memori pada kunci API di API<=23

Versi 1.5.0-beta02

15 Desember 2021

androidx.games:games-performance-tuner:1.5.0-beta02 dirilis. Versi 1.5.0-beta02 berisi commit ini.

Perubahan API

  • Menghapus perubahan yang dapat menyebabkan gangguan pada ABI dari TuningFork_Settings.

Versi 1.5.0-beta01

29 September 2021

androidx.games:games-performance-tuner:1.5.0-beta01 dirilis. Versi 1.5.0-beta01 berisi commit ini.

Fitur Baru

  • Tidak ada perubahan dari rilis alfa. Rilis tersebut memiliki:
    • Perubahan interval antar-upload secara terprogram, bukan hard code di setelan awal.

Perubahan API

  • Tidak ada perubahan dari rilis alfa. Rilis tersebut memiliki:
    • Fungsi baru: TuningFork_setAggregationStrategyInterval
    • Kolom baru di TuningFork_Settings: aggregation_strategy_intervalms_or_count

Versi 1.5.0-alpha01

18 Agustus 2021

androidx.games:games-performance-tuner:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit ini.

Fitur Baru

  • Kini Anda dapat menetapkan interval antar upload APT secara terprogram, bukan menggunakan file setelan.

Perubahan API

  • Menambahkan fungsi: TuningFork_setAggregationStrategyInterval
  • Menambahkan kolom ke struktur TuningFork_Settings: aggregation_strategy_intervalms_or_count

Games-Activity Versi 1.0.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-activity:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

  • Memperbaiki jenis nilai yang ditampilkan GameActivityCallbacks::onSaveInstanceState

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-activity:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

  • Mengganti nama GameActivityInputInfo menjadi GameActivityPointerAxes.
  • Callback onNativeWindowResized kini memberikan lebar dan tinggi jendela.
  • Callback onContentRectChanged telah dihapus.
  • onLowMemory diganti namanya menjadi onTrimMemory.
  • GameActivity_setWindowFormat dihapus.
  • Meningkatkan model kepemilikan untuk pointer GameActivityMotionEvents dan GameActivityMotionEvent.
  • Meningkatkan model kepemilikan status pengguna di callback onSaveInstanceState.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-activity:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Activity adalah library baru yang menggantikan NativeActivity sebagai cara yang direkomendasikan untuk mengintegrasikan game C/C++ dengan Android.

Games-Controller Versi 2.0.

Versi 2.0.1

20 September 2023

`androidx.games: games-controller: 2.0.1 ' dirilis. Versi 2.0.1 berisi commit ini.

Perbaikan Bug Pengontrol Game:

  • Memperbaiki kondisi NullReferenceException yang langka di pengendali onInputDeviceChanged.
  • Perbaiki peringatan agar keyboard USB tertentu tidak terdaftar dengan benar sebagai pengontrol game.

Versi 2.0.0

8 Maret 2023

androidx.games:games-controller:2.0.0 dirilis. Versi 2.0.0 berisi commit ini.

Fitur utama 2.0.0

  • Penambahan kemampuan untuk mendeteksi status koneksi keyboard hardware.
  • Menambahkan kemampuan untuk melaporkan data gerakan (akselerometer/giroskop) dari perangkat utama (yaitu handset) serta pengontrol.
  • Mengubah API dan format untuk database definisi pengontrol guna mengurangi footprint memori dan mendukung fitur tambahan.

Versi 2.0.0-alpha01

11 Januari 2023

androidx.games:games-controller:2.0.0-alpha01 dirilis. Versi 2.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Deteksi keyboard hardware
  • Dukungan pelaporan data gerakan sensor terintegrasi (yaitu menerima data giroskop dan akselerometer dari ponsel itu sendiri)
  • Format data pemetaan pengontrol baru yang dioptimalkan

Perubahan API

  • Panggilan API baru untuk keyboard hardware: Paddleboat_getPhysicalKeyboardStatus dan Paddleboat_setPhysicalKeyboardStatusCallback
  • Panggilan API baru untuk pelaporan data gerakan sensor terintegrasi: Paddleboat_getIntegratedMotionSensorFlags dan Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • Panggilan API baru untuk format data pemetaan pengontrol yang direvisi: Paddleboat_addControllerRemapDataFromFd,Paddleboat_addControllerRemapDataFromFileBuffer
  • Menghentikan penggunaan panggilan API pemetaan lama: Paddleboat_addControllerRemapData dan Paddleboat_getControllerRemapTableData

Perbaikan Bug

  • Memperbaiki masalah kompatibilitas dengan peristiwa gerakan dari GameActivity 1.2.2 dan yang lebih tinggi

Games-Controller Versi 1.1.0

Versi 1.1.0

23 Februari 2022

androidx.games:games-activity:1.1.0 dan androidx.games:games-controller:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan penting sejak versi 1.0.0

Aktivitas Game:

  • WindowInsets memproses dan membuat kueri untuk notch dan respons IME
  • Menambahkan filter peristiwa tombol dan gerakan
  • Perbaikan bug:
    • Menambahkan pesan yang hilang untuk kompatibilitas dengan NativeActivity
    • Memperbaiki tanda tangan onNativeWindowResized
    • Memperbaiki kerugian peristiwa input

Versi 1.1.0-rc01

9 Februari 2022

androidx.games:games-controller:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit ini.

Versi 1.1.0-beta01

26 Januari 2022

androidx.games:games-controller:1.1.0-beta01 dirilis tanpa perubahan sejak 1.1.0-alpha01. Versi 1.1.0-beta01 berisi commit ini.

Versi 1.1.0-alpha01

15 Desember 2021

androidx.games:games-controller:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Fitur Baru

Menambahkan dukungan untuk status baterai, getaran motor ganda, kontrol lampu, dan pelaporan sumbu gerakan pada pengontrol yang didukung saat berjalan di Android S atau yang lebih tinggi.

Perubahan API

  • Menambahkan fungsi Paddleboat_setMotionDataCallback untuk mendaftarkan callback data gerakan pengontrol
  • Menambahkan fungsi Paddleboat_setControllerLight untuk mengubah setelan lampu pengontrol.
  • Menambahkan struktur Paddleboat_Controller_Battery ke Paddleboat_Controller_Data
  • Struktur baru:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Enum baru:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Tanda pengontrol baru:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Perbaikan Bug

  • Menambahkan entri database deviceId alternatif untuk pengontrol PS4
  • Menambahkan entri database API >=31 untuk pengontrol PS5

Games-Controller Versi 1.0.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc02

21 Juli 2021

androidx.games:games-controller:1.0.0-rc02 dirilis. Versi 1.0.0-rc02 berisi commit ini.

Perbaikan Bug

  • Memperbaiki error pemaketan yang menyebabkan impor Prefab gagal pada permutasi arsitektur/versi yang kosong dan tidak digunakan.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-controller:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

  • Memperbaiki masalah kompatibilitas dengan GameActivity terbaru

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-controller:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

  • Fungsi yang menampilkan boolean berhasil atau gagal sekarang menampilkan enum Paddleboat_Error_Code.
  • Mengganti nama Paddleboat_onPause menjadi Paddleboat_onStop
  • Mengganti nama Paddleboat_onResume menjadi Paddleboat_onStart
  • Paddleboat_processGameActivityEvent dibagi menjadi dua fungsi: Paddleboat_processGameActivityKeyInputEvent dan Paddleboat_processGameActivityMotionInputEvent
  • Menghapus fitur pengontrol tambahan yang diperlukan untuk build dengan pratinjau Android S SDK
  • Menambahkan fungsi Paddleboat_getBackButtonConsumed
  • Pengontrol dan callback status mouse sekarang memiliki parameter opsional dari pointer ke data yang ditentukan pengguna
  • Mengeluarkan string nama pengontrol dari struktur info perangkat, sekarang diakses melalui fungsi Paddleboat_getControllerName

Perbaikan Bug

  • Memperbaiki masalah dengan pengontrol yang awalnya tidak melaporkan dirinya sendiri sebagai pengontrol, tetapi kemudian melaporkannya melalui pesan onInputDeviceChanged, yang tidak terdeteksi dengan benar sebagai koneksi pengontrol.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-controller:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Controller adalah library baru yang menyediakan C API untuk mendeteksi, membaca input, dan berinteraksi dengan perangkat pengontrol game.

Game-Teks-Input 2.1

Versi 2.1.0-alpha01

26 Juli 2023

androidx.games:games-text-input:2.1.0-alpha01 dirilis. Versi 2.1.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan dukungan mode multi-baris dan satu baris

Perubahan API

  • Menambahkan fungsi isSoftwareKeyboardVisible
  • Menambahkan definisi bitfield untuk GameActivity_setImeEditorInfo
  • Tambahkan callback onEditorAction

Perbaikan Bug

  • Perbaikan untuk keyboard hardware dan software yang tidak sinkron
  • Hapus fokus saat keyboard virtual disembunyikan

Game-Teks-Input 2.0

Versi 2.0.0

8 Maret 2023

androidx.games:games-text-input:2.0.0 dirilis. Versi 2.0.0 berisi commit ini.

Perubahan penting sejak 1.1.1

  • Update versi utama karena perubahan pada sistem build, tidak ada update untuk library/API itu sendiri.

Games-Text-Input Versi 1.1

Versi 1.1.2-alpha01

9 November 2022

androidx.games:games-text-input:1.1.2-alpha01 dirilis. Versi 1.1.2-alpha01 berisi commit ini.

Fitur Baru

  • Tidak ada perubahan baru

Versi 1.1.1

13 Juli 2022

androidx.games:games-text-input:1.1.1 dirilis. Versi 1.1.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki masalah pada file .aar yang tidak ada dalam rilis sebelumnya.

Versi 1.1.0

9 Februari 2022

androidx.games:games-text-input:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan penting sejak versi 1.0.0 - Menambahkan fungsi pemrosesan dan kueri WindowInsets ke GameTextInput - Menambahkan header gamecommon.h yang hilang

Versi 1.1.0-rc01

26 Januari 2022

androidx.games:games-text-input:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit ini.

Versi 1.1.0-beta01

15 Desember 2021

androidx.games:games-text-input:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit ini.

Perbaikan Bug

  • Memperbaiki inset waterfall dan IME
  • Menambahkan header gamecommon.h yang tidak ada

Versi 1.1.0-alpha01

13 Oktober 2021

androidx.games:games-text-input:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perubahan API

  • Menambahkan fungsionalitas inset IME ke GameTextInput

Games-Text-Input Versi 1.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-text-input:1.0.0-rc01 dirilis tanpa perubahan. Versi 1.0.0-rc01 berisi commit berikut ini.

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-text-input:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

  • Meningkatkan model kepemilikan objek GameTextInputState.
  • Merapikan jenis agar konsisten dengan NDK.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-text-input:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Text-Input adalah library baru untuk membantu developer game menggunakan input keyboard virtual Android dari C/C ++.

Games Frame Pacing Versi 2.1

Versi 2.1.0

15 November 2023

androidx.games:games-frame-pacing:2.1.0 dirilis. Versi 2.1.0 berisi commit ini.

Versi 2.1.0-rc01

20 September 2023

androidx.games:games-frame-pacing:2.1.0-rc01 dirilis. Versi 2.1.0-rc01 berisi commit ini.

Versi 2.1.0-beta01

24 Mei 2023

androidx.games:games-frame-pacing:2.1.0-beta01 dirilis. Versi 2.1.0-beta01 berisi commit ini.

Perbaikan Bug

  • Waktu tunggu jika inisialisasi NDKChoreographer gagal (ef466d)
  • Saat menggunakan kecepatan refresh kueri SwappyGL_getSupportedRefreshPeriodsNS secara eksplisit dari sistem (c85235)

Versi 2.1.0-alpha01

5 April 2023

androidx.games:games-frame-pacing:2.1.0-alpha01 dirilis. Versi 2.1.0-alpha01 berisi commit ini.

Fitur Baru

  • API baru untuk mereset status kecepatan frame.
  • API baru untuk menonaktifkan dampak kecepatan frame swappy sambil tetap mengamati waktu CPU & GPU.

Perubahan API

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing sekarang dapat digunakan untuk mereset status kecepatan frame internal. Pengaturan kecepatan frame sekarang hanya akan mempertimbangkan data dari titik saat API reset dipanggil.
  • SwappyGL_enableFramePacing/SwappyVk_enableFramePacing kini dapat digunakan untuk mengaktifkan/menonaktifkan kecepatan frame swappy. Jika dinonaktifkan,
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait dapat digunakan untuk mengontrol apakah waktu tunggu pemblokiran pekerjaan GPU frame terakhir terjadi saat kecepatan frame dinonaktifkan.

Perbaikan Bug

  • Peningkatan performa dibuat untuk kasus yang terikat GPU saat menggunakan Swappy GL API.

Games Frame Pacing Versi 2.0

Versi 2.0.0

8 Maret 2023

androidx.games:games-frame-pacing:2.0.0 dirilis. Versi 2.0.0 berisi commit ini.

Perubahan penting sejak versi 1.10.1

  • Sistem build mengalami perubahan besar yang menghasilkan hanya satu library yang dihasilkan, bukan beberapa library per versi SDK/NDK.
  • Statistik Frame Vulkan ditambahkan.
  • API baru untuk menghapus statistik frame telah ditambahkan.
  • Semua log tidak berubah dalam mode rilis dan dapat diaktifkan dalam mode debug.

Versi 2.0.0-rc01

22 Februari 2023

androidx.games:games-frame-pacing:2.0.0-rc01 dirilis. Versi 2.0.0-rc01 berisi commit ini.

Fitur Baru

  • Logging kini disembunyikan di balik flag kompilasi. Secara default, build rilis library tidak memiliki logging, dan rilis debug library mengaktifkan semua logging.

Versi 2.0.0-beta01

8 Februari 2023

androidx.games:games-frame-pacing:2.0.0-beta01 dirilis. Versi 2.0.0-beta01 berisi commit ini.

Fitur Baru

  • API baru diperkenalkan untuk menghapus statistik frame.

Perubahan API

  • Menambahkan SwappyGL_clearStats API dan SwappyGL_clearStats API.

Versi 2.0.0-alpha01

11 Januari 2023

androidx.games:games-frame-pacing:2.0.0-alpha01 dirilis. Versi 2.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan statistik frame vulkan

Perubahan API

  • Peningkatan versi utama karena pemfaktoran ulang file build
  • Menambahkan 3 API baru: SwappyVk_enableStats, SwappyVk_recordFrameStart, dan SwappyVk_getStats

Perbaikan Bug

  • Hanya terapkan nilai minimum dalam mode pertukaran otomatis (Ic0786)

Games Frame Pacing 1.10

Versi 1.10.2-alpha01

9 November 2022

androidx.games:games-frame-pacing:1.10.2-alpha01 dirilis. Versi 1.10.2-alpha01 berisi commit ini.

Fitur Baru

  • Tidak ada perubahan baru

Versi 1.10.1

15 Juni 2022

androidx.games:games-frame-pacing:1.10.1 dirilis. Versi 1.10.1 berisi commit ini.

Perbaikan Bug

  • Perbaikan untuk Swappy yang tidak mem-build dengan ndk <23 dan >17.
  • Mengekspos API untuk mengambil kecepatan refresh yang didukung oleh layar.

Versi 1.10.0

23 Februari 2022

androidx.games:games-frame-pacing:1.10.0 dirilis. Versi 1.10.0 berisi commit ini.

Perubahan penting sejak 1.9.0

  • Mengabaikan input filter koreografer yang mencemari dan melancarkan lebih banyak untuk mencegah error pada emulator
  • Menambahkan fungsi *_uninjectTracer.

Versi 1.10.0-rc01

9 Februari 2022

androidx.games:games-frame-pacing:1.10.0-rc01 dirilis. Versi 1.10.0-rc01 berisi commit ini.

Versi 1.10.0-beta01

26 Januari 2022

androidx.games:games-frame-pacing:1.10.0-beta01 dirilis. Versi 1.10.0-beta01 berisi commit ini.

Versi 1.10.0-alpha01

15 Desember 2021

androidx.games:games-frame-pacing:1.10.0-alpha01 dirilis. Versi 1.10.0-alpha01 berisi commit ini.

Fitur Baru

  • Penambahan fungsi SwappyGL_uninjectTracer.

Perubahan API

  • Menghapus callback yang sebelumnya ditambahkan menggunakan SwappyGL_injectTracer dengan menggunakan SwappyGL_uninjectTracer(const SwappyTracer *t) API.

Games Frame Pacing 1.9

Versi 1.9.1

13 Oktober 2021

androidx.games:games-frame-pacing:1.9.1 dirilis. Versi 1.9.1 berisi commit ini.

Perbaikan Bug

Versi 1.9.0

12 Juli 2021

androidx.games:games-frame-pacing:1.9.0 dirilis. Versi 1.9.0 berisi commit ini.

Perubahan penting sejak versi 1.7.0

  • Diupdate agar cocok dengan skema pembuatan versi internal.

Games Frame Pacing 1.7.0

Versi 1.7.0

30 Juni 2021

androidx.games:games-frame-pacing:1.7.0 dirilis. Versi 1.7.0 berisi commit ini.

Versi 1.7.0-rc01

2 Juni 2021

androidx.games:games-frame-pacing:1.7.0-rc01 dirilis. Versi 1.7.0-rc01 berisi commit berikut ini.

Versi 1.7.0-beta02

24 Februari 2021

androidx.games:games-frame-pacing:1.7.0-beta02 dirilis.

Versi 1.7.0-beta01

16 Desember 2020

androidx.games:games-frame-pacing:1.7.0-beta01 dirilis.

Games Performance Tuner 1.4.3

Versi 1.4.3

12 Juli 2021

androidx.games:games-performance-tuner:1.4.3 dirilis. Versi 1.4.3 berisi commit ini.

Perubahan penting sejak 1.1.0

  • Diupdate agar cocok dengan skema pembuatan versi internal.

Games Performance Tuner 1.1.0

Versi 1.1.0

30 Juni 2021

androidx.games:games-performance-tuner:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Versi 1.1.0-rc01

2 Juni 2021

androidx.games:games-performance-tuner:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit berikut ini.

Versi 1.1.0-beta03

21 April 2021

androidx.games:games-performance-tuner:1.1.0-beta03 dirilis.

Versi 1.1.0-beta02

24 Februari 2021

androidx.games:games-performance-tuner:1.1.0-beta02 dirilis.

Versi 1.1.0-beta01

16 Desember 2020

androidx.games:games-performance-tuner:1.1.0-beta01 dirilis.

Versi 1.1.0-alpha01

androidx.games:games-performance-tuner:1.1.0-alpha01 dirilis.

Versi 1.0.0

Versi 1.0.0-alpha02

12 Agustus 2020

Library Android Gaming diganti namanya menjadi library Android Games.

androidx.gaming -> androidx.games

Versi 1.0.0-alpha01

10 Juni 2020

androidx.games:1.0.0-alpha01 dirilis.