Giochi Android

La libreria di giochi Android rispecchia l'SDK Android Game, disponibile come download binario. Puoi usare la libreria Androidx invece di scaricare e integrare manualmente l'SDK Android Game nella tua build.

Per ulteriori informazioni sull'SDK Android Game, consulta la documentazione relativa all'SDK e le note di rilascio dell'SDK.

Questa tabella elenca tutti gli artefatti nel gruppo androidx.games.

Elemento Release stabile Candidato per la release Versione beta Release alpha
attività-di-giochi 2.0.2 3.0.0-rc01 - -
controller-giochi 2.0.1 - - -
frequenza frame dei giochi 2.1.0 - - -
giochi-consigli-memoria-dei-giochi 2.0.1 - 2.1.0-beta01 -
giochi-input-testo 2.0.0 3.0.0-rc01 - -
sintonizzatore-prestazioni giochi - - 2.0.0-beta01 -
Ultimo aggiornamento di questa raccolta: 21 febbraio 2024

Requisiti

consigli-memoria-giochi

L'API MemoryAdvice richiede che l'applicazione venga creata con una delle seguenti versioni NDK:

  • r20.*
  • R21.*
  • R23.*

Dichiarazione delle dipendenze

Per aggiungere una dipendenza al gioco, devi aggiungere il Repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per l'app o il modulo. La libreria games-activity ha integrato la stessa versione della libreria game-text-input, pertanto le app GameActivity non possono includere di nuovo la dipendenza game-text-input:

Trendy

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")
}
}

Per ulteriori informazioni sulle dipendenze, vedi Aggiungere dipendenze build.

Aggiungere proprietà Gradle

Potresti dover aggiungere proprietà al file gradle.properties che si trova nella stessa directory del file build.gradle dell'app (o del modulo). Se il file gradle.properties non esiste, crea questo file.

Se usi Android Studio 4.0, assicurati che gradle.properties contenga le seguenti righe:

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

Se utilizzi Android Studio 4.1 o versioni successive, assicurati che gradle.properties contenga le seguenti righe:

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

Aggiungi pacchetti con CMake

Per rendere disponibili i pacchetti dell'SDK Game importati, aggiungi quanto segue al file CMakeLists.txt dell'app principale:

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

Ciò ti consentirà di includere nel tuo codice di gioco i file di intestazione dell'SDK Android Game:

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

Nel file CMakeLists.txt dell'app principale, trova target_link_libraries per la raccolta condivisa principale. Aggiungi i riferimenti alle librerie statiche dell'SDK Android Game per includerli nella libreria condivisa:

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

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se rilevi nuovi problemi o hai idee per migliorare la libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne una nuova. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Giochi-Memoria-Consiglio versione 2.1

Versione 2.1.0-beta01

29 novembre 2023

androidx.games:games-memory-advice:2.1.0-beta01 viene rilasciato. La versione 2.1.0-beta01 contiene questi commit.

Versione 2.1.0-alpha01

15 novembre 2023

androidx.games:games-memory-advice:2.1.0-alpha01 viene rilasciato. La versione 2.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Aggiornamento del modello di memoria della libreria per previsioni migliori.

Modifiche alle API

  • È stata aggiunta una nuova API getAvailableMemory() che restituisce una stima della quantità di memoria che può essere allocata in modo sicuro, in byte.

Versione 2.1.0-alpha01

26 luglio 2023

androidx.games:games-memory-advice:2.1.0-alpha01 viene rilasciato. La versione 2.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • Aggiungi funzione GetAvailableMemory

Correzioni di bug

  • Aggiorna modello di consiglio per la memoria
  • Correggi il target di build memory_advice condiviso

Giochi-Memoria-Consiglio versione 2.0

Versione 2.0.1

20 settembre 2023

androidx.games:games-memory-advice:2.0.1 viene rilasciato. La versione 2.0.1 contiene questi commit.

Correzioni di bug

  • Risolvi l'arresto anomalo che si verificava nel thread dell'osservatore di stato perché quest'ultimo non era collegato alla JVM.

Versione 2.0.0

6 settembre 2023

androidx.games:games-memory-advice:2.0.0 viene rilasciato. La versione 2.0.0 contiene questi commit.

Funzionalità principali della versione 2.0.0

  • In questa versione è stato addestrato e rilasciato un nuovo modello ML.
  • Un'API per prevedere la quantità di memoria libera viene implementata.

Versione 2.0.0-rc01

26 luglio 2023

androidx.games:games-memory-advice:2.0.0-rc01 viene rilasciato. La versione 2.0.0-rc01 contiene questi commit.

Nuove funzionalità

  • Incluso un nuovo modello per prevedere meglio la memoria rimanente.

Correzioni di bug

  • Risolto il problema relativo alla memoria non funzionante con uno STL condiviso.

Versione 2.0.0-beta04

24 maggio 2023

androidx.games:games-memory-advice:2.0.0-beta04 viene rilasciato. La versione 2.0.0-beta04 contiene questi commit.

Nuove funzionalità

  • Aggiornamento del modello di machine learning alla base della libreria che consentirà risultati migliori per i telefoni più recenti

Versione 2.0.0-beta03

5 aprile 2023

