Instance Method インスタンスメソッド

download(resumeFrom:delegate:)

Resumes a previously-paused download and delivers the URL of the saved file asynchronously.

Declaration 宣言 

func download(resumeFrom resumeData: Data, delegate: URLSessionTaskDelegate? = nil) async throws -> (URL, URLResponse)

Parameters パラメータ

resumeData

A data object that provides the data necessary to resume a download. あるデータオブジェクト、それはダウンロードを再開するのに必要なデータを提供します。

delegate

A delegate that receives life cycle and authentication challenge callbacks as the transfer progresses.

Return Value 戻り値

An asynchronously-delivered tuple that contains the location of the downloaded file as a URL, and a URLResponse.

Discussion 議論

Your app can obtain a resumeData object in two ways: あなたのアプリは、resumeDataオブジェクトを２つの方法で入手します：

  • If your app cancels an existing transfer by calling cancel(byProducingResumeData:), the session object passes a resumeData object to the completion handler that you provided in that call. あなたのアプリがある既存の転送をcancel(byProducingResumeData:)を呼び出すことによって取り消すならば、セッションオブジェクトはresumeDataオブジェクトを、あなたがその呼び出しにおいて提供した完了ハンドラへと渡します。

  • 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 NSURLSessionDownloadTaskResumeData key in the userInfo dictionary contains a resumeData object. 転送が失敗するならば、セッションオブジェクトは、NSErrorオブジェクトを、それの委任先へまたはタスクのもつ完了ハンドラへのどちらかに提供します。そのオブジェクトにおいて、NSURLSessionDownloadTaskResumeDataキーはuserInfo辞書において、resumeDataオブジェクトを含みます。

See Also 参照

Performing Asynchronous Transfers 非同期転送を実行する

func bytes(for: URLRequest, delegate: URLSessionTaskDelegate?) -> (URLSession.AsyncBytes, URLResponse)
Retrieves the contents of a URL based on the specified URL request and delivers an asynchronous sequence of bytes.
func bytes(from: URL, delegate: URLSessionTaskDelegate?) -> (URLSession.AsyncBytes, URLResponse)
Retrieves the contents of a given URL and delivers an asynchronous sequence of bytes.
struct URLSession.AsyncBytes
An asynchronous sequence of bytes. バイトいくつかからなるある非同期シーケンス。
func data(for: URLRequest, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Downloads the contents of a URL based on the specified URL request and delivers the data asynchronously.
func data(from: URL, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Retrieves the contents of a URL and delivers the data asynchronously.
func download(for: URLRequest, delegate: URLSessionTaskDelegate?) -> (URL, URLResponse)
Retrieves the contents of a URL based on the specified URL request and delivers the URL of the saved file asynchronously.
func download(from: URL, delegate: URLSessionTaskDelegate?) -> (URL, URLResponse)
Retrieves the contents of a URL and delivers the URL of the saved file asynchronously.
func upload(for: URLRequest, from: Data, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Uploads data to a URL based on the specified URL request and delivers the result asynchronously.
func upload(for: URLRequest, fromFile: URL, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Uploads data to a URL and delivers the result asynchronously.
protocol URLSessionTaskDelegate
A protocol that defines methods that URL session instances call on their delegates to handle task-level events. あるプロトコル、それはいくつかのメソッドを定義します、それらはURLセッションインスタンスがそれらの委任先上で呼び出してタスク水準イベントを取り扱うものです。