Instance Method
インスタンスメソッド
cancelByProducingResumeData:
Cancels a download and calls a callback with resume data for later use.
ダウンロードを取り消して、あるコールバックを後で使うための再開データで呼び出します。
Declaration
宣言
- (void)cancelByProducingResumeData:(void (^)(NSData
*resumeData))completionHandler;
Parameters
パラメータ
completionHandler
A completion handler that is called when the download has been successfully canceled.
ある完了ハンドラ、それはダウンロードが成功裏に取り消された場合に呼び出されます。
If the download is resumable, the completion handler is provided with a resumeData
object. Your app can later pass this object to a session’s downloadTaskWithResumeData:
or downloadTaskWithResumeData:completionHandler:
method to create a new task that resumes the download where it left off.
ダウンロードが再開可能であるならば、完了ハンドラはresumeData
を提供されます。あなたのアプリは、後でこのオブジェクトをセッションのもつdownloadTaskWithResumeData:
またはdownloadTaskWithResumeData:completionHandler:
メソッドに渡して、ダウンロードをそれが中断したところで再開するある新しいタスクを作成できます。
This block is not guaranteed to execute in a particular thread context. As such, you may want specify an appropriate dispatch queue in which to perform any work.
このブロックは、ある特定のスレッド文脈で遂行することを保証されません。そういうことで、あなたは適切なディスパッチキューを指定してそれにおいて何らかの仕事を実行するようにしたいかもしれません。
Discussion
議論
A download can be resumed only if the following conditions are met:
ダウンロードが、以下の条件が合う場合にのみ再開されることができます:
The resource has not changed since you first requested it
リソースが、あなたが最初にそれを要請したときから変化していない
The task is an HTTP or HTTPS GET
request
タスクが、HTTPまたはHTTPS GET
リクエストである
The server provides either the ETag
or Last-Modified
header (or both) in its response
サーバが、ETag
またはLast-Modified
ヘッダのどちらか(または両方)をそれの応答において提供する
The server supports byte-range requests
サーバが、「バイト範囲」リクエストをサポートする
The temporary file hasn’t been deleted by the system in response to disk space pressure
一時ファイルが、システムによってディスクの空きの窮迫に応じて削除されていない