Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


LoadableStatus

Describes the current loading phase of a Loadable<T> after Loadable<T>.Load or Loadable<T>.LoadAsync is used.
Read time 1 minuteLast updated 6 days ago

Definition

  • Type: Enum
  • Namespace: Unity.Loading
  • Assembly: UnityEngine.ContentLoadModule
public enum LoadableStatus

Remarks

Query Loadable<T>.Status to drive UI or to assert that a load finished before reading Loadable<T>.Target. LoadableStatus.Failed indicates the asynchronous load completed without a usable object. This often occurs due to missing built content.

Examples

using System.Threading.Tasks;using Unity.Loading;using UnityEngine;namespace BuildDocExamples{ public class Loadable_LoadAndReleaseExample { public class HatPicker : MonoBehaviour { public Loadable<GameObject> hatPrefab; public void EquipDefault() { hatPrefab.Load(); Instantiate(hatPrefab.Target); } } // Example showing async loading with status check public async Task LoadAsyncExample(Loadable<Texture2D> myLoadable) { await myLoadable.LoadAsync(); if (myLoadable.Status == LoadableStatus.Loaded) { // Use myLoadable.Target Debug.Log($"Loaded: {myLoadable.Target.name}"); } else { Debug.LogWarning($"Texture2D myLoadable failed to load. Loadable : {myLoadable.ToString()}"); } myLoadable.Release(); } }}

Fields

Value

Description

FailedThe loading operation completed but failed.
LoadedThe loading operation completed successfully.
LoadingThe loading operation has begun.
NoneThe Loadable has not begun loading.