调试 LMK

解决 Unity 游戏中的 LMK 问题是一个系统化的流程:

图 1. 解决 Unity 游戏中的低内存终止 (LMK) 问题的步骤。

获取内存快照

使用 Unity Profiler 获取 Unity 托管的内存快照。 图 2 显示了 Unity 用于处理游戏内存的内存管理层。

图 2. Unity 的内存管理概览。

托管式内存

Unity 的内存管理实现了一个受控内存层,该层使用托管堆和垃圾回收器自动分配和指派内存。托管内存系统是基于 Mono 或 IL2CPP 的 C# 脚本环境。受管内存系统的优势在于,它利用垃圾回收器自动释放内存分配。

C# 非托管内存

非托管 C# 内存层提供对原生内存层的访问权限,让您在使用 C# 代码时能够精确控制内存分配。此内存管理层可通过 Unity.Collections 命名空间以及 UnsafeUtility.Malloc 和 UnsafeUtility.Free 等函数进行访问。

原生内存

Unity 的内部 C/C++ 核心使用原生内存系统来管理场景、资源、图形 API、驱动程序、子系统和插件缓冲区。虽然直接访问受到限制,但您可以使用 Unity 的 C# API 安全地操作数据,并受益于高效的原生代码。原生内存很少需要直接交互,但您可以使用性能分析器监控原生内存对性能的影响,并调整设置以优化性能。

C# 和原生代码之间不共享内存,如图 3 所示。 C# 所需的数据会在每次需要时分配到托管内存空间中。

