SKDownload
Оператор импорта
Swift
import StoreKit
Objective C
@import StoreKit;
Доступность
Доступный в iOS 6.0 и позже.
A SKDownload
объект представляет загружаемое содержание, связанное с продуктом. При создании продукта в Подключении iTunes можно связать одну или более частей загружаемого содержания с ним. Затем во время выполнения, когда продукт куплен пользователем, Вашим использованием приложения SKDownload
объекты загрузить содержание с App Store.
Ваше приложение никогда непосредственно создает a SKDownload
объект. Вместо этого после того, как платеж обрабатывается, Ваше приложение читает объект транзакции downloads
свойство для получения массива SKDownload
объекты связались с транзакцией. Затем для загрузки содержания Вы ставите объект загрузки в очередь на очереди платежа и ожидаете содержания, которое будет загружено. После того, как загрузка завершается, считайте объект загрузки contentURL
свойство для получения URL к загруженному содержанию. Ваше приложение должно обработать загруженный файл прежде, чем завершить транзакцию. Например, это могло бы скопировать файл в каталог, содержание которого является персистентным. Как только все загрузки завершены, Вы заканчиваете транзакцию. После того, как транзакция закончена, объекты загрузки не могут быть поставлены в очередь очереди платежа, и любой URLs к загруженному содержанию недопустим.
-
contentIdentifier
СвойствоСтрока, однозначно определяющая загружаемое содержание. (только для чтения)
Объявление
Swift
var contentIdentifier: String! { get }
Objective C
@property(nonatomic, readonly) NSString *contentIdentifier
Обсуждение
Каждая часть загружаемого содержания, связанного с продуктом, имеет свой собственный уникальный идентификатор. Когда Вы добавляете содержание, идентификатор содержания указан в Подключении iTunes.
Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
contentLength
СвойствоДлина загружаемого содержания, в байтах. (только для чтения)
Объявление
Swift
var contentLength: Int64 { get }
Objective C
@property(nonatomic, readonly) long long contentLength
Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
contentVersion
СвойствоСтрока, идентифицирующая, какая версия содержания доступна для скачивания. (только для чтения)
Объявление
Swift
var contentVersion: String! { get }
Objective C
@property(nonatomic, readonly) NSString *contentVersion
Обсуждение
Строка версии должна быть отформатирована как серия целых чисел, разделенных периодами.
Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
transaction
СвойствоТранзакция связалась с загружаемым файлом. (только для чтения)
Объявление
Swift
var transaction: SKPaymentTransaction! { get }
Objective C
@property(nonatomic, readonly) SKPaymentTransaction *transaction
Обсуждение
Объект загрузки всегда связывается с платежной операцией. Объект загрузки может только быть поставлен в очередь после того, как платеж обрабатывается и прежде чем будет закончена транзакция.
Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
downloadState
СвойствоТекущее состояние объекта загрузки. (только для чтения)
Объявление
Swift
var downloadState: SKDownloadState { get }
Objective C
@property(nonatomic, readonly) SKDownloadState downloadState
Обсуждение
Когда состояние загрузки возражает изменениям, после организации очередей объекта загрузки объект очереди платежа вызывает наблюдателя транзакции. Ваш наблюдатель транзакции должен читать
downloadState
свойство и использование это, чтобы определить, как продолжить. Для получения дополнительной информации о различных состояниях посмотрите состояния Загрузки.Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
progress
СвойствоЗначение, указывающее, сколько из файла было загружено. (только для чтения)
Объявление
Swift
var progress: Float { get }
Objective C
@property(nonatomic, readonly) float progress
Обсуждение
Значение этого свойства является числом с плавающей точкой между
0.0
и1.0
, включительно, где0.0
средние значения никакие данные были загрузкой и1.0
средние значения все данные были загружены. Как правило, Ваше приложение использует значение этого свойства для обновления элемента пользовательского интерфейса, такого как индикатор выполнения, выводящий на экран, сколько из файла было загружено.Не используйте значение этого свойства, чтобы определить, завершилась ли загрузка. Вместо этого используйте
downloadState
свойство.Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
timeRemaining
СвойствоПредполагаемое время, в секундах, чтобы закончить загружать содержание. (только для чтения)
Объявление
Swift
var timeRemaining: NSTimeInterval { get }
Objective C
@property(nonatomic, readonly) NSTimeInterval timeRemaining
Обсуждение
Система пытается оценить, сколько времени она возьмет, чтобы закончить загружать файл. Если это не может создать хорошую оценку, значение этого свойства установлено в
SKDownloadTimeRemainingUnknown
.Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
error
СвойствоОшибка, препятствовавшая тому, чтобы было загружено содержание. (только для чтения)
Объявление
Swift
var error: NSError! { get }
Objective C
@property(nonatomic, readonly) NSError *error
Обсуждение
Значение этого свойства допустимо только когда
downloadState
свойство установлено вSKDownloadStateFailed
.Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
contentURL
СвойствоЛокальное расположение загруженного файла. (только для чтения)
Объявление
Swift
var contentURL: NSURL! { get }
Objective C
@property(nonatomic, readonly) NSURL *contentURL
Обсуждение
Значение этого свойства допустимо только когда
downloadState
свойство установлено вSKDownloadStateFinished
. URL становится недопустимым после того, как будет завершен объект транзакции, связанный с загрузкой.Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
Состояния, в которых может быть работа загрузки.
Объявление
Swift
enum SKDownloadState : Int { case Waiting case Active case Paused case Finished case Failed case Cancelled }
Objective C
enum { SKDownloadStateWaiting, SKDownloadStateActive, SKDownloadStatePaused, SKDownloadStateFinished, SKDownloadStateFailed, SKDownloadStateCancelled, }; typedef NSInteger SKDownloadState;
Константы
-
Waiting
SKDownloadStateWaiting
Указывает, что загрузка еще не запустилась.
Доступный в iOS 6.0 и позже.
-
Active
SKDownloadStateActive
Указывает, что в настоящее время загружается содержание.
Доступный в iOS 6.0 и позже.
-
Paused
SKDownloadStatePaused
Указывает, что Ваше приложение приостановило загрузку.
Доступный в iOS 6.0 и позже.
-
Finished
SKDownloadStateFinished
Указывает, что было успешно загружено содержание.
Доступный в iOS 6.0 и позже.
-
Failed
SKDownloadStateFailed
Указывает, что ошибка произошла, в то время как загружался файл.
Доступный в iOS 6.0 и позже.
-
Cancelled
SKDownloadStateCancelled
Указывает, что Ваше приложение отменило загрузку.
Доступный в iOS 6.0 и позже.
Оператор импорта
Objective C
@import StoreKit;
Swift
import StoreKit
Доступность
Доступный в iOS 6.0 и позже.
-
-
Временные стоимости раньше показывали специальные состояния загрузки.
Объявление
Swift
var SKDownloadTimeRemainingUnknown: NSTimeInterval
Objective C
NSTimeInterval SKDownloadTimeRemainingUnknown;
Константы