共计 6292 个字符,预计需要花费 16 分钟才能阅读完成。
七夕情人节到了,各种 App 都要忙着上新,抓住互联网产品的节日热点,联合利用的类别进行流动营销。比方购物类 App 会在节日进行大促;游览类 App 会推出各种优惠活动;短视频和拍照 App 会推出各种节日限定特效、专属贴纸等。
尤其是游戏类 App,具备较强的社交属性,在节日热点个别都会进行版本更新,上线新皮肤新场景等,波及到的内容很多,有时候版本更新包的资源太大,导致用户更新时等待时间长,影响经营推广和用户下载体验。这时只须要接入 HMS Core Network Kit,就可大幅晋升资源下载速率。
HMS Core Network Kit 是一款网络根底服务套件,聚合远场网络通信优良实际,辅以 RESTful、文件上传 / 下载等场景化接口,为您提供简略易用、低时延、高吞吐和高平安的端云传输通道。除了能够晋升文件上传 / 下载的速度和成功率,还能够在 URL 拜访网络场景中晋升网络访问速度,在弱网环境中可缩小有效网络等待时间,且反对网络平滑迁徙。
从图中能够看出,集成 Network Kit 后下载速度晋升约 40%。
HMS Core Network Kit 首先在 QUIC 协定上叠加自研的大文件拥塞控制算法,通过高效的并发数据流,无效晋升弱网下的吞吐量;其次,智能分片针对不同机器环境设置不同分片阈值及分片数,尽可能晋升下载速度;同时也反对多任务并发执行及治理,工作断点续传,晋升下载成功率。实用于与新版本升级、补丁降级、新场景地图等相干资源加载、流动图片、视频下载等。
开发步骤
在进行开发之前,您须要实现必要的开发筹备工作,详情可见 Network 开发领导文档。
SDK 集成示例代码如下:
dependencies {
// 应用 Network Kit 的网络申请性能
implementation 'com.huawei.hms:network-embedded: 6.0.0.300'
// 应用 Network Kit 的文件上传 / 下载性能
implementation 'com.huawei.hms:filemanager: 6.0.0.300'
}
因为 Network Kit 应用了 Java 8 的新个性,如:Lambda 表达式、动态接口办法等。所以 Network Kit 均须要为 Gradle 增加 Java 8 的环境编译束缚。
在“compileOptions”中增加如下编译配置。
android{
compileOptions{
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
示例代码
文件上传
文件上传性能能够通过如下操作实现。具体开发过程和代码实现能够参见 codelab(文件上传 / 下载集成)和示例代码。
- 当适配版本为 Android6.0(API Level 23)及以上时,须要动静申请读写手机存储权限(每个利用只需胜利申请一次)。
if (Build.VERSION.SDK_INT >= 23) {if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED ||
checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1000);
requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1001);
}
}
- 初始化全局上传治理类 UploadManager。
UploadManager upManager = (UploadManager) new UploadManager
.Builder("uploadManager")
.build(context);
- 结构申请体对象。咱们以上传文件 file1 和 file2 为例。
Map<String, String> httpHeader = new HashMap<>();
httpHeader.put("header1", "value1");
Map<String, String> httpParams = new HashMap<>();
httpParams.put("param1", "value1");
// 替换成您须要上传的目标地址。String normalUrl = "https://path/upload";
// 替换成您须要上传的文件的地址。String filePath1 = context.getString(R.string.filepath1);
// 替换成您须要上传的文件的地址。String filePath2 = context.getString(R.string.filepath2);
// 结构 POST 申请对象。try{BodyRequest request = UploadManager.newPostRequestBuilder()
.url(normalUrl)
.fileParams("file1", new FileEntity(Uri.fromFile(new File(filePath1))))
.fileParams("file2", new FileEntity(Uri.fromFile(new File(filePath2))))
.params(httpParams)
.headers(httpHeader)
.build();}catch(Exception exception){Log.e(TAG,"exception:" + exception.getMessage());
}
- 创立 FileUploadCallback 申请回调类。
FileUploadCallback callback = new FileUploadCallback() {
@Override
public BodyRequest onStart(BodyRequest request) {
// 文件上传开始时回调此办法。Log.i(TAG, "onStart:" + request);
return request;
}
@Override
public void onProgress(BodyRequest request, Progress progress) {
// 文件上传进度变动时回调到此办法。Log.i(TAG, "onProgress:" + progress);
}
@Override
public void onSuccess(Response<BodyRequest, String, Closeable> response) {
// 文件上传胜利时回调此办法。Log.i(TAG, "onSuccess:" + response.getContent());
}
@Override
public void onException(BodyRequest request, NetworkException exception, Response<BodyRequest, String, Closeable> response) {
// 文件上传过程中网络产生异样,或申请被勾销时回调此办法。if (exception instanceof InterruptedException) {
String errorMsg = "onException for canceled";
Log.w(TAG, errorMsg);
} else {String errorMsg = "onException for:" + request.getId() + " " + Log.getStackTraceString(exception);
Log.e(TAG, errorMsg);
}
}
};
- 发送申请上传指定文件,并获取上传是否启动胜利。
当 Result 的 getCode 办法获取的返回值与动态变量 Result.SUCCESS 统一则文件上传工作启动胜利。
Result result = upManager.start(request, callback);
// 上传工作启动是否胜利, 能够通过 Result 的 getCode() 办法获取的返回值是否与动态变量 Result.SUCCESS 统一来判断。if (result.getCode() != Result.SUCCESS) {Log.e(TAG, result.getMessage());
}
- 文件上传状态回调。
文件上传状态扭转时,步骤 4 创立的 FileUploadCallback 对象的不同回调办法将被调用。
• 文件上传开始时,onStart 办法会被调用。
• 文件上传进度扭转时,onProgress 办法会被调用,并可通过解析回调的 Progress 对象,获取上传进度。
• 文件上传工作产生异样时,onException 办法会被调用。
- 验证上传后果。
文件上传胜利后会回调到步骤 4 创立的 FileUploadCallback 申请回调对象的 onSuccess 办法。
文件下载
文件下载性能能够通过如下操作实现。具体开发过程和代码实现请参见 codelab(文件上传 / 下载集成)和示例代码。
- 当适配版本为 Android6.0(API Level 23)及以上时,须要动静申请读写手机存储权限(每个利用只需胜利申请一次)。
if (Build.VERSION.SDK_INT >= 23) {if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED ||
checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1000);
requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1001);
}
}
- 初始化全局下载治理类 DownloadManager。
DownloadManager downloadManager = new DownloadManager.Builder("downloadManager")
.build(context);
- 结构申请体对象。
// 替换成您须要下载的资源地址。String normalUrl = "https://gdown.baidu.com/data/wisegame/10a3a64384979a46/ee3710a3a64384979a46542316df73d4.apk";
// 替换成您想要保留的目标地址。String downloadFilePath = context.getExternalCacheDir().getPath() + File.separator + "test.apk";
// 结构 GET 申请体对象。GetRequest getRequest = DownloadManager.newGetRequestBuilder()
.filePath(downloadFilePath)
.url(normalUrl)
.build();
- 创立 FileRequestCallback 申请回调对象。
FileRequestCallback callback = new FileRequestCallback() {
@Override
public GetRequest onStart(GetRequest request) {
// 文件下载开始时回调此办法。Log.i(TAG, "activity new onStart:" + request);
return request;
}
@Override
public void onProgress(GetRequest request, Progress progress) {
// 文件下载进度变动时回调此办法。Log.i(TAG, "onProgress:" + progress);
}
@Override
public void onSuccess(Response<GetRequest, File, Closeable> response) {
// 文件下载胜利时回调到此办法。String filePath = "";
if (response.getContent() != null) {filePath = response.getContent().getAbsolutePath();}
Log.i(TAG, "onSuccess:" + filePath);
}
@Override
public void onException(GetRequest request, NetworkException exception, Response<GetRequest, File, Closeable> response) {
// 文件下载过程中网络产生异样,或申请被暂停、勾销时回调此办法。if (exception instanceof InterruptedException) {
String errorMsg = "onException for paused or canceled";
Log.w(TAG, errorMsg);
} else {String errorMsg = "onException for:" + request.getId() + " " + Log.getStackTraceString(exception);
Log.e(TAG, errorMsg);
}
}
};
- 应用 DownloadManager 启动下载工作并测验下载工作是否启动胜利。
当 Result 的 getCode 办法获取的返回值与动态变量 Result.SUCCESS 统一则文件下载工作启动胜利。
Result result = downloadManager.start(getRequest, callback);
if (result.getCode() != Result.SUCCESS) {
// 当通过 result 获取到的值为 Result.SUCCESS 时,则下载工作启动胜利,否则启动失败。Log.e(TAG,“start download task failed:”+ result.getMessage());
}
- 文件下载状态回调。
文件下载状态扭转时,步骤 4 创立的 FileRequestCallback 申请回调对象的不同办法将被调用。
• 文件开始下载时,onStart 办法会被调用。
• 文件下载进度扭转时,onProgress 办法会被调用,并可通过解析回调的 Progress 对象,获取下载进度。
• 文件下载工作产生异样时,onException 办法会被调用。
- 验证下载后果。
文件下载胜利后会回调到步骤 4 创立的 FileRequestCallback 申请回调对象的 onSuccess 办法,并可依据您设置的下载门路在手机内存中查看到您下载的文件。
理解更多详情 >>
拜访华为开发者联盟官网
获取开发领导文档
华为挪动服务开源仓库地址:GitHub、Gitee
关注咱们,第一工夫理解 HMS Core 最新技术资讯~