Jeux Android

La bibliothèque de jeux Android reflète le SDK Android Game, qui est disponible en téléchargement sous forme de fichier binaire. Vous pouvez utiliser la bibliothèque androidx au lieu de télécharger et d'intégrer manuellement le SDK Android Game dans votre build.

Pour en savoir plus sur le SDK Android Game, consultez la documentation du SDK et les notes de version du SDK.

Ce tableau présente tous les artefacts du groupe androidx.games.

Artefact Version stable Version finale Version bêta Version alpha
games-activity 3.0.1 - - -
games-controller 2.0.1 - - -
games-frame-pacing 2.1.0 - - -
games-memory-advice 2.0.1 - Version 2.1.0-beta01 -
games-text-input 3.0.1 - - -
games-performance-tuner - - 2.0.0-beta01 -
Dernière mise à jour de la bibliothèque: 20 mars 2024

Exigences

games-memory-advice

L'API MemoryAdvice nécessite que votre application soit créée avec l'une des versions NDK suivantes :

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

Déclarer des dépendances

Pour ajouter une dépendance pour un jeu, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances des artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module. La bibliothèque games-activity a intégré la même version de la bibliothèque game-text-input. Par conséquent, les applications GameActivity ne peuvent pas inclure à nouveau la dépendance 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")
}
}

Pour en savoir plus sur les dépendances, consultez la page Ajouter des dépendances de compilation.

Ajouter des propriétés Gradle

Vous devrez peut-être ajouter des propriétés au fichier gradle.properties situé dans le même répertoire que le fichier build.gradle de votre application (ou de votre module). Si le fichier gradle.properties n'existe pas, créez-le.

Si vous utilisez Android Studio 4.0, assurez-vous que gradle.properties contient les lignes suivantes :

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

Si vous utilisez Android Studio 4.1 ou une version ultérieure, assurez-vous que gradle.properties contient les lignes suivantes :

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

Ajouter des packages avec CMake

Pour rendre disponibles les packages importés du SDK Android Game, ajoutez le code suivant au fichier CMakeLists.txt de votre application principale :

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

Cela vous permettra d'inclure les fichiers d'en-tête du SDK Android Game dans le code de votre jeu :

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

Dans le fichier CMakeLists.txt de votre application principale, recherchez target_link_libraries pour la bibliothèque partagée principale. Ajoutez les références aux bibliothèques statiques du SDK Android Game pour les inclure dans votre bibliothèque partagée :

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

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Games-Memory-Advice version 2.1

Version 2.1.0-beta01

29 novembre 2023

Publication d'androidx.games:games-memory-advice:2.1.0-beta01. Liste des commits de la version 2.1.0-beta01

Version 2.1.0-alpha01

15 novembre 2023

Publication d'androidx.games:games-memory-advice:2.1.0-alpha01. Liste des commits de la version 2.1.0-alpha01

Nouvelles fonctionnalités

  • Mise à jour du modèle de mémoire de la bibliothèque pour améliorer les prédictions.

Modifications apportées à l'API

  • Ajout d'une API getAvailableMemory() qui renvoie une estimation de la quantité de mémoire pouvant être allouée de manière sécurisée, en octets.

Version 2.1.0-alpha01

26 juillet 2023

Publication d'androidx.games:games-memory-advice:2.1.0-alpha01. Liste des commits de la version 2.1.0-alpha01

Modifications apportées à l'API

  • Ajouter la fonction GetAvailableMemory

Correction de bugs

  • Mettre à jour le modèle Memory Advice
  • Corriger la cible de compilation memory_advice partagée

Games-Memory-Advice version 2.0

Version 2.0.1

20 septembre 2023

Publication d'androidx.games:games-memory-advice:2.0.1. Liste des commits de la version 2.0.1

Correction de bugs

  • Correction du plantage qui se produisait dans le thread de l'observateur d'état du fait que le thread n'était pas associé à la JVM.

Version 2.0.0

6 septembre 2023

Publication d'androidx.games:games-memory-advice:2.0.0. Liste des commits de la version 2.0.0

Principales fonctionnalités de la version 2.0.0

  • Un nouveau modèle de ML a été entraîné et publié dans cette version.
  • Une API permettant de prédire la quantité de mémoire disponible est implémentée.

Version 2.0.0-rc01

26 juillet 2023

Publication d'androidx.games:games-memory-advice:2.0.0-rc01. Liste des commits de la version 2.0.0-rc01

Nouvelles fonctionnalités

  • Ajout d'un nouveau modèle pour mieux prédire la mémoire restante.

Correction de bugs

  • Correction du problème lié à Memory Advice avec une STL partagée.

Version 2.0.0-beta04

24 mai 2023

Publication d'androidx.games:games-memory-advice:2.0.0-beta04. Liste des commits de la version 2.0.0-beta04

Nouvelles fonctionnalités

  • Mise à jour du modèle de machine learning sur lequel repose la bibliothèque, afin d'améliorer les résultats pour les téléphones plus récents

Version 2.0.0-beta03

5 avril 2023

Publication d'androidx.games:games-memory-advice:2.0.0-beta03. Liste des commits de la version 2.0.0-beta03

Correction de bugs

  • Correction d'un bug qui empêchait la bibliothèque de charger correctement les éléments TensorFlow Lite requis

Version 2.0.0-beta02

