Version: 2023.2
言語: 日本語

Profiler

class in UnityEngine.Profiling

マニュアルに切り替える

説明

スクリプトから Profiler を扱います。

You can add custom Profiler sections in your scripts with Profiler.BeginSample and Profiler.EndSample.

On standalone platforms, you can save all profiling information to a file, which allows you to inspect it later. To do this, you must specify a Profiler.logFile and set both Profiler.enabled and Profiler.enableBinaryLog to true.

Because use of the Profiler negatively affects the performance of your app, most of the Profiler API functionality is only available when you enable the `Development Build`. Therefore, you must enable `Developer Build` if you want to use profiler API methods in your built app. Disabling `Development Build` makes your app run faster, but prevents you from using most of the Profiler API methods.

The exception to this are the Profiler API methods relating to memory usage. Because Unity manages most of its system memory at run-time, it can provide that information with no performance penalty; therefore these methods are available even if you don't enable `Development Build`. This applies to all memory-related Profiler API methods except Profiler.GetAllocatedMemoryForGraphicsDriver and Profiler.GetRuntimeMemorySizeLong, since they require extra profiling data only available in development builds.

Static 変数

areaCountThe number of Profiler Areas that you can profile.
enableAllocationCallstacksEnables the recording of callstacks for managed allocations.
enableBinaryLogEnables the logging of profiling data to a file.
enabledプロファイラーの有効/無効を設定します
logFileSpecifies the file to use when writing profiling data.
maxUsedMemorySets the maximum amount of memory that Profiler uses for buffering data. This property is expressed in bytes.
usedHeapSizeLongReturns the number of bytes that Unity has allocated. This does not include bytes allocated by external libraries or drivers.

Static 関数

AddFramesFromFileDisplays the recorded profile data in the profiler.
BeginSampleカスタムラベルの付いたコードの一部のプロファイリングを開始します
BeginThreadProfilingEnables profiling on the thread from which you call this method.
EmitFrameMetaDataWrite metadata associated with the current frame to the Profiler stream.
EmitSessionMetaDataWrite metadata associated with the whole Profiler session capture.
EndSampleEnds the current profiling sample.
EndThreadProfilingFrees the internal resources used by the Profiler for the thread.
GetAllCategoriesReturns all ProfilerCategory registered in Profiler.
GetAllocatedMemoryForGraphicsDriverReturns the amount of allocated memory for the graphics driver, in bytes.プレイヤーとエディターでのみ利用可能です。
GetAreaEnabledReturns whether or not a given ProfilerArea is currently enabled.
GetCategoriesCountReturns number of ProfilerCategory registered in Profiler.
GetMonoHeapSizeLongReturns the size of the reserved space for managed-memory.
GetMonoUsedSizeLongGets the allocated managed memory for live objects and non-collected objects.
GetRuntimeMemorySizeLongGathers the native-memory used by a Unity object.
GetTempAllocatorSizeReturns the size of the temp allocator.
GetTotalAllocatedMemoryLongThe total memory allocated by the internal allocators in Unity. Unity reserves large pools of memory from the system; this includes double the required memory for textures because Unity keeps a copy of each texture on both the CPU and GPU. This function returns the amount of used memory in those pools.
GetTotalFragmentationInfoReturns heap memory fragmentation information.
GetTotalReservedMemoryLongThe total memory Unity has reserved.
GetTotalUnusedReservedMemoryLongUnity allocates memory in pools for usage when unity needs to allocate memory. This function returns the amount of unused memory in these pools.
IsCategoryEnabledReturns whether or not a given ProfilerCategory is currently enabled.
SetAreaEnabledEnable or disable a given ProfilerArea.
SetCategoryEnabledEnable or disable a given ProfilerCategory.
SetTempAllocatorRequestedSizeSets the size of the temp allocator.