基于多网并发能力实现网络加速
项目简介
本示例基于多网并发能力,通过系统返回的多个网络通路,帮助开发者在上传、下载大吞吐场景下实现网络加速的功能。
效果预览
| 下载 | 上传 |
|---|---|
![]() |
![]() |
注意事项
- 本示例无法直接运行,如需正常使用下载功能,请开发者在CommonConst.ets中配置下载地址DOWN_URL1和DOWN_URL2,并且这两个地址均需要服务端支持HEAD方法及Range字段。如需正常使用上传功能,则需要开发者在CommonConst.ets配置上传地址UP_HOST,并且确认FilePartsUploadManager.ets中的三个文件上传相关接口是否需要修改。因为文件分段上传通常为私有协议,此处给出示例代码的详解,供开发者理解和修改使用。
- 第一步,首先会通过初始化方法initMultiPartUpload告知服务端初始化,此时传递文件路径和文件名称,如果成功,则会返回指定的InitiateMultipartUpload数据格式;
- 第二步,分段上传文件方法uploadSegment,示例代码使用指定的网络,同时搭配第一步返回的初始化结果上传了文件分段的内容,并记录了所有返回的分段结果UploadPartResult;
- 第三步,通知服务端合并文件,此处会上传第二步骤的所有UploadPartResult。如果开发者在以上三个步骤中有不同的要求,例如返回的数据格式不同、网络请求的Header不同等问题,请自行修改使用。
- 第一步,首先会通过初始化方法initMultiPartUpload告知服务端初始化,此时传递文件路径和文件名称,如果成功,则会返回指定的InitiateMultipartUpload数据格式;
- 打开应用的 "多网络并发传输" 开关,可能会因为各种原因导致打开失败,例如额度用尽、多网并发能力不支持等,开发者可参考连接迁移排查。
使用说明
- 下载本示例代码导入到IDE,打开AppScope->app.json文件,修改bundleName为您自己的应用名称。
- 参考配置调试签名 为第一步对应的bundleName的应用,申请带有"ohos.permission.LINKTURBO"权限的profile文件。
- 使用IDE的File->Project Structure,找到Singing Configs选项卡,配置应用的签名信息。
- 找到设备的系统设置->移动网络->网络加速->打开"允许使用移动数据加速网络"开关。
- 编译安装应用后,"单文件分段上传"页面是可以使用多网络通路,将文件分段上传到云存储的功能,"多文件下载"页面是可以使用多网络通路的能力,同时下载2个文件。
工程目录
├──entry/src/main/ets
│ ├──common
│ │ └──CommonConst.ets // 常量类
│ ├──entryability
│ │ └──EntryAbility.ets // 程序入口类
│ ├──entrybackupability
│ │ └──EntryBackupAbility.ets // 备份恢复类
│ ├──net
│ │ ├──NetBoostManager.ets // 网络并发管理类
│ │ ├──NetConnectionManager.ets // 网络通路获取
│ │ └──SocketClient.ets // Socket网络请求和下载文件使用
│ ├──pages
│ │ ├──DownloadPage.ets // 文件下载页面
│ │ ├──IndexPage.ets // 首页
│ │ └──UploadPage.ets // 单文件分段上传
│ ├──utils
│ │ ├──CommonUtils.ets // 常用工具类,例如Toast
│ │ ├──FileUtils.ets // 文件工具类
│ │ ├──HttpParser.ets // Http协议解析工具类
│ │ ├──PhotoUtils.ets // 图片工具类
│ │ └──XmlUtils.ets // Xml数据格式解析类
│ ├──viewmodel
│ │ ├──download
│ │ │ └──FileDownManager.ets // 单文件下载管理类
│ │ └──upload
│ │ └──FilePartsUploadManager.ets // 单文件分段上传管理类
│ └──view
│ ├──DownloadView.ets // 下载条目信息
│ ├──Titles.ets // 标题信息
│ └──UploadView.ets // 上传条目信息
└──entry/src/main/resources // 应用静态资源目录
具体实现
- 使用multiPathStateChange设置多网状态监听,后续主要是从这里拿到NetHandle多网通路对象。
- 使用requestMultiPath发起多网并发,如果成功发起多网并发,则会触发第一步骤的multiPathStateChange回调,可以从该回调拿到NetHandle对象。
- 通过第二步骤的NetHandle对象的bindSocket方法,将Socket绑定到对应的网络。
- 使用第三步骤绑定指定网络通路的Socket对象访问网络。
- 由于多网有限额限制,开发者可通过getMultiPathQuotaStats获取当前剩余配额信息,并且当不再使用多网通路的时候,建议通过releaseMultiPath及时释放多网通路。
相关权限
- 允许应用使用网络:ohos.permission.INTERNET
- 允许应用使用网络加速:ohos.permission.LINKTURBO
- 允许应用获取数据网络信息:ohos.permission.GET_NETWORK_INFO
依赖
- 不涉及
约束与限制
- 本示例仅支持标准系统上运行,支持设备:华为手机。
- HarmonyOS系统:HarmonyOS 6.0.0 Beta5及以上。
- DevEco Studio版本:DevEco Studio 6.0.0 Beta5及以上。
- HarmonyOS SDK版本:HarmonyOS 6.0.0 Beta5 SDK及以上。

