文档

Unity 引擎

Unity 引擎

性能分析器 计数器参考

内置性能分析性能分析器数器的参考。
阅读时间26 分钟最后更新于 5 天前

Unity 具有内置性能分析器计数器,您可以使用这些计数器在自定义性能分析器模块中收集和显示 Metrics。下表Outline了可用的内置性能分析性能分析器数器。这些信息也可以通过
ProfilerRecorder
API 和性能分析器模块 Editor 获得,因此您可以将它们添加到自定义性能分析器模块。下表包含 Unity 中提供的性能分析器计数器列表:

文件访问性能分析性能分析器数器

可用文件访问性能分析器计数器和释放(非 Development)玩家中的可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

读取的文件字节Unity 在所选定帧期间从此文件读取的信息的总计数量。Unavailable(不可用)
写入的文件字节Unity 在选定帧期间写入此文件的信息的总计数量。Unavailable(不可用)
文件句柄 Open在此帧内时间Open的文件句柄数量。这包括 Unity 在同一帧中打开和关闭的文件。Unavailable(不可用)
文件读取完成在此帧中completed的文件读取数量。Unavailable(不可用)
文件读取已启动在此帧期间开始的文件读取数量Unavailable(不可用)
文件查找此帧在本地文件System中执行的文件查找操作的数量。文件查找操作涉及对文件内容的 search。Unavailable(不可用)
文件已关闭此帧在本地文件System中成功关闭的文件数量。Unavailable(不可用)
打开的文件此帧在本地文件System中成功打开的文件数量。Unavailable(不可用)
飞行中的读取此帧期间正在进行的读取操作的总计数量。Unavailable(不可用)
有关收集文件访问数据的更多信息,请参阅文件访问性能分析器模块参考。

资源加载中性能分析性能分析器数器

可用资源加载中的性能分析器计数器和释放(非 Development)玩家中的可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

音频读取从 AsyncReadManager 请求用于音频加载的字节数量。Unavailable(不可用)
Entities 读取Entities 包中的脚本从 AsyncReadManager 请求的字节数。Unavailable(不可用)
网格读取从 AsyncReadManager 请求用于网格加载的字节数量。Unavailable(不可用)
其他读取为未指定的子系统从 AsyncReadManager 请求的字节数量。Unavailable(不可用)
脚本读取通过脚本 API 从 AsyncReadManager 请求的字节数量。Unavailable(不可用)
纹理读取从 AsyncReadManager 请求用于纹理加载的字节数量。Unavailable(不可用)
虚拟纹理读取从 AsyncReadManager 请求的虚拟纹理字数量。Unavailable(不可用)
有关收集资源数据的更多信息,请参阅资源加载中性能分析器模块参考。

内存性能分析器数器

下表概述了可用内存性能分析器计数器和释放(非 Development)玩家的可用性。
提示
您可以使用
Object.FindObjectsByType
方法来查找指定类型的对象,然后将此信息通道到
Profiler.GetRuntimeMemorySizeLong
以获取其内存 amount,然后在释放玩家中实现此信息。例如,要获取网格数量或网格内存的计数器,请在开发代码中使用
Object.FindObjectsByType<Mesh>().length
and then pass these entries to
GetRunTimeMemorySizeLong
. Only use
 Find
及其相关 API。
GetRunTimeMemorySizeLong
会影响 ON 性能,并且不会在释放版本中提供图形内存量。

性能分析器计数器

描述

释放(非 Development)玩家的可用性

