Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dre0dru/assetmanagement
A set of classes to convert Unity Addressables callbacks/coroutine workflow to async/await with UniTask.
https://github.com/dre0dru/assetmanagement
addressable addressables library unity upm-package
Last synced: 2 months ago
JSON representation
A set of classes to convert Unity Addressables callbacks/coroutine workflow to async/await with UniTask.
- Host: GitHub
- URL: https://github.com/dre0dru/assetmanagement
- Owner: dre0dru
- License: mit
- Created: 2021-02-26T20:19:05.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-11T10:15:05.000Z (over 1 year ago)
- Last Synced: 2024-05-21T14:05:26.546Z (7 months ago)
- Topics: addressable, addressables, library, unity, upm-package
- Language: C#
- Homepage:
- Size: 188 KB
- Stars: 94
- Watchers: 5
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://openupm.com/packages/com.dre0dru.assetmanagement/)
# Addressables Services
A set of classes to convert Unity `Addressables` callbacks/coroutine workflow to async/await with UniTask.
Unity 2020.1+
## Installation
This package can be installed as a Unity package from git url.
### Latest release
- Add following line in `Packages/manifest.json`:
```
"com.dre0dru.assetmanagement": "https://github.com/dre0dru/AssetManagement.git",
```
- Use `Window/Package Manager/Add package from git URL...` in Unity:
```
https://github.com/dre0dru/AssetManagement.git
```
## Dependencies
This package has following dependencies that must be present for package to compile:
- [UniTask](https://github.com/Cysharp/UniTask)
### Optional
- [ScriptingDefineUtility](https://github.com/Thundernerd/Unity3D-ScriptingDefineUtility) enables full logs switch for `Addressables` under `Window->Asset Management->Addressables->Logs`
- [VContainer](https://github.com/hadashiA/VContainer) - optional extension methods for bindings
- [Shared.Sources](https://github.com/dre0dru/Shared.Sources) used for implementations of interfaces in several modules, interfaces are not dependent on this package
## Loaders
Generic type-safe assets loader.
Can be used for both async assets loading on demand or async preloading and sync usage during gameplay.
```csharp
[SerializeField]
private AssetReferenceT _clipAssetReference01;
[SerializeField]
private AssetReferenceT _clipAssetReference02;
IAssetsReferenceLoader loader = new AssetsReferenceLoader();
//Or more generic IAssetsLoader
IAssetsLoader, AudioClip> loader =
new AssetsReferenceLoader();
//Preload assets
await loader.PreloadAssetAsync(_clipAssetReference01);
await loader.PreloadAssetsAsync(_clipAssetReference01, _clipAssetReference02);
//Safely extract preloaded asset synchronously
if (loader.TryGetAsset(_clipAssetReference01, out AudioClip audioClip))
{
Debug.Log($"Asset loaded successfully: {audioClip}");
}
else
{
Debug.Log($"No asset was for preloaded for {_clipAssetReference01.RuntimeKey}");
}
//Check if asset was loaded
bool isAssetPreloaded = loader.IsAssetLoaded(_clipAssetReference01);
//Or use unsafe asset extraction, will throw exception if no asset was preloaded
AudioClip audioClip = loader.GetAsset(_clipAssetReference01);
//Load asynchronously on demand, will be completed immediately if asset is already loaded
AudioClip audioClip = await loader.LoadAssetAsync(_clipAssetReference01);
AudioClip[] audioClips = await loader.LoadAssetsAsync(_clipAssetReference01, _clipAssetReference02);
//Unload unused assets
loader.UnloadAsset(_clipAssetReference01);
//Or unload all assets that were loaded
loader.UnloadAllAssets();
```
### AssetReferenceComponent
`AssetReferenceComponent` allows to filter Addressables assets by specific component in Unity Editor. Must be used with `IAssetsReferenceLoader`.
```csharp
[SerializeField]
private AssetReferenceComponent _cameraReference;
IAssetsReferenceLoader gameObjectLoader =
new AssetsReferenceLoader();
//AssetReferenceComponent can be passed to IAssetsReferenceLoader
//since it is inherited from AssetReferenceGameObject
await gameObjectLoader.PreloadAssetAsync(_cameraReference);
//Safely extract preloaded GameObject with Camera component on it
if(gameObjectLoader.TryGetComponent(_cameraReference, out Camera camera))
{
Camera cameraInstance = Object.Instantiate(camera);
}
//Or use unsafe asset extraction, will throw exception if no asset was preloaded
var cameraComponent = gameObjectLoader.GetComponent(_cameraReference);
```
### VContainer extensions
```csharp
//Will bind IAssetReferenceLoader to AssetRefereceLoader implementation
builder.RegisterAssetsReferenceLoader(Lifetime.Scoped);
```
## Downloaders
Any downloader implements several interfaces: `IStartableDownload`,
`IAssetsDownloadStatus` and optional ` ITrackableProgress`.
Currently only `AssetLabelsDownloadPack` is provided since downloading by `AssetReferenceLabel` is the most common way.
```csharp
//Create download pack
var downloadPack = new AssetLabelsDownloadPack(_assetLabelReference);
//Set method to track download status changes, accepts implementations of IProgress
_downloadPack.TrackProgress(Progress.Create(DisplayStatus));
//Or get status manually
var status = _downloadPack.DownloadStatus;
//Start download
bool isSuccess = await _downloadPack.StartDownloadAsync();
if(!isSuccess){
//Download can be restarted anytime
isSuccess = await _downloadPack.StartDownloadAsync();
}
_downloadPack.Dispose();
```
```csharp
private void DisplayStatus(AssetsDownloadStatus status)
{
_downloadSize.text = $"Size {status.DownloadSizeBytes.ToString()}";
_percentProgress.text = $"Percent: {status.PercentProgress:F}";
_isDownloaded.text = $"Is downloaded {status.IsDownloaded}";
_status.text = $"Status {status.DownloadOperationStatus.ToString()}";
_downloadedBytes.text = $"Downloaded: {status.DownloadedBytes.ToString()}";
}
```
## AssetReferences
Simple Unity `ScriptableObject` Dictionaries for `AssetLabelReference` and `AssetReference`:
- `AssetLabelsUDictionarySo`
- `AssetReferencesUDictionarySo`
## Fonts
> When using TMP with Addressables without initial preparations there will be either duplicated assets or broken Unity Editor workflow.
1. Inherit `TMPAddressableAssets`
2. Create `ScriptableObject` instance, set it up with fonts/sprite assets addressable references
3. Create instance of `TMPBuildProcessorSettings`, set it up
```csharp
TMPAddressableAssets assets;
IAssetsReferenceLoader fontsLoader;
IAssetsReferenceLoader spriteAssetsLoader;
//Setup/bind service instance
IFontsService service = new FontsService(
assets, fontsLoader, spriteAssetsLoader
);
//Load font by locale
await service.LoadFontForLocale("en");
//Unload unused fonts
service.UnloadFontForLocale("ru");
await service.LoadSpriteAsset("CurrencyIcons");
service.UnloadSpriteAsset("CurrencyIcons");
```
## SpriteAtlases
`ISpriteAtlasProvider` implementation can be used to control Unity `SpriteAtlase` loading/unloading at runtime via `Addressables`.
```csharp
IAssetsReferenceLoader spriteAtlasLoader;
ISpriteAtlasAddressableAssets spriteAtlasAddressableAssets;
ISpriteAtlasProvider provider = new SpriteAtlasProvider(
spriteAtlasLoader, spriteAtlasAddressableAssets
);
//Listen SpriteAtlasManager atlas requests
//Requeted SpriteAtlases will be loaded automatically
provider.SubscribeToAtlasManagerRequests();
//Unload all SpriteAtlases that we loaded by this provider
provider.UnloadSpriteAtlases();
provider.UnsubscribeFromAtlasManagerRequests();
```
### VContainer extensions
Entry point for managing provider lifetime:
```csharp
builder.RegisterEntryPoint();
```
# License
The software released under the terms of the [MIT license](./LICENSE.md).