ProfilerUnsafeUtility.FlowEvent

参数

说明

将流事件添加到 Profiler 样本。

使用 Profiler 流事件来突出在不同线程上的任务执行之间的依赖关系。

流事件与 ProfilerMarker 配合使用。

using System;
using System.Threading;
using Unity.Profiling;
using Unity.Profiling.LowLevel;
using Unity.Profiling.LowLevel.Unsafe;

public class Example
{
    public const int k_NumberOfTasks = 4;

    static readonly ProfilerMarker k_ScheduleParallelTasksMarker = new ProfilerMarker("Schedule Parallel Tasks");
    static readonly ProfilerMarker k_ParallelTaskMarker = new ProfilerMarker("Parallel Task");
    static readonly ProfilerMarker k_TaskSyncMarker = new ProfilerMarker("Sync Task");

    static void EmitFlowEventAndChainThread(uint flowId)
    {
        // Mark the next k_ParallelTaskMarker as a beginning of the flow
        ProfilerUnsafeUtility.FlowEvent(flowId, ProfilerFlowEventType.ParallelNext);
        using (k_ParallelTaskMarker.Auto())
        {
            // Do work
        }
    }

    static void ScheduleParallelTask()
    {
        uint flowId;
        var threads = new Thread[k_NumberOfTasks];
        using (k_ScheduleParallelTasksMarker.Auto())
        {
            flowId = ProfilerUnsafeUtility.CreateFlow(ProfilerUnsafeUtility.CategoryScripts);
            // Mark the parent k_ScheduleParallelTasksMarker as a beginning of the flow
            ProfilerUnsafeUtility.FlowEvent(flowId, ProfilerFlowEventType.Begin);
            for (var i = 0; i < k_NumberOfTasks; ++i)
            {
                var thread = new Thread(() => EmitFlowEventAndChainThread(flowId));
                thread.Start();
                threads[i] = thread;
            }
        }

        using (k_TaskSyncMarker.Auto())
        {
            // Mark the parent k_TaskSyncMarker as a beginning of the flow
            ProfilerUnsafeUtility.FlowEvent(flowId, ProfilerFlowEventType.End);
            for (var i = 0; i < k_NumberOfTasks; ++i)
                threads[i].Join();
        }
    }
}

必须将 FlowEvent 与 ProfilerMarker 一起使用。

要将样本标记为流的开头或结尾，请在 FlowEvent 中使用 ProfilerFlowEventType.Begin 和 ProfilerFlowEventType.End 事件，这些事件必须在使用 ProfilerMarker.Begin 和 ProfilerMarker.End 进行检测的范围内，或在 ProfilerMarker.Auto 的 using 范围内。


要将样本标记为流延续点，请在 FlowEvent 中使用 ProfilerFlowEventType.Next 和 ProfilerFlowEventType.ParallelNext，然后调用 ProfilerMarker.Begin 或 ProfilerMarker.Auto。

注意：Unity Job System 会自动标记作业调度、执行和等待点。

其他资源：CreateFlow，CPU 使用情况 Profiler 模块。