AnimationClip 数量加载的 AnimationClip 的数量。Unavailable(不可用)
AnimationClip 内存加载的 AnimationClip 的内存amountount(以字节为单位)。Unavailable(不可用)
应用承诺内存根据平台的Operating System提交的内存amountount(以字节为单位)。可用
应用驻留内存根据平台的Operating System,驻留内存的amountount(以字节为单位)。可用
资源数量已加载Assets的数量。Unavailable(不可用)
音频保留内存音频System的估计保留内存(以字节为单位)。可用
音频使用内存音频System的估计Memory Usage(以字节为单位)。可用
AudioClip 数量加载的 AudioClip 的总计数量。Unavailable(不可用)
AudioClip 内存加载的 AudioClip 的内存amountount(以字节为单位)。Unavailable(不可用)
Game Object 数量Scene 中游戏对象实例的总计数量。Unavailable(不可用)
帧内分配的 GC选定帧中 Managed 分配的总计大小(以字节为单位)。Unavailable(不可用)
GC 分配帧数量选定帧中的 Managed 分配的 amount。Unavailable(不可用)
GC 保留内存为Managed代码保留的总计大小(以字节为单位)。此内存是垃圾收集。可用
GC 使用内存Managed代码使用的堆大大小(以字节为单位)。此内存是垃圾收集。可用
Gfx 保留内存Textures、渲染目标、着色器和网格数据的估计保留内内存(以字节为单位)。Unavailable(不可用)
Gfx 已用内存驱动程序ONTextures、渲染目标、着色器和网格数据上使用的估计内存字节为单位)。Unavailable(不可用)
Material count(材质计数)已加载 Materials 的总计数量。Unavailable(不可用)
材质内存以字节为单位使用的内存加载 Materials 的总计 amount。Unavailable(不可用)
网格数量已加载网格的总计数量。Unavailable(不可用)
网格内存加载的网格的内存amountount(以字节为单位)。Unavailable(不可用)
对象数量应用程序中原生Object实例的数量。Unavailable(不可用)
Physics 使用内存Physics system使用的内存amountount(以字节为单位)。Unavailable(不可用)
Physics 保留内存(2D)2D Physics system保留的内存amountount(以字节为单位)。Unavailable(不可用)
性能分析器保留内存性能分析器 功能从System保留的内存(以字节为单位)。可用
性能分析器使用内存性能分析器功能使用的内存(以字节为单位)。可用
Scene 对象数量动态
UnityEngine.Object
实例的总计数量。此数量包括 Game Object 数量计数器、Plus 组件的总计数量以及场景中不属于资源的所有内容。
Unavailable(不可用)
System总计已用内存ON设备上running的All applications程序使用的总计内存(以字节为单位)。可用
系统使用的内存根据平台的Operating System,驻留内存的amountount(以字节为单位)。该值与应用驻留内存值相同。可用
Texture count(纹理计数)已加载Textures的总计数量Unavailable(不可用)
纹理内存以字节为单位使用的内存加载 Textures 的总计 amount。Unavailable(不可用)
总计保留内存Operating System 中为应用程序保留的总计内存(以字节为单位)。可用
已用内存总计应用程序使用的总计内存(以字节为单位)。可用
视频保留内存视频System的估计保留内存(以字节为单位)。可用
视频使用内存视频System的估计Memory Usage(以字节为单位)。可用
有关收集内存数据的更多信息,请参阅内存性能分析器模块。

Physics Profiler数器

可用 Physics Profiler 计数器和释放(非 Development)玩家的可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

Active约束Physics system 已处理的原始约束数量。Unavailable(不可用)
Active动态机构未处于睡眠状态的 Rigidbody 组件和
ArticulationBody
组件的数量。
Unavailable(不可用)
Active运动体Active运动学Rigidbody组件的数量。Unavailable(不可用)
接合体Scene 中的
ArticulationBody
组件数量
Unavailable(不可用)
寬階加法粗略阶段算法添加的碰撞体的总计数量。Unavailable(不可用)
Broadphase 添加/删除粗略阶段算法添加或已移除的碰撞体的总计数量。Unavailable(不可用)
寬階移除粗筛阶段算法已移除的碰撞体的总计数量。Unavailable(不可用)
碰撞体已同步与 Transforms 同步的碰撞体的 amount。Unavailable(不可用)
连续重叠Unity 使用连续碰撞检测来解决的重叠事件的数量。Unavailable(不可用)
离散重叠Unity 使用 Discrete 碰撞检测来解决的重叠事件的数量。Unavailable(不可用)
动态体
Rigidbody
组件和
ArticulationBody
组件的数量。
Unavailable(不可用)
修改的重叠Unity 使用接触修改 API 进行修改的重叠事件的数量。Unavailable(不可用)
窄相缺失触摸自上一帧以来丢失的碰撞事件的总计 amount。Unavailable(不可用)
窄阶段新建触摸自上一帧以来显示为新建碰撞事件的amountount。Unavailable(不可用)
窄相触摸自上一帧以来丢失或显示为新建的碰撞事件的amountount。Unavailable(不可用)
重叠重叠事件的数量。重叠事件是当碰撞体相互重叠 Other 时。Unavailable(不可用)
Physics 查询Physics 查询(例如射线投射和形状投射)的总计 amount。Unavailable(不可用)
刚体 同步与变换同步的 Rigidbody 组件的 amount。Unavailable(不可用)
静态碰撞体没有 Rigidbody 或 ArticulationBody 组件的碰撞体的数量Unavailable(不可用)
触发器重叠与触发器器碰撞体的重叠事件数量(成对计数)。Unavailable(不可用)
有关收集 Physics 数据的更多信息,请参阅 Physics Profiler 模块参考。