22 mars 2023

Publication d'androidx.games:games-memory-advice:2.0.0-beta02. Liste des commits de la version 2.0.0-beta02

Correction de bugs

  • Correction d'un bug qui empêchait l'association correcte de la version statique de la bibliothèque

Version 2.0.0-beta01

22 février 2023

Publication d'androidx.games:games-memory-advice:2.0.0-beta01. Liste des commits de la version 2.0.0-beta01

Nouvelles fonctionnalités

  • Aucune nouvelle modification

Version 2.0.0-alpha01

8 février 2023

Publication d'androidx.games:games-memory-advice:2.0.0-alpha01. Liste des commits de la version 2.0.0-alpha01

Modifications apportées à l'API

  • Augmentation de la version majeure en raison de la refactorisation des fichiers de compilation.

Correction de bugs

  • Une configuration incorrecte des éléments de la bibliothèque génère désormais une erreur au lieu d'un plantage.

Games-Memory-Advice version 1.0.0

Version 1.0.0-beta03

9 novembre 2022

Publication d'androidx.games:games-memory-advice:1.0.0-beta03. Liste des commits de la version 1.0.0-beta03

Nouvelles fonctionnalités

  • Aucune nouvelle modification

Version 1.0.0-beta01

9 mars 2022

Publication d'androidx.games:games-memory-advice:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

  • Aucune modification depuis la version 1.0.0-alpha01

Version 1.0.0-alpha01

23 février 2022

Publication d'androidx.games:games-memory-advice:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

  • Cette bibliothèque C permet d'interroger et de recevoir des rappels en cas de modification de l'état de la mémoire d'un appareil exécutant un jeu.

Modifications apportées à l'API

  • Il s'agit de la version initiale de la bibliothèque de conseils sur la mémoire. Consultez l'en-tête à l'emplacement include/memory_advice/memory_advice.h pour accéder à l'API complète.

Contribution externe

Games-Activity version 3.0

Version 3.0.1

20 mars 2024

Publication d'androidx.games:games-activity:3.0.1 et d'androidx.games:games-text-input:3.0.1. La version 3.0.1 contient ces commits.

Correction de bugs

  • Correction d'un problème lié à la saisie et à l'affichage de caractères spéciaux.

Version 3.0.0

6 mars 2024

Publication d'androidx.games:games-activity:3.0.0 et d'androidx.games:games-text-input:3.0.0. La version 3.0.0 contient ces commits.

Principales fonctionnalités de la version 3.0.0

  • GameTextInput a été retravaillé pour pouvoir être utilisé dans les jeux.
  • Certaines interfaces des deux bibliothèques ont été modifiées par rapport à la version 2.0.0.

Correction de bugs

  • Correction des problèmes de compatibilité avec les anciens NDK
  • Correction des problèmes de compilation Windows

Version 3.0.0-rc01

21 février 2024

Publication d'androidx.games:games-activity:3.0.0-rc01 et d'androidx.games:games-text-input:3.0.0-rc01. Liste des commits de la version 3.0.0-rc01

Correction de bugs

  • Correction du blocage qui entraînait la mauvaise gestion des événements de clavier par le looper.

Version 3.0.0-beta01

29 novembre 2023

Publication d'androidx.games:games-activity:3.0.0-beta01 et d'androidx.games:games-text-input:3.0.0-beta01. Liste des commits de la version 3.0.0-beta01

Version 3.0.0-alpha01

15 novembre 2023

Publication d'androidx.games:games-activity:3.0.0-alpha01 et d'androidx.games:games-text-input:3.0.0-alpha01. Liste des commits de la version 3.0.0-alpha01

Modifications apportées à l'API

  • Les structures GameActivityMotionEvent et GameActivityCallbacks ont changé de taille.
  • onEditorAction fait passer son type renvoyé de "booléen" à "void".
  • setImeEditorInfo s'attend désormais à des paramètres d'énumération, et non à des entiers.
  • Déplacement des fonctions internes de GameActivityEvents vers GameActivityEvents_internal.h.
  • Les types d'entrée de GameTextInput sont également des énumérations, et non des entiers.

Games-Activity version 2.1

Version 2.1.0-alpha02

6 septembre 2023

Publication d'androidx.games:games-activity:2.1.0-alpha02 et d'androidx.games:games-text-input:2.1.0-alpha02. Liste des commits de la version 2.1.0-alpha02

Correction de bugs

  • La compatibilité avec les appareils 32 bits a été améliorée.

Version 2.1.0-alpha01

26 juillet 2023

Publication d'androidx.games:games-activity:2.1.0-alpha01. Liste des commits de la version 2.1.0-alpha01

Nouvelles fonctionnalités

  • Offrir la possibilité d'ignorer la création de l'instance SurfaceView
  • Ajouter des rapports sur les versions du SDK

Modifications apportées à l'API

  • Utilisez int64_t au lieu de long pour historicalEventTimes afin d'éviter un dépassement sur les systèmes 32 bits.
  • Ajouter la méthode GameActivity_restartInput
  • Ajout d'un rappel natif pour gérer le changement de visibilité du clavier virtuel.

Correction de bugs

  • Optimiser la gestion des événements tactiles
  • Destruction correcte d'une GameActivityMotionEven
  • Corriger le calcul de l'index GameActivityMotionEvent_getHistoricalAxisValue
  • Corriger les masques de bits pour le filtre de mouvement