androidx.games:games-memory-advice:2.0.0-beta03 viene rilasciato. La versione 2.0.0-beta03 contiene questi commit.

Correzioni di bug

  • Risolto un bug per cui la libreria non poteva caricare correttamente gli asset Tensorflow Lite richiesti

Versione 2.0.0-beta02

22 marzo 2023

androidx.games:games-memory-advice:2.0.0-beta02 viene rilasciato. La versione 2.0.0-beta02 contiene questi commit.

Correzioni di bug

  • Risolto un bug che impediva il collegamento corretto alla versione statica della libreria

Versione 2.0.0-beta01

22 febbraio 2023

androidx.games:games-memory-advice:2.0.0-beta01 viene rilasciato. La versione 2.0.0-beta01 contiene questi commit.

Nuove funzionalità

  • Nessuna nuova modifica

Versione 2.0.0-alpha01

8 febbraio 2023

androidx.games:games-memory-advice:2.0.0-alpha01 viene rilasciato. La versione 2.0.0-alpha01 contiene questi commit.

Modifiche alle API

  • Aumento principale della versione dovuto al refactoring dei file di build.

Correzioni di bug

  • La configurazione errata degli asset della raccolta ora genera un errore anziché arrestarsi in modo anomalo.

Giochi-Memoria-Consiglio versione 1.0.0

Versione 1.0.0-beta03

9 novembre 2022

androidx.games:games-memory-advice:1.0.0-beta03 viene rilasciato. La versione 1.0.0-beta03 contiene questi commit.

Nuove funzionalità

  • Nessuna nuova modifica

Versione 1.0.0-beta01

9 marzo 2022

androidx.games:games-memory-advice:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

  • Nessuna modifica dalla versione 1.0.0-alpha01.

Versione 1.0.0-alpha01

23 febbraio 2022

androidx.games:games-memory-advice:1.0.0-alpha01 viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Questa libreria C offre la possibilità di eseguire query e ricevere callback per modificare lo stato della memoria di un dispositivo su cui è in esecuzione un gioco.

Modifiche alle API

  • Si tratta della versione iniziale della libreria di consigli per la memoria. Vedi l'intestazione all'indirizzo include/memory_advice/memory_advice.h per l'API completa.

Contributi esterni

Giochi-Attività versione 3.0

Versione 3.0.0-rc01

21 febbraio 2024

androidx.games:games-activity:3.0.0-rc01 e androidx.games:games-text-input:3.0.0-rc01 vengono rilasciati. La versione 3.0.0-rc01 contiene questi commit.

Correzioni di bug

  • È stato risolto il blocco in cui gli eventi della tastiera non venivano gestiti correttamente dal looper.

Versione 3.0.0-beta01

29 novembre 2023

androidx.games:games-activity:3.0.0-beta01 e androidx.games:games-text-input:3.0.0-beta01 vengono rilasciati. La versione 3.0.0-beta01 contiene questi commit.

Versione 3.0.0-alpha01

15 novembre 2023

androidx.games:games-activity:3.0.0-alpha01 e androidx.games:games-text-input:3.0.0-alpha01 vengono rilasciati. La versione 3.0.0-alpha01 contiene questi commit.

Modifiche alle API

  • Le dimensioni delle strutture GameActivityMotionEvent e GameActivityCallbacks sono state modificate.
  • onEditorAction cambia il tipo restituito da booleano a void.
  • setImeEditorInfo ora prevede parametri enum, non numeri interi.
  • le funzioni interne di GameActivityEvents vengono spostate in GameActivityEvents_internal.h.
  • I tipi di input di GameTextInput sono anche enumerazioni, non numeri interi.

Giochi-Attività versione 2.1

Versione 2.1.0-alpha02

6 settembre 2023

androidx.games:games-activity:2.1.0-alpha02 e androidx.games:games-text-input:2.1.0-alpha02 vengono rilasciati. La versione 2.1.0-alpha02 contiene questi commit.

Correzioni di bug

  • La compatibilità dei dispositivi a 32 bit è stata migliorata.

Versione 2.1.0-alpha01

26 luglio 2023

androidx.games:games-activity:2.1.0-alpha01 viene rilasciato. La versione 2.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Consenti di eseguire l'override della creazione dell'istanza SurfaceView
  • Aggiungi report sulla versione dell'SDK

Modifiche alle API

  • Usa int64_t anziché long per historicalEventTimes al fine di evitare l'overruning sui sistemi a 32 bit
  • Aggiungi metodo GameActivity_restartInput
  • Aggiungi un callback nativo per gestire la modifica della visibilità della tastiera software

Correzioni di bug

  • Ottimizza la gestione degli eventi touch
  • Correggi l'eliminazione di un elemento GameActivityMotionEven
  • Correggi il calcolo dell'indice di GameActivityMotionEvent_getHistoricalAxisValue
  • Correggi le maschere di bit per il filtro di movimento

Giochi-Attività versione 2.0

Versione 2.0.2

24 maggio 2023

androidx.games:games-activity:2.0.2 viene rilasciato. La versione 2.0.2 contiene questi commit.

Correzioni di bug

  • Correzioni della stabilità in GameActivityEvents (b/278017467)

