Notas de la versión

En esta página, se describen los cambios realizados en cada versión de las bibliotecas de Android Game Development Kit (AGDK). Hasta la versión 1.2.4, estas bibliotecas se conocían como el SDK de juegos de Android.

2023.3.0.0 (2 de junio de 2023)

Esta versión incluye varias correcciones de errores.

Actividaddejuego

corrección Se realizaron correcciones de estabilidad en GameActivityEvents.

Biblioteca de Memory Advice de Android

función Se actualizó el modelo de aprendizaje automático que potencia la biblioteca, lo que puede permitir mejores resultados para los teléfonos más nuevos.

Android Performance Tuner

corrección Se corrigió un error por el que fallaba la biblioteca si la cantidad máxima de teclas de instrumentación superaba el recuento de histogramas.
función Se actualizaron las funciones de recopilación de telemetría en la biblioteca, lo que permite generar informes más detallados de los tiempos de renderización de fotogramas.

2023.2.0.0 (27 de abril de 2023)

Esta versión incluye varias correcciones de errores.

Actividaddejuego

corrección Se corrigió la liberación anticipada de memoria con historyEventTimes.
corrección Se corrigió el problema con el desbordamiento de historyEventTimesNanos en sistemas de 32 bits.

Biblioteca de Memory Advice de Android

corrección Se corrigió un error que impedía que la versión estática de la biblioteca se vinculara correctamente.
corrección Se corrigió un error en el que la biblioteca no podía cargar correctamente los recursos necesarios de TensorFlow Lite.

2023.1.0.0 (15 de marzo de 2023)

Esta actualización importante incluye actualizaciones del sistema de compilación para compilar bibliotecas más rápido desde la fuente.

Actividaddejuego

cambiaste Se cambió la interfaz para los tiempos de eventos históricos a fin de superar el límite de 32 bits.
función Se proporcionó al usuario acceso a los cambios de configuración.
función Se optimizó la mayoría de las llamadas JNI en el control de eventos táctiles.
corrección Se corrigió el control predeterminado del SO de eventos táctiles, como el control de botones del sistema.

GameController

función Se agregó la capacidad de detectar el estado de conexión de los teclados de hardware.
función Se agregó la capacidad de informar datos de movimiento (acelerómetro/giroscopio) desde el dispositivo principal (es decir, el teléfono celular) y los controles.
cambiaste Se cambió la API y el formato de la base de datos de definición del controlador para reducir el uso de memoria y admitir funciones adicionales.

Biblioteca de Android Frame Pacing

función Se agregaron estadísticas de fotogramas de Vulkan.
función Se agrega una nueva API para borrar estadísticas de fotogramas.
cambiaste Los registros son silenciosos en el modo de lanzamiento y se pueden habilitar en el modo de depuración.

2022.0.0 (15 de marzo de 2022)

Esta actualización importante incluye la biblioteca de consejos sobre memoria y varias correcciones para otras bibliotecas.

Actividaddejuego

función Se agregó el control de las inserciones para el posicionamiento de la IU del juego alrededor del IME y los cortes.
función Se agregaron filtros de eventos de teclas y movimiento.
corrección Se realizaron correcciones para evitar la pérdida de eventos de entrada y evitar que se consuman todos ellos.

Android Performance Tuner

cambiaste Los informes de memoria ahora son como series temporales en lugar de histogramas
función Permitir que se configure el intervalo de carga de forma programática
corrección Se corrigió el error de la clave de API dañada.

Biblioteca de Android Frame Pacing

función Mejoras en el modo automático
función Agrega funciones "uninjectTracer".

Biblioteca de Memory Advice de Android

función Se agregó la biblioteca de Memory Advice

2021.1.0 (12 de julio de 2021)

Cuando solíamos referirnos a este producto como el SDK de juegos de Android, ahora se lo conoce como Android Game Development Kit. Esta actualización principal incluye varias bibliotecas nuevas, junto con correcciones de errores menores en las bibliotecas de Android Frame Pacing y Android Performance Tuner.

función GameActivity es un componente nuevo que reemplaza y mejora la NativeActivity del NDK.
función GameTextInput es un nuevo componente que mejora la interacción con el teclado en pantalla de Android.
función GameController es un componente nuevo que facilita la interacción con controladores externos y su administración.

1.2.4 (21 de abril de 2021)

Esta es una versión de corrección de errores para Android Performance Tuner.

Android Performance Tuner

corrección Se corrigió el tiempo de carga y el registro de la duración en dispositivos con CLOCK_BOOTTIME inconsistente.

1.2.3 (10 de marzo de 2021)

Esta versión agrega Oboe al SDK de juegos. No se realizaron cambios en la biblioteca de Android Frame Pacing ni en Android Performance Tuner.

Oboe es una biblioteca C++ de código abierto para audio de alto rendimiento en Android. Oboe brinda una única API nativa que funciona en Android 4.1 (nivel de API 16) y versiones posteriores.

1.2.2 (12 de febrero de 2021)

Esta versión tiene mejoras en la API de tiempos de carga para Android Performance Tuner y varias correcciones de errores. No se realizaron cambios en la biblioteca Android Frame Pacing.

Android Performance Tuner

función Ahora, los eventos de carga deben agruparse con llamadas a TuningFork_startLoadingGroup y TuningFork_stopLoadingGroup.
corrección Llamar a TuningFork_flush sube los datos de inmediato en lugar de ponerlos en cola para subirlos después.
corrección Se produjo un error intermitente en la carga debido al formato JSON de los tiempos.
corrección Un problema con las cargas en compilaciones de lanzamiento.

1.2.1 (16 de diciembre, 2020)

