На этой странице описаны изменения для каждого выпуска библиотек Android Game Development Kit (AGDK). До выпуска версии 1.2.4 он назывался Android Games SDK.
2023.3.0.0 (2 июня 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправления стабильности в GameActivityEvents. |
Библиотека рекомендаций по памяти Android
| особенность | Обновлена модель машинного обучения, лежащая в основе библиотеки, что может улучшить результаты для новых телефонов. |
Android-тюнер производительности
| зафиксированный | Исправлена ошибка, из-за которой библиотека аварийно завершала работу, если максимальное количество ключей инструментов превышало количество гистограмм. |
| особенность | Обновлены функции сбора телеметрии в библиотеке, что позволяет более детально составлять отчеты о времени рендеринга кадров. |
2023.2.0.0 (27 апреля 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправлено раннее освобождение памяти с помощью HistoricalEventTimes. |
| зафиксированный | Исправлена проблема с переполнением HistoricalEventTimesNanos в 32-битных системах. |
Библиотека рекомендаций по памяти Android
| зафиксированный | Исправлена ошибка, из-за которой статическая версия библиотеки не могла быть правильно скомпонована. |
| зафиксированный | Исправлена ошибка, из-за которой библиотека не могла правильно загрузить необходимые ресурсы TensorFlow Lite. |
2023.1.0.0 (15 марта 2023 г.)
В этот основной выпуск включены обновления системы сборки, позволяющие быстрее создавать библиотеки из исходного кода.
| измененный | Интерфейс для отображения времени исторических событий изменен, чтобы преодолеть ограничение в 32 бита. |
| особенность | Предоставлен доступ пользователей к изменениям конфигурации. |
| особенность | Оптимизировано большинство вызовов JNI при обработке событий касания. |
| зафиксированный | Исправлена обработка сенсорных событий ОС по умолчанию, например обработка системных кнопок. |
| особенность | Добавлена возможность определять состояние подключения аппаратных клавиатур. |
| особенность | Добавлена возможность сообщать данные о движении (акселерометр/гироскоп) с основного устройства (например, телефона), а также с контроллеров. |
| измененный | Изменен API и формат базы данных определений контроллера для уменьшения объема памяти и поддержки дополнительных функций. |
Библиотека синхронизации кадров Android
| особенность | Добавлена статистика Vulkan Frame. |
| особенность | Добавлен новый API для очистки статистики кадров. |
| измененный | В режиме выпуска все журналы молчат, их можно включить в режиме отладки. |
2022.0.0 (15 марта 2022 г.)
Этот основной выпуск включает библиотеку рекомендаций по памяти и несколько исправлений для других библиотек.
| особенность | Добавлена обработка вставок для позиционирования игрового пользовательского интерфейса вокруг IME и вырезов. |
| особенность | Добавьте фильтры событий ключа и движения. |
| зафиксированный | Исправления, позволяющие избежать потери событий ввода и предотвратить использование всех событий ввода. |
Android-тюнер производительности
| измененный | Отчеты о памяти теперь представлены в виде временных рядов, а не гистограмм. |
| особенность | Разрешить программную настройку интервала загрузки |
| зафиксированный | Исправлена ошибка с поврежденным ключом API. |
Библиотека синхронизации кадров Android
| особенность | Улучшения в автоматическом режиме |
| особенность | Добавьте функции uninjectTracer. |
Библиотека рекомендаций по памяти Android
| особенность | Добавлена библиотека советов по памяти. |
2021.1.0 (12 июля 2021 г.)
Раньше мы называли этот продукт Android Game SDK, теперь он называется Android Game Development Kit. Этот основной выпуск включает в себя несколько новых библиотек, а также незначительные исправления ошибок в библиотеках Android Frame Pacing и Android Performance Tuner.
| особенность | GameActivity — это новый компонент, который заменяет и улучшает NativeActivity из NDK. |
| особенность | GameTextInput — это новый компонент, улучшающий взаимодействие с программной клавиатурой Android. |
| особенность | GameController — это новый компонент, который упрощает взаимодействие с внешними контроллерами и управление ими. |
1.2.4 (21 апреля 2021 г.)
Этот выпуск представляет собой исправление ошибок в Android Performance Tuner.
Android-тюнер производительности
| зафиксированный | Исправлена запись времени загрузки и продолжительности на устройствах с несогласованным CLOCK_BOOTTIME . |
1.2.3 (10 марта 2021 г.)
В этом выпуске в Game SDK добавлен гобой . В библиотеке Android Frame Pacing и Android Performance Tuner изменений нет.
Oboe — это библиотека C++ с открытым исходным кодом для высококачественного звука на Android. Oboe предоставляет единый собственный API, который работает в Android 4.1 (уровень API 16) и выше.
1.2.2 (12 февраля 2021 г.)
В этом выпуске улучшен API времени загрузки для Android Performance Tuner, а также исправлено несколько ошибок. В библиотеке Android Frame Pacing изменений нет.
Android-тюнер производительности
| особенность | События загрузки теперь необходимо группировать с помощью вызовов TuningFork_startLoadingGroup и TuningFork_stopLoadingGroup . |
| зафиксированный | Вызов TuningFork_flush немедленно загружает данные, а не ставит их в очередь для последующей загрузки. |
| зафиксированный | Периодический сбой загрузки из-за форматирования времени в формате JSON. |
| зафиксированный | Проблема с загрузкой в релизные сборки. |
1.2.1 (16 декабря 2020 г.)
Этот выпуск представляет собой внутренний выпуск функций Android Performance Tuner и продвижение библиотек Jetpack из альфа-версии в бета-версию. Никаких изменений в API Android Frame Pacing или Android Performance Tuner не произошло.
Обратите внимание, что библиотеки Game SDK теперь необходимо ссылаться индивидуально при связывании с ними, а не с общей библиотекой gamesdk. См. настройки сборки для Android Frame Pacing: OpenGL , Android Frame Pacing: Vulkan и Android Performance Tuner .
Android-тюнер производительности
| особенность | Когда игрок запускает игру в фоновом режиме во время загрузки, событие отправляется для последующего анализа прерывания загрузки. |
1.2.0 (29 октября 2020 г.)
Основным изменением в этой версии является добавление механизма записи времени загрузки. Также есть некоторые исправления ошибок. Обратите внимание, что Game SDK теперь доступен через библиотеку Jetpack AGDK Libraries .
Библиотека синхронизации кадров Android
| особенность | Поддержка переключения частоты обновления в автоматическом режиме. Обратите внимание, что для поддержки нескольких частот обновления в Android 11, независимо от того, используется ли автоматический режим или нет, следует вызывать SwappyGL_setWindow или SwappyVk_setWindow . |
| зафиксированный | Исправлены ошибки автоматического режима. |
| зафиксированный | Исправления ошибок Вулкана. |
Android-тюнер производительности
| особенность | Время загрузки. Новые функции TuningFork_startRecordingLoadingTime и TuningFork_stopRecordingLoadingTime должны вызываться для записи аннотированных событий времени загрузки. Время от запуска приложения до TuningFork_init и первого тика записывается автоматически. |
| измененный | Предыдущий метод установки аннотации времени загрузки больше не будет работать. |
| особенность | События жизненного цикла.TuningFork_reportLifecycleEvent следует вызывать при вызове соответствующего Java onCreate и т. д. Это позволяет получать подробные отчеты о сбоях из Android Performance Tuner. |
| измененный | При вызове TuningFork_enableMemoryRecording(true) теперь записывается больше показателей памяти. |
| измененный | Изменение модели памяти. Максимальное количество метрик каждого типа теперь указывается при запуске, а не выделяется место для всех возможных комбинаций аннотаций. См. TuningFork_MetricLimits в tuningfork.h . |
| зафиксированный | Нет загрузки на лимитные соединения. |
1.1.0 (10 июня 2020 г.)
Эта версия библиотек AGDK включает библиотеку отчетов по метрикам Android Performance Tuner и настройку качества (также известную как Tuning Fork). Эта библиотека доступна как для собственных игровых движков, так и для Unity, и имеет следующие функции:
| особенность | Интеграция с библиотекой Android Frame Pacing для автоматической записи времени кадра и других показателей рендеринга. |
| особенность | Информация о синхронизации кадров записывается в гистограммах и периодически загружается. |
| особенность | Аннотация данных синхронизации с текущим состоянием игры. |
| особенность | Характеристики устройства, аннотации и настройки качества загружаются вместе с данными синхронизации, что позволяет провести перекрестный анализ. |
| особенность | Особая обработка аннотаций, обозначающих время загрузки уровня. Данные такта кадра не записываются во время загрузки, но продолжительность каждого периода загрузки записывается. |
| особенность | Возможность записи пользовательской информации о времени (с использованием startTrace и endTrace ). |
1.0.2 (30 марта 2020 г.)
Эта версия включает исправления ошибок и изменения в поведении автоматического режима.
| зафиксированный | Исправлены ошибки при уничтожении и повторной инициализации swappy. |
| измененный | Конвейерная обработка теперь включена по умолчанию. Если автоматическая конвейеризация включена, Swappy все равно может отключить ее, когда рабочая нагрузка очень низкая. |
| измененный | Когда автоматический режим включен, Swappy решит переключить интервал замены только после того, как 15% кадров в течение 2-секундного окна будут быстрее или медленнее, чем ожидалось. Обратите внимание, что Swappy никогда не будет выполнять обмен медленнее, чем заданный пользователем интервал обмена. |
1.0.1 (19 февраля 2020 г.)
Эта версия в первую очередь представляет собой выпуск с исправлением ошибок.
| зафиксированный | Очистите ресурсы при выходе по пути к коду SwappyFallback в Vulkan. |
| зафиксированный | SwappyVk_destroySwapchain больше не уничтожает ресурсы устройства, если существует более одной цепочки обмена. |
| зафиксированный | Версия Swappy теперь печатается в logcat . |
| зафиксированный | Сбои и взаимоблокировки в Swappy_destroy для уровня API 24 и ниже. |
| особенность | Поддержка пользовательских менеджеров потоков ( Swappy_setThreadFunctions ). |
| особенность | Поддержка перехвата функций Vulkan ( SwappyVk_setFunctionProvider ). |
1.0.0 (5 декабря 2019 г.)
Эта первоначальная версия библиотек AGDK включает библиотеку Android Frame Pacing .
| особенность | Синхронизация буфера дисплея. |
| особенность | Режим автоматической частоты обновления и поддержка конвейерной обработки. |
| особенность | Сбор статистики рендеринга кадров. |
| особенность | Грамотный выбор поведения во время выполнения в зависимости от наличия функций Android, OpenGL и Vulkan, необходимых Swappy. |
| особенность | Статическая и динамическая компоновка библиотеки. |
| особенность | Поддержка устройств с несколькими частотами обновления. |
На этой странице описаны изменения для каждого выпуска библиотек Android Game Development Kit (AGDK). До выпуска версии 1.2.4 он назывался Android Games SDK.
2023.3.0.0 (2 июня 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправления стабильности в GameActivityEvents. |
Библиотека рекомендаций по памяти Android
| особенность | Обновлена модель машинного обучения, лежащая в основе библиотеки, что может улучшить результаты для новых телефонов. |
Android-тюнер производительности
| зафиксированный | Исправлена ошибка, из-за которой библиотека аварийно завершала работу, если максимальное количество ключей инструментов превышало количество гистограмм. |
| особенность | Обновлены функции сбора телеметрии в библиотеке, что позволяет более детально составлять отчеты о времени рендеринга кадров. |
2023.2.0.0 (27 апреля 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправлено раннее освобождение памяти с помощью HistoricalEventTimes. |
| зафиксированный | Исправлена проблема с переполнением HistoricalEventTimesNanos в 32-битных системах. |
Библиотека рекомендаций по памяти Android
| зафиксированный | Исправлена ошибка, из-за которой статическая версия библиотеки не могла быть правильно скомпонована. |
| зафиксированный | Исправлена ошибка, из-за которой библиотека не могла правильно загрузить необходимые ресурсы TensorFlow Lite. |
2023.1.0.0 (15 марта 2023 г.)
В этот основной выпуск включены обновления системы сборки, позволяющие быстрее создавать библиотеки из исходного кода.
| измененный | Интерфейс для отображения времени исторических событий изменен, чтобы преодолеть ограничение в 32 бита. |
| особенность | Предоставлен доступ пользователей к изменениям конфигурации. |
| особенность | Оптимизировано большинство вызовов JNI при обработке событий касания. |
| зафиксированный | Исправлена обработка сенсорных событий ОС по умолчанию, например обработка системных кнопок. |
| особенность | Добавлена возможность определять состояние подключения аппаратных клавиатур. |
| особенность | Добавлена возможность сообщать данные о движении (акселерометр/гироскоп) с основного устройства (например, телефона), а также с контроллеров. |
| измененный | Изменен API и формат базы данных определений контроллера для уменьшения объема памяти и поддержки дополнительных функций. |
Библиотека синхронизации кадров Android
| особенность | Добавлена статистика Vulkan Frame. |
| особенность | Добавлен новый API для очистки статистики кадров. |
| измененный | В режиме выпуска все журналы молчат, их можно включить в режиме отладки. |
2022.0.0 (15 марта 2022 г.)
Этот основной выпуск включает библиотеку рекомендаций по памяти и несколько исправлений для других библиотек.
| особенность | Добавлена обработка вставок для позиционирования игрового пользовательского интерфейса вокруг IME и вырезов. |
| особенность | Добавьте фильтры событий ключа и движения |
| зафиксированный | Исправления, позволяющие избежать потери событий ввода и предотвратить использование всех событий ввода. |
Android-тюнер производительности
| измененный | Отчеты о памяти теперь представлены в виде временных рядов, а не гистограмм. |
| особенность | Разрешить программную настройку интервала загрузки |
| зафиксированный | Исправлена ошибка с поврежденным ключом API. |
Библиотека синхронизации кадров Android
| особенность | Улучшения в автоматическом режиме |
| особенность | Добавьте функции uninjectTracer. |
Библиотека рекомендаций по памяти Android
| особенность | Добавлена библиотека советов по памяти. |
2021.1.0 (12 июля 2021 г.)
Раньше мы называли этот продукт Android Game SDK, теперь он называется Android Game Development Kit. Этот основной выпуск включает в себя несколько новых библиотек, а также незначительные исправления ошибок в библиотеках Android Frame Pacing и Android Performance Tuner.
| особенность | GameActivity — это новый компонент, который заменяет и улучшает NativeActivity из NDK. |
| особенность | GameTextInput — это новый компонент, улучшающий взаимодействие с программной клавиатурой Android. |
| особенность | GameController — это новый компонент, который упрощает взаимодействие с внешними контроллерами и управление ими. |
1.2.4 (21 апреля 2021 г.)
Этот выпуск представляет собой исправление ошибок в Android Performance Tuner.
Android-тюнер производительности
| зафиксированный | Исправлена запись времени загрузки и продолжительности на устройствах с несогласованным CLOCK_BOOTTIME . |
1.2.3 (10 марта 2021 г.)
В этом выпуске в Game SDK добавлен гобой . В библиотеке Android Frame Pacing и Android Performance Tuner изменений нет.
Oboe — это библиотека C++ с открытым исходным кодом для высококачественного звука на Android. Oboe предоставляет единый собственный API, который работает в Android 4.1 (уровень API 16) и выше.
1.2.2 (12 февраля 2021 г.)
В этом выпуске улучшен API времени загрузки для Android Performance Tuner, а также исправлено несколько ошибок. В библиотеке Android Frame Pacing изменений нет.
Android-тюнер производительности
| особенность | События загрузки теперь необходимо группировать с помощью вызовов TuningFork_startLoadingGroup и TuningFork_stopLoadingGroup . |
| зафиксированный | Вызов TuningFork_flush немедленно загружает данные, а не ставит их в очередь для последующей загрузки. |
| зафиксированный | Периодический сбой загрузки из-за форматирования времени в формате JSON. |
| зафиксированный | Проблема с загрузкой в релизные сборки. |
1.2.1 (16 декабря 2020 г.)
Этот выпуск представляет собой внутренний выпуск функций Android Performance Tuner и продвижение библиотек Jetpack из альфа-версии в бета-версию. Никаких изменений в API Android Frame Pacing или Android Performance Tuner не произошло.
Обратите внимание, что библиотеки Game SDK теперь необходимо ссылаться индивидуально при связывании с ними, а не с общей библиотекой gamesdk. См. настройки сборки для Android Frame Pacing: OpenGL , Android Frame Pacing: Vulkan и Android Performance Tuner .
Android-тюнер производительности
| особенность | Когда игрок запускает игру в фоновом режиме во время загрузки, событие отправляется для последующего анализа прерывания загрузки. |
1.2.0 (29 октября 2020 г.)
Основным изменением в этой версии является добавление механизма записи времени загрузки. Также есть некоторые исправления ошибок. Обратите внимание, что Game SDK теперь доступен через библиотеку Jetpack AGDK Libraries .
Библиотека синхронизации кадров Android
| особенность | Поддержка переключения частоты обновления в автоматическом режиме. Обратите внимание, что для поддержки нескольких частот обновления в Android 11, независимо от того, используется ли автоматический режим или нет, следует вызывать SwappyGL_setWindow или SwappyVk_setWindow . |
| зафиксированный | Исправлены ошибки автоматического режима. |
| зафиксированный | Исправления ошибок Вулкана. |
Android-тюнер производительности
| особенность | Время загрузки. Новые функции TuningFork_startRecordingLoadingTime и TuningFork_stopRecordingLoadingTime должны вызываться для записи аннотированных событий времени загрузки. Время от запуска приложения до TuningFork_init и первого тика записывается автоматически. |
| измененный | Предыдущий метод установки аннотации времени загрузки больше не будет работать. |
| особенность | События жизненного цикла.TuningFork_reportLifecycleEvent должен вызываться при вызове соответствующего Java onCreate и т. д. Это позволяет получать подробные отчеты о сбоях из Android Performance Tuner. |
| измененный | При вызове TuningFork_enableMemoryRecording(true) теперь записывается больше показателей памяти. |
| измененный | Изменение модели памяти. Максимальное количество метрик каждого типа теперь указывается при запуске, а не выделяется место для всех возможных комбинаций аннотаций. См. TuningFork_MetricLimits в tuningfork.h . |
| зафиксированный | Нет загрузки на лимитные соединения. |
1.1.0 (10 июня 2020 г.)
Эта версия библиотек AGDK включает библиотеку отчетов по метрикам Android Performance Tuner и настройку качества (также известную как Tuning Fork). Эта библиотека доступна как для собственных игровых движков, так и для Unity, и имеет следующие функции:
| особенность | Интеграция с библиотекой Android Frame Pacing для автоматической записи времени кадра и других показателей рендеринга. |
| особенность | Информация о синхронизации кадров записывается в гистограммах и периодически загружается. |
| особенность | Аннотация данных синхронизации с текущим состоянием игры. |
| особенность | Характеристики устройства, аннотации и настройки качества загружаются вместе с данными синхронизации, что позволяет провести перекрестный анализ. |
| особенность | Особая обработка аннотаций, обозначающих время загрузки уровня. Данные такта кадра не записываются во время загрузки, но продолжительность каждого периода загрузки записывается. |
| особенность | Возможность записи пользовательской информации о времени (с использованием startTrace и endTrace ). |
1.0.2 (30 марта 2020 г.)
Эта версия включает исправления ошибок и изменения в поведении автоматического режима.
| зафиксированный | Исправлены ошибки при уничтожении и повторной инициализации swappy. |
| измененный | Конвейерная обработка теперь включена по умолчанию. Если автоматическая конвейеризация включена, Swappy все равно может отключить ее, когда рабочая нагрузка очень низкая. |
| измененный | Когда автоматический режим включен, Swappy решит переключить интервал замены только после того, как 15% кадров в течение 2-секундного окна будут быстрее или медленнее, чем ожидалось. Обратите внимание, что Swappy никогда не будет выполнять обмен медленнее, чем заданный пользователем интервал обмена. |
1.0.1 (19 февраля 2020 г.)
Эта версия в первую очередь представляет собой выпуск с исправлением ошибок.
| зафиксированный | Очистите ресурсы при выходе по пути к коду SwappyFallback в Vulkan. |
| зафиксированный | SwappyVk_destroySwapchain больше не уничтожает ресурсы устройства, если существует более одной цепочки обмена. |
| зафиксированный | Версия Swappy теперь печатается в logcat . |
| зафиксированный | Сбои и взаимоблокировки в Swappy_destroy для уровня API 24 и ниже. |
| особенность | Поддержка пользовательских менеджеров потоков ( Swappy_setThreadFunctions ). |
| особенность | Поддержка перехвата функций Vulkan ( SwappyVk_setFunctionProvider ). |
1.0.0 (5 декабря 2019 г.)
Эта первоначальная версия библиотек AGDK включает библиотеку Android Frame Pacing .
| особенность | Синхронизация буфера дисплея. |
| особенность | Режим автоматической частоты обновления и поддержка конвейерной обработки. |
| особенность | Сбор статистики рендеринга кадров. |
| особенность | Грамотный выбор поведения во время выполнения в зависимости от наличия функций Android, OpenGL и Vulkan, необходимых Swappy. |
| особенность | Статическая и динамическая компоновка библиотеки. |
| особенность | Поддержка устройств с несколькими частотами обновления. |
На этой странице описаны изменения для каждого выпуска библиотек Android Game Development Kit (AGDK). До выпуска версии 1.2.4 он назывался Android Games SDK.
2023.3.0.0 (2 июня 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправления стабильности в GameActivityEvents. |
Библиотека рекомендаций по памяти Android
| особенность | Обновлена модель машинного обучения, лежащая в основе библиотеки, что может улучшить результаты для новых телефонов. |
Android-тюнер производительности
| зафиксированный | Исправлена ошибка, из-за которой библиотека аварийно завершала работу, если максимальное количество ключей инструментов превышало количество гистограмм. |
| особенность | Обновлены функции сбора телеметрии в библиотеке, что позволяет более детально составлять отчеты о времени рендеринга кадров. |
2023.2.0.0 (27 апреля 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправлено раннее освобождение памяти с помощью HistoricalEventTimes. |
| зафиксированный | Исправлена проблема с переполнением HistoricalEventTimesNanos в 32-битных системах. |
Библиотека рекомендаций по памяти Android
| зафиксированный | Исправлена ошибка, из-за которой статическая версия библиотеки не могла быть правильно скомпонована. |
| зафиксированный | Исправлена ошибка, из-за которой библиотека не могла правильно загрузить необходимые ресурсы TensorFlow Lite. |
2023.1.0.0 (15 марта 2023 г.)
В этот основной выпуск включены обновления системы сборки, позволяющие быстрее создавать библиотеки из исходного кода.
| измененный | Интерфейс для отображения времени исторических событий изменен, чтобы преодолеть ограничение в 32 бита. |
| особенность | Предоставлен доступ пользователей к изменениям конфигурации. |
| особенность | Оптимизировано большинство вызовов JNI при обработке событий касания. |
| зафиксированный | Исправлена обработка сенсорных событий ОС по умолчанию, например обработка системных кнопок. |
| особенность | Добавлена возможность определять состояние подключения аппаратных клавиатур. |
| особенность | Добавлена возможность сообщать данные о движении (акселерометр/гироскоп) с основного устройства (например, телефона), а также с контроллеров. |
| измененный | Изменен API и формат базы данных определений контроллера для уменьшения объема памяти и поддержки дополнительных функций. |
Библиотека синхронизации кадров Android
| особенность | Добавлена статистика Vulkan Frame. |
| особенность | Добавлен новый API для очистки статистики кадров. |
| измененный | В режиме выпуска все журналы молчат, их можно включить в режиме отладки. |
2022.0.0 (15 марта 2022 г.)
Этот основной выпуск включает библиотеку рекомендаций по памяти и несколько исправлений для других библиотек.
| особенность | Добавлена обработка вставок для позиционирования игрового пользовательского интерфейса вокруг IME и вырезов. |
| особенность | Добавьте фильтры событий ключа и движения |
| зафиксированный | Исправления, позволяющие избежать потери событий ввода и предотвратить использование всех событий ввода. |
Android-тюнер производительности
| измененный | Отчеты о памяти теперь представлены в виде временных рядов, а не гистограмм. |
| особенность | Разрешить программную настройку интервала загрузки |
| зафиксированный | Исправлена ошибка с поврежденным ключом API. |
Библиотека синхронизации кадров Android
| особенность | Улучшения в автоматическом режиме |
| особенность | Добавьте функции uninjectTracer. |
Библиотека рекомендаций по памяти Android
| особенность | Добавлена библиотека советов по памяти. |
2021.1.0 (12 июля 2021 г.)
Раньше мы называли этот продукт Android Game SDK, теперь он называется Android Game Development Kit. Этот основной выпуск включает в себя несколько новых библиотек, а также незначительные исправления ошибок в библиотеках Android Frame Pacing и Android Performance Tuner.
| особенность | GameActivity — это новый компонент, который заменяет и улучшает NativeActivity из NDK. |
| особенность | GameTextInput — это новый компонент, улучшающий взаимодействие с программной клавиатурой Android. |
| особенность | GameController — это новый компонент, который упрощает взаимодействие с внешними контроллерами и управление ими. |
1.2.4 (21 апреля 2021 г.)
Этот выпуск представляет собой исправление ошибок в Android Performance Tuner.
Android-тюнер производительности
| зафиксированный | Исправлена запись времени загрузки и продолжительности на устройствах с несогласованным CLOCK_BOOTTIME . |
1.2.3 (10 марта 2021 г.)
В этом выпуске в Game SDK добавлен гобой . В библиотеке Android Frame Pacing и Android Performance Tuner изменений нет.
Oboe — это библиотека C++ с открытым исходным кодом для высококачественного звука на Android. Oboe предоставляет единый собственный API, который работает в Android 4.1 (уровень API 16) и выше.
1.2.2 (12 февраля 2021 г.)
В этом выпуске улучшен API времени загрузки для Android Performance Tuner, а также исправлено несколько ошибок. В библиотеке Android Frame Pacing изменений нет.
Android-тюнер производительности
| особенность | События загрузки теперь необходимо группировать с помощью вызовов TuningFork_startLoadingGroup и TuningFork_stopLoadingGroup . |
| зафиксированный | Вызов TuningFork_flush немедленно загружает данные, а не ставит их в очередь для последующей загрузки. |
| зафиксированный | Периодический сбой загрузки из-за форматирования времени в формате JSON. |
| зафиксированный | Проблема с загрузкой в релизные сборки. |
1.2.1 (16 декабря 2020 г.)
Этот выпуск представляет собой внутренний выпуск функций Android Performance Tuner и продвижение библиотек Jetpack из альфа-версии в бета-версию. Никаких изменений в API Android Frame Pacing или Android Performance Tuner не произошло.
Обратите внимание, что библиотеки Game SDK теперь необходимо ссылаться индивидуально при связывании с ними, а не с общей библиотекой gamesdk. См. настройки сборки для Android Frame Pacing: OpenGL , Android Frame Pacing: Vulkan и Android Performance Tuner .
Android-тюнер производительности
| особенность | Когда игрок запускает игру в фоновом режиме во время загрузки, событие отправляется для последующего анализа прерывания загрузки. |
1.2.0 (29 октября 2020 г.)
Основным изменением в этой версии является добавление механизма записи времени загрузки. Также есть некоторые исправления ошибок. Обратите внимание, что Game SDK теперь доступен через библиотеку Jetpack AGDK Libraries .
Библиотека синхронизации кадров Android
| особенность | Поддержка переключения частоты обновления в автоматическом режиме. Обратите внимание, что для поддержки нескольких частот обновления в Android 11, независимо от того, используется ли автоматический режим или нет, следует вызывать SwappyGL_setWindow или SwappyVk_setWindow . |
| зафиксированный | Исправлены ошибки автоматического режима. |
| зафиксированный | Исправления ошибок Вулкана. |
Android-тюнер производительности
| особенность | Время загрузки. Новые функции TuningFork_startRecordingLoadingTime и TuningFork_stopRecordingLoadingTime должны вызываться для записи аннотированных событий времени загрузки. Время от запуска приложения до TuningFork_init и первого тика записывается автоматически. |
| измененный | Предыдущий метод установки аннотации времени загрузки больше не будет работать. |
| особенность | События жизненного цикла.TuningFork_reportLifecycleEvent следует вызывать при вызове соответствующего Java onCreate и т. д. Это позволяет получать подробные отчеты о сбоях из Android Performance Tuner. |
| измененный | При вызове TuningFork_enableMemoryRecording(true) теперь записывается больше показателей памяти. |
| измененный | Изменение модели памяти. Максимальное количество метрик каждого типа теперь указывается при запуске, а не выделяется место для всех возможных комбинаций аннотаций. См. TuningFork_MetricLimits в tuningfork.h . |
| зафиксированный | Нет загрузки на лимитные соединения. |
1.1.0 (10 июня 2020 г.)
Эта версия библиотек AGDK включает библиотеку отчетов по метрикам Android Performance Tuner и настройку качества (также известную как Tuning Fork). Эта библиотека доступна как для собственных игровых движков, так и для Unity, и имеет следующие функции:
| особенность | Интеграция с библиотекой Android Frame Pacing для автоматической записи времени кадра и других показателей рендеринга. |
| особенность | Информация о синхронизации кадров записывается в гистограммах и периодически загружается. |
| особенность | Аннотация данных синхронизации с текущим состоянием игры. |
| особенность | Характеристики устройства, аннотации и настройки качества загружаются вместе с данными синхронизации, что позволяет провести перекрестный анализ. |
| особенность | Особая обработка аннотаций, обозначающих время загрузки уровня. Данные такта кадра не записываются во время загрузки, но продолжительность каждого периода загрузки записывается. |
| особенность | Возможность записи пользовательской информации о времени (с использованием startTrace и endTrace ). |
1.0.2 (30 марта 2020 г.)
Эта версия включает исправления ошибок и изменения в поведении автоматического режима.
| зафиксированный | Исправлены ошибки при уничтожении и повторной инициализации swappy. |
| измененный | Конвейерная обработка теперь включена по умолчанию. Если автоматическая конвейеризация включена, Swappy все равно может отключить ее, когда рабочая нагрузка очень низкая. |
| измененный | Когда автоматический режим включен, Swappy решит переключить интервал замены только после того, как 15% кадров в течение 2-секундного окна будут быстрее или медленнее, чем ожидалось. Обратите внимание, что Swappy никогда не будет выполнять обмен медленнее, чем заданный пользователем интервал обмена. |
1.0.1 (19 февраля 2020 г.)
Эта версия в первую очередь представляет собой выпуск с исправлением ошибок.
| зафиксированный | Очистите ресурсы при выходе по пути к коду SwappyFallback в Vulkan. |
| зафиксированный | SwappyVk_destroySwapchain больше не уничтожает ресурсы устройства, если существует более одной цепочки обмена. |
| зафиксированный | Версия Swappy теперь печатается в logcat . |
| зафиксированный | Сбои и взаимоблокировки в Swappy_destroy для уровня API 24 и ниже. |
| особенность | Поддержка пользовательских менеджеров потоков ( Swappy_setThreadFunctions ). |
| особенность | Поддержка перехвата функций Vulkan ( SwappyVk_setFunctionProvider ). |
1.0.0 (5 декабря 2019 г.)
Эта первоначальная версия библиотек AGDK включает библиотеку Android Frame Pacing .
| особенность | Синхронизация буфера дисплея. |
| особенность | Режим автоматической частоты обновления и поддержка конвейерной обработки. |
| особенность | Сбор статистики рендеринга кадров. |
| особенность | Грамотный выбор поведения во время выполнения в зависимости от наличия функций Android, OpenGL и Vulkan, необходимых Swappy. |
| особенность | Статическая и динамическая компоновка библиотеки. |
| особенность | Поддержка устройств с несколькими частотами обновления. |
На этой странице описаны изменения для каждого выпуска библиотек Android Game Development Kit (AGDK). До выпуска версии 1.2.4 он назывался Android Games SDK.
2023.3.0.0 (2 июня 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправления стабильности в GameActivityEvents. |
Библиотека рекомендаций по памяти Android
| особенность | Обновлена модель машинного обучения, лежащая в основе библиотеки, что может улучшить результаты для новых телефонов. |
Android-тюнер производительности
| зафиксированный | Исправлена ошибка, из-за которой библиотека аварийно завершала работу, если максимальное количество ключей инструментов превышало количество гистограмм. |
| особенность | Обновлены функции сбора телеметрии в библиотеке, что позволяет более детально составлять отчеты о времени рендеринга кадров. |
2023.2.0.0 (27 апреля 2023 г.)
Этот выпуск включает в себя несколько исправлений ошибок.
| зафиксированный | Исправлено раннее освобождение памяти с помощью HistoricalEventTimes. |
| зафиксированный | Исправлена проблема с переполнением HistoricalEventTimesNanos в 32-битных системах. |
Библиотека рекомендаций по памяти Android
| зафиксированный | Исправлена ошибка, из-за которой статическая версия библиотеки не могла быть правильно скомпонована. |
| зафиксированный | Исправлена ошибка, из-за которой библиотека не могла правильно загрузить необходимые ресурсы TensorFlow Lite. |
2023.1.0.0 (15 марта 2023 г.)
В этот основной выпуск включены обновления системы сборки, позволяющие быстрее создавать библиотеки из исходного кода.
| измененный | Интерфейс для отображения времени исторических событий изменен, чтобы преодолеть ограничение в 32 бита. |
| особенность | Предоставлен доступ пользователей к изменениям конфигурации. |
| особенность | Оптимизировано большинство вызовов JNI при обработке событий касания. |
| зафиксированный | Исправлена обработка сенсорных событий ОС по умолчанию, например обработка системных кнопок. |
| особенность | Добавлена возможность определять состояние подключения аппаратных клавиатур. |
| особенность | Добавлена возможность сообщать данные о движении (акселерометр/гироскоп) с основного устройства (например, телефона), а также с контроллеров. |
| измененный | Изменен API и формат базы данных определений контроллера для уменьшения объема памяти и поддержки дополнительных функций. |
Библиотека синхронизации кадров Android
| особенность | Добавлена статистика Vulkan Frame. |
| особенность | Добавлен новый API для очистки статистики кадров. |
| измененный | В режиме выпуска все журналы молчат, их можно включить в режиме отладки. |
2022.0.0 (15 марта 2022 г.)
Этот основной выпуск включает библиотеку рекомендаций по памяти и несколько исправлений для других библиотек.
| особенность | Добавлена обработка вставок для позиционирования игрового пользовательского интерфейса вокруг IME и вырезов. |
| особенность | Добавьте фильтры событий ключа и движения. |
| зафиксированный | Исправления, позволяющие избежать потери событий ввода и предотвратить использование всех событий ввода. |
Android-тюнер производительности
| измененный | Отчеты о памяти теперь представлены в виде временных рядов, а не гистограмм. |
| особенность | Разрешить программную настройку интервала загрузки |
| зафиксированный | Исправлена ошибка с поврежденным ключом API. |
Библиотека синхронизации кадров Android
| особенность | Улучшения в автоматическом режиме |
| особенность | Добавьте функции uninjectTracer. |
Библиотека рекомендаций по памяти Android
| особенность | Добавлена библиотека советов по памяти. |
2021.1.0 (12 июля 2021 г.)
Раньше мы называли этот продукт Android Game SDK, теперь он называется Android Game Development Kit. Этот основной выпуск включает в себя несколько новых библиотек, а также незначительные исправления ошибок в библиотеках Android Frame Pacing и Android Performance Tuner.
| особенность | GameActivity — это новый компонент, который заменяет и улучшает NativeActivity из NDK. |
| особенность | GameTextInput — это новый компонент, улучшающий взаимодействие с программной клавиатурой Android. |
| особенность | GameController — это новый компонент, который упрощает взаимодействие с внешними контроллерами и управление ими. |
1.2.4 (21 апреля 2021 г.)
Этот выпуск представляет собой исправление ошибок в Android Performance Tuner.
Android-тюнер производительности
| зафиксированный | Исправлена запись времени загрузки и продолжительности на устройствах с несовместимым CLOCK_BOOTTIME . |
1.2.3 (10 марта 2021 г.)
В этом выпуске в Game SDK добавлен гобой . В библиотеке Android Frame Pacing и Android Performance Tuner изменений нет.
Oboe — это библиотека C++ с открытым исходным кодом для высококачественного звука на Android. Oboe предоставляет единый собственный API, который работает в Android 4.1 (уровень API 16) и выше.
1.2.2 (12 февраля 2021 г.)
В этом выпуске улучшен API времени загрузки для Android Performance Tuner, а также исправлено несколько ошибок. В библиотеке Android Frame Pacing изменений нет.
Android-тюнер производительности
| особенность | События загрузки теперь необходимо группировать с помощью вызовов TuningFork_startLoadingGroup и TuningFork_stopLoadingGroup . |
| зафиксированный | Вызов TuningFork_flush немедленно загружает данные, а не ставит их в очередь для последующей загрузки. |
| зафиксированный | Периодический сбой при загрузке из-за форматирования времени в формате JSON. |
| зафиксированный | Проблема с загрузкой в релизные сборки. |
1.2.1 (16 декабря 2020 г.)
Этот выпуск представляет собой внутренний выпуск функций Android Performance Tuner и продвижение библиотек Jetpack из альфа-версии в бета-версию. Никаких изменений в API Android Frame Pacing или Android Performance Tuner не произошло.
Обратите внимание, что библиотеки Game SDK теперь необходимо ссылаться индивидуально при связывании с ними, а не с общей библиотекой gamesdk. См. настройки сборки для Android Frame Pacing: OpenGL , Android Frame Pacing: Vulkan и Android Performance Tuner .
Android-тюнер производительности
| особенность | Когда игрок запускает игру в фоновом режиме во время загрузки, событие отправляется для последующего анализа прерывания загрузки. |
1.2.0 (29 октября 2020 г.)
Основным изменением в этой версии является добавление механизма записи времени загрузки. Также есть некоторые исправления ошибок. Обратите внимание, что Game SDK теперь доступен через библиотеку Jetpack AGDK Libraries .
Библиотека синхронизации кадров Android
| особенность | Поддержка переключения частоты обновления в автоматическом режиме. Обратите внимание, что для поддержки множественных частот обновления в Android 11, будь то использование автоматического режима или нет, следует вызвать SwappyGL_setWindow или SwappyVk_setWindow . |
| зафиксированный | Автомодирование исправлений ошибок. |
| зафиксированный | Вулканские исправления ошибки. |
| особенность | Время загрузки. Новые функции TuningFork_startRecordingLoadingTime и TuningFork_stopRecordingLoadingTime должны быть вызваны для записи аннотированных событий времени загрузки. Время от запуска приложения до TuningFork_init и первого тика автоматически записаны. |
| измененный | Предыдущий метод установки аннотации времени загрузки больше не будет работать. |
| особенность | События жизненного цикла.TuningFork_reportLifecycleEvent следует вызвать на соответствующую Java onCreate и т. Д. Это обеспечивает подробную отчетность по сбою из The Android Performance Tuner. |
| измененный | Больше показателей памяти теперь записывается при вызове TuningFork_enableMemoryRecording(true) . |
| измененный | Изменение модели памяти. Максимальное количество показателей каждого типа теперь указывается при запуске, а не распределяет пространство для всех возможных комбинаций аннотаций. См. TuningFork_MetricLimits в tuningfork.h . |
| зафиксированный | Нет загрузки на дозированные соединения. |
1.1.0 (10 июня 2020 г.)
В этой версии библиотек AGDK есть библиотека метрических отчетов Android Performance Metric и качественная настройка (также известная как Funing Fork). Эта библиотека доступна как для нативных игровых двигателей, так и для Unity и имеет следующие функции:
| особенность | Интеграция с библиотекой каркаса Android для автоматической записи рамки и других показателей рендеринга. |
| особенность | Информация о времени кадров записывается на гистограммах и периодически загружается. |
| особенность | Аннотация данных времени с текущим состоянием игры. |
| особенность | Характеристики устройства, аннотации и настройки качества загружаются с помощью данных времени, позволяющих анализировать поперечный анализ. |
| особенность | Специальное лечение аннотаций, которые означают время загрузки уровня. Данные о кадре не записываются во время загрузки, но продолжительность каждого периода загрузки. |
| особенность | Возможность записывать пользовательскую информацию о времени (с помощью startTrace и endTrace ). |
1.0.2 (30 марта 2020 г.)
Эта версия включает в себя исправления ошибок и изменения в поведении автоматического режима.
| зафиксированный | Исправление ошибок для резкого разрушения и повторной инициализации. |
| измененный | Трубопровод теперь включен по умолчанию. Если автоматическое пиплатинг включен, Swappy все еще может решить отключить его, когда рабочая нагрузка очень низкая. |
| измененный | Когда авто-режим включен, Swappy решит переключить интервал подкачки только после 15% кадров в окне 2 секунды, либо быстрее, либо медленнее, чем ожидалось. Обратите внимание, что Swappy никогда не будет обменять медленнее, чем интервал подкачки, определенного пользователем. |
1.0.1 (19 февраля 2020 г.)
Эта версия в первую очередь является выпуском исправления ошибок.
| зафиксированный | Очистите ресурсы на выходе по пути кода SwappyFallback в Вулкане. |
| зафиксированный | SwappyVk_destroySwapchain больше не разрушает ресурсы устройства, если существует более одного Swapchain. |
| зафиксированный | Шваровная версия теперь напечатана в logcat . |
| зафиксированный | Сбои и тупики в Swappy_destroy для уровня API 24 и ниже. |
| особенность | Поддержка пользовательских менеджеров потоков ( Swappy_setThreadFunctions ). |
| особенность | Поддержка подключения функций Vulkan ( SwappyVk_setFunctionProvider ). |
1.0.0 (5 декабря 2019 г.)
Эта первоначальная версия библиотек AGDK имеет библиотеку Pacing Android Frame .
| особенность | Отображение буфера синхронизация. |
| особенность | Автомобильный режим скорости обновления и поддержка трубопровода. |
| особенность | Сбор статистики рендеринга кадров. |
| особенность | Изящный выбор поведения во время выполнения, в зависимости от присутствия функций Android, OpenGL и Vulkan, необходимых для Swappy. |
| особенность | Статическое и динамичное связывание библиотеки. |
| особенность | Поддержка устройств с несколькими показателями обновления. |