Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы StoreKit ссылка класса SKDownload

Опции
Развертывание Target:

На этой странице
Язык:

SKDownload

A SKDownload объект представляет загружаемое содержание, связанное с продуктом. При создании продукта в Подключении iTunes можно связать одну или более частей загружаемого содержания с ним. Затем во время выполнения, когда продукт куплен пользователем, Вашим использованием приложения SKDownload объекты загрузить содержание с App Store.

Ваше приложение никогда непосредственно создает a SKDownload объект. Вместо этого после того, как платеж обрабатывается, Ваше приложение читает объект транзакции downloads свойство для получения массива SKDownload объекты связались с транзакцией. Затем для загрузки содержания Вы ставите объект загрузки в очередь на очереди платежа и ожидаете содержания, которое будет загружено. После того, как загрузка завершается, считайте объект загрузки contentURL свойство для получения URL к загруженному содержанию. Ваше приложение должно обработать загруженный файл прежде, чем завершить транзакцию. Например, это могло бы скопировать файл в каталог, содержание которого является персистентным. Как только все загрузки завершены, Вы заканчиваете транзакцию. После того, как транзакция закончена, объекты загрузки не могут быть поставлены в очередь очереди платежа, и любой URLs к загруженному содержанию недопустим.

Наследование

Соответствует

Оператор импорта

Swift

import StoreKit

Objective C

@import StoreKit;

Доступность

Доступный в OS X v10.8 и позже.

Получение информации о загружаемом содержании
  • contentIdentifier contentIdentifier Свойство

    Строка, однозначно определяющая загружаемое содержание. (только для чтения)

    Объявление

    Swift

    var contentIdentifier: String! { get }

    Objective C

    @property(readonly) NSString *contentIdentifier

    Обсуждение

    Каждая часть загружаемого содержания, связанного с продуктом, имеет свой собственный уникальный идентификатор. Когда Вы добавляете содержание, идентификатор содержания указан в Подключении iTunes.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • contentLength contentLength Свойство

    Длина загружаемого содержания, в байтах. (только для чтения)

    Объявление

    Swift

    @NSCopying var contentLength: NSNumber! { get }

    Objective C

    @property(copy, readonly) NSNumber *contentLength

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • contentVersion contentVersion Свойство

    Строка, идентифицирующая, какая версия содержания доступна для скачивания. (только для чтения)

    Объявление

    Swift

    var contentVersion: String! { get }

    Objective C

    @property(copy, readonly) NSString *contentVersion

    Обсуждение

    Строка версии должна быть отформатирована как серия целых чисел, разделенных периодами.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

Получение информации о состоянии загрузки
  • состояние состояние Свойство

    Текущее состояние объекта загрузки. (только для чтения)

    Объявление

    Swift

    var state: SKDownloadState { get }

    Objective C

    @property(readonly) SKDownloadState state

    Обсуждение

    Когда состояние загрузки возражает изменениям, после организации очередей объекта загрузки объект очереди платежа вызывает наблюдателя транзакции. Ваш наблюдатель транзакции должен читать state свойство и использование это, чтобы определить, как продолжить. Для получения дополнительной информации о различных состояниях посмотрите состояния Загрузки.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • прогресс прогресс Свойство

    Значение, указывающее, сколько из файла было загружено. (только для чтения)

    Объявление

    Swift

    var progress: Float { get }

    Objective C

    @property(readonly) float progress

    Обсуждение

    Значение этого свойства является числом с плавающей точкой между 0.0 и 1.0, включительно, где 0.0 средние значения никакие данные были загрузкой и 1.0 средние значения все данные были загружены. Как правило, Ваше приложение использует значение этого свойства для обновления элемента пользовательского интерфейса, такого как индикатор выполнения, выводящий на экран, сколько из файла было загружено.

    Не используйте значение этого свойства, чтобы определить, завершилась ли загрузка. Вместо этого используйте downloadState свойство.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • timeRemaining timeRemaining Свойство

    Предполагаемое время, в секундах, чтобы закончить загружать содержание. (только для чтения)

    Объявление

    Swift

    var timeRemaining: NSTimeInterval { get }

    Objective C

    @property(readonly) NSTimeInterval timeRemaining

    Обсуждение

    Система пытается оценить, сколько времени она возьмет, чтобы закончить загружать файл. Если это не может создать хорошую оценку, значение этого свойства установлено в SKDownloadTimeRemainingUnknown.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

