Files
Nitro_Render_V3/packages/avatar/src/AvatarAssetDownloadManager.ts
T
2026-04-01 12:31:24 +02:00

313 lines
9.4 KiB
TypeScript

import { IAssetManager, IAvatarFigureContainer, IAvatarImageListener } from '@nitrots/api';
import { GetConfiguration } from '@nitrots/configuration';
import { AvatarRenderLibraryEvent, GetEventDispatcher, NitroEvent, NitroEventType } from '@nitrots/events';
import { AvatarAssetDownloadLibrary } from './AvatarAssetDownloadLibrary';
import { AvatarStructure } from './AvatarStructure';
export class AvatarAssetDownloadManager
{
private _assets: IAssetManager;
private _structure: AvatarStructure;
private _missingMandatoryLibs: string[] = [];
private _figureMap: Map<string, AvatarAssetDownloadLibrary[]> = new Map();
private _figureListeners: Map<string, IAvatarImageListener[]> = new Map();
private _incompleteFigures: Map<string, AvatarAssetDownloadLibrary[]> = new Map();
private _currentDownloads: AvatarAssetDownloadLibrary[] = [];
private _libraryNames: string[] = [];
private _libraryLoadedCallback: (event: AvatarRenderLibraryEvent) => void = null;
constructor(assets: IAssetManager, structure: AvatarStructure)
{
this._assets = assets;
this._structure = structure;
}
private static DEFAULT_MANDATORY_LIBS: string[] = ['hh_human_face'];
public async init(): Promise<void>
{
const configuredLibs = GetConfiguration().getValue<string[]>('avatar.mandatory.libraries') || [];
this._missingMandatoryLibs = [ ...configuredLibs ];
for(const lib of AvatarAssetDownloadManager.DEFAULT_MANDATORY_LIBS)
{
if(this._missingMandatoryLibs.indexOf(lib) === -1) this._missingMandatoryLibs.push(lib);
}
const url = GetConfiguration().getValue<string>('avatar.figuremap.url');
if(!url || !url.length) throw new Error('Missing "avatar.figuremap.url" in config — add the figure map URL to your renderer-config.json');
let response: Response;
try
{
response = await fetch(url);
}
catch(fetchErr)
{
throw new Error(`Could not fetch figure map from "${ url }" — check "avatar.figuremap.url" in renderer-config.json (${ fetchErr.message })`);
}
if(response.status !== 200) throw new Error(`Failed to load figure map from "${ url }" — server returned HTTP ${ response.status }. Check "avatar.figuremap.url" in renderer-config.json`);
let responseData: any;
try
{
responseData = await response.json();
}
catch(parseErr)
{
throw new Error(`Invalid JSON in figure map "${ url }" — the URL may be wrong. Check "avatar.figuremap.url" in renderer-config.json (${ parseErr.message })`);
}
this.processFigureMap(responseData.libraries);
// Store callback for cleanup
this._libraryLoadedCallback = (event: AvatarRenderLibraryEvent) => this.onLibraryLoaded(event);
GetEventDispatcher().addEventListener(NitroEventType.AVATAR_ASSET_DOWNLOADED, this._libraryLoadedCallback);
await this.processMissingLibraries();
}
public dispose(): void
{
if(this._libraryLoadedCallback)
{
GetEventDispatcher().removeEventListener(NitroEventType.AVATAR_ASSET_DOWNLOADED, this._libraryLoadedCallback);
this._libraryLoadedCallback = null;
}
this._figureMap.clear();
this._figureListeners.clear();
this._incompleteFigures.clear();
this._currentDownloads = [];
}
private processFigureMap(data: any): void
{
if(!data) return;
const downloadUrl = GetConfiguration().getValue<string>('avatar.asset.url');
for(const library of data)
{
if(!library) continue;
const libraryName = (library.id as string);
const revision = (library.revision || '');
if(this._libraryNames.indexOf(libraryName) >= 0) continue;
this._libraryNames.push(libraryName);
const downloadLibrary = new AvatarAssetDownloadLibrary(libraryName, revision, downloadUrl, this._assets);
for(const part of (library.parts || []))
{
const id = (part.id as string);
const type = (part.type as string);
const partString = (type + ':' + id);
let existing = this._figureMap.get(partString);
if(!existing) existing = [];
existing.push(downloadLibrary);
this._figureMap.set(partString, existing);
}
}
}
private async processMissingLibraries(): Promise<void>
{
const promises: Promise<void>[] = [];
this._missingMandatoryLibs.forEach(value =>
{
const libraries = this._figureMap.get(value);
if(libraries) for(const library of libraries) promises.push(library.downloadAsset());
});
this._missingMandatoryLibs = [];
await Promise.all(promises);
}
private onLibraryLoaded(event: AvatarRenderLibraryEvent): void
{
if(!event || !event.library) return;
const loadedFigures: string[] = [];
for(const [figure, libraries] of this._incompleteFigures.entries())
{
let isReady = true;
for(const library of libraries)
{
if(!library || library.isLoaded) continue;
isReady = false;
break;
}
if(isReady)
{
loadedFigures.push(figure);
const listeners = this._figureListeners.get(figure);
if(listeners)
{
for(const listener of listeners)
{
if(!listener || listener.disposed) continue;
listener.resetFigure(figure);
}
}
this._figureListeners.delete(figure);
GetEventDispatcher().dispatchEvent(new NitroEvent(NitroEventType.AVATAR_ASSET_LOADED));
}
}
for(const figure of loadedFigures)
{
if(!figure) continue;
this._incompleteFigures.delete(figure);
}
let index = 0;
while(index < this._currentDownloads.length)
{
const download = this._currentDownloads[index];
if(download)
{
if(download.libraryName === event.library.libraryName) this._currentDownloads.splice(index, 1);
}
index++;
}
}
public isAvatarFigureContainerReady(container: IAvatarFigureContainer): boolean
{
return !this.getAvatarFigurePendingLibraries(container).length;
}
private getAvatarFigurePendingLibraries(container: IAvatarFigureContainer): AvatarAssetDownloadLibrary[]
{
const pendingLibraries: AvatarAssetDownloadLibrary[] = [];
if(!container || !this._structure) return pendingLibraries;
const figureData = this._structure.figureData;
if(!figureData) return pendingLibraries;
const setKeys = container.getPartTypeIds();
for(const key of setKeys)
{
const set = figureData.getSetType(key);
if(!set) continue;
const figurePartSet = set.getPartSet(container.getPartSetId(key));
if(!figurePartSet) continue;
for(const part of figurePartSet.parts)
{
if(!part) continue;
const name = (part.type + ':' + part.id);
const existing = this._figureMap.get(name);
if(existing === undefined) continue;
for(const library of existing)
{
if(!library || library.isLoaded) continue;
if(pendingLibraries.indexOf(library) >= 0) continue;
pendingLibraries.push(library);
}
}
}
return pendingLibraries;
}
public isNftPartSet(partSet: { parts: { type: string, id: number }[] }): boolean
{
if(!partSet || !partSet.parts) return false;
for(const part of partSet.parts)
{
if(!part) continue;
const name = (part.type + ':' + part.id);
const libraries = this._figureMap.get(name);
if(!libraries) continue;
for(const library of libraries)
{
if(library && library.libraryName.toLowerCase().includes('nft')) return true;
}
}
return false;
}
public downloadAvatarFigure(container: IAvatarFigureContainer, listener: IAvatarImageListener): void
{
const figure = container.getFigureString();
const pendingLibraries = this.getAvatarFigurePendingLibraries(container);
if(pendingLibraries && pendingLibraries.length)
{
if(listener && !listener.disposed)
{
let listeners = this._figureListeners.get(figure);
if(!listeners)
{
listeners = [];
this._figureListeners.set(figure, listeners);
}
listeners.push(listener);
}
this._incompleteFigures.set(figure, pendingLibraries);
for(const library of pendingLibraries)
{
if(!library) continue;
library.downloadAsset();
}
}
else
{
if(listener && !listener.disposed) listener.resetFigure(figure);
}
}
}