Versione 2.0.1

5 aprile 2023

androidx.games:games-activity:2.0.1 viene rilasciato. La versione 2.0.1 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema dello spazio di archiviazione anticipato della memoria con historicalEventTimes.
  • Risolto il problema di overflow di historicalEventTimesNanos sui sistemi a 32 bit

Versione 2.0.0

8 marzo 2023

androidx.games:games-activity:2.0.0 viene rilasciato. La versione 2.0.0 contiene questi commit.

Funzionalità principali della versione 2.0.0

  • È stata cambiata l'interfaccia della cronologia degli eventi per superare il limite di 32 bit.
  • Ha fornito l'accesso utente alle modifiche alla configurazione, come l'orientamento.
  • Informazioni aggiornate fornite nella struttura contentRect.
  • È stato fornito un modo più semplice per personalizzare i valori predefiniti di SurfaceView.
  • È stata corretta la gestione predefinita del sistema operativo per gli eventi touch, ad esempio la gestione dei pulsanti di sistema.
  • È stata ottimizzata la maggior parte delle chiamate JNI nella gestione degli eventi di contatto; questa operazione influisce sulle prestazioni.

Versione 2.0.0-rc01

22 febbraio 2023

androidx.games:games-activity:2.0.0-rc01 viene rilasciato. La versione 2.0.0-rc01 contiene questi commit.

Versione 2.0.0-beta01

8 febbraio 2023

androidx.games:games-activity:2.0.0-beta01 viene rilasciato. La versione 2.0.0-beta01 contiene questi commit.

Correzioni di bug

  • Correzione della gestione dei pulsanti di sistema. (2a103e).

Versione 2.0.0-alpha01

11 gennaio 2023

androidx.games:games-activity:2.0.0-alpha01 viene rilasciato senza modifiche. La versione 2.0.0-alpha01 contiene questi commit.

Giochi-Attività versione 1.2

Versione 1.2.2

7 dicembre 2022

androidx.games:games-activity:1.2.2 viene rilasciato. La versione 1.2.2 contiene questi commit.

Correzioni di bug

  • Ora è possibile impostare il numero massimo di eventi di movimento in fase di runtime.

Versione 1.2.2-alpha01

9 novembre 2022

androidx.games:games-activity:1.2.2-alpha01 viene rilasciato. La versione 1.2.2-alpha01 contiene questi commit.

Modifiche alle API

  • L'API ora contiene anche informazioni sulla versione nel formato GAMEACTIVITY_PACKED_VERSION. (I287e6).
  • È stato aggiunto il callback onContentRectChanged che viene chiamato quando è cambiato il rettangolo nella finestra in cui devono essere posizionati i contenuti. (I81396)

Correzioni di bug

  • Corretto l'overflow del buffer degli eventi. Sia inputBuffer->keyEvents che motionEvents sono ora buffer allocati dinamicamente. (Ic00f6)
  • Non riesce a funzionare correttamente se la memoria è esaurita. È stata aggiunta la gestione di realloc() errori durante il ridimensionamento dei buffer.

Versione 1.2.1

13 luglio 2022

androidx.games:games-activity:1.2.1 viene rilasciato. La versione 1.2.1 contiene questi commit.

Correzioni di bug

  • Sono stati risolti i problemi relativi al file .aar mancante nella release precedente.

Versione 1.2.0

15 giugno 2022

androidx.games:games-activity:1.2.0 viene rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

  • Consente alle classi derivate di GameActivity di gestire il caricamento della libreria nativa.
  • Carica sempre la libreria nativa in GameActivity.onCreate.
  • Se non è stata trovata alcuna altra libreria, utilizza di riserva il caricamento della libreria denominata "main".

Giochi-Attività versione 1.1

Versione 1.1.0

23 febbraio 2022

androidx.games:games-activity:1.1.0 e androidx.games:games-controller:1.1.0 vengono rilasciati. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

Attività di gioco:

  • WindowInsets offre ascolto e query per la risposta a notch e IME
  • Aggiungere filtri di eventi chiave e di movimento
  • Correzioni di bug:
    • Aggiungi messaggi mancanti per compatibilità con NativeActivity
    • Correggi la firma di on NativeWindowRidimensionad
    • Correggi le perdite di eventi di input

Versione 1.1.0-rc01

9 febbraio 2022

androidx.games:games-activity:1.1.0-rc01 e androidx.games:games-controller:1.1.0-rc01 vengono rilasciati. La versione 1.1.0-rc01 contiene questi commit.

Versione 1.1.0-beta03

26 gennaio 2022

androidx.games:games-activity:1.1.0-beta03 viene rilasciato. La versione 1.1.0-beta03 contiene questi commit.

Correzioni di bug

  • Correggi la firma di onNativeWindowResized
  • Mantieni l'handle alla finestra nativa in onSurfaceChanged

Versione 1.1.0-beta02

15 dicembre 2021

androidx.games:games-activity:1.1.0-beta02 viene rilasciato. La versione 1.1.0-beta02 contiene questi commit.

Correzioni di bug

  • Correggi la condizione di gara nell'impostazione del filtro eventi.

Versione 1.1.0-beta01

17 novembre 2021

