Firstborn/Library/PackageCache/com.unity.addressables@1.19.19/Documentation~/TransformInternalId.md
Schaken-Mods 7502018d20 Adding Mod Support
There is an asset in the store I grabbed. the coding is WAY above my head, I got about half of it and integrated and adapted what I can to it. im going as far as I can with it and ill come back in a few month when I understand t better.
2023-05-13 22:01:48 -05:00

7.2 KiB

uid
addressables-api-transform-internal-id

Transforming resource URLs

Addressables provides the following ways to modify the URLs it uses to load assets at runtime:

  • Static properties in a Profile variable
  • Implementing an ID transform function
  • Implementing a WebRequestOverride method

Static Profile variables

You can use a static property when defining the RemoteLoadPath Profile variable to specify all or part of the URL from which your application loads remote content, including catalogs, catalog hash files, and AssetBundles. See Profile variable syntax for information about specifying a property name in a Profile variable. The value of your static property must be set before Addressables initializes. Changing the value after initialization has no effect.

ID transform function

You can assign a function to the Addressables.ResourceManager object's InternalIdTransformFunc property to individually change the URLs from which Addressables loads assets. You must assign the function before the relevant operation starts, otherwise the default URL is used.

Using TransformInternalId grants a fair amount of flexibility, especially in regards to remote hosting. Given a single IResourceLocation, you can transform the ID to point towards a server specified at runtime. This is particularly useful if your server IP address changes or if you use different URLS to provide different variants of your application assets.

The ResourceManager calls your TransformInternalId function when it looks up an asset, passing the IResourceLocation instance for the asset to your function. You can change the InternalId property of this IResourceLocation and return the modified object to the ResourceManager.

The following example illustrates how you could append a query string to all URLs for AssetBundles:

[!code-cssample]

WebRequest override

You can assign a function to the Addressables object's WebRequestOverride property to individually modify the UnityWebRequest from which is used to download files, such as an AssetBundle or catalog json file. You must assign the function before the relevant operation starts, otherwise the default UnityWebRequest is used.

The ResourceManager calls your WebRequestOverride function before UnityWebRequest.SendWebRequest is called. Passing the UnityWebRequest for the download to your function.

The following example illustrates how you could append a query string to all URLs for AssetBundles and catalogs:

[!code-cssample]