Отладка сбоев LMK

Чтобы устранить LMK-события в игре на Unity, выполните следующие действия:

Рисунок 1. Как устранить сбои LMK в играх на Unity.

Как получить снимок памяти

Используйте Unity Profiler, чтобы получить снимок памяти, управляемой Unity. На рисунке 2 показаны уровни управления памятью, которые Unity использует для обработки памяти в игре.

Рисунок 2. Обзор управления памятью в Unity.

Управляемая память

В Unity управление памятью реализовано через управляемый уровень памяти, который использует управляемую кучу и сборщик мусора для автоматического выделения и назначения памяти. Управляемая память – это среда скриптов C#, основанная на Mono или IL2CPP. Преимущество управляемой системы памяти заключается в том, что она использует сборщик мусора для автоматического освобождения выделенной памяти.

Неуправляемая память C#

Неуправляемый уровень памяти C# обеспечивает доступ к нативному уровню памяти, позволяя точно контролировать распределение памяти при использовании кода C#. Доступ к этому уровню управления памятью можно получить через пространство имен Unity.Collections и такие функции, как UnsafeUtility.Malloc и UnsafeUtility.Free.

Нативная память

Внутреннее ядро Unity на C/C++ использует нативную систему памяти для управления сценами, объектами, графическими API, драйверами, подсистемами и буферами плагинов. Хотя прямой доступ ограничен, вы можете безопасно манипулировать данными с помощью C# API Unity и использовать преимущества эффективного нативного кода. Собственная память редко требует прямого взаимодействия, но вы можете отслеживать ее влияние на производительность с помощью Profiler и корректировать настройки для оптимизации производительности.

Память не распределяется между C# и нативным кодом, как показано на рисунке 3. Данные, необходимые для C#, выделяются в управляемом пространстве памяти каждый раз, когда это необходимо.