Este es un lanzamiento interno de la función para Android Performance Tuner y una promoción de las bibliotecas de Jetpack de la versión alfa a la versión beta. No se realizaron cambios en las API de Android Frame Pacing ni de Android Performance Tuner.

Ten en cuenta que ahora se debe referir a las bibliotecas del SDK de juegos de manera individual cuando vincules con ellas, en lugar de vincular con la biblioteca genérica "gamesdk". Consulta la configuración de la compilación para Android Frame Pacing: OpenGL, Android Frame Pacing: Vulkan y Android Performance Tuner.

Android Performance Tuner

función Cuando un jugador ejecuta en segundo plano un juego durante la carga, se envía un evento para analizar el abandono de carga más adelante.

1.2.0 (29 de octubre de 2020)

El cambio principal en esta versión es la adición de un mecanismo para registrar los tiempos de carga. También se corrigieron algunos errores. Ten en cuenta que el SDK de juegos ahora está disponible a través de la biblioteca de Jetpack para las bibliotecas de AGDK.

Biblioteca de Android Frame Pacing

función Compatibilidad con el cambio de frecuencia de la actualización del modo automático
Ten en cuenta que, para admitir varias frecuencias de actualización en Android 11, independientemente de que se use el modo automático o no, se debe llamar a SwappyGL_setWindow o a SwappyVk_setWindow.
corrección Corrección de errores en modo automático.
corrección Corrección de errores de Vulkan.

Android Performance Tuner

función Tiempos de carga.
Se debe llamar a las funciones nuevas TuningFork_startRecordingLoadingTime y TuningFork_stopRecordingLoadingTime para registrar los eventos de tiempo de carga con anotaciones. El tiempo desde el inicio de la app hasta TuningFork_init y la primera marca se registran automáticamente.
cambiaste El método anterior para configurar una anotación del tiempo de carga dejará de funcionar.
función Eventos de ciclo de vida.
Se debe llamar a TuningFork_reportLifecycleEvent después de que se llame al onCreate adecuado de Java, etc., lo que habilita los informes de fallas detallados desde Android Performance Tuner.
cambiaste Ahora, se registran más métricas de memoria cuando se llama a TuningFork_enableMemoryRecording(true).
cambiaste Cambio en el modelo de memoria.
Ahora, la cantidad máxima de métricas de cada tipo se especifica al inicio, en lugar de asignar espacio para todas las combinaciones de anotaciones posibles. Consulta TuningFork_MetricLimits en tuningfork.h.
corrección No se realizaron cargas en conexiones de uso medido.

1.1.0 (10 de junio de 2020)

Esta versión de las bibliotecas de AGDK cuenta con el informe de métricas de Android Performance Tuner y la biblioteca de ajustes de calidad (también conocida como Tuning Fork). Esta biblioteca está disponible para motores de juegos nativos y Unity, y presenta las siguientes funciones:

función Se realiza una integración con la biblioteca de Android Frame Pacing a fin de registrar automáticamente la latencia de fotogramas y otras métricas de procesamiento.
función La información de latencia de fotogramas se graba en histogramas y se sube de forma periódica.
función La anotación de los datos de latencia se basa en el estado actual del juego.
función Las características, las anotaciones y la configuración de calidad del dispositivo se suben junto con los datos de latencia para permitir un análisis integral.
función Se tratan de manera especial las anotaciones que indican el tiempo de carga de los niveles. Durante la carga, no se graban los datos de marcas de fotogramas, pero sí la duración de cada período de esta.
función Se incluye la capacidad para grabar información de latencia personalizada (mediante startTrace y endTrace).

1.0.2 (30 de marzo de 2020)

Esta versión incluye correcciones de errores y cambios en el comportamiento del modo automático.

corrección Se corrigieron errores de destrucción e inicialización nueva de Swappy.
cambiaste La canalización ahora está activada de forma predeterminada. Swappy podrá desactivar la canalización automática cuando la carga de trabajo sea muy baja.
cambiaste Si el modo automático está habilitado, Swappy decidirá cambiar el intervalo de intercambio cuando el 15% de los fotogramas en una ventana de 2 segundos sean más rápidos o más lentos de lo esperado. Ten en cuenta que Swappy nunca establecerá un intercambio más lento que el especificado por el usuario.

1.0.1 (19 de febrero de 2020)

Esta es, esencialmente, una versión de corrección de errores.

corrección Limpia los recursos en la salida, en la ruta de acceso del código SwappyFallback en Vulkan.
corrección SwappyVk_destroySwapchain ya no destruye los recursos del dispositivo si hay más de una cadena de intercambio.
corrección La versión de Swappy ahora se imprime en logcat.
corrección Se corrigieron interbloqueos y fallas en Swappy_destroy para el nivel de API 24 y versiones anteriores.
función Se admiten administradores de subprocesos personalizados (Swappy_setThreadFunctions).
función Se admite el hook de funciones de Vulkan (SwappyVk_setFunctionProvider).

1.0.0 (5 de diciembre de 2019)

Esta versión inicial de las bibliotecas de AGDK incluye la biblioteca de Android Frame Pacing.

función Se incluye sincronización del búfer de pantalla.
función Se admite la canalización y el modo de frecuencia de actualización automática.
función Recopilación de estadísticas de procesamiento de fotogramas.
función La selección del comportamiento durante el tiempo de ejecución se realizar de manera fluida en virtud de las funciones de Android, OpenGL y Vulkan requeridas por Swappy que estén presentes.
función Se incluye vinculación estática y dinámica de la biblioteca.
función Se admiten dispositivos con varias frecuencias de actualización.