Object Storage Service：iOS流式下載

注意事項

• 使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient，具體請參見初始化。

  說明

  所建立儲存空間的所屬地區取決於初始化配置的endpoint地區資訊。

• 要下載檔案，您必須有ossGetObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

• OSS iOS SDK沒有提供stream類型的下載介面，但是提供了類似NSURLSession庫的didReceiveData函數的分段回調功能。如果設定了分段回調，下載的結果中將不再包含實際資料。

範例程式碼

以下代碼用於流式下載：

OSSGetObjectRequest * request = [OSSGetObjectRequest new];
// 填寫Bucket名稱，例如examplebucket。
request.bucketName = @"examplebucket";
// 填寫不包含Bucket名稱在內的Object完整路徑，例如exampledir/exampleobject.txt。
request.objectKey = @"exampledir/exampleobject.txt";
// 設定分段回呼函數。
request.onRecieveData = ^(NSData * data) {
    NSLog(@"Recieve data, length: %ld", [data length]);
};
OSSTask * getTask = [client getObject:request];
[getTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"download object success!");
    } else {
        NSLog(@"download object failed, error: %@" ,task.error);
    }
    return nil;
}];
// [getTask waitUntilFinished];
// [request cancel];

相關文檔

• 關於流式下載的API介面說明，請參見GetObject。

• 關於初始化OSSClient，請參見如何初始化OSSClient執行個體。