Доступ к завершенной загрузке
  • ошибка ошибка Свойство

    Ошибка, препятствовавшая тому, чтобы было загружено содержание. (только для чтения)

    Объявление

    Swift

    @NSCopying var error: NSError! { get }

    Objective C

    @property(copy, readonly) NSError *error

    Обсуждение

    Значение этого свойства допустимо только когда downloadState свойство установлено в SKDownloadStateFailed.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • contentURL contentURL Свойство

    Локальное расположение загруженного файла. (только для чтения)

    Объявление

    Swift

    @NSCopying var contentURL: NSURL! { get }

    Objective C

    @property(copy, readonly) NSURL *contentURL

    Обсуждение

    Значение этого свойства допустимо только когда downloadState свойство установлено в SKDownloadStateFinished. URL становится недопустимым после того, как будет завершен объект транзакции, связанный с загрузкой.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

Управление загруженным содержанием
  • contentURLForProductID (_:) + contentURLForProductID:

    Возвращает локальное расположение для ранее загруженного flie.

    Объявление

    Swift

    class func contentURLForProductID(_ productID: String!) -> NSURL!

    Objective C

    + (NSURL *)contentURLForProductID:(NSString *)productID

    Параметры

    productID

    Идентификатор продукта.

    Возвращаемое значение

    Локальное расположение для ранее загруженного flie.

    Обсуждение

    Используйте этот метод для определения местоположения содержания на последующих запусках приложения.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • deleteContentForProductID (_:) + deleteContentForProductID:

    Удаляет ранее загруженный файл.

    Объявление

    Swift

    class func deleteContentForProductID(_ productID: String!)

    Objective C

    + (void)deleteContentForProductID:(NSString *)productID

    Параметры

    productID

    Идентификатор продукта.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.

Константы
  • Состояния загрузки

    Состояния, в которых может быть работа загрузки.

    Объявление

    Swift

    struct SKDownloadState { init(_ value: Int) var value: Int }

    Objective C

    enum { SKDownloadStateWaiting, SKDownloadStateActive, SKDownloadStatePaused, SKDownloadStateFinished, SKDownloadStateFailed, SKDownloadStateCancelled, }; typedef NSInteger SKDownloadState;

    Константы

    • SKDownloadStateWaiting

      SKDownloadStateWaiting

      Указывает, что загрузка еще не запустилась.

      Доступный в OS X v10.8 и позже.

    • SKDownloadStateActive

      SKDownloadStateActive

      Указывает, что в настоящее время загружается содержание.

      Доступный в OS X v10.8 и позже.

    • SKDownloadStatePaused

      SKDownloadStatePaused

      Указывает, что Ваше приложение приостановило загрузку.

      Доступный в OS X v10.8 и позже.

    • SKDownloadStateFinished

      SKDownloadStateFinished

      Указывает, что было успешно загружено содержание.

      Доступный в OS X v10.8 и позже.

    • SKDownloadStateFailed

      SKDownloadStateFailed

      Указывает, что ошибка произошла, в то время как загружался файл.

      Доступный в OS X v10.8 и позже.

    • SKDownloadStateCancelled

      SKDownloadStateCancelled

      Указывает, что Ваше приложение отменило загрузку.

      Доступный в OS X v10.8 и позже.

    Оператор импорта

    Objective C

    @import StoreKit;

    Swift

    import StoreKit

    Доступность

    Доступный в OS X v10.8 и позже.