ProfilerRecorder 构造函数

参数

描述

使用 Profiler 指标名称和类别构建 ProfilerRecorder 实例。

用于初始化 ProfilerRecorder 并将其与特定 Profiler 指标关联。

默认情况下，ProfilerRecorder 不会立即开始收集数据。使用 ProfilerRecorderOptions.StartImmediately 在 ProfilerRecorder 构造的同时启用收集。或者，在构造之后使用 Start 方法。如果 CurrentValue 是您唯一感兴趣的数据，则无需启动 ProfilerRecorder 或分配样本存储。在这种情况下，在创建 ProfilerRecorder 时使用 0 作为capacity 参数。

使用负数作为capacity 参数会抛出 ArgumentException。

注意
ProfilerRecorder 会分配内存，在不再需要时必须将其释放。

using Unity.Profiling;
using UnityEngine;

public class ExampleScript : MonoBehaviour
{
    ProfilerRecorder systemMemoryRecorder;
    ProfilerRecorder gcMemoryRecorder;
    ProfilerRecorder mainThreadTimeRecorder;

    void OnEnable()
    {
        systemMemoryRecorder = new ProfilerRecorder(ProfilerCategory.Memory, "System Used Memory", 1, ProfilerRecorderOptions.Default | ProfilerRecorderOptions.StartImmediately);
        gcMemoryRecorder = new ProfilerRecorder(ProfilerCategory.Memory, "GC Reserved Memory", 1, ProfilerRecorderOptions.Default | ProfilerRecorderOptions.StartImmediately);
        mainThreadTimeRecorder = new ProfilerRecorder(ProfilerCategory.Internal, "Main Thread", 15);
        mainThreadTimeRecorder.Start();
    }

    void OnDisable()
    {
        systemMemoryRecorder.Dispose();
        gcMemoryRecorder.Dispose();
        mainThreadTimeRecorder.Dispose();
    }
}

其他资源：StartNew。

参数

描述

使用 Profiler 指标名称构建 ProfilerRecorder 实例。

用于仅使用指标名称初始化 ProfilerRecorder。Unity 会在所有类别中搜索指标名称，因此，初始化速度比指定类别慢。

参数

描述

使用 Profiler 指标名称指针或其他不安全句柄构建 ProfilerRecorder 实例。