Manage asset packs at runtime
Download and access asset packs at runtime.
阅读时间3 分钟最后更新于 1 个月前
Unity provides APIs to manage asset packs at runtime. They use Google’s PlayCore API, which means they have the same limitations as PlayCore, and can’t manage asset packs. Using the PlayCore API also means your application requires the PlayCore plug-in. If your project has asset packs, either custom asset packs or Unity-generated asset packs, Unity automatically adds the PlayCore dependency to the application’s manifest.
install-timeThe way you download asset packs and access their assets depends on the asset pack delivery mode. There are three asset pack delivery modes:
- : Google Play automatically downloads
install-timeasset packs when the device installs the application. Google Play considers these asset packs to be part of the base application, and an end user can’t uninstall them without uninstalling the entire application. The PlayCore API doesn’t handleinstall-timeasset packs, which means that you can’t check the status, request to download, or removeinstall-timeasset packs. You also can’t directly access assets inside of these asset packs, except streaming assets in Unity-generatedinstall-timeasset packs. To access streaming assets, use Application.streamingAssetsPath to get the path to streaming assets location, then use UnityWebRequest to access assets in that path. If you create a custom asset pack, you can’t access assets inside it using standard file APIs. Instead, use Android’s AssetManager APIs.install-time - : Google Play automatically starts to download
fast-followasset packs after it installs the application. However, it's possible that not allfast-followasset packs are available on the first time the application launches. To check the status and downloadfast-followasset packs, refer to Download asset packs.fast-follow - : Google Play doesn’t automatically download
on-demandasset packs. You have to manually start the download. For information on how to do this, refer to Download asset packs.on-demand
For more information about delivery modes, refer to Delivery modes.
Download asset packs
If your application uses or asset packs, the device must download these asset packs before the application can access assets inside of them. To check the status of asset packs and download them if they're not on the device, you must first know the name of each asset pack. To get the names of Unity-generated asset packs, call AndroidAssetPacks.GetCoreUnityAssetPackNames. There is no runtime API to get the names of custom asset packs so you must keep track of them yourself. You set the name of custom asset packs at build time; it’s the name of the directory.
fast-followon-demandAfter you have the names of your asset packs, to check the status of each asset pack, call AndroidAssetPacks.GetAssetPackStateAsync, passing in the asset pack name. This returns the status of the asset pack you query, and you can use the result to determine whether you need to download the asset pack. If you want to quickly query the status of every Unity-generated asset pack, you can use AndroidAssetPacks.coreUnityAssetPacksDownloaded. This helps you to ensure that every Unity-generated asset pack is available before you load any scene other than the first one or try to access other resources that Unity handles.
For every asset pack you need to download, call AndroidAssetPacks.DownloadAssetPackAsync, passing in the asset pack name. While the asset pack downloads, monitor the download status because downloads can pause or fail. There are two ways to do this:
- Periodically check the DownloadAssetPackAsyncOperation instance that AndroidAssetPacks.DownloadAssetPackAsync returns.
- Use the version of AndroidAssetPacks.DownloadAssetPackAsync that takes a callback as its second parameter. The callback you pass in must take an AndroidAssetPackInfo as a parameter that you can use to determine the state of the download.