packName = “asset-pack-name” // Directory name for the asset pack
dynamicDelivery {
deliveryType = “[ install-time | fast-follow | on-demand ]”
}
}
- 5、在项目的应用 build.gradle文件中,添加项目中每个 Asset Pack 的名称,如下所示:
// In the app build.gradle file:
android {
…
assetPacks = [":asset-pack-name", “:asset-pack2-name”]
}
- 6、在项目的 settings.gradle 文件中,添加项目中的所有 Asset Pack,如下所示:
// In the settings.gradle file:
include ‘:app’
include ‘:asset-pack-name’
include ‘:asset-pack2-name’
-
7、在 Asset Pack 目录中,创建以下子目录:src/main/assets。
-
8、将资产放置在 src/main/assets 目录中。你也可以在此处创建子目录。应用的目录结构现在应如下所示:
-
1)build.gradle
-
2)settings.gradle
-
3)app/
-
4)asset-pack-name/build.gradle
-
5)asset-pack-name/src/main/assets/your-asset-directories
-
9、使用 Gradle 构建 Android App Bundle。在生成的 app bundle 中,根级目录现在包含以下内容:
-
1)asset-pack-name/manifest/AndroidManifest.xml:配置 Asset Pack 的标识符和分发模式
-
2)asset-pack-name/assets/your-asset-directories:此目录包含作为 Asset Pack 的一部分分发的所有资产
Gradle 会为每个 Asset Pack 生成清单,并为你输出 assets/ 目录。
- 10、(可选)配置 App Bundle 以支持不同的纹理压缩格式。
常见的纹理压缩格式:
-
DDS 或 S3TC:有时称为 DXTC 或 DXTn。OpenGL 支持此格式的三种形式。
-
ETC1:大多数设备都支持此格式。这种格式不支持透明度,但游戏可将第二个纹理文件用于 Alpha 通道组件。
-
ETC2:支持 GLES3 的所有设备均支持此格式。
-
PVRTC:iOS 游戏常用的格式,在某些 Android 设备上也受支持。
-
ASTC:专为取代之前的格式而设计的新格式。比先前的格式更加灵活,因为它支持各种块大小。使用这种格式可以帮助你优化游戏大小。
支持的格式及支持相应格式设备所占的百分比:
Play Core API 集成
请务必先将 Play Core 库添加到你的项目中。
Play Core Java API 提供了用于请求资源包、管理下载内容和获取资源的 AssetPackManager 类。请务必先将 Play Core 库添加到你的项目中。 你可以根据希望获取的资源包的分发类型来实现此 API。这些步骤如以下流程图所示。
注意: 用于获取 install-time Asset Pack 的 API 与用于获取 fast-follow 和 on-demand Asset Pack 的 API 不同。
安装时分发
配置为 install-time 的资源包可以在应用启动后立即使用。使用 Java AssetManager API 获取在此模式下提供的资产:
import android.content.res.AssetManager;
…
Context context = createPackageContext(“com.example.app”, 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open(“asset-name”);
快速跟进式分发和按需分发
以下几部分介绍了如何在下载 Asset Pack 前获取其相关信息、如何调用 API 以开始下载,以及之后如何获取已下载的 Asset Pack。这几部分适用于 fast-follow 和 on-demand Asset Pack。
查看状态
每个资源包都存储于应用的内部存储空间内单独的文件夹中。使用 getPackLocation() 方法确定 Asset Pack 的根文件夹。此方法会返回以下值:
-
有效的AssetPackLocation对象:资源包根文件夹位于 assetsPath(),现已可立即获取
-
null:未知 Asset Pack 或资产无法使用
**注意:**请勿依赖在两次应用启动之间的间隔时间内缓存的 Asset Pack 位置。应用应在每次启动时始终检查是否存在 Asset Pack。Asset Pack 可能会因应用更新或用户清除应用数据而变为无效。
获取有关资源包的下载信息
在提取资源包之前,应用必须披露下载内容的大小。使用getPackStates() 方法确定下载内容的大小,以及资源包是否已在下载。
Task getPackStates(List packNames)
getPackStates() 是用于返回任务的异步方法。该任务的结果包含一个 AssetPackStates 对象。AssetPackStates 对象的 packStates() 方法会返回一个 Map<String, AssetPackState>。此映射包含所请求的每个 Asset Pack 的状态,按其名称进行键控:
Map<String, AssetPackState> AssetPackStates#packStates()
最终请求如下所示:
final String assetPackName = “myasset”;
assetPackManager
.getPackStates(Collections.singletonList(assetPackName))
.addOnCompleteListener(new OnCompleteListener() {
@Override
public void onComplete(Task task) {
AssetPackStates assetPackStates;
try {
assetPackStates = task.getResult();
AssetPackState assetPackState =
assetPackStates.packStates().get(assetPackName);
} catch (RuntimeExecutionException e) {
Log.d(“MainActivity”, e.getMessage());
return;
})
以下 AssetPackState 方法提供了资源包的大小、截至目前已下载的数据量(如已请求),以及已传输到应用的数据量:
-
totalBytesToDownload()
-
bytesDownloaded()
-
transferProgressPercentage()
如需获取资源包的状态,请使用 status() 方法,该方法以整数形式返回与 AssetPackStatus 类中某个常量字段相对应的状态。尚未安装的资源包状态为 AssetPackStatus.NOT_INSTALLED。
如果请求失败,请使用 errorCode() 方法,该方法的返回值与 AssetPackErrorCode 类中的某个常量字段相对应。
安装
使用 fetch() 方法首次下载资源包,或要求进行资源包更新以完成操作:
Task fetch(List packNames)
此方法会返回一个 AssetPackStates 对象,其中包含资源包列表及其初始下载状态和大小。如果通过 fetch() 请求的 Asset Pack 已经在下载,就会返回下载状态,并且不会启动其他下载。
**注意:**在大多数情况下,你需要实现 listener 以跟踪下载和安装过程,如下一部分所述。
监控下载状态
你应实现 listener 以跟踪 Asset Pack 的安装进度。状态更新按 Asset Pack 细分,以支持跟踪各 Asset Pack 的状态。在请求的所有其他下载完成之前,你就可以开始使用已可供使用的资源包。
-
void registerListener(AssetPackStateUpdatedListener listener)
-
void unregisterListener(AssetPackStateUpdatedListener listener)
注意: 在用户安装或更新应用后,Play 商店会自动触发下载任何 fast-follow 资源包。不过,这些资源包可能无法立即供用户使用。你必须在每次应用启动时检查 fast-follow Asset Pack 的状态。如果下载正在进行,请使用监听器对其进行监控。如果下载已取消或暂停,你可以使用 fetch() 方法恢复下载,如安装部分所述。
下载内容较大
如果下载内容超过150MB并且用户未连接到 WLAN,那么在用户明确同意使用移动网络连接继续下载前,下载不会开始。同样,如果下载内容较大并且用户与 WLAN 的连接断开,下载会暂停,需要用户明确同意才能使用移动网络连接继续下载。已暂停的 Asset Pack 状态为 WAITING_FOR_WIFI。如需触发界面流程以提示用户同意,请使用 showCellularDataConfirmation() 方法。
请注意,如果应用不调用此方法,下载会暂停,并且只有当用户重新连接到 WLAN 时才会自动恢复下载。
以下是监听器的一个实现示例:
assetPackStateUpdateListener = new AssetPackStateUpdateListener() {
@Override
public void onStateUpdate(AssetPackState assetPackState) {
switch (assetPackState.status()) {
case AssetPackStatus.PENDING:
Log.i(TAG, “Pending”);
break;
case AssetPackStatus.DOWNLOADING:
long downloaded = assetPackState.bytesDownloaded();
long totalSize = assetPackState.totalBytesToDownload();
double percent = 100.0 * downloaded / totalSize;
Log.i(TAG, “PercentDone=” + String.format("%.2f", percent));
break;
case AssetPackStatus.TRANSFERRING:
// 100% downloaded and assets are being transferred.
// Notify user to wait until transfer is complete.
break;
case AssetPackStatus.COMPLETED:
// Asset pack is ready to use. Start the game.
break;
case AssetPackStatus.FAILED:
// Request failed. Notify user.
Log.e(TAG, assetPackState.errorCode());
brea
《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》
【docs.qq.com/doc/DSkNLaERkbnFoS0ZF】 完整内容开源分享
k;
case AssetPackStatus.CANCELED:
// Request canceled. Notify user.
break;
case AssetPackStatus.WAITING_FOR_WIFI:
if (!waitForWifiConfirmationShown) {
assetPackManager.showCellularDataConfirmation(MainActivity.this)
.addOnSuccessListener(new OnSuccessListener () {
@Override
public void onSuccess(Integer resultCode) {
if (resultCode == RESULT_OK) {
Log.d(TAG, “Confirmation dialog has been accepted.”);
} else if (resultCode == RESULT_CANCELED) {
Log.d(TAG, “Confirmation dialog has been denied by the user.”);
}
}
});
waitForWifiConfirmationShown = true;
}
break;
case AssetPackStatus.NOT_INSTALLED:
// Asset pack is not downloaded yet.
break;
}
}
}
或者,你也可以使用 getPackStates() 方法获取当前下载的状态。AssetPackStates 包含下载进度、下载状态和任何失败的错误代码。
获取资源包
在下载请求达到 COMPLETED 状态后,你可以使用文件系统调用获取资源包。使用 getPackLocation() 方法获取资源包的根文件夹。
资源存储于资源包根目录内的 assets 目录下。你可以使用便捷方法 assetsPath() 获取 assets 目录的路径。请使用以下方法获取特定资产的路径:
private String getAbsoluteAssetPath(String assetPack, String relativeAssetPath) {
AssetPackLocation assetPackPath = assetPackManager.getPackLocation(assetPack);
if (assetPackPath == null) {
// asset pack is not ready
return null;
}
String assetsFolderPath = assetPackPath.assetsPath();
// equivalent to: FilenameUtils.concat(assetPackPath.path(), “assets”);
String assetPath = FilenameUtils.concat(assetsFolderPath, relativeAssetPath);
return assetPath;