Profiling.Profiler.BeginSample

Unity · Версия 2020.3 LTS · Scripting · Profiler

Profiling.Profiler.BeginSample

Объявление

public static void BeginSample(string name);

public static void BeginSample(string name, Object targetObject);

Параметры

name Строка для идентификации образца в окне Profiler.
targetObject Объект, предоставляющий контекст выборке.

Описание

Начните профилирование фрагмента кода с пользовательского ярлыка.

Профилировщик отображает образец в представлениях "Иерархия" и "Временная шкала". Образец вложен в события или функциональные вызовы, которые приводят к выполнению кода образца. Например, образец, размещенный в разделе «Обновление», отображается в разделе Update.ScriptRunBehaviourUpdate в представлениях «Иерархия профилировщика» и «Временная шкала». Если вы укажете targetObject, вы можете щелкнуть образец на временной шкале профилировщика, чтобы выбрать этот объект в редакторе (при профилировании из режима воспроизведения в редакторе).

Profiler.BeginSample условно компилируется с помощью ConditionalAttribute. Таким образом, при развертывании в сборке, отличной от разработки, у него не будет накладных расходов.

using UnityEngine;
using System.Collections;
using UnityEngine.Profiling;

public class ExampleClass : MonoBehaviour
{
    void Example()
    {
        Profiler.BeginSample("MyPieceOfCode");
        // Code to measure...
        Profiler.EndSample();
    }
}

Смотрите так же: Profiler.EndSample, ProfilerCPU.

Обновлено 17 ноября 2026 г.