Legacy Documentation: Version 2018.1 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Application.lowMemory

Description

This event occurs when an iOS or Android device notifies of low memory while the app is running in the foreground. You can release non-critical assets from memory (such as, textures or audio clips) in response to this in order to avoid the app being terminated. You can also load smaller versions of such assets. Furthermore, you should serialize any transient data to permanent storage to avoid data loss if the app is terminated.

This event corresponds to the following callbacks on the different platforms:
- iOS: [UIApplicationDelegate applicationDidReceiveMemoryWarning]
- Android: onLowMemory() and onTrimMemory(level == TRIM_MEMORY_RUNNING_CRITICAL)


Here is an example of handling the callback:

#pragma strict
class LowMemoryTrigger extends MonoBehaviour {
    private function Start() {
        _textures = new List.<Texture2D>();
        Application.lowMemory += OnLowMemory;
    }
    private function Update() {
        // allocate textures until we run out of memory
        _textures.Add(new Texture2D(256, 256));
    }
    private function OnLowMemory() {
        // release all cached textures
        _textures = new List.<Texture2D>();
        Resources.UnloadUnusedAssets();
    }
}

Did you find this page useful? Please give it a rating: