七夕情人節到了,各種App都要忙著上新,抓住互聯網產品的節日熱點,結合應用的類別進行活動營銷。比如購物類App會在節日進行大促;旅游類App會推出各種優惠活動;短視頻和拍照App會推出各種節日限定特效、專屬貼紙等。 尤其是游戲類App,具有較強的社交屬性,在節日熱點一般都會進行版本更新,上線新皮膚新 ...
七夕情人節到了,各種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 最新技術資訊~