Checking Volume Storage Capacity ボリュームストレージ容量を調べる

Overview 概要

Before you try to store a large amount of data locally, first verify that you have sufficient storage capacity. あなたが大量のデータをローカルに格納しようとする前に、まずあなたが十分なストレージ容量を持つことを検証してください。 To get the storage capacity of a volume, you construct a URL (using an instance of URL) that references an object on the volume to be queried, and then query that volume.

Decide Which Query Type to Use どのクエリ型を使うか決める

The query type to use depends on what's being stored. If you’re storing data based on a user request or resources the app requires to function properly (for example, a video the user is about to watch or resources that are needed for the next level in a game), query against volumeAvailableCapacityForImportantUsageKey. However, if you’re downloading data in a more predictive manner (for example, downloading a newly available episode of a TV series that the user has been watching recently), query against volumeAvailableCapacityForOpportunisticUsageKey. 使用するクエリ型は、何が格納されているかに依存します。あなたがユーザリクエストに基づくデータまたはアプリが適切に機能するのに必要とするリソースを格納しているならば（例えば、ユーザがまさに見ようとしているビデオまたはゲームの次のレベルに必要とされるリソース）、volumeAvailableCapacityForImportantUsageKeyに問い合わせ（クエリ）をしてください。しかしながら、あなたがデータをより予測できる流儀でダウンロードしているならば（例えば、ユーザが最近見ているあるTVシリーズの新しく利用可能なエピソードをダウンロードする）、volumeAvailableCapacityForOpportunisticUsageKeyに問い合わせしてください。

Construct a Query クエリを構成する

Use this example as a guide to construct your own query: この例をあなた独自のクエリを構成する手引きとして使ってください：

let fileURL = URL(fileURLWithPath:"/")
do {
    let values = try fileURL.resourceValues(forKeys: [.volumeAvailableCapacityForImportantUsageKey])
    if let capacity = values.volumeAvailableCapacityForImportantUsage {
        print("Available capacity for important usage: \(capacity)")
    } else {
        print("Capacity is unavailable")
    }
} catch {
    print("Error retrieving capacity: \(error.localizedDescription)")
}