- downloadTaskWithURL:
- downloadTaskWithURL:completionHandler:
- downloadTaskWithRequest:
- downloadTaskWithRequest:completionHandler:
- downloadTaskWithResumeData:
NSURLSessionDownloadTask
NSURLSessionDownloadDelegate
Availability 有効性
Technology
- (NSURLSessionDownloadTask
*)downloadTaskWithResumeData:(NSData
*)resumeData
completionHandler:(void (^)(NSURL
*location, NSURLResponse
*response, NSError
*error))completionHandler;
resumeData
A data object that provides the data necessary to resume the download. あるデータオブジェクト、それはダウンロードを再開するのに必要なデータを提供します。
completionHandler
The completion handler to call when the load request is complete. This handler is executed on the delegate queue. ロードリクエストが完了する時に呼び出す完了ハンドラ。このハンドラは、委任先キュー上で遂行されます。
If you pass nil
, only the session delegate methods are called when the task completes, making this method equivalent to the download
method.
あなたがnil
を渡すならば、セッション委任先メソッドそれらだけがそのタスクが完了する時に呼び出され、このメソッドをdownload
メソッドと等しいものにします。
location
The location of a temporary file where the server’s response is stored. You must move this file or open it for reading before your completion handler returns. Otherwise, the file is deleted, and the data is lost. サーバのもつ応答が格納されるところの一時ファイルの場所。あなたは、このファイルを移動する、またはそれを読み出すために開くことを、あなたの完了ハンドラが戻る前にしなければなりません。そうでなければ、このファイルは消去されます、そしてデータは失われます。
response
An object that provides response metadata, such as HTTP headers and status code. If you are making an HTTP or HTTPS request, the returned object is actually an NSHTTPURLResponse
object.
あるオブジェクト、それは応答メタデータを提供します、たとえばHTTPヘッダおよび状態コード。あなたがHTTPまたはHTTPSリクエストをしているならば、返されるオブジェクトは事実上NSHTTPURLResponse
オブジェクトです。
error
An error object that indicates why the request failed, or nil
if the request was successful.
あるエラーオブジェクト、それはなぜリクエストが失敗したかを指し示します、またはnil
、もしリクエストがうまくいったならば。
The new session download task. 新しいセッションダウンロードタスク。
By using a completion handler, the task bypasses calls to delegate methods for response and data delivery, and instead provides any resulting data, response, or error inside the completion handler. Delegate methods for handling authentication challenges, however, are still called. 完了ハンドラを使うことによって、タスクは応答とデータを配達するための委任先メソッドへの呼び出しを迂回します、そして代わりに何らかの結果データ、応答、そしてエラーを完了ハンドラ内部で提供します。認証チャレンジを取り扱う委任先メソッドは、しかしながら、依然として呼び出されます。
You should pass a nil
completion handler only when creating tasks in sessions whose delegates include a URLSession:
method.
あなたがnil
完了ハンドラを渡すべきなのは唯一、委任先がURLSession:
メソッドを含むセッションにおいて、それらタスクを作成している時です。
Your app can obtain a resume
object in two ways:
あなたのアプリは、resume
オブジェクトを2つの方法で入手します:
If your app cancels an existing transfer by calling cancel
, the session object passes a resume
object to the completion handler that you provided in that call.
あなたのアプリがある既存の転送をcancel
を呼び出すことによって取り消すならば、セッションオブジェクトはresume
オブジェクトを、あなたがその呼び出しにおいて提供した完了ハンドラへと渡します。
If a transfer fails, the session object provides an NSError
object either to its delegate or to the task’s completion handler. In that object, the NSURLSession
key in the user
dictionary contains a resume
object.
転送が失敗するならば、セッションオブジェクトは、NSError
オブジェクトを、それの委任先へまたはタスクのもつ完了ハンドラへのどちらかに提供します。そのオブジェクトにおいて、NSURLSession
キーはuser
辞書において、resume
オブジェクトを含みます。
After you create the task, you must start it by calling its resume
method.
あなたがタスクを作成する後、あなたはそれを、それのresume
メソッドを呼び出すことによって開始しなければなりません。
If the request completes successfully, the location
parameter of the completion handler block contains the location of the temporary file, and the error
parameter is nil
. If the request fails, the location
parameter is nil
and the error
parameter contain information about the failure. If a response from the server is received, regardless of whether the request completes successfully or fails, the response
parameter contains that information.
リクエストが成功裏に完了するならば、完了ハンドラブロックのlocation
パラメータは一時ファイルの場所を含みます、そしてerror
パラメータはnil
です。リクエストが失敗するならば、location
パラメータはnil
です、そしてerror
パラメータはその失敗についての情報を含みます。サーバからの応答が受け取られるならば、リクエストがうまく完了するか失敗するかどうかに関係なく、response
パラメータはその情報を含みます。
Note 注意
A download can be resumed only if it is an HTTP or HTTPS GET
request, and only if the remote server supports byte-range requests (with the Range
header) and provides the ETag
or Last-Modified
header in its responses. A download may also restart if the file on the server has been modified, or if the temporary file has been deleted because of low disk space.
ダウンロードは、それがHTTPまたはHTTPSのGET
リクエストである場合にのみ、そしてリモートサーバがバイト範囲リクエストをサポートする(Range
ヘッダで)そしてETag
またはLast-Modified
ヘッダをそれの応答において提供する場合にのみ、再開されることができます。ダウンロードはまた、サーバ上のファイルが修正されたならば、または一時ファイルがディスクの空きが少ないために消去されるならば、再始動するでしょう。
- downloadTaskWithURL:
- downloadTaskWithURL:completionHandler:
- downloadTaskWithRequest:
- downloadTaskWithRequest:completionHandler:
- downloadTaskWithResumeData:
NSURLSessionDownloadTask
NSURLSessionDownloadDelegate