Games-Activity version 2.0

Version 2.0.2

24 mai 2023

Publication d'androidx.games:games-activity:2.0.2. Liste des commits de la version 2.0.2

Correction de bugs

  • Corrections de stabilité dans GameActivityEvents. (b/278017467)

Version 2.0.1

5 avril 2023

Publication d'androidx.games:games-activity:2.0.1. Liste des commits de la version 2.0.1

Correction de bugs

  • Correction de la libération anticipée de la mémoire avec historicalEventTimes.
  • Résolution du problème de dépassement de historicalEventTimesNanos sur les systèmes 32 bits.

Version 2.0.0

8 mars 2023

Publication d'androidx.games:games-activity:2.0.0. Liste des commits de la version 2.0.0

Principales fonctionnalités de la version 2.0.0

  • Modification de l'interface pour l'historique des heures des événements afin de dépasser la limite de 32 bits.
  • Fournit un accès utilisateur aux modifications de configuration, telles que l'orientation.
  • Vous avez fourni des informations à jour dans la structure contentRect.
  • Ajout d'un moyen plus simple de personnaliser SurfaceView par défaut.
  • Correction de la gestion par défaut des événements tactiles par le système d'exploitation, comme la gestion des boutons système.
  • Optimisation de la plupart des appels JNI pour la gestion des événements tactiles, auparavant affectant les performances.

Version 2.0.0-rc01

22 février 2023

Publication d'androidx.games:games-activity:2.0.0-rc01. Liste des commits de la version 2.0.0-rc01

Version 2.0.0-beta01

8 février 2023

Publication d'androidx.games:games-activity:2.0.0-beta01. Liste des commits de la version 2.0.0-beta01

Correction de bugs

  • Correction de la gestion des boutons système. (2a103e)

Version 2.0.0-alpha01

11 janvier 2023

Publication d'androidx.games:games-activity:2.0.0-alpha01 sans aucune modification. Liste des commits de la version 2.0.0-alpha01

Games-Activity version 1.2

Version 1.2.2

7 décembre 2022

Publication d'androidx.games:games-activity:1.2.2. Liste des commits de la version 1.2.2

Correction de bugs

  • Le nombre maximal d'événements de mouvement peut désormais être défini au moment de l'exécution.

Version 1.2.2-alpha01

9 novembre 2022

Publication d'androidx.games:games-activity:1.2.2-alpha01. Liste des commits de la version 1.2.2-alpha01

Modifications apportées à l'API

  • Désormais, l'API contient également des informations de version sous la forme "GAMEACTIVITY_PACKED_VERSION". (I287e6)
  • Ajout d'un rappel onContentRectChanged qui est appelé lorsque le rectangle de la fenêtre dans lequel le contenu doit être déplacé a été modifié. (I81396)

Correction de bugs

  • Correction d'un dépassement de tampon lié aux événements. inputBuffer->keyEvents et motionEvents sont désormais des tampons alloués de manière dynamique. (Ic00f6)
  • Échec en douceur en cas de manque de mémoire. Nous avons ajouté la gestion des erreurs realloc() lors du redimensionnement des tampons.

Version 1.2.1

13 juillet 2022

Publication d'androidx.games:games-activity:1.2.1. Liste des commits de la version 1.2.1

Correction de bugs

  • Correction du problème de fichier .aar manquant dans la version précédente.

Version 1.2.0

15 juin 2022

Publication d'androidx.games:games-activity:1.2.0. Liste des commits de la version 1.2.0

Changements importants depuis la version 1.1.0

  • Les classes dérivées de GameActivity sont maintenant autorisées à gérer le chargement de la bibliothèque native.
  • Chargement systématique de la bibliothèque native dans GameActivity.onCreate.
  • En absence d'autre bibliothèque trouvée, chargement d'une bibliothèque de secours portant le nom "main".

Games-Activity version 1.1

Version 1.1.0

23 février 2022

Publication d'androidx.games:games-activity:1.1.0 et d'androidx.games:games-controller:1.1.0. Liste des commits de la version 1.1.0

Changements importants depuis la version 1.0.0

Games-Activity :

  • Écoute et interrogation de WindowInsets relatives à l'encoche et réponse d'IME
  • Ajout de filtres d'événements de touche et de mouvement
  • Correction de bugs :
    • Ajout des messages manquants pour assurer la compatibilité avec NativeActivity
    • Correction de la signature d'onNativeWindowResized
    • Correction des pertes d'événements d'entrée

Version 1.1.0-rc01

9 février 2022

Publication d'androidx.games:games-activity:1.1.0-rc01 et d'androidx.games:games-controller:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta03

26 janvier 2022

Publication d'androidx.games:games-activity:1.1.0-beta03. Liste des commits de la version 1.1.0-beta03

Correction de bugs

  • Correction de la signature de onNativeWindowResized
  • Maintien d'un handle vers la fenêtre native dans onSurfaceChanged

Version 1.1.0-beta02

15 décembre 2021

Publication d'androidx.games:games-activity:1.1.0-beta02. Liste des commits de la version 1.1.0-beta02

Correction de bugs

  • Correction de la condition de concurrence dans le paramètre de filtre d'événement.

Version 1.1.0-beta01

17 novembre 2021

