# 将性能分析器计数器添加到代码中

> Collect specific statistics with profiler counters.

要添加性能分析器计数器，请创建脚本来执行以下操作：

* [创建并定义新计数器](#creating-and-defining-a-counter)。
* [更新计数器的值](#updating-a-counters-value)。

这些部分中的代码示例添加了一个性能分析器计数器，用来跟踪 Unity 为游戏对象的拖尾效果的每个实例创建的粒子总数。在这些示例中，游戏对象的名称为“Tank”。

## 资质要求

一些示例会用到 [Profiling Core 包](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest)，在开始之前必须安装该包。因为 Unity Profiling Core 是核心包，所以在 Package Manager UI 中无法找到。要安装包，请执行以下操作之一：

* [添加名称](/engine/6000.0/manual/packages-list/packages/upm-ui/actions/quick.md)，即 `com.unity.profiling.core`。
* [通过此链接](/engine/6000.0/manual/com-unity-profiling.md)安装。

## 创建和定义计数器

要新建计数器：

1. 编写一个脚本来定义新计数器的值类型。
2. 向此类型分配名称和单位。

\*\*重要提示：\*\*创建计数器时，必须指定新计数器所属的性能分析器类别。可以使用 [`ProfilerCategory`](/engine/6000.0/manual/unity-profiling.md) 类中的现有 Unity 类别来完成此操作。以下示例中的脚本使用现有的 `ProfilerCategory.Scripts` 类别。

性能分析器计数器 API 支持推送和拉取操作。您可以将计数器的值推送到性能分析器，或者性能分析器可以在帧末尾拉取该值。

如果您的数据不经常更改，例如每帧更改一次，请使用 [`ProfilerCounter`](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest?subfolder=/api/Unity.Profiling.ProfilerCounter-1.html) API 将计数器数据推送到性能分析器。如果您的数据每帧更改多次，请使用 `ProfilerCounterValue` API。这样能使性能分析器在帧结束时自动获取最后一个值。

以下示例脚本定义 [`ProfilerCounterValue`](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest?subfolder=/api/Unity.Profiling.ProfilerCounter-1.html) `TankTrailParticleCount`，其中名称为“Tank Trail Particles”，单位为 [ProfilerMarkerDataUnit.Count](/engine/6000.0/script-reference/unity-profiling/profiler-marker-data-unit/count.md)：

```lang-csharp
public static class GameStats
{
   public static readonly ProfilerCategory TanksCategory = ProfilerCategory.Scripts;

   public const string TankTrailParticleCountName = "Tank Trail Particles";
   public static readonly ProfilerCounterValue<int> TankTrailParticleCount =
       new ProfilerCounterValue<int>(TanksCategory, TankTrailParticleCountName, ProfilerMarkerDataUnit.Count,
           ProfilerCounterOptions.FlushOnEndOfFrame | ProfilerCounterOptions.ResetToZeroOnFlush);
}
```

选项 `FlushOnEndOfFrame` 和 `ResetToZeroOnFlush` 会自动将计数器发送到性能分析器数据流，并在帧末尾将计数 (Count) 值重置为零。

## 更新计数器的值

要更新计数器的值，请创建一个 MonoBehaviour 脚本来设置已定义的计数器的值。

以下 MonoBehaviour 脚本在 Update 函数中计算每一帧属于指定游戏对象的拖尾粒子数量。为此，它使用名为 `TankTrailParticleCount` 的计数器。

以下示例脚本还会在检视面板中创建一个名为拖尾粒子系统 (Trail Particle System, `m_TrailParticleSystem`) 的公共属性：

```lang-csharp
 using UnityEngine;

 class TankMovement : MonoBehaviour
 {
    public ParticleSystem m_TrailParticleSystem;

    void Update()
    {
        GameStats.TankTrailParticleCount.Value += m_TrailParticleSystem.particleCount;
    }
 }
```

### 将性能分析器计数器添加到自定义性能分析器模块

要通过代码在自定义性能分析器模块中显示性能分析器计数器，必须创建新的 `ProfilerModule` 脚本并定义该模块的属性，包括显示的计数器、名称和图标。有关如何执行此操作的信息，请参阅[在代码中创建性能分析器模块](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/customizing/creating-custom-modules.md#creating-profiler-modules-code)。

## 其他资源

* [将性能分析信息添加到代码中简介](/engine/6000.0/manual/analysis/profiler/adding-information-code/intro.md)
* [向代码中添加性能分析器标记](/engine/6000.0/manual/analysis/profiler/adding-information-code/add-markers-code.md)
* [自定义性能分析器模块](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/customizing.md)
* [Profiling Core 包](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest)