业务概述
====

资源包后台下载是将资源文件（例如关卡包、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/3a/v3/Tywl2UziQ4WOLY0JosSQ-w/zh-cn_image_0000002633849550.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=7E581E4F98F7D64A2B48526B22063FA052CDA73986FF89D6187778DAF54430BC "点击放大")
    
*   场景二
    
    待用户设备满足闲时条件时，在游戏未启动状态下，若检测到上次更新资源包未完成，或该游戏有新的资源包需要更新，将自动触发资源包下载。用户下拉通知栏，实时查看资源包下载进度。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/36/v3/EAFVbb9-SiGEwKH6dwkUDg/zh-cn_image_0000002634009454.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=536AE77957A3FD46DC81127E104E64193D0EB84978BF07DBAA166D0205BD65D5 "点击放大")
    

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/06/v3/rYFETcX_Sh-ywYu1nvnpPQ/zh-cn_image_0000002664208603.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=3B502EC15898788D4CBF7093D035AC725DFC2B340A0B12867F99F463EB52C6A3 "点击放大")

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d3/v3/eoCQbVhPTJSoBnRZ34bxEg/zh-cn_image_0000002664328663.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=385CF6FF437F86F6CC4244A0BFBF375AEC3A08E8562078D3470104A618D16B97 "点击放大")

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/95/v3/UvkENp3FTQS7hUJhS1Yo2w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=CDC0CC250B51F8E5B8033203273A60174FBE9EB1CBE7E8F945277A1D8C28C675)

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b0/v3/HDwWYwyZRN6VeN3hOhO6lg/zh-cn_image_0000002633849552.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132550Z&HW-CC-Expire=86400&HW-CC-Sign=3862E27EBEBF7CEF3E7918DA81B3EC721DFFA4B2B29064E78B60A88F6C670465 "点击放大")

#### 实现流程

| 序号 | 步骤 | 说明 |
| :-- | :-- | :-- |
| 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)是为资源包后台下载框架，为资源包后台下载提供关键的生命周期函数。在后台下载任务成功/失败/结束后支持调用相应的回调函数。 |
| 系统后台下载 | 游戏应用进程未加载时，系统能力自动开启资源包下载任务。 |