Publication d'androidx.games:games-activity:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01

Nouvelles fonctionnalités

  • Ajout de la possibilité d'interroger les encarts de fenêtre et d'écouter à la recherche de modifications des encarts. Les jeux peuvent ainsi réagir à l'affichage d'IME et gérer les encarts de cascade d'annonces et d'appareil photo.

Modifications apportées à l'API

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

Correction de bugs

  • Corrections pour éviter de consommer tous les événements clés : le volume, l'appareil photo, etc. sont désormais transmis au système.

Version 1.1.0-alpha01

29 septembre 2021

Publication d'androidx.games:games-activity:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Modifications apportées à l'API

  • Ajout du rappel onContentRectChanged à GameActivityCallbacks

Correction de bugs

  • Messages manquants ajoutés à android_native_app_glue.h :
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

Version 2.0.0-beta01

10 janvier 2024

Publication d'androidx.games:games-performance-tuner:2.0.0-beta01 sans aucune modification par rapport à la dernière version alpha. Liste des commits de la version 2.0.0-beta01

Version 2.0.0-alpha07

29 novembre 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha07. Liste des commits de la version 2.0.0-alpha07

Correction de bugs

  • Correction du signalement de valeurs erronées par les rapports de télémétrie sur la mémoire

Version 2.0.0-alpha06

1er novembre 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha06. Liste des commits de la version 2.0.0-alpha06

Version 2.0.0-alpha05

23 août 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha05. Liste des commits de la version 2.0.0-alpha05

Nouvelles fonctionnalités

  • Migration de la bibliothèque Protobuf vers Protobuf lite.

Correction de bugs

  • Correction des problèmes liés au pointeur flottant.

Version 2.0.0-alpha04

19 avril 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha04. Liste des commits de la version 2.0.0-alpha04

Nouvelles fonctionnalités

  • Mise à jour des fonctionnalités de collecte de télémétrie dans la bibliothèque, afin de créer des rapports plus précis sur les délais d'affichage des images.

Correction de bugs

  • Correction d'un bug qui provoquait le plantage de la bibliothèque si le nombre maximal de clés d'instrumentation était supérieur au nombre d'histogrammes.

Version 2.0.0-alpha03

22 février 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha03. Liste des commits de la version 2.0.0-alpha03

Correction de bugs

  • Games-Performance-Tuner a été transféré vers un nouveau processus de publication. Cela ne devrait impliquer aucun changement de comportement.

Version 2.0.0-alpha02

8 février 2023

Publication d'androidx.games:games-performance-tuner:2.0.0-alpha02. Liste des commits de la version 2.0.0-alpha02

Modifications apportées à l'API

  • Ajout de l'API TuningFork_predictQualityLevels, ce qui permettra de prédire le niveau de qualité et les paramètres de fidélité à utiliser.

Games Performance Tuner 1.6

Version 1.6.1-alpha01

9 novembre 2022

Publication d'androidx.games:games-performance-tuner:1.6.1-alpha01. Liste des commits de la version 1.6.1-alpha01

Nouvelles fonctionnalités

  • Aucune nouvelle modification

Version 1.6.0

15 juin 2022

Publication d'androidx.games:games-performance-tuner:1.6.0. Liste des commits de la version 1.6.0

Changements importants depuis la version 1.5.0

  • Correction de l'erreur pour laquelle getpid renvoyait 0 lors de la tentative d'obtention de la télémétrie de la mémoire.
  • Arrêt de l'exécution de StopLoadingGroup sans groupe de chargement actif.

Games Performance Tuner 1.5.0

Version 1.5.0

9 février 2022

Publication d'androidx.games:games-performance-tuner:1.5.0. Liste des commits de la version 1.5.0

Changements importants depuis la version 1.4.0

  • Modification de l'intervalle entre les importations de façon programmatique, plutôt qu'en utilisant le codage en dur dans les paramètres initiaux.
    • Fonction ajoutée : TuningFork_setAggregationStrategyInterval
  • Correction du problème de corruption de la mémoire dans la clé API pour les versions d'API<=23

Version 1.5.0-rc01

26 janvier 2022

Publication d'androidx.games:games-performance-tuner:1.5.0-rc01. Liste des commits de la version 1.5.0-rc01

Correction de bugs

  • Correction du problème de corruption de la mémoire dans la clé API pour les versions d'API<=23

Version 1.5.0-beta02

15 décembre 2021

Publication d'androidx.games:games-performance-tuner:1.5.0-beta02. Liste des commits de la version 1.5.0-beta02

Modifications apportées à l'API

  • Suppression de la modification destructive de l'interface binaire d'application (ABI) de TuningFork_Settings.

Version 1.5.0-beta01

29 septembre 2021

Publication d'androidx.games:games-performance-tuner:1.5.0-beta01. Liste des commits de la version 1.5.0-beta01

Nouvelles fonctionnalités

  • Aucune modification par rapport à la version alpha. Celle-ci contenait les modifications suivantes :
    • Modification de l'intervalle entre les importations de façon programmatique, plutôt qu'en utilisant le codage en dur dans les paramètres initiaux.

Modifications apportées à l'API

  • Aucune modification par rapport à la version alpha. Celle-ci contenait les modifications suivantes :
    • Nouvelle fonction : TuningFork_setAggregationStrategyInterval
    • Nouveau champ dans TuningFork_Settings: aggregation_strategy_intervalms_or_count