为了让托管游戏的代码 (C#) 访问引擎的原生内存数据,例如,调用 GameObject.transform 会发出原生调用来访问原生区域中的内存数据,然后使用 Bindings 将值返回给 C#。绑定可确保每个平台都采用正确的调用惯例,并自动将托管类型封送到其原生等效类型。

这种情况仅在第一次发生,因为用于访问 transform 属性的托管 shell 会保留在原生代码中。缓存 transform 属性可以减少托管代码和原生代码之间的来回调用次数,但缓存的实用性取决于该属性的使用频率。另请注意,当您访问这些 API 时,Unity 不会将原生内存的部分内容复制到托管内存中。

图 3. 从 C# 托管代码访问原生内存。

如需了解详情,请参阅 Unity 中的内存简介。

此外,建立内存预算对于确保游戏顺畅运行至关重要,而实现内存消耗分析或报告系统可确保每个新版本都不会超出内存预算。另一种获得更深入分析的方法是将播放模式测试与持续集成 (CI) 相结合,以验证游戏特定区域的内存消耗情况。

管理资产

这是内存消耗中最重要且最可操作的部分。尽早进行性能分析。

Android 游戏中的内存用量可能会因游戏类型、资源数量和类型以及内存优化策略而有很大差异。不过,内存用量的常见影响因素通常包括纹理、网格、音频文件、着色器、动画和脚本。

检测重复的素材资源

第一步是使用内存分析器、build 报告工具或 Project Auditor 检测配置不当的资源和重复的资源。

纹理

分析游戏对设备的支持情况,并确定正确的纹理格式。 您可以使用 Play Asset Delivery、Addressable 或 AssetBundle 的更手动流程,为高端和低端设备拆分纹理 bundle。

请遵循 优化移动游戏性能 和 优化 Unity 纹理导入设置 讨论帖子中提供的最著名的建议。然后尝试以下解决方案:

  • 使用 ASTC 格式压缩纹理以减少内存占用,并尝试使用更高的块速率(例如 8x8)。

    如果必须使用 ETC2,请将纹理打包到 Atlas 中。将多个纹理放入单个纹理中可确保其为 2 的幂 (POT),从而减少绘制调用并加快渲染速度。

  • 优化 RenderTarget 纹理格式和大小。避免使用不必要的高分辨率纹理。在移动设备上使用较小的纹理可节省内存。

  • 使用纹理通道打包来节省纹理内存。

网格和模型

首先,检查基本设置(第 27 页),并验证以下网格导入设置:

  • 合并冗余和较小的网格。
  • 减少场景中对象(例如静态或远处的对象)的顶点数。
  • 为高几何体素材资源生成细节层次 (LOD) 组。

材质和着色器

  • 在构建过程中,以编程方式剥离未使用的着色器变体。
  • 将常用的着色器变体整合到超级着色器中,以避免着色器重复。
  • 启用动态着色器加载,以解决 VRAM/RAM 中预加载着色器占用大量内存的问题。不过,如果着色器编译导致帧卡顿,请注意。
  • 使用动态着色器加载,防止加载所有变体。 如需了解详情,请参阅着色器构建时间和内存用量方面的改进博文。
  • 利用 MaterialPropertyBlocks 正确使用材质实例化。

音频

首先检查基本设置(第 41 页),然后验证以下网格导入设置:

  • 使用 FMOD 或 Wwise 等第三方音频引擎时,请移除未使用或多余的 AudioClip 引用。
  • 预加载音频数据。对于在运行时或场景启动期间不需要立即使用的片段,请停用预加载。这有助于减少场景初始化期间的内存开销。

动画

  • 调整 Unity 的动画压缩设置,以最大限度地减少关键帧数量并消除冗余数据。
    • 关键帧缩减:自动移除不必要的关键帧
    • 四元数压缩:压缩旋转数据以减少内存用量

您可以在 Rig 或 Animation 标签页下的 Animation Import Settings 中调整压缩设置。

  • 重复使用动画片段,而不是为不同对象复制动画片段。

    使用动画器重写控制器可重复使用动画器控制器,并为不同角色替换特定片段。

  • 烘焙基于物理的动画:如果您的动画是物理驱动或程序化的,请将其烘焙到动画片段中,以避免运行时计算。

  • 优化骨骼绑定:在绑定中使用更少的骨骼,以降低复杂性和内存消耗。

    • 避免为小型或静态对象使用过多的骨骼。
    • 如果某些骨骼不需要动画或不需要使用,请将其从骨架中移除。
  • 缩短动画片段长度。

    • 剪辑动画片段,仅保留必要的帧。避免存储未使用或过长的动画。
    • 使用循环动画,而不是为重复动作创建长片段。
  • 确保仅附加或激活了一个动画组件。例如,如果您使用的是 Animator,请停用或移除旧版动画组件。

  • 如果不需要,请避免使用 Animator。对于基本视觉特效,请使用补间动画库或在脚本中实现视觉特效。动画工具系统可能会占用大量资源,尤其是在低端移动设备上。

  • 在处理大量动画时,请使用作业系统来处理动画,因为该系统已经过全面重新设计,可以更高效地利用内存。

场景

加载新场景时,系统会引入素材资源作为依赖项。但是,如果没有适当的资产生命周期管理,这些依赖项不会由引用计数器监控。因此,即使在卸载未使用的场景后,素材资源也可能会保留在内存中,从而导致内存碎片化。

  • 使用 Unity 的对象池为重复出现的游戏元素重复使用 GameObject 实例,因为对象池使用堆栈来保存对象实例集合以供重复使用,并且不是线程安全的。最大限度地减少 Instantiate 和 Destroy 可提高 CPU 性能和内存稳定性。
  • 正在卸载素材资源:
  • 重构场景,而不是持续使用 Resources.UnloadUnusedAssets。
  • 为 Addressables 调用 Resources.UnloadUnusedAssets() 可能会无意中卸载动态加载的 bundle。谨慎管理动态加载资源的生命周期。

其他

  • 场景转换导致的分片 - 调用 Resources.UnloadUnusedAssets() 方法时,Unity 会执行以下操作:

    • 释放不再使用的素材资源所占用的内存
    • 运行类似垃圾回收器的操作,检查托管和原生对象堆中是否有未使用的资源,并将其卸载
    • 清理纹理、网格和资源内存(前提是不存在有效引用)
  • AssetBundle 或 Addressable - 在此领域进行更改非常复杂,需要团队共同努力来实施策略。不过,一旦掌握了这些策略,它们就能显著改善内存用量、缩减下载大小并降低云成本。如需详细了解如何在 Unity 中管理资源,请参阅 Addressables。

  • 集中式共享依赖项:将共享依赖项(例如着色器、纹理和字体)系统地分组到专用 bundle 或 Addressable 组中。这样可以减少重复,并确保高效卸载不必要的资源。

  • 使用 Addressables 进行依赖项跟踪 - Addressables 可简化加载和卸载,并自动卸载不再引用的依赖项。过渡到 Addressables 进行内容管理和依赖项解析可能是一种可行的解决方案,具体取决于游戏的具体情况。使用分析工具分析依赖项链,以找出不必要的重复项或依赖项。或者,如果您使用的是 AssetBundle,请参阅 Unity 数据工具。

  • TypeTrees - 如果游戏的 Addressables 和 AssetBundles 是使用与玩家相同的 Unity 版本构建和部署的,并且不需要与其他玩家 build 向后兼容,请考虑停用写入 TypeTree,这应该会缩减 bundle 大小和序列化文件对象内存占用。将本地 Addressables 软件包设置 ContentBuildFlags 中的构建流程修改为 DisableWriteTypeTree。

编写垃圾回收器友好型代码

Unity 利用垃圾回收 (GC) 来管理内存,方法是自动识别并释放未使用的内存。虽然 GC 至关重要,但如果处理不当,可能会导致性能问题(例如帧速率峰值),因为此过程可能会暂时暂停游戏,从而导致性能中断和用户体验不佳。

如需了解有关如何降低托管堆分配量频率的实用技巧,请参阅 Unity 手册;如需查看示例,请参阅 UnityPerformanceTuningBible 第 271 页。

  • 减少垃圾回收器分配:

    • 避免使用 LINQ、lambda 和闭包,因为它们会分配堆内存。
    • 使用 StringBuilder 代替字符串串联来处理可变字符串。
    • 通过调用 COLLECTIONS.Clear() 重复使用集合,而不是重新实例化集合。

    如需了解详情,请参阅 Ultimate Guide to Profiling Unity games 电子书。

  • 管理界面画布更新:

    • 界面元素的动态变化 - 当 Text、Image 或 RectTransform 属性等界面元素更新时(例如,更改文本内容、调整元素大小或为位置添加动画效果),引擎可能会为临时对象分配内存。
    • 字符串分配 - 界面元素(如 Text)通常需要更新字符串,因为在大多数编程语言中,字符串都是不可变的。
    • 脏画布 - 当画布上的某些内容发生变化(例如,调整大小、启用和停用元素或修改布局属性)时,整个画布或其一部分可能会被标记为“脏”并重新构建。这可能会触发临时数据结构(例如网格数据、顶点缓冲区或布局计算)的创建,从而增加垃圾生成。
    • 复杂或频繁的更新 - 如果画布包含大量元素或频繁更新(例如,每帧更新),这些重新构建可能会导致严重的内存抖动。
  • 启用增量 GC,通过将分配清理工作分散到多个帧中来减少大型回收峰值。请进行性能分析,以验证此选项是否能提升游戏的性能并减少内存占用。

  • 如果您的游戏需要采用受控方法,请将垃圾回收模式设置为手动。然后,在关卡切换时或在没有活跃游戏内容的其他时刻,调用垃圾回收。

  • 针对游戏状态转换(例如关卡切换)调用手动垃圾回收 GC.Collect()。

  • 从基本代码实践开始优化数组,如有必要,可对大型数组使用原生数组或其他原生容器。

  • 使用 Unity 内存分析器等工具监控托管对象,以跟踪销毁后仍然存在的非托管对象引用。

    使用 Profiler 标记提交到性能报告工具,以实现自动化。

避免内存泄漏和碎片化

内存泄漏

在 C# 代码中,如果 Unity 对象被销毁后仍存在对该对象的引用,则托管封装容器对象(称为托管 shell)会保留在内存中。当场景卸载时,或者当内存所附加到的 GameObject 或其任何父对象通过 Destroy() 方法销毁时,与引用关联的原生内存会被释放。不过,如果对场景或 GameObject 的其他引用未清除,则托管内存可能会作为泄露的 shell 对象保留。如需详细了解托管式 Shell 对象,请参阅托管式 Shell 对象手册。

此外,内存泄漏还可能由事件订阅、lambda 和闭包、字符串串联以及池化对象管理不当引起:

  • 如需开始使用,请参阅查找内存泄漏,以正确比较 Unity 内存快照。
  • 检查事件订阅和内存泄漏。如果对象订阅了事件(例如通过委托或 UnityEvent),但在销毁前未正确取消订阅,事件管理器或发布者可能会保留对这些对象的引用。这会阻止对这些对象进行垃圾回收,从而导致内存泄漏。
  • 监控在对象销毁时未取消注册的全局或单例类事件。例如,在对象析构函数中取消订阅或取消挂钩委托。
  • 确保销毁池化对象会完全使对文本网格组件、纹理和父级游戏对象的引用失效。
  • 请注意,在比较 Unity 内存分析器快照并观察到内存消耗量存在差异但没有明确原因时,该差异可能是由显卡驱动程序或操作系统本身引起的。

内存碎片化

当许多小分配以随机顺序释放时,就会发生内存碎片化。堆分配量是按顺序进行的,这意味着当上一个内存块空间不足时,系统会创建新的内存块。因此,新对象不会填充旧数据块的空白区域,从而导致碎片化。此外,大型临时分配可能会在游戏会话期间导致永久性碎片化。

当在长生命周期分配附近进行短生命周期的大型分配时,此问题尤为严重。

根据分配的生命周期对其进行分组;理想情况下,应在应用生命周期的早期阶段一起进行长期分配。

观察者和活动管理员

  • 除了内存泄漏部分中提到的问题之外,随着时间的推移,内存泄漏还会导致碎片化,因为未使用的内存会分配给不再使用的对象。
  • 确保销毁池化对象会完全使对文本网格组件、纹理和父级 GameObjects 的引用失效。
  • 事件管理器通常会创建和存储列表或字典,以管理事件订阅。如果这些数据结构在运行时动态增大和缩小,则可能会因频繁分配和取消分配而导致内存碎片化。

代码

  • 协程有时会分配内存,您可以通过缓存 IEnumerator 的 return 语句(而不是每次都声明一个新语句)来避免这种情况。
  • 持续监控池化对象的生命周期状态,避免保留 UnityEngine.Object 虚影引用。

素材资源

  • 对于文本驱动的游戏体验,请使用动态回退系统,以避免在多语言情况下预加载所有字体。
  • 按类型和预期生命周期将资源(例如纹理和粒子)整理在一起。
  • 压缩具有空闲生命周期属性的资源,例如冗余界面图片和静态网格。

基于生命周期的分配

  • 在应用生命周期开始时分配长生命周期资源,以确保紧凑分配。
  • 对于内存密集型或瞬态数据结构(例如物理集群),请使用 NativeCollections 或自定义分配器。

游戏可执行文件和插件也会影响内存用量。

IL2CPP 元数据

IL2CPP 会在构建时为每种类型(例如类、泛型和委托)生成元数据,然后在运行时用于反射、类型检查和其他特定于运行时的操作。此元数据存储在内存中,可能会显著增加应用的总体内存占用。IL2CPP 的元数据缓存对初始化和加载时间有重大影响。此外,IL2CPP 不会对某些元数据元素(例如泛型类型或序列化信息)进行去重,这可能会导致内存用量激增。如果项目中存在重复或冗余的类型使用,则会加剧这种情况。

您可以通过以下方式缩减 IL2CPP 元数据:

  • 避免使用反射 API,因为它们可能会导致 IL2CPP 元数据分配量显著增加
  • 停用内置软件包
  • 实现 Unity 2022 完全泛型共享,这应该有助于减少泛型引起的开销。不过,为了进一步减少分配,请减少泛型的使用。

代码剥离

除了缩减 build 的大小之外,代码剥离还可以减少内存用量。针对 IL2CPP 脚本后端进行构建时,托管字节码剥离(默认处于启用状态)会从托管程序集中移除未使用的代码。该过程的工作原理是定义根程序集,然后使用静态代码分析来确定这些根程序集使用的其他托管代码。系统会移除所有无法访问的代码。如需详细了解托管代码剥离,请参阅优化战壕中的故事:使用 Unity 2020 LTS 更好地剥离托管代码博文和托管代码剥离文档。

原生分配器

尝试使用原生内存分配器来微调内存分配器。如果游戏内存不足,请使用较小的内存块,即使这会涉及较慢的分配器。如需了解详情,请参阅动态堆分配器示例。

管理原生插件和 SDK

  • 找出有问题的插件 - 移除每个插件并比较游戏内存快照。这涉及使用脚本定义符号停用大量代码功能,以及使用接口重构高度耦合的类。请参阅Level up your code with game programming patterns,了解如何在不影响游戏可玩性的情况下,简化停用外部依赖项的过程。

  • 与插件或 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
}