Чтобы управляемый код игры (C#) мог получить доступ к данным нативной памяти движка, например вызов GameObject.transform, он выполняет нативный вызов для доступа к данным памяти в нативной области, а затем возвращает значения в C# с помощью Bindings. Привязки обеспечивают правильные соглашения о вызовах для каждой платформы и обрабатывают автоматический маршалинг управляемых типов в их нативные эквиваленты.

Это происходит только в первый раз, поскольку управляемая оболочка для доступа к свойству transform сохраняется в нативном коде. Кеширование свойства transform может уменьшить количество вызовов между управляемым и нативным кодом, но полезность кеширования зависит от того, как часто используется свойство. Также обратите внимание, что Unity не копирует части нативной памяти в управляемую память при доступе к этим API.

Рисунок 3. Доступ к нативной памяти из управляемого кода C#.

Подробнее о памяти в Unity…

Кроме того, важно установить лимит памяти, чтобы игра работала без сбоев, и внедрить систему аналитики или отчетности по потреблению памяти, чтобы каждый новый выпуск не превышал этот лимит. Чтобы получить более точные данные, интегрируйте тесты в режиме Play с непрерывной интеграцией (CI). Это позволит вам проверять потребление памяти в определенных областях игры.

Как управлять объектами

Это наиболее важная и действенная часть потребления памяти. профиле компании.

Использование памяти в играх для Android может значительно различаться в зависимости от типа игры, количества и типов объектов, а также стратегий оптимизации памяти. Однако обычно на использование памяти влияют текстуры, сетки, аудиофайлы, шейдеры, анимации и скрипты.

Обнаружение повторяющихся объектов

Сначала нужно найти неправильно настроенные и дублирующиеся объекты с помощью профилировщика памяти, инструмента для создания отчетов о сборке или Project Auditor.

Текстуры

Проанализируйте, какие устройства поддерживают вашу игру, и выберите подходящий формат текстур. Вы можете разделить наборы текстур для устройств с высокой и низкой производительностью с помощью Play Asset Delivery, Addressable или вручную с помощью AssetBundle.

Следуйте рекомендациям из статей Optimize Your Mobile Game Performance (Оптимизация производительности мобильной игры) и Optimising Unity Texture Import Settings (Оптимизация настроек импорта текстур в Unity). Затем попробуйте сделать следующее:

  • Сжимайте текстуры с помощью форматов ASTC, чтобы уменьшить объем потребляемой памяти, и экспериментируйте с более высокой частотой блоков, например 8x8.

    Если вам необходимо использовать ETC2, упакуйте текстуры в атлас. Размещение нескольких текстур в одной текстуре обеспечивает ее степень двойки (POT), может уменьшить количество вызовов отрисовки и ускорить рендеринг.

  • Оптимизируйте формат и размер текстуры RenderTarget. Избегайте неоправданно высокого разрешения текстур. Использование текстур меньшего размера на мобильных устройствах экономит память.

  • Используйте упаковку каналов текстур, чтобы экономить память.

Сетки и модели

Сначала проверьте основные настройки (стр. 27), а затем убедитесь, что заданы следующие параметры импорта сетки:

  • Объедините лишние и мелкие сетки.
  • Уменьшите количество вершин для объектов в сценах (например, для статических или удаленных объектов).
  • Создайте группы уровней детализации (LOD) для объектов с высокой геометрией.

Материалы и шейдеры

  • Программно удаляйте неиспользуемые варианты шейдеров во время сборки.
  • Объединяйте часто используемые варианты шейдеров в супершейдеры, чтобы избежать дублирования.
  • Включите динамическую загрузку шейдеров, чтобы решить проблему с большим объемом потребляемой памяти, который возникает при предварительной загрузке шейдеров в видеопамять или ОЗУ. Однако обратите внимание, не вызывает ли компиляция шейдеров задержки кадров.
  • Используйте динамическую загрузку шейдеров, чтобы не загружать все варианты. Дополнительную информацию можно найти в записи блога Улучшения в сборке шейдеров и использовании памяти.
  • Используйте экземпляры материалов, задействуя MaterialPropertyBlocks.

Аудио

Сначала проверьте основные настройки (стр. 41), а затем настройки импорта сетки:

  • Удалите неиспользуемые или избыточные ссылки на AudioClip, если вы используете сторонние аудиодвижки, например FMOD или Wwise.
  • Предварительная загрузка аудиоданных. Отключите предварительную загрузку клипов, которые не требуются сразу во время выполнения или запуска сцены. Это помогает снизить нагрузку на память при инициализации сцены.

Анимации

  • Измените настройки сжатия анимации в Unity, чтобы минимизировать количество ключевых кадров и удалить лишние данные.
    • Уменьшение количества ключевых кадров. Автоматически удаляет ненужные ключевые кадры.
    • Сжатие кватернионов. Сжимает данные о вращении, чтобы уменьшить использование памяти.

Настройки сжатия можно изменить в разделе Animation Import Settings (Настройки импорта анимации) на вкладке Rig (Оснастка) или Animation (Анимация).

  • Используйте анимационные клипы повторно, а не дублируйте их для разных объектов.

    Используйте Animator Override Controller, чтобы повторно использовать Animator Controller и заменять определенные клипы для разных персонажей.

  • Запекайте анимации, основанные на физике. Если ваши анимации основаны на физике или процедурные, запекайте их в клипы, чтобы избежать вычислений во время выполнения.

  • Оптимизируйте скелетный риг. Используйте меньше костей, чтобы снизить сложность и потребление памяти.

    • Не используйте слишком много костей для небольших или статичных объектов.
    • Если определенные кости не анимированы или не нужны, удалите их из скелета.
  • Уменьшите длину анимированного клипа.

    • Обрежьте анимационные клипы, чтобы оставить только нужные кадры. Не храните неиспользуемые или слишком длинные анимации.
    • Используйте зацикленную анимацию вместо длинных клипов с повторяющимися движениями.
  • Убедитесь, что прикреплен или активирован только один компонент анимации. Например, если вы используете Animator, отключите или удалите компоненты Legacy animation.

  • Не используйте Animator, если в этом нет необходимости. Для простых визуальных эффектов используйте библиотеки твининга или реализуйте эффект в скрипте. Система анимации может быть ресурсоемкой, особенно на мобильных устройствах низкого класса.

  • Если у вас много анимаций, используйте Job System. Эта система была полностью переработана, чтобы эффективнее использовать память.

Сцены

При загрузке новых сцен они приносят с собой объекты в качестве зависимостей. Однако без надлежащего управления жизненным циклом объектов эти зависимости не отслеживаются счетчиками ссылок. В результате объекты могут оставаться в памяти даже после выгрузки неиспользуемых сцен, что приводит к фрагментации памяти.

  • Используйте пул объектов Unity, чтобы повторно использовать экземпляры GameObject для повторяющихся элементов геймплея. Пул объектов использует стек для хранения коллекции экземпляров объектов для повторного использования и не является потокобезопасным. Минимизация Instantiate и Destroy повышает производительность ЦП и стабильность памяти.
  • Выгрузка объектов:
    • Выгружайте объекты в менее критичные моменты, например во время заставок или загрузки экранов.
    • Частое использование Resources.UnloadUnusedAssets вызывает скачки в обработке ЦП из-за больших внутренних операций мониторинга зависимостей.
    • Проверьте, нет ли больших скачков загрузки ЦП в маркере профиля GC.MarkDependencies. Удалите или уменьшите частоту его выполнения и вручную выгрузите определенные ресурсы с помощью Resources.UnloadAsset, а не полагайтесь на всеобъемлющий Resources.UnloadUnusedAssets().
  • Реструктурируйте сцены, а не используйте постоянно Resources.UnloadUnusedAssets.
  • Вызов Resources.UnloadUnusedAssets() для Addressables может привести к непреднамеренной выгрузке динамически загруженных пакетов. Тщательно управляйте жизненным циклом динамически загружаемых объектов.

Другое

  • Фрагментация, вызванная переходами между сценами. При вызове метода Resources.UnloadUnusedAssets() Unity выполняет следующие действия:

    • Освобождает память, занятую объектами, которые больше не используются.
    • Запускает операцию, похожую на сборщик мусора, чтобы проверить управляемую и нативную кучу объектов на наличие неиспользуемых объектов и выгрузить их.
    • Очищает память, занятую текстурами, сетками и объектами, если на них нет активных ссылок.
  • AssetBundle или Addressable – вносить изменения в этой области сложно, и для реализации стратегий требуются коллективные усилия команды. Однако, освоив эти стратегии, вы сможете значительно улучшить использование памяти, уменьшить размер скачиваемых файлов и снизить затраты на облако. Подробнее об управлении объектами в UnityAddressables…

  • Централизованные общие зависимости. Систематически группируйте общие зависимости, такие как шейдеры, текстуры и шрифты, в специальные наборы или группы Addressable. Это позволяет избежать дублирования и гарантирует, что ненужные объекты будут выгружены.

  • Используйте Addressables для отслеживания зависимостей. Адресуемые объекты упрощают загрузку и выгрузку и могут автоматически выгружать зависимости, на которые больше нет ссылок. В зависимости от особенностей игры, переход на Addressables для управления контентом и разрешения зависимостей может быть подходящим решением. Проанализируйте цепочки зависимостей с помощью инструмента Analyze, чтобы выявить ненужные дубликаты или зависимости. Если вы используете AssetBundles, ознакомьтесь с информацией об инструментах Unity Data Tools.

  • TypeTrees – если Addressables и AssetBundles вашей игры созданы и развернуты с использованием той же версии Unity, что и проигрыватель, и не требуют обратной совместимости с другими сборками проигрывателя, попробуйте отключить запись TypeTree. Это должно уменьшить размер пакета и объем памяти, занимаемый сериализованными объектами файлов. Измените процесс сборки в локальном пакете Addressables, задав для параметра ContentBuildFlags значение DisableWriteTypeTree.

Пишите код, совместимый со сборщиком мусора

В Unity используется сборка мусора (GC) для управления памятью путем автоматического определения и освобождения неиспользуемой памяти. Хотя сборка мусора необходима, она может вызывать проблемы с производительностью (например, скачки частоты кадров), если не обрабатывается должным образом. Этот процесс может на мгновение приостановить игру, что приведет к сбоям в производительности и ухудшению пользовательского опыта.

Полезные советы о том, как снизить частоту выделения памяти для управляемой кучи, можно найти в руководстве по Unity. Примеры приведены на странице 271 руководства по оптимизации производительности Unity.

  • Уменьшите количество выделений памяти сборщиком мусора.

    • Избегайте LINQ, лямбда-выражений и замыканий, которые выделяют память в куче.
    • Используйте StringBuilder для изменяемых строк вместо объединения строк.
    • Повторно используйте коллекции, вызывая COLLECTIONS.Clear(), а не создавая их экземпляры заново.

    Дополнительную информацию можно найти в электронной книге Ultimate Guide to Profiling Unity games (Полное руководство по профилированию игр Unity).

  • Управление обновлениями макета интерфейса:

    • Динамические изменения элементов интерфейса. Когда обновляются свойства элементов интерфейса, например текста, изображения или RectTransform (например, меняется текстовый контент, размер элементов или положение анимации), движок может выделять память для временных объектов.
    • Выделение строк. Элементы пользовательского интерфейса, такие как Text, часто требуют обновления строк, поскольку строки неизменяемы в большинстве языков программирования.
    • Измененный холст. Когда на холсте что-то меняется (например, размер, включение и отключение элементов или изменение свойств макета), весь холст или его часть могут быть помечены как измененные и перестроены. Это может привести к созданию временных структур данных (например, данных сетки, буферов вершин или вычислений макета), что увеличивает объем мусора.
    • Сложные или частые обновления. Если на холсте много элементов или он часто обновляется (например, каждый кадр), перестроения могут привести к значительному перемешиванию памяти.
  • Включите инкрементную сборку мусора, чтобы уменьшить количество пиков за счет распределения очистки памяти по нескольким кадрам. Проверьте, улучшает ли этот параметр производительность игры и объем потребляемой памяти.

  • Если вам нужен контролируемый подход, установите ручной режим сборки мусора. Затем, когда уровень изменится или наступит другой момент, когда активный игровой процесс не идет, вызовите сборку мусора.

  • Вызывайте сборку мусора вручную с помощью GC.Collect() при переходах между состояниями игры, например при переключении уровней.

  • Оптимизируйте массивы, начиная с базовых методов кодирования и, при необходимости, используя нативные массивы или другие нативные контейнеры для больших массивов.

  • Отслеживайте управляемые объекты с помощью таких инструментов, как Unity Профилировщик памяти, чтобы выявлять ссылки на неуправляемые объекты, которые сохраняются после уничтожения.

    Используйте маркер профилировщика, чтобы отправить данные в инструмент для работы с отчетами для автоматизированного подхода.

Как избежать утечки и фрагментации памяти

Утечки памяти

Если в коде C# ссылка на объект Unity существует после его уничтожения, управляемый объект-оболочка, известный как управляемая оболочка, остается в памяти. Собственная память, связанная с ссылкой, освобождается, когда сцена выгружается или когда объект GameObject, к которому подключена память, или любой из его родительских объектов уничтожается с помощью метода Destroy(). Однако если другие ссылки на сцену или GameObject не были удалены, управляемая память может сохраняться в виде объекта Leaked Shell Object. Дополнительную информацию можно найти в руководстве по управляемым объектам оболочки.

Кроме того, утечки памяти могут быть вызваны подписками на события, лямбда-выражениями и замыканиями, объединением строк и неправильным управлением объединенными объектами.

  • Чтобы начать, ознакомьтесь с разделом Поиск утечек памяти, в котором рассказывается, как правильно сравнивать снимки памяти Unity.
  • Проверьте подписки на события и утечки памяти. Если объекты подписываются на события (например, через делегаты или UnityEvents), но не отменяют подписку должным образом перед уничтожением, менеджер событий или издатель может сохранить ссылки на эти объекты. Это предотвращает сбор мусора для этих объектов, что приводит к утечкам памяти.
  • Отслеживайте события глобальных классов или классов-одиночек, которые не отменяются при уничтожении объекта. Например, отмените подписку или отсоедините делегаты в деструкторах объектов.
  • Убедитесь, что при уничтожении объединенных объектов полностью удаляются ссылки на компоненты TextMesh, текстуры и родительские объекты GameObject.
  • При сравнении снимков Unity Профилировщика памяти и необъяснимой разнице в потреблении памяти помните, что она может быть вызвана графическим драйвером или самой операционной системой.

Фрагментация памяти

Фрагментация памяти происходит, когда много небольших выделений освобождаются в случайном порядке. Выделение памяти для кучи происходит последовательно, то есть новые фрагменты памяти создаются, когда в предыдущем фрагменте заканчивается место. Следовательно, новые объекты не заполняют пустые области старых фрагментов, что приводит к фрагментации. Кроме того, крупные временные выделения могут привести к постоянной фрагментации на протяжении всего игрового сеанса.

Это особенно проблематично, когда большие кратковременные выделения памяти происходят рядом с долговременными.

Группируйте выделения памяти по времени жизни. В идеале долгоживущие выделения должны выполняться вместе на ранних этапах жизненного цикла приложения.

Наблюдатели и менеджеры мероприятий

  • Помимо проблемы, упомянутой в разделе Утечки памяти, со временем утечки памяти могут способствовать фрагментации, оставляя неиспользуемую память, выделенную объектам, которые больше не используются.
  • Убедитесь, что при уничтожении объектов пула полностью удаляются ссылки на компоненты текстовых сеток, текстуры и родительские объекты GameObjects.
  • Менеджеры событий часто создают и хранят списки или словари для управления подписками на события. Если они динамически растут и уменьшаются во время выполнения, они могут способствовать фрагментации памяти из-за частого выделения и освобождения памяти.

Код

  • Сопрограммы иногда выделяют память. Этого можно избежать, если кешировать оператор return интерфейса IEnumerator, а не объявлять его каждый раз заново.
  • Постоянно отслеживайте состояния жизненного цикла объединенных объектов, чтобы избежать сохранения фантомных ссылок UnityEngine.Object.

Объекты

  • Используйте динамические резервные системы для текстовых игр, чтобы не загружать все шрифты для многоязычных случаев.
  • Объединяйте объекты (например, текстуры и частицы) по типу и ожидаемому жизненному циклу.
  • Удалите объекты с атрибутами жизненного цикла бездействия, например лишние изображения интерфейса и статические сетки.

Распределение на основе общего времени

  • Выделяйте долгоживущие объекты в начале жизненного цикла приложения, чтобы обеспечить компактное распределение.
  • Используйте NativeCollections или пользовательские распределители для структур данных, требующих большого объема памяти или временных структур данных (например, физических кластеров).

Исполняемый файл игры и плагины также влияют на использование памяти.

Метаданные IL2CPP

IL2CPP генерирует метаданные для каждого типа (например, классов, универсальных шаблонов и делегатов) во время сборки, которые затем используются во время выполнения для отражения, проверки типов и других операций, специфичных для среды выполнения. Эти метаданные хранятся в памяти и могут значительно увеличить общий объем потребляемой памяти приложения. Кэш метаданных IL2CPP значительно влияет на время инициализации и загрузки. Кроме того, IL2CPP не дедуплицирует некоторые элементы метаданных, например обобщенные типы или сериализованную информацию, что может привести к чрезмерному использованию памяти. Это усугубляется повторяющимся или избыточным использованием типов в проекте.

Метаданные IL2CPP можно уменьшить следующими способами:

Удаление кода

Помимо уменьшения размера сборки, удаление кода также снижает использование памяти. При сборке с использованием серверной части сценариев IL2CPP удаление управляемого байт-кода (которое активировано по умолчанию) удаляет неиспользуемый код из управляемых сборок. Процесс работает путем определения корневых сборок, а затем использует статический анализ кода, чтобы определить, какой другой управляемый код используют эти корневые сборки. Недоступный код удаляется. Дополнительную информацию об удалении управляемого кода можно найти в записи блога TTales from the optimization trenches: Better managed code stripping with Unity 2020 LTS и в документации по удалению управляемого кода.

Нативные распределители

Поэкспериментируйте с нативными распределителями памяти, чтобы настроить их. Если в игре мало памяти, используйте блоки меньшего размера, даже если это замедлит работу распределителей. Подробнее о динамическом распределителе кучи…

Управление нативными плагинами и SDK

  • Найдите проблемный плагин. Для этого удаляйте плагины по одному и сравнивайте снимки памяти игры. Для этого нужно отключить многие функции кода с помощью Scripting Define Symbols и провести рефакторинг тесно связанных классов с интерфейсами. Чтобы упростить отключение внешних зависимостей, не нарушая работу игры, ознакомьтесь с шаблонами программирования игр.

  • Свяжитесь с автором плагина или SDK. Большинство плагинов не имеют открытого исходного кода.

  • Воспроизведите использование памяти плагином. Вы можете написать небольшой плагин (используйте этот плагин Unity в качестве примера), который выделяет память. Проверьте снимки памяти с помощью Android Studio (поскольку Unity не отслеживает эти распределения) или вызовите класс MemoryInfo и метод Runtime.totalMemory() в том же проекте.

Плагин Unity выделяет память Java и нативную память. Вот как это сделать:

Java

byte[] largeObject = new byte[1024 * 1024 * megaBytes];
list.add(largeObject);

Нативные объявления

char* buffer = new char[megabytes * 1024 * 1024];

// Random data to fill the buffer
for (int i = 1; i < megabytes * 1024 * 1024; ++i) {
   buffer[i] = 'A' + (i % 26); // Fill with letters A-Z
}