Version 1.5.0-alpha01

18 août 2021

Publication d'androidx.games:games-performance-tuner:1.5.0-alpha01. Liste des commits de la version 1.5.0-alpha01

Nouvelles fonctionnalités

  • Il est désormais possible de définir l'intervalle entre les importations APT de façon programmatique, plutôt qu'en utilisant le fichier de paramètres.

Modifications apportées à l'API

  • Fonction ajoutée : TuningFork_setAggregationStrategyInterval
  • Ajout d'un champ à la structure TuningFork_Settings : aggregation_strategy_intervalms_or_count

Games-Activity version 1.0.0

Version 1.0.0

4 août 2021

Publication d'androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 et androidx.games:games-text-input:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

Il s'agit de la première version stable de Games-Activity, Games-Controller et Games-Text-Input. Pour en savoir plus, consultez la page d'accueil d'AGDK.

Version 1.0.0-rc01

12 juillet 2021

Publication d'androidx.games:games-activity:1.0.0-rc01. Liste des commits de la version 1.0.0-rc01

Correction de bugs

  • Correction du type renvoyé de GameActivityCallbacks::onSaveInstanceState

Version 1.0.0-beta01

30 juin 2021

Publication d'androidx.games:games-activity:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

Modifications apportées à l'API

  • Remplacement du nom GameActivityInputInfo par GameActivityPointerAxes.
  • Le rappel onNativeWindowResized donne désormais la largeur et la hauteur de la fenêtre.
  • Suppression du rappel onContentRectChanged.
  • Remplacement du nom onLowMemory par onTrimMemory.
  • Suppression de GameActivity_setWindowFormat.
  • Amélioration du modèle de propriété pour les pointeurs GameActivityMotionEvents et GameActivityMotionEvent.
  • Amélioration du modèle de propriété de l'état de l'utilisateur dans le rappel onSaveInstanceState.

Version 1.0.0-alpha01

16 juin 2021

Publication d'androidx.games:games-activity:1.0.0-alpha01.

Nouvelles fonctionnalités

  • Games-Activity est une nouvelle bibliothèque qui remplace NativeActivity comme méthode recommandée pour intégrer un jeu C/C++ à Android.

Games-Controller version 2.0

Version 2.0.1

20 septembre 2023

Publication d 'androidx.games: games-controller: 2.0.1. Liste des commits de la version 2.0.1

Correction de bugs liés à la manette de jeu:

  • Correction d'une condition NullReferenceException rare dans le gestionnaire onInputDeviceChanged.
  • Correction visant à empêcher certains claviers USB de s'enregistrer correctement en tant que manettes de jeu.

Version 2.0.0

8 mars 2023

Publication d'androidx.games:games-controller:2.0.0. Liste des commits de la version 2.0.0

Principales fonctionnalités de la version 2.0.0

  • Ajout de la possibilité de détecter l'état de connexion des claviers physiques.
  • Ajout de la possibilité de signaler les données de mouvement (accéléromètre/gyroscope) de l'appareil principal (téléphone) ainsi que des contrôleurs.
  • Modification de l'API et du format de la base de données de définition de contrôleurs afin de réduire l'encombrement de la mémoire et de prendre en charge des fonctionnalités supplémentaires.

Version 2.0.0-alpha01

11 janvier 2023

Publication d'androidx.games:games-controller:2.0.0-alpha01. Liste des commits de la version 2.0.0-alpha01