2D Physics Profiler 计数器

可用的 2D Physics Profiler 计数器和释放(非 Development)玩家的可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

添加的联系人在此帧中添加的接触数量。这包括 碰撞 和 触发器 触点。Unavailable(不可用)
睡眠体睡眠(未唤醒)并存在于此帧中的 Rigidbody2D 的数量。Unavailable(不可用)
睡眠形状睡眠(未唤醒)并存在于此帧中的 Physics 形状的数量。Unavailable(不可用)
唤醒身体唤醒并存在于此帧中的 Rigidbody2D 的数量。Unavailable(不可用)
唤醒形状在此帧唤醒和存在的Physics形状的数量。Unavailable(不可用)
宽相位对Physics system 在此帧中处理的宽相位对的数量。Unavailable(不可用)
广泛阶段更新Physics system 在此帧中处理的粗略阶段更新的数量。Unavailable(不可用)
碰撞进入Physics system 在此帧中调用的 OnCollisionEnter2D 回调的数量。Unavailable(不可用)
碰撞退出Physics system 在此帧中调用的 OnCollisionExit2D 回调的数量。Unavailable(不可用)
碰撞停留Physics system 在此帧中调用的 OnCollisionStay2D 回调的数量。Unavailable(不可用)
连续体此帧中存在的具有
Continuous
碰撞检测模式的 Rigidbody2D 的数量。
Unavailable(不可用)
离散体此帧中存在的具有
Discrete
碰撞检测模式的 Rigidbody2D 的数量。
Unavailable(不可用)
动态体此帧中存在的 Body Type 为
Dynamic
的 Rigidbody2D 的数量。
Unavailable(不可用)
动态形状既是
Dynamic
又存在于此帧中的 Physics 形状的数量。
Unavailable(不可用)
GetContacts 查询Physics system调用帧的接触检索查询的数量。这包括查询,例如
Physics2D.GetContacts
、
Collider2D.GetContacts
和
Rigidbody2D.GetContacts
。
Unavailable(不可用)
IsTouching 查询Physics system调用帧的接触式触摸查询的数量。这包括查询,例如
Physics2D.IsTouching
、
Collider2D.IsTouching
和
Rigidbody2D.IsTouching
。
Unavailable(不可用)
运动体此帧中存在的 Body Type 为
Kinematic
的 Rigidbody2D 的数量。
Unavailable(不可用)
重叠查询Physics system调用帧的重叠查询数量。这包括查询,例如
Physics2D.OverlapPoint
、
Physics2D.OverlapCircle
和
Collider2D.OverlapCollider
。
Unavailable(不可用)
粒子查询粒子系统在此帧中调用的查询数量。Unavailable(不可用)
Raycast 查询Physics system调用帧的基于Ray线的查询的数量。这包括
Physics2D.Raycast
和
Physics2D.Linecast
等查询。
Unavailable(不可用)
已移除接触Physics system 在此帧中已移除的接触数量。这包括 碰撞 和 触发器 触点。Unavailable(不可用)
形状投射查询Physics system调用帧的形状扫描查询的数量。这包括查询,例如
Physics2D.BoxCast
、
Physics2D.CircleCast
和
Collider2D.Cast
。
Unavailable(不可用)
解算器 Continuous Islands处理Continuous解算步骤的孤岛数量。Unavailable(不可用)
解算器离散孤岛处理Discrete解算步骤When解算的接触孤岛数量。Unavailable(不可用)
解算器模拟数量Unity 自动或通过调用
Physics2D.Simulate
或
PhysicsScene2D.Simulate
来模拟 All Physics 场景的次数。
Unavailable(不可用)
解算器世界数量此帧中存在的 Physics 场景的总计数量。Unavailable(不可用)
静态体此帧中存在的 Body Type 为
Static
的 Rigidbody2D 的数量。
Unavailable(不可用)
Static此帧中既为 Static 又存在的 Physics 形状的数量。Unavailable(不可用)
机构总计此帧中存在的
Rigidbody2D
的总计数量。
Unavailable(不可用)
回调总计Physics system 在此帧中调用的
OnCollisionEnter2D
、
OnCollisionStay2D
、
OnCollisionExit2D
、OnTriggerEnter2D、
OnTriggerStay2D
和
OnTriggerExit2D
回调的总计数量。
Unavailable(不可用)
接触总计此帧中存在的接触的总计数量。这包括 碰撞 和 触发器 触点。Unavailable(不可用)
总计关节此帧中存在的 Any
Joint2D
的总计数量。
Unavailable(不可用)
总计形状此帧中存在的 Physics 形状的总计数量。Unavailable(不可用)
总计查询Physics system调用帧的查询数量。这包括查询,例如
Physics2D.Raycast
和
Physics2D.OverlapPoint
Unavailable(不可用)
总计变换Sync CallsPhysics system 在此帧中调用的变换 Sync Calls 的总计数量。Unavailable(不可用)
变换父同步体受变换同步影响的 Rigidbody2D 的数量,该变换同步是由变换重新父级引起的。Unavailable(不可用)
变换父同步碰撞体受变换Sync影响的 Collider2D 的数量,该同步是由重新为变换父子项引起的。Unavailable(不可用)
变换 Sync 体受变换 Sync 影响的 Rigidbody2D 的数量。Unavailable(不可用)
变换 Sync 碰撞体受变换 Sync 影响的 Collider2D 的数量。Unavailable(不可用)
触发器进入在此帧中调用的 OnTriggerEnter2D 回调的数量。Unavailable(不可用)
触发器退出在此帧中调用的 OnTriggerExit2D 回调的数量。Unavailable(不可用)
触发器停留在此帧中调用的 OnTriggerStay2D 回调的数量。Unavailable(不可用)
有关收集 2D Physics 数据的更多信息,请参阅 2D Physics Profiler 模块参考。

