Ожидание App Store для обработки транзакций

Очередь транзакции играет центральную роль в разрешении Вашему приложению связаться с App Store через платформу Стора Кита. Вы добавляете работу к очереди, что App Store должен действовать на, такие как платежное требование, которое должно быть обработано. Когда изменения состояния транзакции — например, наблюдателя очереди транзакции приложения, когда платежное требование успешно выполняется — Стор Кит вызывают именно Ваше решение класс действует как наблюдатель. В очень небольших приложениях Вы могли обработать всю логику Стора Кита в делегате приложения, включая наблюдение очереди транзакции. В большинстве приложений Вы создаете отдельный класс, обрабатывающий эту логику наблюдателя вместе с остальной частью логики хранилища Вашего приложения. Наблюдатель должен соответствовать SKPaymentTransactionObserver протокол.

Используя средние значения наблюдателя Ваше приложение постоянно не опрашивает состояние своих активных транзакций. В дополнение к использованию очереди транзакции для платежных требований Ваше приложение также использует очередь транзакции, чтобы загрузить размещенное Apple содержание и узнать, что были возобновлены подписки.

Зарегистрируйте наблюдателя очереди транзакции, когда Ваше приложение будет запущено, как показано в Перечислении 4-1. Удостоверьтесь, что наблюдатель готов обработать транзакцию в любое время, не сразу после того, как Вы добавляете транзакцию к очереди. Например, рассмотрите случай пользователя, покупающего что-то в Вашем приложении прямо перед входом в туннель. Ваше приложение не в состоянии поставить купленное содержание, потому что нет никакого сетевого соединения. В следующий раз, когда Ваше приложение запускается, Стор Кит вызывает Вашего наблюдателя очереди транзакции снова и поставляет купленное содержание в то время. Точно так же, если Вашему приложению не удается отметить транзакцию, как закончено, Стор Кит вызывает наблюдателя каждый раз, когда Ваше приложение запускается, пока транзакция должным образом не закончена.

Перечисление 4-1  , Регистрирующее наблюдателя очереди транзакции

- (BOOL)application:(UIApplication *)application

 didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

{

    /* ... */

    [[SKPaymentQueue defaultQueue] addTransactionObserver:observer];

}

Реализуйте paymentQueue:updatedTransactions: метод на Вашем наблюдателе очереди транзакции. Набор хранилища вызывает этот метод, когда состояние транзакции изменяется — например, когда было обработано платежное требование. Состояние транзакции говорит Вам, какое действие Ваше приложение должно выполнить, как показано в Таблице 4-1 и Перечислении 4-2. Транзакции в очереди могут изменить состояние в любом порядке. Ваше приложение должно быть готово работать над любой активной транзакцией в любое время.

Перечисление 4-2  , Отвечающее на состояния транзакции

- (void)paymentQueue:(SKPaymentQueue *)queue

 updatedTransactions:(NSArray *)transactions

{

    for (SKPaymentTransaction *transaction in transactions) {

        switch (transaction.transactionState) {

            // Call the appropriate custom method for the transaction state.

            case SKPaymentTransactionStatePurchasing:

                [self showTransactionAsInProgress:transaction deferred:NO];

                break;

            case SKPaymentTransactionStateDeferred:

                [self showTransactionAsInProgress:transaction deferred:YES];

                break;

            case SKPaymentTransactionStateFailed:

                [self failedTransaction:transaction];

                break;

            case SKPaymentTransactionStatePurchased:

                [self completeTransaction:transaction];

                break;

            case SKPaymentTransactionStateRestored:

                [self restoreTransaction:transaction];

                break;

            default:

                // For debugging

                NSLog(@"Unexpected transaction state %@", @(transaction.transactionState));

                break;

        }

    }

}

Чтобы усовершенствовать Ваш пользовательский интерфейс при ожидании, наблюдатель очереди транзакции может реализовать дополнительные методы от SKPaymentTransactionObserver протокол следующим образом. paymentQueue:removedTransactions: когда транзакции удалены из очереди — в Вашей реализации этого метода, удаляют соответствующие элементы из UI Вашего приложения, метод вызывают. paymentQueueRestoreCompletedTransactionsFinished: или paymentQueue:restoreCompletedTransactionsFailedWithError: метод вызывают, когда Стор Кит заканчивает восстанавливать транзакции в зависимости от того, была ли ошибка. В Вашей реализации этих методов обновите UI своего приложения для отражения успеха или ошибки.

Сохранение закупки

После предоставления доступа к продукту Ваше приложение должно сделать персистентную запись из закупки. Ваше использование приложения, что персистентная запись на запуске, чтобы продолжать делать продукт доступным. Это также использует ту запись для восстановления покупок, как описано в Восстановлении Купленных продуктов. Стратегия персистентности Вашего приложения зависит тип продуктов, которые Вы продаете и версии iOS.

• Для непотребляемых продуктов и автовозобновляемых подписок в iOS 7 и позже, используйте получение приложения в качестве своей персистентной записи.

• Для непотребляемых продуктов и автовозобновляемых подписок в версиях iOS ранее, чем iOS 7, используйте Пользовательскую систему Значений по умолчанию или iCloud для ведения учет персистентного учета.

• Для невозобновления подписок используйте iCloud или Ваш собственный сервер для ведения учет персистентного учета.

• Для потребляемых продуктов, Ваши обновления приложения его внутреннее состояние для отражения закупки но нет никакой потребности вести персистентный учет, потому что потребляемые продукты не восстанавливаются или синхронизируются через устройства. Гарантируйте, что обновленное состояние является частью объекта, поддерживающего сохранение состояния (в iOS) или что Вы вручную сохраняете состояние через запуски приложения (в iOS или OS X). Для получения информации о сохранении состояния посмотрите Сохранение состояния и Восстановление.

При использовании Пользовательской системы Значений по умолчанию или iCloud, Ваше приложение может сохранить значение, такое как число или булевская переменная или копия получения транзакции. В OS X пользователь может отредактировать Пользовательскую систему Значений по умолчанию с помощью defaults команда. Хранение получения требует большей прикладной логики, но препятствует тому, чтобы вмешалась персистентная запись.

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

#if USE_ICLOUD_STORAGE

NSUbiquitousKeyValueStore *storage = [NSUbiquitousKeyValueStore defaultStore];

#else

NSUserDefaults *storage = [NSUserDefaults standardUserDefaults];

#endif

[storage setBool:YES forKey:@"enable_rocket_car"];

[storage setObject:@15 forKey:@"highest_unlocked_level"];

[storage synchronize];

#if USE_ICLOUD_STORAGE

NSUbiquitousKeyValueStore *storage = [NSUbiquitousKeyValueStore defaultStore];

#else

NSUserDefaults *storage = [NSUserDefaults standardUserDefaults];

#endif

NSData *newReceipt = transaction.transactionReceipt;

NSArray *savedReceipts = [storage arrayForKey:@"receipts"];

if (!receipts) {

    // Storing the first receipt

    [storage setObject:@[newReceipt] forKey:@"receipts"];

} else {

    // Adding another receipt

    NSArray *updatedReceipts = [savedReceipts arrayByAddingObject:newReceipt];

    [storage setObject:updatedReceipts forKey:@"receipts"];

}

[storage synchronize];

Разблокирование функциональности приложения

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

Например, с помощью получения приложения, код мог бы быть похожим на следующее:

NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];

NSData *receiptData = [NSData dataWithContentsOfURL:receiptURL];

// Custom method to work with receipts

BOOL rocketCarEnabled = [self receipt:receiptData

        includesProductID:@"com.example.rocketCar"];

Или, с помощью Пользовательской системы Значений по умолчанию:

NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];

BOOL rocketCarEnabled = [defaults boolForKey:@"enable_rocket_car"];

Тогда используйте ту информацию для включения надлежащих путей выполнения кода в приложении.

if (rocketCarEnabled) {

    // Use the rocket car.

} else {

    // Use the regular car.

}

Поставка связанного содержания

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

Можно встроить то содержание в пакет приложения, или можно загрузить его по мере необходимости — каждый подход имеет свои преимущества и недостатки. Если Вы включаете слишком мало содержания в свой комплект приложений, пользователь должен ожидать даже маленьких покупок, которые будут загружены. При включении слишком много в комплект приложений начальная загрузка приложения берет слишком долго, и пространство потрачено впустую для пользователей, не покупающих соответствующие продукты. Кроме того, если Ваше приложение будет слишком большим, то пользователи не будут в состоянии загрузить его по сотовым сетям.

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

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

В iOS 6 и позже, большинство приложений должно использовать размещенное Apple содержание для загруженных файлов. Вы создаете размещенный Apple пакет содержания с помощью цели Содержания Закупки В приложении в XCode и представляете его Подключению iTunes. При хостинге содержания на серверах Apple, Вы не должны обеспечивать серверы — содержание Вашего приложения сохранено Apple с помощью той же инфраструктуры, поддерживающей другие крупномасштабные операции, такие как App Store. Даже если Ваше приложение не работает, Кроме того, размещенное Apple содержание автоматически загружает в фоновом режиме.

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

NSURL *url = [[NSBundle mainBundle] URLForResource:@"rocketCar"

                                     withExtension:@"plist"];

[self loadVehicleAtURL:url];

NSError *error;

BOOL success = [URL setResourceValue:[NSNumber numberWithBool:YES]

                              forKey:NSURLIsExcludedFromBackupKey

                               error:&error];

if (!success) { /* Handle error... */ }

Окончание транзакции

Окончание транзакции говорит Стору Киту о завершении всего необходимого для закупки. Незаконченные транзакции остаются в очереди, пока они не закончены, и наблюдателя очереди транзакции вызывают каждый раз, когда Ваше приложение запускается так, Ваше приложение может закончить транзакции. Ваше приложение должно закончить каждую транзакцию, независимо от того, успешно выполнилась ли транзакция или отказавший.

Завершите все следующие действия перед окончанием транзакции:

• Сохраните закупку.

• Загрузите связанное содержание.

• Обновите UI своего приложения, чтобы позволить пользователю получить доступ к продукту.

Для окончания транзакции вызовите finishTransaction: метод на очереди платежа.

SKPaymentTransaction *transaction = <# The current payment #>;

[[SKPaymentQueue defaultQueue] finishTransaction:transaction];

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

Предложенные шаги тестирования

Протестируйте каждую часть своего кода, чтобы проверить реализацию его правильно.