Class: AssetManager

Defined in: packages/core/src/asset/asset-manager.ts:57

Centralized asset loader with caching and priority‑based preloading.

Remarks

• Initializes loader instances against a shared LoadingManager.
• preloadAssets loads critical assets first (blocking), then starts background ones.
• Use getGLTF/getTexture/getAudio to retrieve cached results by key.

Constructors

Constructor

new AssetManager(): AssetManager

Returns

AssetManager

Properties

loadingManager

static loadingManager: LoadingManager

Defined in: packages/core/src/asset/asset-manager.ts:58

---

world

static world: World

Defined in: packages/core/src/asset/asset-manager.ts:59

Methods

getAsset()

static getAsset(key): any

Defined in: packages/core/src/asset/asset-manager.ts:140

Fetch any cached asset by logical key.

Parameters

key

string

Returns

any

---

getAudio()

static getAudio(key): AudioBuffer

Defined in: packages/core/src/asset/asset-manager.ts:156

Get a cached AudioBuffer by logical key.

Parameters

key

string

Returns

AudioBuffer

---

getGLTF()

static getGLTF(key, options?): GLTF

Defined in: packages/core/src/asset/asset-manager.ts:194

Get a cached GLTF by logical key.

Parameters

key

string

options?

GetGLTFOptions

Returns

GLTF

Remarks

Returns a fresh clone by default (scene/scenes are new Object3D trees; geometries, materials, animations stay shared), so the same key may be safely used for multiple entities. Pass { shared: true } to return the cached instance directly.

---

getTexture()

static getTexture(key): Texture<unknown>

Defined in: packages/core/src/asset/asset-manager.ts:171

Get a cached Texture by logical key.

Parameters

key

string

Returns

Texture<unknown>

---

init()

static init(renderer, world, options): void

Defined in: packages/core/src/asset/asset-manager.ts:64

Initialize loaders and bind to the current world/renderer.

Parameters

renderer

WebGLRenderer

world

World

options

Partial<AssetManagerOptions> = {}

Returns

void

---

loadAudio()

static loadAudio(url, key?): Promise<AudioBuffer>

Defined in: packages/core/src/asset/asset-manager.ts:146

Load an AudioBuffer by URL; optionally register a logical key.

Parameters

url

string

key?

string

Returns

Promise<AudioBuffer>

---

loadGLTF()

static loadGLTF(url, key?): Promise<GLTF>

Defined in: packages/core/src/asset/asset-manager.ts:133

Load a GLTF by URL; optionally register a logical key.

Parameters

url

string

key?

string

Returns

Promise<GLTF>

Remarks

Resolves with the cached GLTF directly. Use AssetManager.getGLTF after the load resolves to retrieve a clone suitable for placing into multiple entities.

---

loadHDRTexture()

static loadHDRTexture(url, key?): Promise<Texture<unknown>>

Defined in: packages/core/src/asset/asset-manager.ts:176

Load an HDR equirectangular texture; optionally register a logical key.

Parameters

url

string

key?

string

Returns

Promise<Texture<unknown>>

---

loadTexture()

static loadTexture(url, key?): Promise<Texture<unknown>>

Defined in: packages/core/src/asset/asset-manager.ts:161

Load a Texture by URL; optionally register a logical key.

Parameters

url

string

key?

string

Returns

Promise<Texture<unknown>>

---

preloadAssets()

static preloadAssets(manifest): Promise<void>

Defined in: packages/core/src/asset/asset-manager.ts:80

Preload assets with critical/background prioritization.

Parameters

manifest

AssetManifest

Returns

Promise<void>