Class UnityAssetUtils

Utility class for Unity asset loading operations including Addressables management, audio clip caching, and asset warm-up functionality with thread-safe operations.

Every public entry point is gated by SerenityAssetLoadingModeProvider:

• AddressablesWithResourcesFallback (default) keeps the committed behaviour: Addressables first, Resources fallback.
• AddressablesOnly skips every Resources fallback path.
• ResourcesOnly never touches the Addressables API — no LoadAssetAsync, no LoadAssetsAsync, no LoadResourceLocationsAsync, no WaitForCompletion.

In ResourcesOnly mode the synchronous WebGL guard is moot: no sync Addressables call is reachable. The guard remains on the Addressables-using branches so that any AddressablesOnly / AddressablesWithResourcesFallback caller that hits sync code on WebGL still throws NotSupportedException with an actionable message.

Inheritance

object

UnityAssetUtils

Inherited Members

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

Namespace: Serenity.Global.Infrastructure.Utils

Assembly: Serenity.UnityGlobal.Infrastructure.dll

Syntax

public static class UnityAssetUtils

Methods

ClearAudioClipCache()

Declaration

public static void ClearAudioClipCache()

ClearWarned(Type)

Declaration

public static void ClearWarned(Type t = null)

Parameters

Type	Name	Description
Type	t

EnsureAudioClipWarmedUp(AudioClip, string)

Declaration

public static void EnsureAudioClipWarmedUp(AudioClip clip, string keyOrPath)

Parameters

Type	Name	Description
AudioClip	clip
string	keyOrPath

FindByGuidAsync<T>(string, IEnumerable<string>, CancellationToken)

Declaration

public static Task<T> FindByGuidAsync<T>(string guid, IEnumerable<string> labels = null, CancellationToken cancellationToken = default) where T : Object, IFoundationSettings

Parameters

Type	Name	Description
string	guid
IEnumerable<string>	labels
CancellationToken	cancellationToken

Returns

Type	Description
Task<T>

Type Parameters

Name	Description
T

FindByGuidBlocking<T>(string, IEnumerable<string>)

Declaration

public static T FindByGuidBlocking<T>(string guid, IEnumerable<string> labels = null) where T : Object, IFoundationSettings

Parameters

Type	Name	Description
string	guid
IEnumerable<string>	labels

Returns

Type	Description
T

Type Parameters

Name	Description
T

FindManyByGuidBlocking<T>(IEnumerable<string>, IEnumerable<string>)

Declaration

public static Dictionary<string, T> FindManyByGuidBlocking<T>(IEnumerable<string> guids, IEnumerable<string> labels = null) where T : Object, IFoundationSettings

Parameters

Type	Name	Description
IEnumerable<string>	guids
IEnumerable<string>	labels

Returns

Type	Description
Dictionary<string, T>

Type Parameters

Name	Description
T

LoadAllFromAnyAsync<T>(IEnumerable<string>, CancellationToken)

Declaration

public static Task<IList<T>> LoadAllFromAnyAsync<T>(IEnumerable<string> labels, CancellationToken cancellationToken = default) where T : Object

Parameters

Type	Name	Description
IEnumerable<string>	labels
CancellationToken	cancellationToken

Returns

Type	Description
Task<IList<T>>

Type Parameters

Name	Description
T

LoadAllFromAnyAsync<T>(string, CancellationToken)

Declaration

public static Task<IList<T>> LoadAllFromAnyAsync<T>(string label = null, CancellationToken cancellationToken = default) where T : Object

Parameters

Type	Name	Description
string	label
CancellationToken	cancellationToken

Returns

Type	Description
Task<IList<T>>

Type Parameters

Name	Description
T

LoadAllFromAnyBlocking<T>(IEnumerable<string>)

Declaration

public static T[] LoadAllFromAnyBlocking<T>(IEnumerable<string> labels) where T : Object

Parameters

Type	Name	Description
IEnumerable<string>	labels

Returns

Type	Description
T[]

Type Parameters

Name	Description
T

LoadAllFromAnyBlocking<T>(string)

Declaration

public static T[] LoadAllFromAnyBlocking<T>(string label = null) where T : Object

Parameters

Type	Name	Description
string	label

Returns

Type	Description
T[]

Type Parameters

Name	Description
T

LoadAudioClipAsync(string, CancellationToken)

Declaration

public static Task<AudioClip> LoadAudioClipAsync(string keyOrPath, CancellationToken cancellationToken = default)

Parameters

Type	Name	Description
string	keyOrPath
CancellationToken	cancellationToken

Returns

Type	Description
Task<AudioClip>

LoadAudioClipBlocking(string)

Declaration

public static AudioClip LoadAudioClipBlocking(string keyOrPath)

Parameters

Type	Name	Description
string	keyOrPath

Returns

Type	Description
AudioClip

LogAudioClipCacheStatus()

Declaration

public static void LogAudioClipCacheStatus()

PreloadAndWarmUpAudioClipsAsync(IEnumerable<string>)

Declaration

public static Task PreloadAndWarmUpAudioClipsAsync(IEnumerable<string> keyOrPaths)

Parameters

Type	Name	Description
IEnumerable<string>	keyOrPaths

Returns

Type	Description
Task

PreloadAudioClipAsync(string)

Declaration

public static void PreloadAudioClipAsync(string keyOrPath)

Parameters

Type	Name	Description
string	keyOrPath

PreloadAudioClipsAsync(IEnumerable<string>)

Declaration

public static Task PreloadAudioClipsAsync(IEnumerable<string> keyOrPaths)

Parameters

Type	Name	Description
IEnumerable<string>	keyOrPaths

Returns

Type	Description
Task