业务概述
====

资源包后台下载是将资源文件（例如关卡包、3D角色模型、纹理等）静默下载到用户设备中，减少游戏启动后等待资源包下载的时间，解决游戏启动慢的问题，为用户提供即开即玩的游戏体验。

#### 约束与限制

*   游戏资源加速服务从5.1.0(18)版本开始支持extension系统托管下载、应用前台下载资源包、系统后台切应用前台接续下载资源包功能，并且从5.1.1(19)版本开始，新增extension协同下载功能。
    
*   游戏资源加速服务从5.1.0(18)版本开始支持Phone、Tablet设备，并且从API版本26.0.0开始，新增支持PC/2in1设备。
    

#### 主要功能

#### \[h2\]系统后台下载资源包

*   场景一
    
    用户在应用市场安装游戏后、或在应用市场更新游戏后，在游戏未启动状态下，若检测到该游戏有资源包需要更新，将自动触发资源包下载。用户下拉通知栏，实时查看资源包下载进度。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/tmaD53gQQ2Kr5GQQzCg_sw/zh-cn_image_0000002594828926.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=393CB3F808EB6BB9D9D42DFBD924CB8BD851F40DAEFEC60D9D66BA99BB16C710 "点击放大")
    
*   场景二
    
    待用户设备满足闲时条件时，在游戏未启动状态下，若检测到上次更新资源包未完成，或该游戏有新的资源包需要更新，将自动触发资源包下载。用户下拉通知栏，实时查看资源包下载进度。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5a/v3/-RyPS7QCTZK521ug17A-rg/zh-cn_image_0000002625188373.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=351BBDBC25A3168EA89C843BAE115217498C6F308E070C4FD3FC8A26CE0C9F9D "点击放大")
    

#### \[h2\]系统后台切应用前台接续下载资源包

用户在应用市场安装游戏后、或在应用市场更新游戏后，在游戏未启动状态下，若检测到该游戏有资源包需要更新，将自动触发资源包下载。用户下拉通知栏，实时查看资源包下载进度。在下载过程中点击游戏App，游戏接管未完成的下载任务。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fa/v3/1T7-5VCgRryIP2y7BV8Rig/zh-cn_image_0000002625108517.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=C6084801298BB2EB44B8AD90C3ACAA5DED9EAC93D47DED511A795CA82022D739 "点击放大")

#### \[h2\]应用前台下载资源包

用户点击游戏App，若检测到上次更新资源包未完成，或该游戏有新的资源包需要更新，游戏将接续执行未完成的下载任务或提交新的下载任务。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7e/v3/s5FCSwqoR86lJ6LD4--kag/zh-cn_image_0000002594669000.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=3B0C7E04CC29530590AED669F4B372EF5D6C7B310A801EE1B057D58B10E5AFB1 "点击放大")

#### \[h2\]应用前台切应用后台下载资源包

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7e/v3/gu9Q2F9BTomxHJm5CmSjGQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=E9E35648629B6646C99DACD0F46442AA90A3EABACC4C95DC44B20EF3962C8644)

需要与[dataTransfer类型的长时任务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/continuous-task)协同使用。

应用前台下载资源包的过程中，将游戏切至后台，资源包下载任务不中断。用户下拉通知栏，实时查看资源包下载进度。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ac/v3/4IMLD36BQ8GJRC1BMrsAcA/zh-cn_image_0000002594828928.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=2373D223478D39FD581302C3D197AF74F3EED682864F597C04C9AE87F659DEA6 "点击放大")

#### 实现流程

| 序号 | 步骤 | 说明 |
| :-- | :-- | :-- |
| 1 | [开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-prepare) | 开发者需提前做好相关准备工作。 |
| 2 | 
开发资源包后台下载功能：

\- [系统后台下载资源包](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-back-system)

\- [应用前台下载资源包](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-fore)

\- [系统后台切应用前台接续下载资源包](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-back-fore)

 | 开发者可以在游戏工程中接入资源包系统后台下载、应用前台下载、系统后台切应用前台接续下载功能。 |
| 3 | 

发布资源包下载任务：

1\. [进入申请页面](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-release#进入申请页面)

2\. [创建下载任务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-release#创建下载任务)

3\. [提交下载任务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-release#提交下载任务)

4\. [测试下载功能](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-release#测试下载功能)

5\. [发布下载任务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-release#发布下载任务)

 | 开发者需前往AppGallery Connect创建并发布下载资源包任务。建议开发者在正式发布资源包下载任务前，先在本地测试是否可以成功下载资源包。 |
| 4 | [查看资源包分发数据](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-data) | 资源包下载任务正式发布后，开发者可以前往AppGallery Connect查看资源包分发情况。 |

#### 基本概念

| 概念 | 说明 |
| :-- | :-- |
| CDN | 内容分发网络（Content Delivery Network），是一种通过网络中分布资源服务器，用以提高网站访问速度的技术。当前资源包后台下载功能支持游戏在AppGallery Connect配置华为CDN或三方CDN的资源包下载配置项。 |
| 资源加速ExtensionAbility | [ExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-extensionability)组件是基于特定场景（例如服务卡片、输入法）提供的应用组件，以便满足更多的使用场景。[资源加速ExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/graphics-accelerate-extensionability)是为资源包后台下载框架，为资源包后台下载提供关键的生命周期函数。在后台下载任务成功/失败/结束后支持调用相应的回调函数。 |
| 系统后台下载 | 游戏应用进程未加载时，系统能力自动开启资源包下载任务。 |