Android断点续传下载

注意事项

• 使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient，具体请参见如何初始化Android端OSSClient实例。

示例代码

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

// 填写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());
        }
    }
});

相关文档

• 关于断点续传下载的完整示例代码，请参见GitHub示例。

• 关于断点续传下载的API接口说明，请参见GetObject。

• 关于初始化OSSClient，请参见如何初始化Android端OSSClient实例。