Nouvelles fonctionnalités

  • Détection du clavier physique
  • Prise en charge des rapports intégrés sur les mouvements des capteurs (réception des données du gyroscope et de l'accéléromètre du téléphone)
  • Nouveau format de données optimisé pour le mappage de la manette

Modifications apportées à l'API

  • Nouveaux appels d'API pour le clavier physique : Paddleboat_getPhysicalKeyboardStatus et Paddleboat_setPhysicalKeyboardStatusCallback
  • Nouveaux appels d'API pour les rapports intégrés sur les mouvements des capteurs : Paddleboat_getIntegratedMotionSensorFlags et Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • Nouveaux appels d'API pour le nouveau format de données pour le mappage de la manette : Paddleboat_addControllerRemapDataFromFd et Paddleboat_addControllerRemapDataFromFileBuffer
  • Abandon des anciens appels d'API de mappage : Paddleboat_addControllerRemapData et Paddleboat_getControllerRemapTableData

Correction de bugs

  • Résolution du problème de compatibilité avec les événements de mouvement à partir de la version 1.2.2 de GameActivity

Games-Controller version 1.1.0

Version 1.1.0

23 février 2022

Publication d'androidx.games:games-activity:1.1.0 et d'androidx.games:games-controller:1.1.0. Liste des commits de la version 1.1.0

Changements importants depuis la version 1.0.0

Games-Activity :

  • Écoute et interrogation de WindowInsets relatives à l'encoche et réponse d'IME
  • Ajout de filtres d'événements de touche et de mouvement
  • Correction de bugs :
    • Ajout des messages manquants pour assurer la compatibilité avec NativeActivity
    • Correction de la signature d'onNativeWindowResized
    • Correction des pertes d'événements d'entrée

Version 1.1.0-rc01

9 février 2022

Publication d'androidx.games:games-controller:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta01

26 janvier 2022

Publication d'androidx.games:games-controller:1.1.0-beta01 sans aucune modification par rapport à la version 1.1.0-alpha01. Liste des commits de la version 1.1.0-beta01

Version 1.1.0-alpha01

15 décembre 2021

Publication d'androidx.games:games-controller:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Nouvelles fonctionnalités

Ajout de la compatibilité avec l'état de la batterie, les vibrations à deux moteurs, le contrôle de l'éclairage et les rapports sur les axes de mouvement sur les manettes compatibles avec Android S ou version ultérieure.

Modifications apportées à l'API

  • Ajout de la fonction Paddleboat_setMotionDataCallback pour l'enregistrement des rappels de données en lien avec les mouvements de la manette.
  • Ajout de la fonction Paddleboat_setControllerLight pour modifier les paramètres d'éclairage de la manette.
  • Ajout de la structure Paddleboat_Controller_Battery à Paddleboat_Controller_Data
  • Nouvelles structures :
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Nouvelles énumérations :
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Nouveaux indicateurs de manette :
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Correction de bugs

  • Ajout d'une autre entrée de base de données deviceId pour la manette PS4
  • Ajout d'une entrée pour la manette PS5 dans la base de données pour les niveaux d'API >=31

Games-Controller version 1.0.0

Version 1.0.0

4 août 2021

Publication d'androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 et androidx.games:games-text-input:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

Il s'agit de la première version stable de Games-Activity, Games-Controller et Games-Text-Input. Pour en savoir plus, consultez la page d'accueil d'AGDK.

Version 1.0.0-rc02

21 juillet 2021

Publication d'androidx.games:games-controller:1.0.0-rc02. Liste des commits de la version 1.0.0-rc02

Correction de bugs

  • Correction de l'erreur d'empaquetage qui entraînait l'échec de l'importation de Prefab en cas de permutations architecture/version vides ou inutilisées.

Version 1.0.0-rc01

12 juillet 2021

Publication d'androidx.games:games-controller:1.0.0-rc01. Liste des commits de la version 1.0.0-rc01

Correction de bugs

  • Correction d'un problème d'incompatibilité avec la dernière version de GameActivity

Version 1.0.0-beta01

30 juin 2021

Publication d'androidx.games:games-controller:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

Modifications apportées à l'API

  • Les fonctions qui renvoyaient une valeur booléenne en cas de réussite ou d'échec renvoient maintenant une énumération Paddleboat_Error_Code.
  • Remplacement du nom Paddleboat_onPause par Paddleboat_onStop
  • Remplacement du nom Paddleboat_onResume par Paddleboat_onStart
  • Division de Paddleboat_processGameActivityEvent en deux fonctions : Paddleboat_processGameActivityKeyInputEvent et Paddleboat_processGameActivityMotionInputEvent
  • Suppression des fonctionnalités étendues de la manette qui nécessitaient une compilation avec une preview du SDK Android S
  • Ajout de la fonction Paddleboat_getBackButtonConsumed
  • Les rappels d'état de la manette et de la souris disposent désormais d'un paramètre facultatif de pointeur vers les données définies par l'utilisateur
  • Déplacement de la chaîne de nom de la manette en dehors de la structure des informations sur l'appareil. La chaîne est désormais accessible via la fonction Paddleboat_getControllerName

Correction de bugs

  • La connexion d'une manette qui ne s'affichait pas en tant que manette au départ, mais qui le faisait par la suite via un message onInputDeviceChanged n'était pas correctement détectée comme une connexion de manette.

Version 1.0.0-alpha01

16 juin 2021

Publication d'androidx.games:games-controller:1.0.0-alpha01.

Nouvelles fonctionnalités

  • Games-Controller est une nouvelle bibliothèque qui fournit une API C pour détecter les manettes de jeu, lire les entrées de celles-ci et interagir avec elles.

Games-Text-Input 2.1

Version 2.1.0-alpha01

26 juillet 2023

Publication d'androidx.games:games-text-input:2.1.0-alpha01. Liste des commits de la version 2.1.0-alpha01

Nouvelles fonctionnalités

  • Ajouter la prise en charge des modes multiligne et monoligne

Modifications apportées à l'API

  • Ajouter la fonction isSoftwareKeyboardVisible
  • Ajout de définitions de champs de bits pour GameActivity_setImeEditorInfo.
  • Ajouter un rappel onEditorAction

Correction de bugs

  • Correction d'un problème de désynchronisation des claviers physiques et logiciels
  • Effacer le curseur lorsque le clavier virtuel est masqué

Games-Text-Input 2.0

Version 2.0.0

8 mars 2023

Publication d'androidx.games:games-text-input:2.0.0. Liste des commits de la version 2.0.0

Changements importants depuis la version 1.1.1

  • Mise à jour de la version majeure en raison des modifications apportées au système de compilation, aucune mise à jour de la bibliothèque/de l'API elle-même.

Games-Text-Input version 1.1

Version 1.1.2-alpha01

9 novembre 2022

Publication d'androidx.games:games-text-input:1.1.2-alpha01. Liste des commits de la version 1.1.2-alpha01

Nouvelles fonctionnalités

  • Aucune nouvelle modification

Version 1.1.1

13 juillet 2022

Publication d'androidx.games:games-text-input:1.1.1. Liste des commits de la version 1.1.1

Correction de bugs

  • Correction du problème de fichier .aar manquant dans la version précédente.

Version 1.1.0

9 février 2022

Publication d'androidx.games:games-text-input:1.1.0. Liste des commits de la version 1.1.0

Changements importants depuis la version 1.0.0 - Ajout d'une fonctionnalité d'écoute et d'interrogation WindowInsets à GameTextInput - Ajout de l'en-tête gamecommon.h manquant

Version 1.1.0-rc01

26 janvier 2022

Publication d'androidx.games:games-text-input:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta01

15 décembre 2021

Publication d'androidx.games:games-text-input:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01

Correction de bugs

  • Correction des encarts de cascade d'annonces et d'IME
  • Ajouter de l'en-tête gamecommon.h manquant

Version 1.1.0-alpha01

13 octobre 2021

Publication d'androidx.games:games-text-input:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Modifications apportées à l'API

  • Ajout d'encarts IME à GameTextInput

Games-Text-Input version 1.0

Version 1.0.0

4 août 2021

Publication d'androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 et androidx.games:games-text-input:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

Il s'agit de la première version stable de Games-Activity, Games-Controller et Games-Text-Input. Pour en savoir plus, consultez la page d'accueil d'AGDK.

Version 1.0.0-rc01

12 juillet 2021

Publication d'androidx.games:games-text-input:1.0.0-rc01 sans aucune modification. Liste des commits de la version 1.0.0-rc01

Version 1.0.0-beta01

30 juin 2021

Publication d'androidx.games:games-text-input:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

Modifications apportées à l'API

  • Amélioration du modèle de propriété des objets GameTextInputState.
  • Organisation des types pour cohérence avec le NDK.

Version 1.0.0-alpha01

16 juin 2021

Publication d'androidx.games:games-text-input:1.0.0-alpha01.

Nouvelles fonctionnalités

  • Games-Text-Input est une nouvelle bibliothèque qui permet aux développeurs de jeux d'utiliser la saisie au clavier virtuel Android depuis C/C++.

Games Frame Pacing version 2.1

Version 2.1.0

15 novembre 2023

Publication d'androidx.games:games-frame-pacing:2.1.0. Liste des commits de la version 2.1.0

Version 2.1.0-rc01

20 septembre 2023

Publication d'androidx.games:games-frame-pacing:2.1.0-rc01. Liste des commits de la version 2.1.0-rc01

Version 2.1.0-beta01

24 mai 2023

Publication d'androidx.games:games-frame-pacing:2.1.0-beta01. Liste des commits de la version 2.1.0-beta01

Correction de bugs

  • Délai avant expiration en cas d'échec de l'initialisation de NDKChoreographer. (ef466d)
  • Lorsque vous utilisez explicitement la fréquence d'actualisation des requêtes SwappyGL_getSupportedRefreshPeriodsNS depuis le système. (C85235)

Version 2.1.0-alpha01

5 avril 2023

Publication d'androidx.games:games-frame-pacing:2.1.0-alpha01. Liste des commits de la version 2.1.0-alpha01

Nouvelles fonctionnalités

  • Nouvelle API permettant de réinitialiser l'état du frame pacing.
  • Nouvelle API permettant de désactiver l'impact du frame pacing de Swappy tout en observant les temps de processeur et de GPU.

Modifications apportées à l'API

  • Vous pouvez désormais utiliser SwappyGL_resetFramePacing/SwappyVk_resetFramePacing pour réinitialiser l'état interne du frame pacing. Le frame pacing ne prend désormais en compte que les données à partir du moment où l'API de réinitialisation est appelée.
  • Vous pouvez désormais utiliser SwappyGL_enableFramePacing/SwappyVk_enableFramePacing pour activer/désactiver le frame pacing de Swappy. Lorsque cette option est désactivée,
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait permet de contrôler si une attente bloquante du travail GPU du dernier frame se produit lorsque le frame pacing est désactivé.

Correction de bugs

  • Les améliorations des performances sont apportées aux cas liés au GPU lors de l'utilisation de l'API Swappy GL.

Games Frame Pacing version 2.0

Version 2.0.0

8 mars 2023

Publication d'androidx.games:games-frame-pacing:2.0.0. Liste des commits de la version 2.0.0

Changements importants depuis la version 1.10.1

  • Le système de compilation a subi des modifications majeures, ce qui a conduit à la génération d'une seule bibliothèque au lieu de plusieurs par version du SDK/NDK.
  • Des statistiques de frame Vulkan ont été ajoutées.
  • Une nouvelle API permettant d'effacer les statistiques de frames a été ajoutée.
  • Les journaux sont tous silencieux en mode version et peuvent être activés en mode débogage.

Version 2.0.0-rc01

22 février 2023

Publication d'androidx.games:games-frame-pacing:2.0.0-rc01. Liste des commits de la version 2.0.0-rc01

Nouvelles fonctionnalités

  • La journalisation est maintenant masquée derrière un indicateur de compilation. Par défaut, le build de la bibliothèque n'est associé à aucune journalisation, et la journalisation est complètement activée dans la version de débogage de la bibliothèque.

Version 2.0.0-beta01

8 février 2023

Publication d'androidx.games:games-frame-pacing:2.0.0-beta01. Liste des commits de la version 2.0.0-beta01

Nouvelles fonctionnalités

  • Ajout d'une nouvelle API pour effacer les statistiques des frames.

Modifications apportées à l'API

  • Ajout des API SwappyGL_clearStats et SwappyGL_clearStats.

Version 2.0.0-alpha01

11 janvier 2023

Publication d'androidx.games:games-frame-pacing:2.0.0-alpha01. Liste des commits de la version 2.0.0-alpha01

Nouvelles fonctionnalités

  • Ajout de statistiques de cadence Vulkan

Modifications apportées à l'API

  • Augmentation de la version majeure en raison de la refactorisation des fichiers de compilation
  • Ajout de trois nouvelles API : SwappyVk_enableStats, SwappyVk_recordFrameStart et SwappyVk_getStats

Correction de bugs

  • Application du seuil uniquement en mode d'échange automatique (Ic0786)

Games Frame Pacing 1.10

Version 1.10.2-alpha01

9 novembre 2022

Publication d'androidx.games:games-frame-pacing:1.10.2-alpha01. Liste des commits de la version 1.10.2-alpha01

Nouvelles fonctionnalités

  • Aucune nouvelle modification

Version 1.10.1

15 juin 2022

Publication d'androidx.games:games-frame-pacing:1.10.1. Liste des commits de la version 1.10.1

Correction de bugs

  • Correction d'un problème d'absence de compilation de Swappy avec les versions de NDK inférieures à 23 et supérieures à 17.
  • Exposition de l'API pour récupérer les fréquences d'actualisation compatibles avec l'écran.

Version 1.10.0

23 février 2022

Publication d'androidx.games:games-frame-pacing:1.10.0. Liste des commits de la version 1.10.0

Changements importants depuis la version 1.9.0

  • Les entrées de filtre polluantes de Choreographer sont ignorées. Augmentation de la fluidité pour éviter les blocages sur l'émulateur
  • Ajout de fonctions *_uninjectTracer.

Version 1.10.0-rc01

9 février 2022

Publication d'androidx.games:games-frame-pacing:1.10.0-rc01. Liste des commits de la version 1.10.0-rc01

Version 1.10.0-beta01

26 janvier 2022

Publication d'androidx.games:games-frame-pacing:1.10.0-beta01. Liste des commits de la version 1.10.0-beta01

Version 1.10.0-alpha01

15 décembre 2021

Publication d'androidx.games:games-frame-pacing:1.10.0-alpha01. Liste des commits de la version 1.10.0-alpha01

Nouvelles fonctionnalités

  • Ajout de la fonction SwappyGL_uninjectTracer.

Modifications apportées à l'API

  • Suppression des rappels précédemment ajoutés avec SwappyGL_injectTracer à l'aide de l'API SwappyGL_uninjectTracer(const SwappyTracer *t).

Games Frame Pacing 1.9

Version 1.9.1

13 octobre 2021

Publication d'androidx.games:games-frame-pacing:1.9.1. Liste des commits de la version 1.9.1

Correction de bugs

Version 1.9.0

12 juillet 2021

Publication d'androidx.games:games-frame-pacing:1.9.0. Liste des commits de la version 1.9.0

Changements importants depuis la version 1.7.0

  • Mise à jour pour correspondre au schéma de gestion des versions interne.

Games Frame Pacing 1.7.0

Version 1.7.0

30 juin 2021

Publication d'androidx.games:games-frame-pacing:1.7.0. Liste des commits de la version 1.7.0

Version 1.7.0-rc01

2 juin 2021

Publication d'androidx.games:games-frame-pacing:1.7.0-rc01. Liste des commits de la version 1.7.0-rc01

Version 1.7.0-beta02

24 février 2021

Publication d'androidx.games:games-frame-pacing:1.7.0-beta02.

Version 1.7.0-beta01

16 décembre 2020

Publication d'androidx.games:games-frame-pacing:1.7.0-beta01.

Games Performance Tuner 1.4.3

Version 1.4.3

12 juillet 2021

Publication d'androidx.games:games-performance-tuner:1.4.3. Liste des commits de la version 1.4.3

Changements importants depuis la version 1.1.0

  • Mise à jour pour correspondre au schéma de gestion des versions interne.

Games Performance Tuner 1.1.0

Version 1.1.0

30 juin 2021

Publication d'androidx.games:games-performance-tuner:1.1.0. Liste des commits de la version 1.1.0

Version 1.1.0-rc01

2 juin 2021

Publication d'androidx.games:games-performance-tuner:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta03

21 avril 2021

Publication d'androidx.games:games-performance-tuner:1.1.0-beta03.

Version 1.1.0-beta02

24 février 2021

Publication d'androidx.games:games-performance-tuner:1.1.0-beta02.

Version 1.1.0-beta01

16 décembre 2020

Publication d'androidx.games:games-performance-tuner:1.1.0-beta01.

Version 1.1.0-alpha01

Publication d'androidx.games:games-performance-tuner:1.1.0-alpha01.

Version 1.0.0

Version 1.0.0-alpha02

12 août 2020

En anglais, la bibliothèque Android Gaming a été renommée en bibliothèque Android Games.

androidx.gaming -> androidx.games

Version 1.0.0-alpha01

10 juin 2020

Publication d'androidx.games:1.0.0-alpha01.