androidx.games:games-activity:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Nuove funzionalità

  • Aggiunto il supporto per l'esecuzione di query sui set di finestre e il rilevamento delle modifiche agli inserti. Ciò consente ai giochi di reagire al popup dell'IME e di gestire gli inserti a cascata e taglio della videocamera.

Modifiche alle API

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

Correzioni di bug

  • Evita di consumare tutti gli eventi chiave: volume, videocamera ecc. vengono ora trasmessi al sistema.

Versione 1.1.0-alpha01

29 settembre 2021

androidx.games:games-activity:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • Callback onContentRectChanged aggiunto a GameActivityCallbacks

Correzioni di bug

  • Messaggi mancanti aggiunti a android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Giochi Performance Tuner 2.0

Versione 2.0.0-beta01

10 gennaio 2024

androidx.games:games-performance-tuner:2.0.0-beta01 viene rilasciato senza modifiche rispetto all'ultima release alpha. La versione 2.0.0-beta01 contiene questi commit.

Versione 2.0.0-alpha07

29 novembre 2023

androidx.games:games-performance-tuner:2.0.0-alpha07 viene rilasciato. La versione 2.0.0-alpha07 contiene questi commit.

Correzioni di bug

  • Correzione dei report sulla telemetria della memoria che, a volte, segnalavano valori errati

Versione 2.0.0-alpha06

1° novembre 2023

androidx.games:games-performance-tuner:2.0.0-alpha06 viene rilasciato. La versione 2.0.0-alpha06 contiene questi commit.

Versione 2.0.0-alpha05

23 agosto 2023

androidx.games:games-performance-tuner:2.0.0-alpha05 viene rilasciato. La versione 2.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Migrazione della libreria Protobuf a Protobuf Lite.

Correzioni di bug

  • Sono stati risolti i problemi relativi al puntatore sospeso.

Versione 2.0.0-alpha04

19 aprile 2023

androidx.games:games-performance-tuner:2.0.0-alpha04 viene rilasciato. La versione 2.0.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Sono state aggiornate le funzionalità di raccolta della telemetria nella libreria, per generare report più granulari sui tempi di rendering dei frame.

Correzioni di bug

  • Risolto un bug per cui la libreria si arrestava in modo anomalo se il numero massimo di tasti di strumentazione superava il numero di istogrammi.

Versione 2.0.0-alpha03

22 febbraio 2023

androidx.games:games-performance-tuner:2.0.0-alpha03 viene rilasciato. La versione 2.0.0-alpha03 contiene questi commit.

Correzioni di bug

  • La funzionalità Games-Performance-Tuner è stata spostata in un nuovo processo di rilascio. Non dovrebbero essere apportate modifiche al comportamento.

Versione 2.0.0-alpha02

8 febbraio 2023

androidx.games:games-performance-tuner:2.0.0-alpha02 viene rilasciato. La versione 2.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • È stata aggiunta l'API TuningFork_predictQualityLevels, che aiuterà a prevedere il livello qualitativo/parametri di fedeltà corretti da utilizzare.

Giochi Performance Tuner 1.6

Versione 1.6.1-alpha01

9 novembre 2022

androidx.games:games-performance-tuner:1.6.1-alpha01 viene rilasciato. La versione 1.6.1-alpha01 contiene questi commit.

Nuove funzionalità

  • Nessuna nuova modifica

Versione 1.6.0

15 giugno 2022

androidx.games:games-performance-tuner:1.6.0 viene rilasciato. La versione 1.6.0 contiene questi commit.

Modifiche importanti dalla versione 1.5.0

  • È stato risolto il problema di getpid che restituiva 0 durante il tentativo di ottenere la telemetria della memoria.
  • È stata interrotta l'esecuzione di StopLoadingGroup senza un gruppo di caricamento attivo.

Giochi Performance Tuner 1.5.0

Versione 1.5.0

9 febbraio 2022

androidx.games:games-performance-tuner:1.5.0 viene rilasciato. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • Modifica l'intervallo tra un caricamento e l'altro in modo programmatico, anziché essere impostato come hardcoded nelle impostazioni iniziali.
    • Funzione aggiunta: TuningFork_setAggregationStrategyInterval
  • Correzione del danneggiamento della memoria nella chiave API su API<=23

Versione 1.5.0-rc01

26 gennaio 2022

androidx.games:games-performance-tuner:1.5.0-rc01 viene rilasciato. La versione 1.5.0-rc01 contiene questi commit.

Correzioni di bug

  • Correzione del danneggiamento della memoria nella chiave API sull'API <=23

Versione 1.5.0-beta02

15 dicembre 2021

androidx.games:games-performance-tuner:1.5.0-beta02 viene rilasciato. La versione 1.5.0-beta02 contiene questi commit.

Modifiche alle API

  • Rimuovi la modifica che provoca l'interruzione dell'ABI da TuningFork_Settings.

Versione 1.5.0-beta01

29 settembre 2021

androidx.games:games-performance-tuner:1.5.0-beta01 viene rilasciato. La versione 1.5.0-beta01 contiene questi commit.

Nuove funzionalità

  • Nessuna modifica dalla release alpha. Questa release aveva:
    • Modifica l'intervallo tra un caricamento e l'altro in modo programmatico, anziché essere impostato come hardcoded nelle impostazioni iniziali.