渲染性能分析器分析器计数器

可用渲染性能分析器计数器和释放(非 Development)玩家的可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

Batches数量Unity 在一帧内处理的 Batches 的总计数量。此数量包括Static和动态Batches。可用
CPU 主要线程帧时间从帧的 Start 到 When the main thread 完成其在该帧期间执行的工作之间的时间。已启用帧定时 Stats 时可用。
CPU 渲染线程帧时间从 ON 渲染线程的工作开始到 Unity Calls
Present
方法之间的时间。
已启用帧定时 Stats 时可用。
CPU 总计帧时间总计 CPU 帧时间。Unity 将此计算为两帧结束之间的时间,包括Any开销或两帧之间的等待时间。已启用帧定时 Stats 时可用。
绘制 Calls 数量Unity 在一帧内发出的绘制 Calls 的总计数量。可用
动态批量绘制 Calls 数量Unity 组合到动态 Batches 中的绘制 Calls 的数量。Unavailable(不可用)
动态批处理三角形数量动态Batches中包含的游戏对象对象中的三角数量。Unavailable(不可用)
动态批处理顶点数量动态 Batches 中包含的游戏对象中的顶点数量。Unavailable(不可用)
动态 Batches 数量Unity 在帧期间处理的动态 Batches 数量。Unavailable(不可用)
动态批处理时间Unity 创建动态批处理结构所花费的时间。Unavailable(不可用)
GPU 帧时间GPU 渲染帧开始和结束之间的时间差。已启用帧定时 Stats 时可用。
索引缓冲区 Upload 帧字节CPU 上传到 GPU 的几何体体数amount(以字节为单位)。可用
索引缓冲区 Upload 帧数量CPU 在帧中上传到 GPU 的几何体体数amount。可用
实例化批量绘制 Calls 数量Unity 组合到实例 Batches 中的绘制 Calls 的数量。Unavailable(不可用)
实例化批处理三角形数量实例化游戏对象对象中的三角数量。Unavailable(不可用)
实例化批处理顶点数量实例化游戏对象中的顶点数量。Unavailable(不可用)
Instanced Batches 数量Unity 在一帧内为渲染实例游戏对象而处理的 Batches 数量。Unavailable(不可用)
渲染纹理字节RenderTextures 使用的内存amount(以字节为单位)。可用
渲染纹理更改数量Unity 在帧期间将一个或多个个 RenderTexture 设置为渲染目标的数量。可用
渲染纹理数量Unity 在帧期间使用的渲染纹理的数量。可用
SetPass Calls CountUnity 在一帧内切换用于渲染游戏对象对象的着Shader Pass的数量。可用
阴影投射物数量在一帧中Cast Shadows的游戏对象对象的数量。如果游戏对象对象投射多个个阴影(因为多个个光线光源它),则每个投射的阴影都有一个条目。可用
Static Batched 绘制 Calls 数量Unity 合并到StaticBatches中的绘制Calls数量。Unavailable(不可用)
静态批处理三角形计数StaticBatches中包含的游戏对象对象中的三角数量。Unavailable(不可用)
静态批处理顶点计数Static Batches 中包含的游戏对象中的顶点数量。Unavailable(不可用)
Static Batches 数量Unity 在一帧内处理的 Static Batches 数量。Unavailable(不可用)
三角形数量Unity 在一帧内处理的三角形的数量。可用
已用缓冲区字节以字节为单位使用的内存 GPU 缓冲区的 amount。可用
已用缓冲区数量GPU 缓冲区的总计数量。这包括vertex、索引和计算缓冲区以及渲染所需的All内部缓冲区。可用
已用纹理字节Textures 使用的内存量(以字节为单位)。Unavailable(不可用)
Used Textures 数量Unity 在帧期间使用的 Textures 数量。Unavailable(不可用)
顶点缓冲区 Upload 帧字节CPU 上传到 GPU 的几何体体数amount(以字节为单位)。可用
顶点缓冲区 Upload 帧内数量CPU 在帧中上传到 GPU 的几何体体数amount。可用
顶点数量Unity 在帧期间处理的顶点数量。可用
视频内存字节应用程序程序中视视频使用的System内内存(以字节为单位)。可用
可见蒙皮网格数量帧中 Skinned mesh Renderer 的数量。可用
有关收集渲染数据的更多信息,请参阅渲染性能分析器模块参考。

