Monitor wait operations

AsyncOperationHandle provides the following methods to monitor and report operation progress:

  • GetDownloadStatus: Returns a DownloadStatus struct that contains information about downloaded bytes and remaining bytes to download. DownloadStatus.Percent reports the percentage of downloaded bytes.
  • AsyncOperationHandle.PercentComplete: Returns an equally weighted total percentage of all completed sub operations. For example, if an operation has five sub operations, each one represents 20% of the total. This value doesn't factor in the amount of data that individual sub operations must download.

For example, when you call Addressables.DownloadDependenciesAsync and five AssetBundles require downloading, GetDownloadStatus tells you what percentage of the total bytes for all sub operations Unity has downloaded. PercentComplete tells you what percentage of operations have finished, regardless of their size.

If you call LoadAssetAsync, and one AssetBundle requires downloading before Unity can load an asset from it, the download percentage might be misleading. The values that GetDownloadStatus provides reach 100% before the operation finishes, because the operation has additional sub operations to conduct. The value of PercentComplete reaches 50% when the download sub operation finishes and 100% when the actual load into memory completes.

Additional resources