Modifiche alle API

  • Nessuna modifica dalla release alpha. Questa release aveva:
    • Nuova funzione: TuningFork_setAggregationStrategyInterval
    • Nuovo campo in TuningFork_Settings: aggregation_strategy_intervalms_or_count

Versione 1.5.0-alpha01

18 agosto 2021

androidx.games:games-performance-tuner:1.5.0-alpha01 viene rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Ora è possibile impostare l'intervallo tra i caricamenti APT in modo programmatico, invece di utilizzare il file delle impostazioni.

Modifiche alle API

  • Funzione aggiunta: TuningFork_setAggregationStrategyInterval
  • Campo aggiunto allo struct TuningFork_Settings: aggregation_strategy_intervalms_or_count

Giochi-Attività versione 1.0.0

Versione 1.0.0

4 agosto 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0 vengono rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

Questa è la release iniziale nella versione stabile di Games-Activity, Games-Controller e Games-Text-Input. Per ulteriori informazioni, consulta la home page di AGDK.

Versione 1.0.0-rc01

12 luglio 2021

androidx.games:games-activity:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Correzioni di bug

  • Correggi il tipo restituito di GameActivityCallbacks::onSaveInstanceState

Versione 1.0.0-beta01

30 giugno 2021

androidx.games:games-activity:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • Rinomina GameActivityInputInfo in GameActivityPointerAxes.
  • Il callback onNativeWindowResized ora fornisce la larghezza e l'altezza della finestra.
  • Il callback onContentRectChanged è stato rimosso.
  • onLowMemory è stato rinominato in onTrimMemory.
  • Lingua GameActivity_setWindowFormat rimossa.
  • Modello di proprietà migliorato per i puntatori GameActivityMotionEvents e GameActivityMotionEvent.
  • Miglioramento del modello di proprietà dello stato dell'utente nel callback onSaveInstanceState.

Versione 1.0.0-alpha01

16 giugno 2021

androidx.games:games-activity:1.0.0-alpha01 viene rilasciato.

Nuove funzionalità

  • Giochi-Attività è una nuova raccolta che sostituisce NativeActivity come metodo consigliato per integrare un gioco C/C++ con Android.

Versione controller di gioco 2.0.

Versione 2.0.1

20 settembre 2023

Viene rilasciato il comando "androidx.games: games-controller: 2.0.1". La versione 2.0.1 contiene questi commit.

Correzioni di bug relativi al controller di gioco:

  • Correggi la condizione NullReferenceException rara nel gestore onInputDeviceChanged.
  • Risolvi il problema per evitare che alcune tastiere USB vengano erroneamente registrate come controller di gioco.

Versione 2.0.0

8 marzo 2023

androidx.games:games-controller:2.0.0 viene rilasciato. La versione 2.0.0 contiene questi commit.

Funzionalità principali della versione 2.0.0

  • Aggiunta la possibilità di rilevare lo stato della connessione delle tastiere hardware.
  • Aggiunta la possibilità di segnalare i dati di movimento (accelerometro/giroscopio) dal dispositivo principale (ovvero il telefono) e dai controller.
  • Sono stati modificati l'API e il formato per il database di definizione dei controller al fine di ridurre l'utilizzo di memoria e supportare funzionalità aggiuntive.

Versione 2.0.0-alpha01

11 gennaio 2023

