Class AssetsManager

valdi/src/valdi/runtime/Resources/AssetsManager.hpp:52–193

class AssetBytesStore;

class AssetsManager : public SharedPtrRefCountable, public AssetLoaderRequestHandlerListener {
public:
    AssetsManager(const Shared<IResourceLoader>& resourceLoader,
                  const Ref<RemoteModuleManager>& remoteModuleManager,
                  const Ref<AssetLoaderManager>& assetLoaderManager,
                  const Ref<DispatchQueue>& workerQueue,
                  MainThreadManager& mainThreadManager,
                  ILogger& logger);
    ~AssetsManager() override;

    Ref<Asset> getAsset(const AssetKey& assetKey);
    Ref<Asset> createAssetWithBytes(const BytesView& bytes);
    bool isAssetAlive(const AssetKey& assetKey) const;

    std::optional<AssetLocation> getResolvedAssetLocation(const AssetKey& assetKey);

    void setResolvedAssetLocation(const AssetKey& assetKey, const AssetLocation& assetLocation);

    void onAssetCatalogChanged(const Ref<Bundle>& bundle);

    void addAssetLoadObserver(const AssetKey& assetKey,
                              const std::shared_ptr<snap::valdi_core::AssetLoadObserver>& observer,
                              const Ref<Context>& context,
                              snap::valdi_core::AssetOutputType outputType,
                              int32_t preferredWidth,
                              int32_t preferredHeight,
                              const Value& attachedData);

    void removeAssetLoadObserver(const AssetKey& assetKey,
                                 const std::shared_ptr<snap::valdi_core::AssetLoadObserver>& observer);

    void updateAssetLoadObserverPreferredSize(const AssetKey& assetKey,
                                              const std::shared_ptr<snap::valdi_core::AssetLoadObserver>& observer,
                                              int32_t preferredWidth,
                                              int32_t preferredHeight);

    static bool isAssetUrl(const StringBox& str);

    void onLoad(const Ref<AssetLoaderRequestHandler>& request, const Result<Ref<LoadedAsset>>& result) override;

    void setShouldRemoveUnusedLocalAssets(bool removeUnusedLocalAssets);

    void setListener(AssetsManagerListener* listener);

    void beginPauseUpdates();
    void endPauseUpdates();

    void flushUpdates();

    // Reset every asset currently in AssetStateFailedRetryable back to AssetStateInitial and
    // re-resolve it. A statically-mounted asset (e.g. a button icon) that failed a remote load
    // otherwise stays failed for the whole session because only a new consumer clears the state;
    // this gives an external trigger (app returning to foreground) a way to recover such assets.
    void retryFailedAssets();

private:
    Shared<IResourceLoader> _resourceLoader;
    Ref<RemoteModuleManager> _remoteModuleManager;