An NSURLSessionConfiguration object defines the behavior and policies to use when uploading and downloading data using an NSURLSession object. When uploading or downloading data, creating a configuration object is always the first step you must take. You use this object to configure the timeout values, caching policies, connection requirements, and other types of information that you intend to use with your NSURLSession object.NSURLSessionConfigurationオブジェクトは、NSURLSessionオブジェクトを使ってデータをアップロードおよびダウンロードするときに使う挙動と方針を定義します。データをアップロードまたはダウンロードする時、構成設定オブジェクトを作成することは、常にあなたが取らなければならない最初の一歩です。あなたはこのオブジェクトを使うことで、タイムアウト値、キャッシュ方針、接続要件、そしてあなたのNSURLSessionオブジェクトで使うことをあなたが意図する他の種類の情報を構成設定します。
It is important to configure your NSURLSessionConfiguration object appropriately before using it to initialize a session object. Session objects make a copy of the configuration settings you provide and use those settings to configure the session. Once configured, the session object ignores any changes you make to the NSURLSessionConfiguration object. If you need to modify your transfer policies, you must update the session configuration object and use it to create a new NSURLSession object.
重要なことは、あなたのNSURLSessionConfigurationオブジェクトを、それを使ってセッションオブジェクトを初期化する前に、適切に構成設定することです。セッションオブジェクトは、あなたが提供する構成設定の設定それらのコピーを作ります、そしてそれらの設定を使ってセッションを構成設定します。一旦構成設定されたならば、セッションオブジェクトは、あなたがNSURLSessionConfigurationオブジェクトにするあらゆる変更を無視します。あなたがあなたの転送方針を修正する必要があるならば、あなたはセッション構成設定オブジェクトを更新して、それを使って新しいNSURLSessionオブジェクトを作成しなければなりません。
For more information about using configuration objects to create sessions, see NSURLSession.
セッションを作成するために構成設定オブジェクトを使うことについてのさらなる情報として、NSURLSessionを見てください。
Types of Session Configurations
セッション構成設定の型
The behavior and capabilities of a URL session are largely determined by the kind of configuration used to create the session.
あるURLセッションの挙動と能力は、セッションを作成するために使われる構成設定の種類によって大部分は決定されます。
The singleton shared session (which has no configuration object) is for basic requests. It’s not as customizable as sessions that you create, but it serves as a good starting point if you have very limited requirements. You access this session by calling the shared class method. See that method’s discussion for more information about its limitations.
シングルトン共有セッション（それは構成設定オブジェクトを持ちません）は、基本的なリクエストに対するものです。それはあなたが作成するセッションと同じようにカスタマイズ可能ではありません、しかしそれは良い出発点として利用できます、もしあなたが非常に制限された要件を持つならば。あなたはこのセッションに、共有クラスメソッドを呼び出すことによってアクセスします。そのメソッドのもつ議論をそれの限界についてのさらなる情報として見てください。
Default sessions behave much like the shared session (unless you customize them further), but let you obtain data incrementally using a delegate. You can create a default session configuration by calling the default method on the URLSessionConfiguration class.
省略時のセッションは、ほとんど共有セッションのように振るまいます、しかしあなたにデータを漸増的に委任先を使って入手させます。あなたは、省略時のセッション構成設定を、省略時のメソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。
Ephemeral sessions are similar to default sessions, but they don’t write caches, cookies, or credentials to disk. You can create an ephemeral session configuration by calling the ephemeral method on the URLSessionConfiguration class.
短命セッションは、省略時のセッションに似ています、しかしそれらはキャッシュ、クッキー、または資格情報をディスクに書き出しません。あなたは、短命セッション構成設定を、短命メソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。
Background sessions let you perform uploads and downloads of content in the background while your app isn’t running. You can create a background session configuration by calling the backgroundSessionConfiguration(_:) method on the URLSessionConfiguration class.
バックグラウンドセッションは、あなたに内容のアップロードとダウンロードをあなたのアプリが動作していない間にバックグラウンドで実行させます。あなたは、バックグラウンドセッション構成設定を、backgroundSessionConfiguration(_:) メソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。
Topics
話題
Creating a Session Configuration Object
セッション構成設定オブジェクトを作成する
Creates a session configuration object that allows HTTP and HTTPS uploads or downloads to be performed in the background.
あるセッション構成設定オブジェクトを作成します、それはHTTPおよびHTTPSアップロードまたはダウンロードにバックグラウンドで実行されることを許可します。
The identifier for the shared container into which files in background URL sessions should be downloaded.
それへとバックグラウンドURLセッションにおけるファイルがダウンロードされるべき、共有コンテナに対する識別子。
A Boolean value that indicates whether the session should wait for connectivity to become available, or fail immediately.
あるブール値、それは相互通信能力が利用可能になるのをセッションが待機するべきか、または直ちに失敗するかを指し示します。
The minimum TLS protocol version that the client should accept when making connections in this session.
接続をこのセッションにおいて作っているクライアントが受け入れるべき最小限のTLSプロトコルバージョン。
The maximum TLS protocol version that the client should request when making connections in this session.
最大限のTLSプロトコルバージョン、それはクライアントがこのセッションにおいて接続をする時にリクエストすべきものです。
The maximum TLS protocol version that the client should request when making connections in this session.
最大限のTLSプロトコルバージョン、それはクライアントがこのセッションにおいて接続をする時にリクエストすべきものです。
A Boolean value that indicates whether the app should be resumed or launched in the background when transfers finish.
あるブール値、それは転送が終了する時にアプリがバックグラウンドで再開されるまたは起動されるべきかどうかを指し示します。
A Boolean value that determines whether background tasks can be scheduled at the discretion of the system for optimal performance.
あるブール値、それはバックグラウンドタスクが最善の性能のためにシステムの裁量で予定されることができるかどうかを決定します。
A Boolean value that indicates whether TCP connections should be kept open when the app moves to the background.
あるブール値、それはアプリがバックグラウンドに移動する時にTCP接続が開いたままにされるべきかどうかを指し示します。
Use the available radios in iOS devices to improve your app’s network reliability and performance.
iOSデバイスにおいて利用可能な無線を使って、あなたのアプリのもつネットワーク信頼性と性能を改善します。
A service type that specifies the Multipath TCP connection policy for transmitting data over Wi-Fi and cellular interfaces.
あるサービス型、それはWi-Fiおよびcellularインターフェイス越しのデータ転送に対するマルチパスTCP接続方針を指定します。
A Boolean value indicating whether your app may use Multipath protocols to seamlessly transition between Wi-Fi and cellular networks.
あなたのアプリがマルチバスプロトコルを使って途切れることなくWi-Fiとセルラーネットワークの間を推移するかもしれないかどうかを指し示すあるブール値。
Key: com.apple.developer.networking.multipath
Setting HTTP Policy and Proxy Properties
HTTPポリシーおよびプロキシプロパティを設定する
A Boolean value that indicates whether the session should wait for connectivity to become available, or fail immediately.
あるブール値、それは相互通信能力が利用可能になるのをセッションが待機するべきか、または直ちに失敗するかを指し示します。
A Boolean value that indicates whether connections may use the network when the user has specified Low Data Mode.
ユーザがLow Data Modeを指定する場合に接続がネットワークを使うかもしれないかどうかを指し示すブール値。
A Boolean value that indicates whether connections may use a network interface that the system considers expensive.
システムが高くつくと考えるネットワークインターフェイスを接続が使うかもしれないかどうかを指し示すブール値。
Returns a session configuration object that allows HTTP and HTTPS uploads or downloads to be performed in the background.
あるセッション構成設定オブジェクトを返します、それはHTTPおよびHTTPSアップロードまたはダウンロードにバックグラウンドで実行されることを許可します。