虚拟纹理性能性能分析器数器

释放(非 Development)玩家中的可用虚拟纹理性能分析器计数器和可用性如下:

性能分析器计数器

描述

释放(非 Development)玩家的可用性

图集虚拟纹理空间或图集的数量(最多 64 个)。Unavailable(不可用)
最大缓存需求选定帧中 All GPU 缓存的最高缓存需求。Unavailable(不可用)
最大缓存 Mip Bias应用于具有相同纹理格式的AllTextures的Automatic Mipmap Bias。如果值不为零,则缓存不足以容纳Format的All可见瓦片。Mipmap Bias 越高,纹理质量越低。Unavailable(不可用)
缺失磁盘数据应用程序程序为满足所选定帧而需要从磁盘读取的剩余数据(以字节为单位)。Unavailable(不可用)
缺失串流瓦片屏幕ON可见但不在视频内存中的瓦片数量。Unavailable(不可用)
从磁盘读取Unity 在所选定帧中completed的磁盘读取操作的字节数量。Unavailable(不可用)
必需瓦片ON 屏幕上可见的纹理瓦片的数量。这些是着色器尝试样本以渲染所帧瓦片。Unavailable(不可用)
总计 CPU 缓存大小Unity 从磁盘加载纹理瓦片后为存储纹理瓦片分配的内存amount。Unavailable(不可用)
总计 GPU 缓存大小虚拟纹理模块在所选定帧中分配的All GPU 缓存的大小。Unavailable(不可用)
有关收集虚拟纹理数据的更多信息,请参阅虚拟纹理模块参考。

其他资源