Legacy Documentation: Version 4.6(go to latest)
Language: English
  • C#
  • JS
  • Boo

Script language

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

Resources.LoadAsync

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static function LoadAsync(path: string): ResourceRequest;
public static ResourceRequest LoadAsync(string path);
public static def LoadAsync(path as string) as ResourceRequest

Parameters

path Path to the asset in the Resources folder.

Description

Asynchronously loads an asset stored at path in a Resources folder.

Asynchronous loading requires Unity Pro.

Returns a ResourceRequest, from which the asset can be retrieved once the loading operation is completed. Only objects of type will be returned if this parameter is supplied. The path is relative to any Resources folder inside the Assets folder of your project, extensions must be omitted.

Note:
All asset names & paths in Unity use forward slashes, paths using backslashes will not work.

See Also: ResourceRequest, Resources.Load.

// Assigns a texture named "glass" to a Plane.

function Start () { StartCoroutine (LoadTexture()); }

function LoadTexture(){ var go = new GameObject.CreatePrimitive(PrimitiveType.Cube); var request = Resources.LoadAsync ("glass"); yield request; go.renderer.material.mainTexture = request.asset as Texture2D; }
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Start() {
        StartCoroutine(LoadTexture());
    }
    IEnumerator LoadTexture() {
        GameObject go = GameObject.CreatePrimitive(PrimitiveType.Cube);
        ResourceRequest request = Resources.LoadAsync("glass");
        yield return request;
        go.renderer.material.mainTexture = request.asset as Texture2D;
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Start() as void:
		StartCoroutine(LoadTexture())

	def LoadTexture() as IEnumerator:
		go as GameObject = GameObject.CreatePrimitive(PrimitiveType.Cube)
		request as ResourceRequest = Resources.LoadAsync('glass')
		yield request
		go.renderer.material.mainTexture = (request.asset as Texture2D)

public static function LoadAsync(path: string, type: Type): ResourceRequest;
public static ResourceRequest LoadAsync(string path, Type type);
public static def LoadAsync(path as string, type as Type) as ResourceRequest

Parameters

path Path to the asset in the Resources folder.
type Type filter for objects returned.

Description

Asynchronously loads an asset stored at path in a Resources folder.

Asynchronous loading requires Unity Pro.

Returns a ResourceRequest, from which the asset can be retrieved once the loading operation is completed. Only objects of type will be returned. The path is relative to any Resources folder inside the Assets folder of your project, extensions must be omitted.

See Also: ResourceRequest, Resources.Load.

// Assigns a texture named "glass" to a Plane.

function Start () { StartCoroutine (LoadTexture()); }

function LoadTexture(){ var go = new GameObject.CreatePrimitive(PrimitiveType.Cube); var request = Resources.LoadAsync ("glass", typeof(Texture2D)); yield request; go.renderer.material.mainTexture = request.asset as Texture2D; }
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Start() {
        StartCoroutine(LoadTexture());
    }
    IEnumerator LoadTexture() {
        GameObject go = GameObject.CreatePrimitive(PrimitiveType.Cube);
        ResourceRequest request = Resources.LoadAsync("glass", typeof(Texture2D));
        yield return request;
        go.renderer.material.mainTexture = request.asset as Texture2D;
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Start() as void:
		StartCoroutine(LoadTexture())

	def LoadTexture() as IEnumerator:
		go as GameObject = GameObject.CreatePrimitive(PrimitiveType.Cube)
		request as ResourceRequest = Resources.LoadAsync('glass', typeof(Texture2D))
		yield request
		go.renderer.material.mainTexture = (request.asset as Texture2D)

public static function LoadAsync(path: string): ResourceRequest;
public static ResourceRequest LoadAsync(string path);
public static def LoadAsync(path as string) as ResourceRequest

Parameters

path Path to the asset in the Resources folder.

Description

Asynchronously loads an asset stored at path in a Resources folder.

Asynchronous loading requires Unity Pro.

Returns a ResourceRequest, from which the asset can be retrieved once the loading operation is completed. Only objects of type T will be returned. The path is relative to any Resources folder inside the Assets folder of your project, extensions must be omitted.

See Also: ResourceRequest, Resources.Load.

// Assigns a texture named "glass" to a Plane.

function Start () { StartCoroutine (LoadTexture()); }

function LoadTexture(){ var go = new GameObject.CreatePrimitive(PrimitiveType.Cube); var request = Resources.LoadAsync.<Texture2D> ("glass"); yield request; go.renderer.material.mainTexture = request.asset; }
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Start() {
        StartCoroutine(LoadTexture());
    }
    IEnumerator LoadTexture() {
        GameObject go = GameObject.CreatePrimitive(PrimitiveType.Cube);
        ResourceRequest request = Resources.LoadAsync<Texture2D>("glass");
        yield return request;
        go.renderer.material.mainTexture = request.asset;
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Start() as void:
		StartCoroutine(LoadTexture())

	def LoadTexture() as IEnumerator:
		go as GameObject = GameObject.CreatePrimitive(PrimitiveType.Cube)
		request as ResourceRequest = Resources.LoadAsync[of Texture2D]('glass')
		yield request
		go.renderer.material.mainTexture = request.asset