androidx.games:games-controller:2.0.0-alpha01 viene rilasciato. La versione 2.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Rilevamento tastiera hardware
  • Supporto integrato per la segnalazione dei dati di movimento del sensore (ovvero, ricezione dei dati del giroscopio e dell'accelerometro dallo smartphone stesso)
  • Nuovo formato dei dati di mappatura dei controller ottimizzati

Modifiche alle API

  • Nuove chiamate API per la tastiera hardware: Paddleboat_getPhysicalKeyboardStatus e Paddleboat_setPhysicalKeyboardStatusCallback
  • Nuove chiamate API per la generazione di report sui dati di movimento dei sensori integrati: Paddleboat_getIntegratedMotionSensorFlags e Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • Nuove chiamate API per il formato dei dati di mappatura del titolare rivisto: Paddleboat_addControllerRemapDataFromFd,Paddleboat_addControllerRemapDataFromFileBuffer
  • Chiamate API di mappatura precedenti deprecate: Paddleboat_addControllerRemapData e Paddleboat_getControllerRemapTableData

Correzioni di bug

  • Risolto il problema di compatibilità con gli eventi di movimento di GameActivity 1.2.2 e versioni successive

Versione controller di gioco 1.1.0

Versione 1.1.0

23 febbraio 2022

androidx.games:games-activity:1.1.0 e androidx.games:games-controller:1.1.0 vengono rilasciati. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

Attività di gioco:

  • WindowInsets offre ascolto e query per la risposta a notch e IME
  • Aggiungere filtri di eventi chiave e di movimento
  • Correzioni di bug:
    • Aggiungi messaggi mancanti per compatibilità con NativeActivity
    • Correggi la firma di on NativeWindowRidimensionad
    • Correggi le perdite di eventi di input

Versione 1.1.0-rc01

9 febbraio 2022

androidx.games:games-controller:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Versione 1.1.0-beta01

26 gennaio 2022

androidx.games:games-controller:1.1.0-beta01 viene rilasciato senza modifiche dal giorno 1.1.0-alpha01. La versione 1.1.0-beta01 contiene questi commit.

Versione 1.1.0-alpha01

15 dicembre 2021

androidx.games:games-controller:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

È stato aggiunto il supporto dello stato della batteria, della vibrazione bimotore, del controllo delle luci e della generazione di report sugli assi di movimento per i controller supportati su Android S o versioni successive.

Modifiche alle API

  • Aggiunta della funzione Paddleboat_setMotionDataCallback per la registrazione dei callback dei dati di movimento del controller
  • Aggiunta la funzione Paddleboat_setControllerLight per modificare le impostazioni della spia del controller.
  • Struttura Paddleboat_Controller_Battery aggiunta a Paddleboat_Controller_Data
  • Nuove strutture:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Nuove enumerazioni:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Nuovi flag del controller:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Correzioni di bug

  • È stata aggiunta una voce di database alternativa per deviceId per il controller PS4
  • Aggiunta voce database API >=31 per controller PS5

Versione controller di gioco 1.0.0

Versione 1.0.0

4 agosto 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0 vengono rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

Questa è la release iniziale nella versione stabile di Games-Activity, Games-Controller e Games-Text-Input. Per ulteriori informazioni, consulta la home page di AGDK.

Versione 1.0.0-rc02

21 luglio 2021

androidx.games:games-controller:1.0.0-rc02 viene rilasciato. La versione 1.0.0-rc02 contiene questi commit.

Correzioni di bug

  • Risolto l'errore di pacchettizzazione che causava il mancato funzionamento dell'importazione prefabbricata in caso di permutazioni di architettura/versione vuote e inutilizzate.

Versione 1.0.0-rc01

12 luglio 2021

androidx.games:games-controller:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Correzioni di bug

  • Risolto un problema di incompatibilità con la versione più recente di GameActivity

Versione 1.0.0-beta01

30 giugno 2021

androidx.games:games-controller:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • Le funzioni che hanno restituito un valore booleano per l'esito positivo o negativo ora restituiscono un'enumerazione Paddleboat_Error_Code.
  • Paddleboat_onPause rinominato in Paddleboat_onStop
  • Paddleboat_onResume rinominato in Paddleboat_onStart
  • Paddle boat_processGameActivityEvent suddivisa in due funzioni: Paddleboat_processGameActivityKeyInputEvent e Paddleboat_processGameActivityMotionInputEvent
  • Sono state rimosse le funzionalità estese del controller che richiedevano la creazione di un SDK per Android S in anteprima
  • Funzione Paddleboat_getBackButtonConsumed aggiunta
  • I callback dello stato del controller e del mouse ora hanno un parametro facoltativo di un puntatore ai dati definiti dall'utente
  • Stringa del nome del controller spostata fuori dalla struttura delle informazioni sul dispositivo, ora accessibile tramite la funzione Paddleboat_getControllerName

Correzioni di bug

  • Risolto il problema per cui un controller che inizialmente non si autoclassificava come controller, ma in seguito lo fa tramite un messaggio onInputDeviceChanged, non veniva rilevato correttamente come connessione del controller.

Versione 1.0.0-alpha01

16 giugno 2021

androidx.games:games-controller:1.0.0-alpha01 viene rilasciato.

Nuove funzionalità

  • Un controller di gioco è una nuova libreria che fornisce un'API C per rilevare, leggere l'input e interagire con i controller di gioco.

Giochi-Testo-Input 2.1

Versione 2.1.0-alpha01

26 luglio 2023

androidx.games:games-text-input:2.1.0-alpha01 viene rilasciato. La versione 2.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Aggiungi un supporto di modalità multilinea e singola linea

Modifiche alle API

  • Aggiungi funzione isSoftwareKeyboardVisible
  • Aggiungi definizioni di bitfield per GameActivity_setImeEditorInfo
  • Aggiungi callback onEditorAction

Correzioni di bug

  • Correzione della mancata sincronizzazione delle tastiere hardware e software
  • Cancella lo stato attivo quando la tastiera software è nascosta

Giochi-Testo-Input 2.0

Versione 2.0.0

8 marzo 2023

androidx.games:games-text-input:2.0.0 viene rilasciato. La versione 2.0.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.1

  • Aggiornamento della versione principale a causa delle modifiche al sistema di compilazione, non sono presenti aggiornamenti della libreria/API stessa.

Games-Text-Input Versione 1.1

Versione 1.1.2-alpha01

9 novembre 2022

androidx.games:games-text-input:1.1.2-alpha01 viene rilasciato. La versione 1.1.2-alpha01 contiene questi commit.

Nuove funzionalità

  • Nessuna nuova modifica

Versione 1.1.1

13 luglio 2022

androidx.games:games-text-input:1.1.1 viene rilasciato. La versione 1.1.1 contiene questi commit.

Correzioni di bug

  • Sono stati risolti i problemi relativi al file .aar mancante nella release precedente.

Versione 1.1.0

9 febbraio 2022

androidx.games:games-text-input:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0 - Aggiunta della funzionalità di ascolto e query di WindowInsets a GameTextInput - Aggiunta dell'intestazione gamecommon.h mancante

Versione 1.1.0-rc01

26 gennaio 2022

androidx.games:games-text-input:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Versione 1.1.0-beta01

15 dicembre 2021

androidx.games:games-text-input:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Correzioni di bug

  • Risolvere i problemi relativi agli insiemi a cascata e IME
  • Aggiungi intestazione gamecommon.h mancante

Versione 1.1.0-alpha01

13 ottobre 2021

androidx.games:games-text-input:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • Aggiunta la funzionalità degli inserti IME a GameTextInput

Giochi-Testo-Input versione 1.0

Versione 1.0.0

4 agosto 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0 vengono rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

Questa è la release iniziale nella versione stabile di Games-Activity, Games-Controller e Games-Text-Input. Per ulteriori informazioni, consulta la home page di AGDK.

Versione 1.0.0-rc01

12 luglio 2021

androidx.games:games-text-input:1.0.0-rc01 viene rilasciato senza modifiche. La versione 1.0.0-rc01 contiene questi commit.

Versione 1.0.0-beta01

30 giugno 2021

androidx.games:games-text-input:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • Miglioramento del modello di proprietà degli oggetti GameTextInputState.
  • Ordinamento dei tipi in modo che sia coerente con NDK.

Versione 1.0.0-alpha01

16 giugno 2021

androidx.games:games-text-input:1.0.0-alpha01 viene rilasciato.

Nuove funzionalità

  • Games-Text-Input è una nuova raccolta che aiuta gli sviluppatori di giochi a utilizzare l'input da tastiera software Android da C/C++.

Pacing del frame dei giochi versione 2.1

Versione 2.1.0

15 novembre 2023

androidx.games:games-frame-pacing:2.1.0 viene rilasciato. La versione 2.1.0 contiene questi commit.

Versione 2.1.0-rc01

20 settembre 2023

androidx.games:games-frame-pacing:2.1.0-rc01 viene rilasciato. La versione 2.1.0-rc01 contiene questi commit.

Versione 2.1.0-beta01

24 maggio 2023

androidx.games:games-frame-pacing:2.1.0-beta01 viene rilasciato. La versione 2.1.0-beta01 contiene questi commit.

Correzioni di bug

  • Timeout nel caso in cui l'inizializzazione di NDKChoreographer non va a buon fine (ef466d)
  • Quando si utilizzano le frequenze di aggiornamento delle query SwappyGL_getSupportedRefreshPeriodsNS in modo esplicito dal sistema (c85235)

Versione 2.1.0-alpha01

5 aprile 2023

androidx.games:games-frame-pacing:2.1.0-alpha01 viene rilasciato. La versione 2.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Nuova API per reimpostare lo stato di frequenza frame.
  • Nuova API per disabilitare l'impatto del pacing dei frame di swappy pur continuando a osservare i tempi di CPU e GPU.

Modifiche alle API

  • Ora puoi utilizzare SwappyGL_resetFramePacing/SwappyVk_resetFramePacing per reimpostare lo stato di frequenza fotogrammi interna. Il pacing dei frame ora prenderà in considerazione solo i dati a partire dal momento in cui viene chiamata l'API di reimpostazione.
  • Ora è possibile utilizzare SwappyGL_enableFramePacing/SwappyVk_enableFramePacing per attivare/disattivare il pacing dei frame dello scambio. Quando questa opzione è disabilitata,
  • È possibile usare SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait per controllare se si verifica un'attesa di blocco del lavoro della GPU dell'ultimo frame quando il pacing dei frame è disattivato.

Correzioni di bug

  • I miglioramenti delle prestazioni vengono apportati per i casi legati alla GPU quando si utilizza l'API Stackpy GL.

Pacing del frame dei giochi versione 2.0

Versione 2.0.0

8 marzo 2023

androidx.games:games-frame-pacing:2.0.0 viene rilasciato. La versione 2.0.0 contiene questi commit.

Modifiche importanti dalla versione 1.10.1

  • Il sistema di build ha subito importanti modifiche che hanno portato alla generazione di una sola libreria anziché a più librerie per ogni versione dell'SDK/NDK.
  • Le statistiche Vulkan Frame sono state aggiunte.
  • È stata aggiunta una nuova API per la cancellazione delle statistiche dei frame.
  • I log sono tutti silenziosi in modalità di pubblicazione, possono essere attivati in modalità di debug.

Versione 2.0.0-rc01

22 febbraio 2023

androidx.games:games-frame-pacing:2.0.0-rc01 viene rilasciato. La versione 2.0.0-rc01 contiene questi commit.

Nuove funzionalità

  • Il logging è ora nascosto dietro un flag di compilazione. Per impostazione predefinita, la build della release della libreria non ha logging e la release di debug della libreria ha tutti i log attivati.

Versione 2.0.0-beta01

8 febbraio 2023

androidx.games:games-frame-pacing:2.0.0-beta01 viene rilasciato. La versione 2.0.0-beta01 contiene questi commit.

Nuove funzionalità

  • Introduzione di una nuova API per cancellare le statistiche dei frame.

Modifiche alle API

  • Sono state aggiunte le API SwappyGL_clearStats e SwappyGL_clearStats.

Versione 2.0.0-alpha01

11 gennaio 2023

androidx.games:games-frame-pacing:2.0.0-alpha01 viene rilasciato. La versione 2.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Statistiche sui frame vulkan aggiunte

Modifiche alle API

  • Aumento principale della versione dovuto al refactoring dei file di build
  • Sono state aggiunte 3 nuove API : SwappyVk_enableStats, SwappyVk_recordFrameStart e SwappyVk_getStats

Correzioni di bug

  • Applica la soglia solo in modalità di scambio automatico (Ic0786)

Pacing del frame per i giochi 1.10

Versione 1.10.2-alpha01

9 novembre 2022

androidx.games:games-frame-pacing:1.10.2-alpha01 viene rilasciato. La versione 1.10.2-alpha01 contiene questi commit.

Nuove funzionalità

  • Nessuna nuova modifica

Versione 1.10.1

15 giugno 2022

androidx.games:games-frame-pacing:1.10.1 viene rilasciato. La versione 1.10.1 contiene questi commit.

Correzioni di bug

  • Correzione per lo swappy che non creava con ndk <23 e >17.
  • API esposta per recuperare le frequenze di aggiornamento supportate dal display.

Versione 1.10.0

23 febbraio 2022

androidx.games:games-frame-pacing:1.10.0 viene rilasciato. La versione 1.10.0 contiene questi commit.

Modifiche importanti dalla versione 1.9.0

  • Ignora gli input del filtro del coreografo inquinante e rilassati ulteriormente per evitare che si blocchi nell'emulatore
  • Aggiungi le funzioni *_uninjectTracer.

Versione 1.10.0-rc01

9 febbraio 2022

androidx.games:games-frame-pacing:1.10.0-rc01 viene rilasciato. La versione 1.10.0-rc01 contiene questi commit.

Versione 1.10.0-beta01

26 gennaio 2022

androidx.games:games-frame-pacing:1.10.0-beta01 viene rilasciato. La versione 1.10.0-beta01 contiene questi commit.

Versione 1.10.0-alpha01

15 dicembre 2021

androidx.games:games-frame-pacing:1.10.0-alpha01 viene rilasciato. La versione 1.10.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Aggiunta della funzione SwappyGL_uninjectTracer.

Modifiche alle API

  • Rimuovi i callback aggiunti in precedenza utilizzando SwappyGL_injectTracer mediante l'API SwappyGL_uninjectTracer(const SwappyTracer *t).

Pacing del frame per i giochi 1.9

Versione 1.9.1

13 ottobre 2021

androidx.games:games-frame-pacing:1.9.1 viene rilasciato. La versione 1.9.1 contiene questi commit.

Correzioni di bug

Versione 1.9.0

12 luglio 2021

androidx.games:games-frame-pacing:1.9.0 viene rilasciato. La versione 1.9.0 contiene questi commit.

Modifiche importanti dalla versione 1.7.0

  • Aggiornato in modo che corrisponda allo schema di controllo delle versioni interno.

Pacing del frame per i giochi 1.7.0

Versione 1.7.0

30 giugno 2021

androidx.games:games-frame-pacing:1.7.0 viene rilasciato. La versione 1.7.0 contiene questi commit.

Versione 1.7.0-rc01

2 giugno 2021

androidx.games:games-frame-pacing:1.7.0-rc01 viene rilasciato. La versione 1.7.0-rc01 contiene questi commit.

Versione 1.7.0-beta02

24 febbraio 2021

androidx.games:games-frame-pacing:1.7.0-beta02 viene rilasciato.

Versione 1.7.0-beta01

16 dicembre 2020

androidx.games:games-frame-pacing:1.7.0-beta01 viene rilasciato.

Giochi Performance Tuner 1.4.3

Versione 1.4.3

12 luglio 2021

androidx.games:games-performance-tuner:1.4.3 viene rilasciato. La versione 1.4.3 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

  • Aggiornato in modo che corrisponda allo schema di controllo delle versioni interno.

Giochi Performance Tuner 1.1.0

Versione 1.1.0

30 giugno 2021

androidx.games:games-performance-tuner:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Versione 1.1.0-rc01

2 giugno 2021

androidx.games:games-performance-tuner:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Versione 1.1.0-beta03

21 aprile 2021

androidx.games:games-performance-tuner:1.1.0-beta03 viene rilasciato.

Versione 1.1.0-beta02

24 febbraio 2021

androidx.games:games-performance-tuner:1.1.0-beta02 viene rilasciato.

Versione 1.1.0-beta01

16 dicembre 2020

androidx.games:games-performance-tuner:1.1.0-beta01 viene rilasciato.

Versione 1.1.0-alpha01

Viene rilasciato androidx.games:games-performance-tuner:1.1.0-alpha01.

Versione 1.0.0

Versione 1.0.0-alpha02

12 agosto 2020

La raccolta Android Gaming è stata rinominata nella raccolta Android Games.

androidx.gaming -> androidx.games

Versione 1.0.0-alpha01

10 giugno 2020

Viene rilasciato androidx.games:1.0.0-alpha01.