Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


UnloadUnusedAssets()

Unloads assets that are not used.
Read time 1 minuteLast updated 12 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule
public static AsyncOperation UnloadUnusedAssets()

Returns

Type

Description

AsyncOperationObject on which you can yield to wait until the operation completes.

Remarks

An asset is deemed to be unused if it isn't reached after walking the whole game object hierarchy, including script components. Static variables are also examined.
The script execution stack, however, is not examined so an asset referenced only from within the script stack will be unloaded. All assets other than ScriptableObjects are loaded back in the next time one of its properties or methods is used. This requires extra care for assets which have been modified in memory. Make sure to call EditorUtility.SetDirty before an asset garbage collection is triggered.