Struct AssetServer 

pub struct AssetServer { /* private fields */ }

The central asset server: coordinates loading, caching, hot-reload, and streaming.

Lifecycle

1. Register loaders with register_loader.
2. Request assets with load or load_manifest.
3. Call update each frame to process the streaming queue and hot-reload.
4. Retrieve loaded data via get.

Implementations

impl AssetServer

pub fn new_with_config(config: AssetServerConfig) -> Self

Create a new asset server with the given configuration.

pub fn new() -> Self

Create a new asset server with default configuration.

pub fn set_root_dir(&mut self, dir: impl Into<PathBuf>)

Change the root asset directory.

pub fn register_loader<A: Asset, L: AssetLoader<A>>(&mut self, loader: L)

Register a loader for asset type A.

The loader’s extensions() are used to match file paths. If multiple loaders claim the same extension, the most recently registered one takes precedence.

pub fn mount_pack(&mut self, pack: AssetPack)

Mount an AssetPack. Files in packs are resolved before the file-system.

pub fn load<A: Asset>(&mut self, path: impl Into<AssetPath>) -> AssetHandle<A>

Request that path be loaded as asset type A.

Returns an AssetHandle<A> immediately. The handle will become populated after update processes the request.

If the asset is already loaded, a handle to the existing data is returned.

pub fn load_with_priority<A: Asset>( &mut self, path: impl Into<AssetPath>, priority: StreamPriority, ) -> AssetHandle<A>

Like load but with an explicit priority.

pub fn load_manifest(&mut self, manifest: &AssetManifest)

Queue all assets declared in manifest for loading.

Callers should subsequently call typed load::<T>() for each entry to obtain typed handles; this method ensures the paths are pre-registered at the declared priorities.

pub fn update(&mut self)

Drive the asset server for one frame.

This processes pending streaming requests (up to stream_batch_size per call) and polls the hot-reload watcher. Call once per frame.

pub fn get<A: Asset>(&mut self, handle: &AssetHandle<A>) -> Option<Arc<A>>

Try to get the data for handle.

Returns None if the asset is not yet loaded or has been evicted.

pub fn load_state<A: Asset>(&self, handle: &AssetHandle<A>) -> LoadState

Get the LoadState of handle.

pub fn reload<A: Asset>(&mut self, handle: &AssetHandle<A>)

Force an immediate synchronous reload of an asset by handle.

pub fn insert<A: Asset>( &mut self, path: impl Into<AssetPath>, asset: A, ) -> AssetHandle<A>

Insert an already-constructed asset directly into the registry.

Returns a handle to the inserted asset. Useful for procedurally generated assets that have no backing file.

pub fn stats(&self) -> &AssetServerStats

Return a snapshot of the current server statistics.

pub fn asset_count(&self) -> usize

Number of assets currently tracked by the registry.

pub fn is_idle(&self) -> bool

true if all streaming requests have been processed.

pub fn read_bytes( &mut self, path: &AssetPath, ) -> Result<(Vec<u8>, Option<SystemTime>), String>

Read bytes for a given path, checking packs first then the file-system. Exposed as pub for testing and pack inspection utilities.

Trait Implementations

impl Debug for AssetServer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AssetServer

fn default() -> Self

Returns the “default value” for a type.