文档

Android断点续传下载

更新时间:

断点续传下载是指客户端在从网络上下载资源时,由于网络等原因中断下载。当您再次开启下载时,可以从已下载完成的部分继续下载未完成的部分,从而节省时间和流量。

注意事项

示例代码

以下代码用于断点续传下载:

// 填写Bucket名称,例如examplebucket。
// 填写不包含Bucket名称在内的Object完整路径,例如exampledir/exampleobject.txt。
String objectKey = "exampledir/exampleobject.txt";
// 填写下载到本地文件所在的完整路径。
String localFile = "/storage/emulated/0/oss/examplefile.txt";
ResumableDownloadRequest request = new ResumableDownloadRequest(bucketName, objectKey, localFile);
// 设置分片大小,单位为B。单个分片大小默认256 KB(即256*1024)。如果无特殊需求,无需手动设置此参数。
request.setPartSize(256*1024);
// 开启断点续传下载功能。
request.setEnableCheckPoint(true);
// 设置断点记录文件的完整路径。只有当Object下载中断产生了断点记录文件后,如果需要继续下载该Object,才需要设置对应的断点记录文件。
request.setCheckPointFilePath("/storage/emulated/0/oss");
request.setProgressListener(new OSSProgressCallback() {
    @Override
    public void onProgress(Object request, long currentSize, long totalSize) {
        Log.d("ResumableDownload", "currentSize: " + currentSize + " totalSize: " + totalSize);
    }
});
OSSAsyncTask task = oss.asyncResumableDownload(request, new OSSCompletedCallback<ResumableDownloadRequest, ResumableDownloadResult>() {
    @Override
    public void onSuccess(ResumableDownloadRequest request, ResumableDownloadResult result) {
        Log.d("ResumableDownload", "DownloadSuccess");
    }

    @Override
    public void onFailure(ResumableDownloadRequest request, ClientException clientException, ServiceException serviceException) {
        // 请求异常。
        if (clientException != null) {
            // 客户端异常,例如网络异常等。
            clientException.printStackTrace();
        }
        if (serviceException != null) {
            // 服务端异常。
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});

相关文档